# 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

## É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 chacune Systè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

## É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 chacune Image de tuile Zone de 8×8 pixels de la banque d'images Banque 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

## É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–B4 Longueur maximale 48 notes Polyphonie 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
Q
Do#
2
Ré
W
Ré#
3
Mi
E
Fa
R
Fa#
5
Sol
T
Sol#
6
La
Y
La#
7
Si
U
Octave inférieure (rangée ZXC + ASD)
Do
Z
Do#
S
Ré
X
Ré#
D
Mi
C
Fa
V
Fa#
G
Sol
B
Sol#
H
La
N
La#
J
Si
M
Silence
A

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

## É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 4 Nombre 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.