Manuel de Pyxel Editor

Manuel de l'éditeur de ressources de Pyxel.

Présentation

Pyxel Editor est l'outil d'édition de ressources intégré à Pyxel. Il se compose de 4 éditeurs, accessibles via les boutons d'éditeur en haut de l'écran.

Éditeur d'images

Éditer les images (banques d'images) utilisées pour les sprites et les tuiles

Éditeur de tilemap

Composer des maps en disposant les images de la banque comme tuiles

Éditeur de sons

Éditer les sons utilisés pour les effets sonores et les mélodies

Éditeur de musique

Composer des pistes musicales (BGM, etc.) en ordonnant les sons

Lancement

Pyxel Editor se lance avec la commande suivante :

pyxel edit [PYXEL_RESOURCE_FILE]

Si le fichier de ressources Pyxel (.pyxres) spécifié existe, il sera chargé. Sinon, un nouveau fichier sera créé avec le nom indiqué. Si aucun nom de fichier n'est spécifié, my_resource.pyxres sera créé.

Opérations communes

Opérations communes à tous les éditeurs.

Barre de menus

La barre de menus en haut de l'écran contient les 4 boutons de changement d'éditeur, les boutons Undo/Redo et le bouton de sauvegarde. La zone de message d'aide à droite affiche des informations contextuelles selon la position du curseur de la souris ou du curseur d'édition.

	Raccourci	Action
	—	Basculer vers l'éditeur d'images
	—	Basculer vers l'éditeur de tilemap
	—	Basculer vers l'éditeur de sons
	—	Basculer vers l'éditeur de musique
	Ctrl(Cmd)+Z	Annuler (Undo)
	Ctrl(Cmd)+Y	Rétablir (Redo)
	Ctrl(Cmd)+S	Sauvegarder

Autres raccourcis

Raccourci	Action
Alt(Option)+Left/Right	Changer de type d'éditeur
Shift+Ctrl(Cmd)+C	Copier l'intégralité de l'objet en cours d'édition
Shift+Ctrl(Cmd)+X	Couper l'intégralité de l'objet en cours d'édition (copier et effacer)
Shift+Ctrl(Cmd)+V	Coller l'objet copié
Shift+Click ([+]/[-] buttons)	Modifier la valeur ou le numéro par pas de ±10

Utilisation depuis un programme

Le fichier de ressources créé peut être chargé dans une application Pyxel avec la fonction pyxel.load().

Changer le fichier de ressources en cours d'édition

Glissez-déposez un autre fichier .pyxres dans la fenêtre de l'éditeur pour charger son contenu. Cette opération écrase toutes les modifications en cours. Attention aux changements non sauvegardés.

Éditeur d'images

Mode d'édition des images de chaque banque d'images. Permet de créer des images pour sprites et tuiles pixel par pixel.

Spécifications

Nombre de banques d'images 0–2 (3 banques)Taille 256×256 pixels chacuneSystème de coordonnées (0,0) en haut à gauche, X+ vers la droite, Y+ vers le bas

Disposition de l'écran

Canevas d'image

La zone d'édition sélectionnée dans la vue de la banque d'images est affichée en zoom. Cliquez ou glissez avec la souris pour dessiner.

Raccourci	Action
Right Click	Prélever la couleur à la position du curseur (pipette)
Right Drag	Déplacer la vue (panoramique)

Vue de la banque d'images

Vue réduite de la banque d'images complète. Le cadre blanc indique la zone d'édition actuelle.

Raccourci	Action
Arrow Keys	Déplacer la zone d'édition (cadre blanc)
Click	Déplacer la zone d'édition à la position du clic
Right Drag	Déplacer la vue (panoramique)

Boutons d'outils

Sélectionne l'outil de dessin à utiliser.

	Raccourci	Action
	S	Sélectionner une zone rectangulaire
	P	Dessiner à main levée. Maintenir Shift pour tracer une ligne droite
	R	Dessiner le contour d'un rectangle. Maintenir Shift pour un carré
	Shift+R	Dessiner un rectangle plein. Maintenir Shift pour un carré
	C	Dessiner le contour d'une ellipse. Maintenir Shift pour un cercle
	Shift+C	Dessiner une ellipse pleine. Maintenir Shift pour un cercle
	B	Remplir la zone contiguë de même couleur

Raccourcis en mode sélection

Les raccourcis suivants sont disponibles lors de l'utilisation de l'outil de sélection.

Raccourci	Action
Ctrl(Cmd)+A	Sélectionner tout le canevas
Ctrl(Cmd)+C	Copier la sélection
Ctrl(Cmd)+X	Couper la sélection (copier et effacer)
Ctrl(Cmd)+V	Coller la sélection copiée
H	Retourner la sélection horizontalement
V	Retourner la sélection verticalement

Palette de couleurs

Sélectionne la couleur de dessin parmi la palette de 16 couleurs.

Raccourci	Action
1–8	Sélectionner les couleurs 0~7
Shift+1–8	Sélectionner les couleurs 8~15

Numéro de banque

Change la banque d'images à éditer (0~2).

Chargement de fichiers externes

Glissez-déposez un fichier image (PNG, JPG, etc.) dans l'éditeur d'images pour charger l'image à la position de la zone d'édition. Les couleurs sont automatiquement converties vers la palette Pyxel, et les parties dépassant la banque d'images sont tronquées.

Éditeur de tilemap

Mode d'édition des tilemaps en plaçant les images de la banque d'images comme motifs de tuiles.

Spécifications

Nombre de tilemaps 0–7 (8 cartes)Taille 256×256 tuiles chacuneImage de tuile Zone de 8×8 pixels de la banque d'imagesBanque d'images de référence Une par tilemap

Disposition de l'écran

Canevas de tilemap

La zone d'édition sélectionnée dans la vue de la tilemap est affichée en zoom. Placez les tuiles sélectionnées dans la vue des tuiles. Les raccourcis des outils de dessin et de sélection sont les mêmes que dans l'éditeur d'images. La valeur initiale de toutes les cellules étant la tuile (0,0), il est recommandé de laisser la position (0,0) de la banque d'images vide.

Raccourci	Action
Right Click	Prélever la tuile à la position du curseur (pipette de tuile)
Right Drag	Déplacer la vue (panoramique)

Vue de la tilemap

Vue réduite de la tilemap complète. Le cadre blanc indique la zone d'édition actuelle.

Raccourci	Action
Arrow Keys	Déplacer la zone d'édition (cadre blanc)
Click/Drag	Déplacer la zone d'édition à la position du clic

Vue des tuiles

Affichage de la banque d'images de référence. Sélectionnez la tuile à placer avec le cadre blanc.

Raccourci	Action
Shift+Arrow Keys	Déplacer la sélection
Drag	Sélectionner plusieurs tuiles (sélection rectangulaire)
Right Drag	Déplacer la vue (panoramique)

Numéro de tilemap

Change la tilemap à éditer (0~7).

Numéro de banque de référence

Change la banque d'images de référence pour les tuiles (0~2).

Boutons d'outils

Sélectionne l'outil de dessin à utiliser.

	Raccourci	Action
	S	Sélectionner une zone rectangulaire
	P	Dessiner à main levée. Maintenir Shift pour tracer une ligne droite
	R	Dessiner le contour d'un rectangle. Maintenir Shift pour un carré
	Shift+R	Dessiner un rectangle plein. Maintenir Shift pour un carré
	C	Dessiner le contour d'une ellipse. Maintenir Shift pour un cercle
	Shift+C	Dessiner une ellipse pleine. Maintenir Shift pour un cercle
	B	Remplir la zone contiguë de même couleur

Placement de tuiles multiples

Sélectionnez plusieurs tuiles par glisser dans la vue des tuiles, puis dessinez pour placer les tuiles en motif répétitif. Par exemple, en sélectionnant 2 tuiles verticalement et en dessinant avec le stylo, les 2 tuiles alternent de façon répétée. La sélection de tuiles en largeur et hauteur fonctionne de la même manière. La position de début du dessin correspond au coin supérieur gauche de la sélection.

Chargement de fichiers TMX

Glissez-déposez un fichier TMX créé avec Tiled Map Editor (Tiled) dans l'éditeur de tilemap pour charger le contenu du calque 0 à la position de la zone d'édition.

Éditeur de sons

Mode d'édition des sons utilisés pour les mélodies et les effets sonores.

Spécifications

Nombre de sons 0–63 (64 sons)Tessiture C0–B4Longueur maximale 48 notesPolyphonie 1 note (ou silence)Réglages par note Timbre, volume, effet

Disposition de l'écran

Numéro de son

Change le son à éditer (0~63).

Vitesse de lecture

Définit la durée de lecture par note. Ce réglage est commun à toutes les notes, de 1 à 99. Plus la valeur est faible, plus la lecture est rapide (1 unité = 1/120 s ; ex. : speed 60 = 0,5 s par note). Valeur recommandée : 1~9 pour les effets sonores, 10+ pour les mélodies.

Lecture / Arrêt / Boucle

	Raccourci	Action
	Space	Lire
	Space	Arrêter (Space pendant la lecture pour arrêter)
	L	Activer/désactiver la lecture en boucle

Piano roll

Saisissez les notes en cliquant. Les carrés rouges représentent les notes, les carrés bleus les silences. En mode piano roll, un curseur bleu s'affiche ; en mode propriétés, le curseur change de forme. Les notes sont lues de gauche à droite ; les espaces vides deviennent automatiquement des silences. Cliquer sur une position existante écrase la note. Le glisser permet de saisir des notes par interpolation linéaire.

Raccourci	Action
Up/Down	Basculer entre le piano roll et la zone de propriétés
Left/Right	Déplacer le curseur
Delete(fn+delete)	Supprimer la note à la position actuelle
Backspace(delete)	Supprimer la note précédant la position actuelle
Shift+Space	Lire à partir de la position du curseur
Ctrl(Cmd)+A	Tout sélectionner
Shift+Left/Right	Commencer la sélection de plage

Sélection de plage

Raccourci	Action
Ctrl(Cmd)+C	Copier la sélection
Ctrl(Cmd)+X	Couper la sélection (copier et effacer)
Ctrl(Cmd)+V	Coller la sélection copiée
Ctrl(Cmd)+U	Augmenter la hauteur de la sélection de 1
Ctrl(Cmd)+D	Diminuer la hauteur de la sélection de 1

Barre d'octave

Affiche l'octave de départ (0~3) pour la saisie au clavier. Le clavier couvre 2 octaves à partir de l'octave sélectionnée.

Raccourci	Action
PageUp(fn+Up)	Monter d'un octave
PageDown(fn+Down)	Descendre d'un octave

Saisie au clavier

Les notes peuvent être saisies via le clavier PC. Les rangées supérieures (QWE + chiffres) et inférieures (ZXC + ASD) correspondent chacune à un octave de piano, couvrant 2 octaves simultanément. Les touches blanches correspondent aux notes naturelles, les touches grises aux dièses. La barre d'octave permet de sélectionner l'octave de départ (0~3).

Octave supérieure (rangée QWE + chiffres)

Do#

Ré

Ré#

Fa#

Sol

Sol#

La#

Octave inférieure (rangée ZXC + ASD)

Do#

Ré

Ré#

Fa#

Sol

Sol#

La#

Silence

Raccourci	Action
Keyboard Key → Enter	Saisir la note de la touche pressée dans le piano roll
1	Changer le timbre de prévisualisation (rotation parmi 4 timbres)

Zone de propriétés (TON / VOL / EFX)

Définit le timbre (TON), le volume (VOL) et l'effet (EFX) pour chaque note. Appuyez sur la touche ↓ ou cliquez sur la ligne TON pendant l'édition du piano roll pour accéder à la zone de propriétés. Les déplacements du curseur, la sélection, le copier-coller fonctionnent comme dans le piano roll. Appuyez sur une touche dans chaque ligne pour saisir la valeur correspondante (ex. : P sur la ligne TON définit Pulse). Pour changer le timbre en cours de séquence, définissez la valeur pour toutes les notes à partir de la position souhaitée. Idem pour VOL et EFX.

Tone (timbre)

Lorsque le curseur est sur la ligne TON, appuyez sur les touches suivantes pour définir le timbre. La valeur par défaut est T (Triangle).

T Triangle Onde triangulaire. Son doux et délicat, proche de la flûte

S Square Onde carrée. Son électronique et net, proche de la clarinette ou de l'orgue

P Pulse Onde Pulse. Son brillant et éclatant, proche de la trompette

N Noise Bruit. Son sans hauteur définie. Pour percussions et effets sonores (explosions, etc.)

Volume

Lorsque le curseur est sur la ligne VOL, appuyez sur les touches 0~7 pour définir le volume (0 = silence, 7 = maximum). La valeur par défaut est 7. L'utilisation du volume maximum sur plusieurs canaux simultanément peut provoquer une saturation.

Effect (effet)

Lorsque le curseur est sur la ligne EFX, appuyez sur les touches suivantes pour définir l'effet. La valeur par défaut est N (None).

N None Aucun effet

S Slide Liaison progressive de la hauteur depuis la note précédente

V Vibrato Oscillation périodique du son

F FadeOut Diminution progressive du volume sur toute la durée. Aussi utilisé pour séparer des notes de même hauteur

H Half-FadeOut Diminution progressive du volume sur la seconde moitié. Durée de son plus longue que F

Q Quarter-FadeOut Diminution progressive du volume sur le dernier quart. Durée de son plus longue que H

Éditeur de musique

Mode de composition de pistes musicales en ordonnant les sons dans l'ordre de lecture.

Spécifications

Nombre de musiques 0–7 (8 morceaux)Nombre de canaux 4Nombre de sons par canal 32 maximum

Disposition de l'écran

Numéro de musique

Change la musique à éditer (0~7).

Lecture / Arrêt / Boucle

	Raccourci	Action
	Space	Lire
	Space	Arrêter (Space pendant la lecture pour arrêter)
	L	Activer/désactiver la lecture en boucle

Éditeur de séquence (CH0~CH3)

Place les numéros de sons dans l'ordre de lecture sur 4 canaux (CH0~CH3). Le copier-coller entre canaux est possible.

Raccourci	Action
Up/Down	Changer de canal d'édition
Left/Right	Déplacer le curseur d'édition
Delete(fn+delete)	Supprimer le son à la position actuelle
Backspace(delete)	Supprimer le son précédant la position actuelle
Shift+Space	Lire à partir de la position du curseur
Ctrl(Cmd)+A	Sélectionner toute la plage du canal en cours d'édition
Shift+Arrow Keys	Sélectionner une plage du canal
Ctrl(Cmd)+C	Copier la sélection
Ctrl(Cmd)+X	Couper la sélection (copier et effacer)
Ctrl(Cmd)+V	Coller la sélection (possible entre canaux)
Ctrl(Cmd)+U	Augmenter le numéro de son de la sélection de 1
Ctrl(Cmd)+D	Diminuer le numéro de son de la sélection de 1

Boutons de sons (0~63)

Boutons d'insertion de numéros de sons (0~63). Appuyez pour insérer un numéro de son à la position du curseur. Les sons créés sont affichés en bleu, les non créés en gris. Survolez un bouton pour pré-écouter le son.