How to Create DSi/3DS Themes

To make a TWiLight Menu++ theme, you will need an image editor capable of exporting .png files, 16 BPP .bmp files or .png files, and 4 BPP .bmp files. Idéalement, il devrait également être en mesure de réorganiser manuellement les palettes d’images. GIMP is recommended and will be used for this guide, as it’s capable of everything needed.

Partie 1 : Télécharger les exemples #

The first thing you should do is download the example themes. These can be used as a base for your theme and are already in the correct format, so if you have issues later on, you can compare with these.

Partie 2 : Modifier les images #

Download and install GIMP

• D’autres éditeurs d’images tels que Photoshop peuvent fonctionner, mais GIMP sera utilisé dans ce guide

Once installed, open GIMP and select Windows -> Dockable Dialogs -> Colormap. Cela ouvre la boîte de dialogue de la palette, qui sera utile lors de l’édition d’images palettisées.

Vous pouvez maintenant ouvrir l’image que vous voulez modifier dans GIMP et passer à la section ci-dessous en fonction du dossier dans lequel elle se trouve. Notez que TWiLight Menu++ est pointilleux sur le format exact des images et qu’il varie selon le dossier dans lequel elles se trouvent, assurez-vous donc d’exporter comme indiqué dans la section.

Background textures (background folder) #

These can be PNG files or 16-bit (A1 R5 G5 B5 or X1 R5 G5 B5) BMP files.

• Si vous utilisez des fichiers BMP, vous pouvez les régler sur 16 bits dans les options avancées lors de l’exportation. Vous devrez peut-être le faire à chaque fois que vous exporterez en BMP

Battery textures (battery folder) #

Il doit s’agir de fichiers PNG. La transparence est prise en charge, mais seule une transparence à 100 % fonctionnera.

Paletted textures (grf folder) #

These must be 4 BPP (16 color) BMP files.

To edit these in GIMP, select Image -> Mode -> RGB to allow changing colors, then when done changing colors, select Image -> Mode -> Indexed... to convert back to paletted. When switching to indexed, ensure that Generate optimum palette is checked and Maximum number of colors is set to 16.

Note: Some images in the DSi theme have their palettes overridden based on the user’s profile color. If editing the colors of these ensure that the UserPalette option for it in the theme.ini is set to 0.

Après avoir converti en indexé, allez dans le dialogue de la palette et assurez-vous que la couleur transparente (#FF00FF) est la couleur #0 dans la palette. If it isn’t, right click in the colormap and select Rearrange Colormap... then move the transparent color to be the first color in the colormap and select OK.

If there are fewer than 16 colors in your final colormap, press the + button at the bottom of the colormap dialog until you have 16 colors.

When exporting, it’s recommended to check the Do not write color space information box under the Compatibility Options dropdown.

DS Classic Menu textures (quickmenu folder) #

Il doit s’agir de fichiers PNG.

UI textures (ui folder) #

Il doit s’agir de fichiers PNG. La transparence est prise en charge, mais seule une transparence à 100 % fonctionnera. Tout pixel transparent dans une texture doit l’être dans toutes les autres, afin qu’il soit correctement écrasé lors d’un changement.

Video texture (video folder) #

Only used for the 3DS theme, 3dsRotatingCubes.rvid is a Rocket Video file. For more information on converting videos to rvid, read Converting a video to .rvid on the Vid2RVID wiki. Si vous ne voulez pas qu’il soit affiché, vous pouvez simplement le supprimer.

Volume textures (volume folder) #

Les textures de volume ne sont affichées qu’en mode DSi.

Il doit s’agir de fichiers PNG. La transparence est prise en charge, mais seule une transparence à 100 % fonctionnera.

Theme configuration (theme.ini file) #

You may configure various options on how the theme is drawn in the theme.ini to accommodate larger graphics or different layouts. For true/false options, 0 is false, and 1 is true. Les options dont la valeur par défaut est vide pour un thème sont inutilisées dans ce thème.

Options du mode Macro #

You may add specific override options to theme.ini for use in Macro Mode. To do this, add [MACRO] to a blank line at the bottom of the configuration file, then add any specified configurations below it.

Musique de fond et effets sonores personnalisés #

The DSi and 3DS UIs also support custom music. See DSi/3DS Themes - Custom SFX for more details.

Polices personnalisées #

You may put Custom Fonts in the font folder for use in the theme. You can also add override fonts for the date & time using date_time.nftr, and the console username with username.nftr.

Palettes personnalisées #

For the paletted textures (grf folder), you can optionally add override palette sets which are used when the corresponding UserPalette setting is enabled. Palette set files can be created using this editor. Lorsque vous utilisez l’éditeur, importez l’image avec laquelle vous souhaitez travailler, puis créez une palette pour chacune des 16 couleurs du profil DS. You can use this example palette file as a starting point.

Les 16 lignes de la collection de palettes correspondent à chaque couleur du profil et doivent être placées dans l’ordre suivant :

1. Gris-Bleu
2. Marron
3. Rouge
4. Rose
5. Orange
6. Jaune
7. Vert citron
8. Vert
9. Vert foncé
10. Turquoise
11. Cyan/Bleu clair
12. Bleu
13. Bleu foncé/Indigo
14. Violet/Pourpre foncé
15. Violet
16. Magenta

Once you’ve created a palette file, place it in the palettes folder. The name of the palette file should match the name of its image but with a .bin extension instead (ex. start_border.bin will be applied to start_border.bmp).

You may also put a username.bin palette file to change the palettes of the username font. Make sure to set the palette editor to Font Mode when creating this file.

Partie 3 : Ajout dans TWiLight Menu++ #

Once you’ve edited some graphics and would like to test your theme, simply copy your theme folder (the folder containing the background, battery, etc folders) to sd:/_nds/TWiLightMenu/3dsmenu/themes/ or sd:/_nds/TWiLightMenu/dsimenu/themes/ for 3DS and DSi theme themes respectively.

Part 4: Sharing your theme #

Once you’ve completed your theme, you can share it with the community by creating a Pull Request adding it to the DS-Homebrew/twlmenu-extras GitHub repository in a .7z file. If you’re unfamiliar with using git you can also simply create an issue on that repository with a zip file of your theme requesting it be added.