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

Tutoriel d'introduction: comment éditer les voxels dans Avoyd
Documentation Utilisateur
Contrôles et Raccourcis Clavier
Définitions

🔗 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 :

Ouvrir l'éditeur: démarrer Avoyd et cliquer Voxel Editor dans le menu principal.
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
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).
Sélectionner l'outil de création Set dans la liste d'outil (colonne à gauche dans la fenêtre Edit Tool onglet Shapes).
Sélectionner Cube dans la liste des formes Shape.
Modifier les paramètres du cube:
- Régler la taille Size = 3 voxels.
- Régler la quantité Amount = 255.
Choisir un matériau jaune : ouvrir la Palette et cliquer sur un carré de couleur jaune pour le sélectionner.
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.
Cliquer le bouton gauche de la souris: un cube jaune composé de 3x3x3 voxels est créé. Cliquer à nouveau pour ajouter de nouveaux cubes.

🔗 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.

Sélectionner l'outil Paint (colonne de gauche) dans la fenêtre Edit Tool.
Sélectionner la forme Shape = Cube et régler sa taillle Size = 2 voxels.
Sélectionner un matériau bleu dans la palette.
Déplacer le pointeur avec la souris sur la zone 3D: un cube bleu 2x2x2 avec une grille verte apparaît.
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).
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.

🔗 3. Supprimer des voxels avec 'Delete'

Comment effacer des voxels :

Sélectionner Delete dans Edit Tool.
Régler la taille du cube Size = 2 voxels.
Déplacer le pointeur sur la zone 3D: une grille et un cube semi-transparent rouges de taille 2x2x2 apparaissent.
Déplacer le curseur jusqu`à ce qu'il chevauche des voxels ajoutés auparavant et cliquer : les voxels disparaissent.

🔗 4. Pour aller plus loin

Utiliser Set avec d'autres formes, par example une boîte de taille (size) 4 x 8 x 12 voxels.
Réduire la quantité Amount à moins de 255: les voxels sont plus petits et se déforment pour toucher leurs voisins.
Écrire son nom en voxels: choisir Set, une forme cube, cocher Continuous (continu) (laisser Collide (collision) décoché) et garder le bouton droit de la souris enfoncé pour dessiner une ligne continue avec.
Lire les bulles d'aide (en anglais) en explorant les fonctions de l'éditeur.
Télécharger nos fichiers "Avoyd world" (*.avwr) pour tester les fonctionalités d'Avoyd.
Regarder la vidéo "Avoyd Voxel Editor - Basics of Editing Voxel Scenes" sur Youtube (en anglais). L'interface a changé depuis mais les principes restent les mêmes.
Apprendre comment utiliser la caméra, modifier l'éclairage et l'atmosphère et faire un rendu (texte et vidéo en anglais).
Si vous avez des questions n'hésitez pas à contacter enkisoftware.

🔗 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).