Documentation Avoyd Éditeur de Voxels

Mis à jour le 06 juin 2023

Comment utiliser Avoyd pour réaliser des créations en voxels: tutoriel, contrôles et raccourcis. La documentation utilisateur est en cours de traduction


Avoyd Éditeur de Voxels capture d'écran - modèle 3D d'un paysage abstrait en voxels créé à partir de l'image 2D importée d'une fractale Mandelbrot et de cubes ajoutés par l'outil de génération procédurale. L'interface utilisateur inclus les fenêtres : éditeur, matériaux, illumination et atmosphère, outils de sélection, inspection et remplacement de matériaux, caméras et rendu.
Capture d'écran d'Avoyd Éditeur de Voxels avec l'interface utilisateur et une scène 3D en voxels.


🔗 Tutoriel d'introduction: comment éditer les voxels dans Avoyd



Ce tutoriel décrit pas à pas comment commmencer à utiliser l'éditeur de voxels d'Avoyd pour créer des formes de base avec les outils d'édition : Créer des voxels (Set), les modifier avec la fonction Peindre (Paint) et les Supprimer (Delete).

Pour commencer, télécharger Avoyd sur le site www.enkisoftware.com et l'installer.

🔗 1. Créer une forme simple en voxels avec 'Set'

Ces instructions expliquent comment utiliser l'éditeur pour crées un cube jaune de taille 3x3x3 voxels :

  1. Ouvrir l'éditeur: démarrer Avoyd et cliquer Voxel Editor dans le menu principal.
  2. Ouvrir l'outil d'édition: dans la barre de menu située en haut de la fenêtre, sélectionner Tools > Edit Tool onglet Shapes
  3. Avant de commencer, vérifier dans Edit Tool que :
    • le curseur de l'éditeur est visible : ouvrir la section Edit Cursor et s'assurer que les options Show Wireframe (montrer la grille) et Show Brush Preview (prévisualiser la forme) sont cochées. Alternativement, sélectionner Move Edit Cursor here dans le menu contextuel.
    • l'ancre Anchor est désactivée (case décochée).
    • l'option Sticky (collant) est désactivée (case décochée).
  4. Sélectionner l'outil de création Set dans la liste d'outil (colonne à gauche dans la fenêtre Edit Tool onglet Shapes).
  5. Sélectionner Cube dans la liste des formes Shape.
  6. Modifier les paramètres du cube:
    • Régler la taille Size = 3 voxels.
    • Régler la quantité Amount = 255.
  7. Choisir un matériau jaune : ouvrir la Palette et cliquer sur un carré de couleur jaune pour le sélectionner.
  8. Déplacer le pointeur de la souris en dehors de la fenêtre Edit Tool sur la zone du "monde" en 3D: le curseur de l'éditeur, une prévisualisation d'un cube jaune de dimensions 3x3x3 voxels apparaît, entouré d'une grille verte. Il suit les mouvements de la souris. Utiliser la molette de la souris pour éloigner ou rapprocher le curseur. Si vous ne voyez pas de curseur, sélectionner Move Edit Cursor here dans le menu contextuel.
  9. Cliquer le bouton gauche de la souris: un cube jaune composé de 3x3x3 voxels est créé. Cliquer à nouveau pour ajouter de nouveaux cubes.
Avoyd Éditeur de Voxels: fenêtre de l'outil d'édition ouverte avec l'option 'Set' (créer) sélectionnée, le curseur est un cube jaune, à gauche avant de créer une forme en voxels, à droite après la création
Outil d'édition 'Set' (créer) configuration et utilisation (cliquer pour agrandir)
AVANT : option 'Set', 'Cube' de taille 3 et matériau jaune sélectionnés : curseur cube de 3x3x3 voxels - grille verte avec prévisualisation des voxels jaunes ;
'Edit Cursor' activé ; 'Anchor' et 'Sticky' désactivées
APRÈS : le cube jaune est créé (le curseur est au dessus)

🔗 2. Modifier les matériaux avec 'Paint' (peindre)

Dans Avoyd, peindre ne change pas que la couleur : cela change le matériau dont sont fait les voxels. Les instructions qui suivent d'ecrivent comment peindre en bleu les voxels jaunes que vous venez de créer.

  1. Sélectionner l'outil Paint (colonne de gauche) dans la fenêtre Edit Tool.
  2. Sélectionner la forme Shape = Cube et régler sa taillle Size = 2 voxels.
  3. Sélectionner un matériau bleu dans la palette.
  4. Déplacer le pointeur avec la souris sur la zone 3D: un cube bleu 2x2x2 avec une grille verte apparaît.
  5. Déplacer le curseur jusqu`à ce qu'il chevauche un cube jaune. (Se souvenir que l'on peut tiliser la molette de la souris pour éloigner ou rapprocher le curseur).
  6. Cliquer le bouton gauche de la souris pour peindre: une partie de la forme jaune est maintenant bleue. The matériau d'origine a été remplacé par le matériau bleu.
Avoyd Éditeur de Voxels: fenêtre de l'outil d'édition ouverte avec l'option 'Paint' (peindre) sélectionnée, le curseur est un cube bleu, à gauche avant de peindre les voxels, à droite après l'opération
Outil d'édition 'Paint' (peindre) configuration et utilisation (cliquer pour agrandir)
AVANT : option 'Paint' sélectionnée, 'Cube' de taille 2 et matériau bleu sélectionnés : curseur cube de 2x2x2 voxels - grille verte avec prévisualisation des voxels bleus - intersecte le cube jaune
APRÈS : l'intersection de 2x2x1 voxels est peinte en bleu (le curseur est au dessus)

🔗 3. Supprimer des voxels avec 'Delete'

Comment effacer des voxels :

  1. Sélectionner Delete dans Edit Tool.
  2. Régler la taille du cube Size = 2 voxels.
  3. Déplacer le pointeur sur la zone 3D: une grille et un cube semi-transparent rouges de taille 2x2x2 apparaissent.
  4. Déplacer le curseur jusqu`à ce qu'il chevauche des voxels ajoutés auparavant et cliquer : les voxels disparaissent.
Avoyd Éditeur de Voxels: fenêtre de l'outil d'édition ouverte avec l'option 'Delete' (supprimer) sélectionnée, le curseur est un cube rouge, à gauche avant de supprimer des voxels, à droite après l'opération
Outil d'édition 'Delete' (supprimer) configuration et utilisation (cliquer pour agrandir)
AVANT : option 'Delete' sélectionnée, 'Cube' de taille 2 sélectionné (le matériau ne s'applique pas) : curseur cube de 2x2x2 voxels - grille et prévisualisation rouges - intersecte le cube jaune et bleu
APRÈS : l'intersection de 2x2x1 voxels est supprimée

🔗 4. Pour aller plus loin




🔗 Documentation Utilisateur



Traduction française en cours

Documentation en anglais




🔗 Contrôles et Raccourcis Clavier



Avoyd nécessite une souris et un clavier. Les commandes et les raccourcis sont actuellement codés en dur : ils ne sont pas configurables par l'utilisateur. Les commandes correspondent à un clavier Azerty.

🔗 Contrôle de la Caméra en Mode Mouvement

Les contrôles de la caméra sont activés en mode Mouvement (entrée piégée). En d'autres termes, le mode Mouvement vous donne le contrôle de la caméra : vous pouvez vous déplacer en 3D à l'aide de la souris et du clavier. Pour activer le mode Mouvement, cliquez et maintenez enfoncé le bouton droit de la souris. Vous pouvez également appuyer sur la touche Tab pour alterner entre le mode Menu et le mode Mouvement.

Les contrôles de la caméra dans l'éditeur de voxels sont similaires à ceux d'un jeu de tir à la première personne FPS en gravité zéro, sans collision ni inertie.

Fonction Commande
Enclencher le mode Mouvement Clic droit de la souris et maintenir, ou
Tab (alterne entre les deux modes)
Désenclencher le mode Mouvement Relâcher le bouton droit de la souris, ou
Tab, ou
Echap
Diriger le viseur de la caméra
Lacet et Tanguage
Souris (1*)
Translation (déplacement) horizontale vers l'avant
Avancer
Z
Translation horizontale vers l'arrière
Reculer
S
Translation horizontale vers la gauche
Esquiver à gauche
Q
Translation horizontale vers la droite
Esquiver à droite
D
Roulis à gauche
(sens inverse des aiguilles d'une montre)
A (3*)
Roulis à droite
(sens des aiguilles d'une montre)
E (3*)
Translation verticale vers le haut
Sauter, Monter
Barre Espace
Translation verticale vers le bas
Descendre
Ctrl gauche
Augmentation de la Vitesse
Sprint
Maj gauche
Caméra à la Première Personne / Caméra Arcball C (alterne)
Caméra sauvegardée 'Saved Camera': Ajouter Alt + ↓
Caméra sauvegardée: Précédente Alt + ←
Caméra sauvegardée: Suivante Alt + →


🔗 Commandes de l'Outil d'Edition 'Edit Tool'

Ces commandes sont disponibles lorsque la fenêtre de l'outil d'édition est ouverte et active. Menu Tools > Edit Tool > Shapes

Fonction Commande
Ouvrir l'outil d'édition Menu Tools > Edit Tool > Shapes, ou
"Alt+E" pour onglet Shapes (formes) ou "Alt+G" pour onglet Procedural Generation (génération procédurale)
Passer du mode Menu au mode Mouvement Clic droit de la souris et maintenir, ou
Tab (alterne entre les deux modes)
Passer du mode Mouvement au mode Menu Relâcher le bouton droit de la souris, ou
Tab (alterne entre les deux modes), ou
Echap
Afficher le curseur d'édition Section 'Edit Cursor' : cocher 'Show Wireframe' (montrer la grille) et 'Show Brush Preview' (prévisualiser la forme)
Déplacer le curseur d'édition Souris (en mode Menu, et l'ancre 'Anchor' doit être désactivée)
Rapprocher / éloigner le curseur d'édition Molette de la souris (l'ancre 'Anchor' doit être libre : 'Lock Position' décoché) (2*)
Activer / désactiver l'ancre 'Anchor' Alt + A
Augmenter / diminuer la taille de la forme 'Shape' d'un voxel dans les 3 directions ↑ ↓, ou
Maj + molette de la souris
Éxecuter l'édition F, ou
Souris bouton gauche (curseur dans la zone 3D), ou
Bouton [ Do... ]
Couper dans le monde 3D Ctrl + X (curseur dans la zone 3D)
Copier dans le monde 3D Ctrl + C (curseur dans la zone 3D)
Coller dans le monde 3D Ctrl + V (curseur dans la zone 3D)
Annuler la dernière édition dans le monde 3D Ctrl + Z
Rétablir - Inverser la dernière annulation dans le monde 3D Ctrl + Y
Sélectionner un outil d'édition personnalisé 0..9, ou
sélectionner dans la liste 'Presets'
Ouvrir le menu contextuel Clic droit de la souris (curseur dans la zone 3D)
Afficher / masquer tous les éléments de l'interface utilisateur Ctrl + M (5*)(6*)
Capture d'écran F10 (4*)
Ouvrir mondes et modèles, importer Sélectionner le fichier avec la souris puis glisser et déposer dans Avoyd, ou
Menus File > Open; File > Load Template; File > Import


🔗 Raccourcis Clavier

Commandes en ordre alphabétique

Commande Fonction
0..9 Sélectionner un outil d'édition personnalisé (outil d'édition 'Édit Tool' ouvert, onglet 'Shapes' a le focus)
A Roulis à gauche (sens inverse des aiguilles d'une montre)
C Alterner Caméra à la Première Personne / Caméra Arcball
D Translation horizontale vers la droite - Esquiver à droite
E Roulis à droite (sens des aiguilles d'une montre)
F Executer l'édition (outil d'édition 'Édit Tool' ouvert, onglet 'Shapes' a le focus)
P Pauser le jeu
Q Translation horizontale vers la gauche - Esquiver à gauche
S Translation horizontale vers l'arrière - Reculer
Z Translation horizontale vers l'avant - Avancer
Alt + Entrée Alterner entre plein écran et fenêtré
Alt + ↓ Caméra sauvegardée 'Saved Camera': Ajouter
Alt + ← Caméra sauvegardée: Précédente
Alt + → Caméra sauvegardée: Suivante
Alt + A Activer / désactiver l'ancre 'Anchor'
Alt + C Camera - ouvrir la fenêtre / donner le focus / fermer
Alt + E 'Edit Tool' (outil d'edition) onglet 'Shapes' (formes) - ouvrir la fenêtre / donner le focus / fermer
Alt + G 'Edit Tool' (outil d'edition) onglet 'Procedural Generation' (génération procédurale) - ouvrir la fenêtre / donner le focus / fermer
Alt + L 'Light and Atmosphere' (lumière et atmosphère) - ouvrir la fenêtre / donner le focus / fermer
Alt + M 'Materials' (matériaux) - ouvrir la fenêtre / donner le focus / fermer
Alt + P 'Pick and Inspect Material' (outil d'inspection et de sélection des matériaux) - ouvrir la fenêtre / donner le focus / fermer
Alt + R 'Replace Material' (remplacer un matériau) - ouvrir la fenêtre / donner le focus / fermer
Alt + X Fermer toutes les fenêtres
Ctrl gauche Translation verticale vers le bas - Descendre
Ctrl + C (5*) Copier dans le monde 3D (outil d'édition 'Édit Tool' ouvert, onglet 'Shapes' a le focus)
Ctrl + M (5*)(6*) Afficher / masquer tous les éléments de l'interface utilisateur
Ctrl + N (5*) Créer un nouveau monde (vide)
Ctrl + O (5*) Ouvrir un fichier monde *.avwr existant
Ctrl + R (5*) Revenir à la dernière version sauvegardée ou importée
Ctrl + S (5*) Sauvegarder le monde dans un fichier *.avwr
Ctrl + V (5*) Coller dans le monde 3D (outil d'édition 'Édit Tool' ouvert, onglet 'Shapes' a le focus)
Ctrl + X (5*) Couper du monde 3D (outil d'édition 'Édit Tool' ouvert, onglet 'Shapes' a le focus)
Ctrl + Y (5*) Rétablir - Inverser la dernière annulation dans le monde 3D
Ctrl + Z (5*) Annuler la dernière édition dans le monde 3D
Esc Désenclencher le mode Mouvement, puis retourner au menu principal
Espace Translation verticale vers le haut - Sauter, Monter
F1 'Help' (aide) | Durant le jeu : alterner entre première et troisième personne
F10 Capture d'écran (4*)
Maj + Mouse wheel in / out Augmenter / diminuer la taille de la forme 'Shape' d'un voxel dans les 3 directions (outil d'édition 'Édit Tool' ouvert et a le focus)
Maj (gauche) Augmentation de la Vitesse - Sprint
Tab Alterne entre les modes Menu et Mouvement
Augmenter la taille de la forme 'Shape' d'un voxel dans les 3 directions (outil d'édition 'Édit Tool' ouvert et a le focus)
Diminuer la taille de la forme 'Shape' d'un voxel dans les 3 directions (outil d'édition 'Édit Tool' ouvert et a le focus)


🔗 Contrôles de la Souris

Contrôle Fonction
Souris (mode Menu) Déplacer le pointeur de la souris au-dessus de l'interface utilisateur.
Déplacer le curseur d'édition au-dessus de la zone 3D (si l'outil d'édition 'Edit Tool' ou de sélection 'Pick' ou de remplacement 'Replace' est ouvert et a le focus, et l'ancre 'Anchor' est désactivée)
Souris (mode Mouvement) (1*) Diriger le viseur de la caméra
Lacet et Tanguage
Clic gauche sur la zone 3D / sur un voxel Éxecuter l'édition (si l'outil d'édition 'Edit Tool' est ouvert et a le focus)
Sélectionner un voxel et rendre son Matériau courant (si l'outil de sélection 'Pick' ou de remplacement 'Replace' est ouvert et a le focus)
Molette (2*) Rapprocher / éloigner le curseur d'édition (si l'outil d'édition 'Edit Tool' est ouvert et a le focus, et l'ancre 'Anchor' est désactivée)
Maj + Molette Augmenter / diminuer la taille de la forme 'Shape' d'un voxel dans les 3 directions
Clic droit sur la zone 3D Ouvrir le menu contextuel
Clic droit de la souris et maintenir / relâcher Enclencher / désenclencher le mode Mouvement (entrée piégée)
Glisser et déposer un fichier dans Avoyd Ouvrir mondes et modèles, importer


Notes Contrôles et Raccourcis Clavier :
1* Inverser l'axe vertical Y de la souris et sa sensibilité dans Settings > Controls Invert Mouse Y et Mouse Sensitivity.
2* Vitesse de la molette de la souris réglable dans menu Settings > Controls Mouse Wheel Sensitivity.
3* Avec aligner la caméra sur les axes Align Camera to Axes activé : rotation de 180° de la caméra le long the l'axe choisi, et avec 'Automatic' activé rotation de 90°. Voir menu Tools > Camera.
4* Les captures d'écran sont enregistrées dans le dossier ..\Utilisateurs\nom_utilisateur\Documents\Avoyd\Screenshots; configuration du format des captures (jpeg, png etc.) dans menu Settings > System > Saved Images Properties.
5* Les raccourcis clavier utilisant le modificateur Ctrl sont désactivés en mode Mouvement afin de ne pas interférer avec la touche Ctrl de la caméra (Déplacement translation verticale vers le bas - descendre).
6* Utiliser "Ctrl + ," dans Avoyd 0.8.15 et versions précédentes.


Traduction initiale par Pilou moiscript.weebly.com



🔗 Définitions



Art Voxel
Art 3D (en trois dimensions) fait de voxels. Chaque voxel est habituellement représenté par un cube monochrome, avec parfois des variations de style: arrêtes visibles, angles arrondis etc. Les éditeurs de voxels sont communément utilisés pour construire les modèles et créer des rendus voxels.

Éditeur de Voxels
Logiciel d'art permettant de créér des formes / modèles 3D en voxels et faire des rendus, produire des contenus et décors pour jeux vidéo etc. Exemples de logiciels d'art voxel : notre application Avoyd, le logiciel libre Goxel, le populaire MagicaVoxel, Qubicle pour le développement de jeux vidéo, et bien d'autres.

Voxel
Représentation de données stockées dans une grille / matrice 3D dans l'espace. La forme la plus commune d'un voxel est un cube, mais il peut aussi être représenté, par exemple, par une brique de lego, une sphère, un matériau qui se déforme en fonction de son voisinage (pour des formes plus lisses) etc. Les voxels sont utilisés dans les jeux vidéo, l'imagerie médicale, l'art. Ils peuvent être monochromes ou les surfaces peuvent être remplacées par des images (textures).

Avoyd is a voxel editor and game developed and published by enkisoftware  •  ©enkisoftware 2001-2023