rvtr/wiki
1
Fork 0
mirror of https://github.com/rvtr/wiki.git synced 2025-10-31 06:31:13 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity
ds-index-revamp
wiki/pages/_zh-CN/twilightmenu/custom-dsi-3ds-skins.md
lifehackerhansol 64d2ab3c9e
treewide: Update translations 2024-01-17
2024-01-17 11:21:30 -08:00

303 lines
35 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
lang: zh-CN
layout: wiki
section: twilightmenu
category: customization
title: 如何创建DSi/3DS皮肤
description: 如何为TWiLight Menu++ 制作自定义DSi 和 3DS 皮肤
---
To make a TWiLight Menu++ skin, you will need an image editor capable of exporting `.png` files, 16 <abbr title="Bits Per Pixel">BPP</abbr> `.bmp` files or `.png` files, and 4 BPP `.bmp` files. Ideally, it should also be able to manually rearrange image palettes. [GIMP](https://www.gimp.org) is recommended and will be used for this guide, as it's capable of everything needed.
## 第一部分：下载示例
你应该做的第一件事是下载 [示例皮肤](/assets/files/skin-examples.zip)。 These can be used as a base for your skin and are already in the correct format, so if you have issues later on, you can compare with these.
## 第2部分：编辑图像
Download and install [GIMP](https://www.gimp.org)
- Other image editors such as Photoshop may work, but GIMP is what will be used in this guide
安装后，打开GIMP，选择 `Windows` -> `Dockable Dialogs` -> `Colormap`。 这将打开颜色映射对话框，这在编辑调色板图像时很有帮助。
现在你可以在GIMP中打开你想编辑的任何一张图片，然后根据它所在的文件夹继续进入下面的章节。 请注意，TWiLight Menu++对图片的确切格式很挑剔，它因图片在哪个文件夹中而不同，所以要确保按照该部分的规定导出。
### 背景纹理 (`背景` 文件夹)
这些可以是PNG文件或16位(`A1 R5 G5 B5` 或 `X1 R5 G5 B5`) BMP文件。
- If using BMP files, you can set them to 16-bit under Advanced Options while exporting. You may need to do this each time you export as BMP
| 纹理 | 描述 |
| --------------------- | ------------------------------------------------------------------------------------------------------ |
| top | The top screen background texture |
| top_photo | The top screen background texture when a photo is being shown |
| bottom | The bottom background texture when not hovering over an icon |
| bottom_ds | For the 3DS theme, the bottom background texture when not hovering over an icon when on a DS Phat/Lite |
| bottom_macro | For the DSi theme, the background texture when not hovering over an icon while using Macro Mode |
| bottom_bubble | The bottom background texture when hovering over an icon |
| bottom_bubble_ds | For the 3DS theme, the bottom background texture when hovering over an icon when on a DS Phat/Lite |
| bottom_bubble_macro | For the DSi theme, the background texture when hovering over an icon while using Macro Mode |
| bottom_moving | For the DSi theme, the bottom background texture when moving an icon |
| bottom_moving_macro | For the DSi theme, the background texture when moving an icon while using Maco Mode |
### 电池纹理 (`电池` 文件夹)
These must be PNG files. Transparency is supported, however only 100% transparency will work.
| 纹理 | Description/Notes |
| ------------------ | ------------------------------------- |
| battery0 | 电池电量极低时闪烁 `电池1` |
| battery1 | 0-4在DSi模式下使用 |
| battery1purple | 当 `电源LED颜色` ，在设置中被设置为 `紫色` ，就会使用紫色图标。 |
| battery2 | |
| battery2purple | |
| battery3 | |
| battery3purple | |
| battery4 | |
| battery4purple | |
| batterycharge | |
| batterychargeblink | 充电时闪烁， `电池电量` |
| batteryfull | 在DSi/3DS的DS模式下使用。 |
| batteryfullDS | 在DS Phat/DS Lite上使用 |
| batterylow | 在DS模式时使用 |
### 调色板纹理(`grf` 文件夹)
这些必须是4个BPP（16色）BMP文件的文件。
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. 当切换到索引时，确保勾选 `生成最佳调色板` ，并将 `最大颜色数` 设置为 `16`。
**注意：** DSi主题中的一些图片的调色板是根据用户的个人资料颜色来覆盖的。 如果要编辑这些颜色，请确保 `UserPalette` 在 `theme.ini` 中为其设置的选项是 `0`。
在转换为索引后，进入颜色映射对话框，确保透明色（#FF00FF）是颜色映射中的#0。 如果不是，在颜色图中点击右键，选择 `重新排列颜色图...` ，然后将透明色移动到颜色图中的第一个颜色，并选择 `确定`。
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.
| 纹理 | 描述 |
| ------------- | ----------------------------------------------------------------------------------------------- |
| bips | 显示在滚动条底部的提示音（DSi主题）。 |
| box | The box texture, containing both full and empty textures (DSi Theme) |
| box_empty | The texture displayed for an empty box (3DS Theme) |
| box_full | The texture displayed for a box with an icon (3DS Theme) |
| brace | The brace texture shown past the first and last icon (DSi Theme) |
| bubble | The bottom bit of the bubble that draws over the start border or icon box |
| button_arrow | The textures for the arrows on either side of bottom scrollbar (DSi Theme) |
| cornerbutton | The buttons that are displayed on the SELECT menu (DSi Theme) (The name is based on an old use) |
| cursor | The border with animation frames that indicate the selected icon (3DS Theme) |
| dialogbox | The background of the dialog box that slides down |
| folder | The icon for folders |
| icon_a26 | The icon for Atari 2600 games |
| icon_col | The icon for Colecovision games |
| icon_gb | The icon for Game Boy games |
| icon_gba | The icon for GBA games |
| icon_gbamode | The icon for native GBA Mode |
| icon_gg | The icon for Game Gear games |
| icon_img | The icon for BMP, GIF, and PNG images |
| icon_int | The icon for Intellivision games |
| icon_m5 | The icon for Sord M5 games |
| icon_manual | The icon for the manual |
| icon_md | The icon for Mega Drive games |
| icon_nes | The icon for NES games |
| icon_ngp | The icon for Neo Geo Pocket games |
| icon_pce | The icon for PC Engine/TurboGrafx-16 games |
| icon_plg | The icon for DSTWO plugins |
| icon_settings | The icon for Nintendo DSi Settings |
| icon_sg | The icon for Sega SG-1000 games |
| icon_sms | The icon for Sega Master System games |
| icon_snes | The icon for SNES games |
| icon_unk | The icon displayed when a game is missing an icon |
| icon_ws | The icon for WonderSwan games |
| launch_dot | The dots displayed when a game is launched (DSi Theme) |
| moving_arrow | The arrow displayed when a game is being moved (DSi Theme) |
| progress | The progress loading animation with 8 frames |
| scroll_window | The part of the scrollbar that indicates the icons that are in view |
| small_cart | The icons displayed along the top (3DS Theme) and in the SELECT menu (DSi Theme) |
| start_border | The border with animation frames that indicates the selected icon (DSi Theme) |
| start_text | The text displayed on the start border (DSi Theme) |
| wirelessicons | The icons displayed to indicate a game has wireless support |
### DS Classic Menu textures (`quickmenu` folder)
These must be PNG files.
| 纹理 | 描述 |
| ---------- | --------------------------------------------------- |
| bottombg | Background for the bottom screen |
| phat_topbg | Background for the top screen on DS Phat |
| topbg | Background for the top screen on any other DS model |
### UI textures (`ui` folder)
These must be PNG files. Transparency is supported, however only 100% transparency will work. Any pixel that is transparent in one texture should be transparent in all of them, so that it's properly overwritten on change.
| 纹理 | 描述 |
| ------------------------ | ---------------------------------------------------------------- |
| Lshoulder | The left shoulder |
| Lshoulder_greyed | The left shoulder when there are no pages to the left |
| Lshoulder_photo | The left shoulder when there is a photo being shown |
| Lshoulder_photo_greyed | The left shoulder with no pages to the left and a photo showing |
| Rshoulder | The right shoulder |
| Rshoulder_greyed | The right shoulder when there are no pages to the right |
| Rshoulder_photo | The right shoulder when there is a photo being shown |
| Rshoulder_photo_greyed | The right shoulder with no pages to the left and a photo showing |
### 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](https://github.com/RocketRobz/Vid2RVID/wiki/Converting-a-video-to-.rvid) on the Vid2RVID wiki. If you don't want this to be drawn you can simply delete it.
### Volume textures (`volume` folder)
Volume textures are only displayed in DSi Mode.
These must be PNG files. Transparency is supported, however only 100% transparency will work.
| 纹理 | Description/Notes |
| ------- | ---------------------------- |
| volume0 | 0 is muted, 4 is full volume |
| volume1 | |
| volume2 | |
| volume3 | |
| volume4 | |
## 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. Options with a blank default value for a theme are unused in that theme.
| Value | Description/Notes | Default (3DS) | Default (DSi) |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------------- |
| `StartBorderRenderY` | The initial Y position of the Start Border | 92 | 81 |
| `StartBorderSpriteW` | The width of the start border sprite. Note that the start border texture is exactly half of the full border | 32 | 32 |
| `StartBorderSpriteH` | The height of the start border sprite | 64 | 80 |
| `StartTextRenderY` | The initial Y position of the Start text | 143 | 143 |
| `BubbleTipRenderX` | The X position of the tip of the bubble that is drawn over the start border | 125 | 122 |
| `BubbleTipRenderY` | The Y position of the tip of the bubble that is drawn over the start border | 98 | 80 |
| `BubbleTipSpriteW` | The width of the bubble tip sprite | 7 | 11 |
| `BubbleTipSpriteH` | The height of the bubble tip sprite | 7 | 8 |
| `TitleboxRenderY` | The initial Y position of the title text box | 96 | 85 |
| `TitleboxTextY` | The initial Y position of the title text | 55 | 30 |
| `TitleboxTextW` | The maximum width of the title text | 200 | 240 |
| `TitleboxTextLarge` | Whether to use the large font for the title text | 0 | 1 |
| `TitleboxMaxLines` | The maximum lines of text to show of the title | 3 | 4 |
| `VolumeRenderX` | The X position on the top screen to draw the volume icon | 4 | 4 |
| `VolumeRenderY` | The Y position on the top screen to draw the volume icon | 5 | 5 |
| `ShoulderLRenderX` | The X position on the top screen to draw the left shoulder | 0 | 0 |
| `ShoulderLRenderY` | The Y position on the top screen to draw the left shoulder | 172 | 172 |
| `ShoulderRRenderX` | The X position on the top screen to draw the right shoulder | 178 | 178 |
| `ShoulderRRenderY` | The Y position on the top screen to draw the right shoulder | 172 | 172 |
| `BatteryRenderX` | The X position on the top screen to draw the battery icon | 235 | 235 |
| `BatteryRenderY` | The Y position on the top screen to draw the battery icon | 5 | 5 |
| `UsernameRenderX` | The X position on the top screen to draw the username text | 28 | 28 |
| `UsernameRenderY` | The Y position on the top screen to draw the username text | 15 | 15 |
| `UsernameRenderXDS` | The X position on the top screen to draw the username text, when on a DS Phat/Lite | 4 | 4 |
| `DateRenderX` | The X postion on the top screen to draw the date text | 162 | 162 |
| `DateRenderY` | The Y postion on the top screen to draw the date text | 7 | 7 |
| `TimeRenderX` | The X positon on the top screen to draw the time text | 200 | 200 |
| `TimeRenderY` | The Y positon on the top screen to draw the time text | 7 | 7 |
| `PurpleBatteryAvailable` | Whether or not to use the purple battery icons when `Power LED color` is set to `Purple` in settings | 1 | 1 |
| `FontPalette1` | The transparent color of the font, unused for default fonts | 0x0000 | 0x0000 |
| `FontPalette2` | The colors of the font, use [this site](http://www.conradshome.com/html2bgr15/) to convert | 0xDEF7 | 0xDEF7 |
| `FontPalette3` | | 0xC631 | 0xC631 |
| `FontPalette4` | | 0xA108 | 0xA108 |
| `FontPaletteDateTime1` | The override transparent color of the font for the date and time | 0x0000 | 0x0000 |
| `FontPaletteDateTime2` | The override color of the font for the date and time | 0xDEF7 | 0xA529 |
| `FontPaletteDateTime3` | | 0xC631 | 0xBDEF |
| `FontPaletteDateTime4` | | 0xA108 | 0xD6B5 |
| `FontPaletteTitlebox1` | The override transparent color of the font for the ROM title box | 0x0000 | 0x0000 |
| `FontPaletteTitlebox2` | The override color of the font for the ROM title box | 0xDEF7 | 0xDEF7 |
| `FontPaletteTitlebox3` | | 0xC631 | 0xC631 |
| `FontPaletteTitlebox4` | | 0xA108 | 0xA108 |
| `FontPaletteDialog1` | The override transparent color of the font for dialogs | 0x0000 | 0x0000 |
| `FontPaletteDialog2` | The override color of the font for dialogs | 0xDEF7 | 0xDEF7 |
| `FontPaletteDialog3` | | 0xC631 | 0xC631 |
| `FontPaletteDialog4` | | 0xA108 | 0xA108 |
| `FontPaletteOverlay1` | The override transparent color of the font for overlayed text | 0x0000 | 0x0000 |
| `FontPaletteOverlay2` | The override color of the font for overlayed text | 0xDEF7 | 0xDEF7 |
| `FontPaletteOverlay3` | | 0xC631 | 0xC631 |
| `FontPaletteOverlay4` | | 0xA108 | 0xA108 |
| `FontPaletteUsername1` | The override transparent color of the font for the username | 0x0000 | 0x0000 |
| `FontPaletteUsername2` | The override color of the font for the username | 0xDEF7 | 0xDEF7 |
| `FontPaletteUsername3` | | 0xC631 | 0xC631 |
| `FontPaletteUsername4` | | 0xA108 | 0xA108 |
| `BipsUserPalette` | Whether or not to use the DS Profile color for the palette of the bips on the scrollbar | | 0 |
| `BoxUserPalette` | Whether or not to use the DS Profile color for the palette of the boxes containing the game icons in the DSi Theme | | 0 |
| `BoxEmptyUserPalette` | Whether or not to use the DS Profile color for the palette of empty boxes in the 3DS Theme | 0 | |
| `BoxFullUserPalette` | Whether or not to use the DS Profile color for the palette of the boxes containing the game icons in the 3DS Theme | 0 | |
| `BraceUserPalette` | Whether or not to use the DS Profile color for the palette of the brace at the start and end of the game list | | 0 |
| `BubbleUserPalette` | Whether or not to use the DS Profile color for the palette of the tip of the title bubble | 0 | 0 |
| `ButtonArrowUserPalette` | Whether or not to use the DS Profile color for the palette of the arrow buttons on the bottom of the screen | | 1 |
| `CornerButtonUserPalette` | Whether or not to use the DS Profile color for the palette of the DSi Menu and Settings icons in the SELECT menu | | 0 |
| `CursorUserPalette` | Whether or not to use the DS Profile color for the palette of the cursor | 0 | |
| `DialogBoxUserPalette` | Whether or not to use the DS Profile color for the palette of the dialog box | 0 | 1 |
| `FolderUserPalette` | Whether or not to use the DS Profile color for the palette of folders | 0 | 0 |
| `LaunchDotsUserPalette` | Whether or not to use the DS Profile color for the palette of the launch dots | | 1 |
| `MovingArrowUserPalette` | Whether or not to use the DS Profile color for the palette of the arrow shown when moving icons | | 1 |
| `ProgressUserPalette` | Whether or not to use the DS Profile color for the palette of the loading progress spinner | 1 | 1 |
| `ScrollWindowUserPalette` | Whether or not to use the DS Profile color for the palette of the background to the scroll window on the scrollbar | | 0 |
| `SmallCartUserPalette` | Whether or not to use the DS Profile color for the palette of the cartridge icons | 0 | 0 |
| `StartBorderUserPalette` | Whether or not to use the DS Profile color for the palette of the start border | | 1 |
| `StartTextUserPalette` | Whether or not to use the DS Profile color for the palette of the start text | | 1 |
| `WirelessIconsUserPalette` | Whether or not to use the DS Profile color for the palette of the wireless icons | 0 | 0 |
| `IconA26UserPalette` | Whether or not to use the DS Profile color for the palette of the Atari 2600 icon | 0 | 0 |
| `IconCOLUserPalette` | Whether or not to use the DS Profile color for the palette of the ColecoVision icon | 0 | 0 |
| `IconGBUserPalette` | Whether or not to use the DS Profile color for the palette of the Game Boy icon | 0 | 0 |
| `IconGBAUserPalette` | Whether or not to use the DS Profile color for the palette of the Game Boy Advance icon | 0 | 0 |
| `IconGBAModeUserPalette` | Whether or not to use the DS Profile color for the palette of the native GBA Mode icon | 0 | 0 |
| `IconGGUserPalette` | Whether or not to use the DS Profile color for the palette of the Game Gear icon | 0 | 0 |
| `IconIMGUserPalette` | Whether or not to use the DS Profile color for the palette of the image icon | 0 | 0 |
| `IconINTUserPalette` | Whether or not to use the DS Profile color for the palette of the Intellivision icon | 0 | 0 |
| `IconM5UserPalette` | Whether or not to use the DS Profile color for the palette of the Sord M5 icon | 0 | 0 |
| `IconManualUserPalette` | Whether or not to use the DS Profile color for the palette of the manual icon | 0 | 0 |
| `IconMDUserPalette` | Whether or not to use the DS Profile color for the palette of the Genesis/Mega Drive icon | 0 | 0 |
| `IconNESUserPalette` | Whether or not to use the DS Profile color for the palette of the NES/Famicom icon | 0 | 0 |
| `IconNGPUserPalette` | Whether or not to use the DS Profile color for the palette of the Neo Geo Pocket icon | 0 | 0 |
| `IconPCEUserPalette` | Whether or not to use the DS Profile color for the palette of the PC Engine/TurboGrafx-16 icon | 0 | 0 |
| `IconPLGUserPalette` | Whether or not to use the DS Profile color for the palette of the DSTWO plugin icon | 0 | 0 |
| `IconSettingsUserPalette` | Whether or not to use the DS Profile color for the palette of the DSi Settings icon | 0 | 0 |
| `IconSGUserPalette` | Whether or not to use the DS Profile color for the palette of the SG-1000 icon | 0 | 0 |
| `IconSMSUserPalette` | Whether or not to use the DS Profile color for the palette of the Master System icon | 0 | 0 |
| `IconSNESUserPalette` | Whether or not to use the DS Profile color for the palette of the SNES icon | 0 | 0 |
| `IconUnknownUserPalette` | Whether or not to use the DS Profile color for the palette of the unknown (missing) icon | 0 | 0 |
| `IconWSUserPalette` | Whether or not to use the DS Profile color for the palette of the WonderSwan icon | 0 | 0 |
| `UsernameUserPalette` | Whether or not to use the DS Profile color for the palette of the username | 1 | 1 |
| `ProgressBarUserPalette` | Whether or not to use the DS Profile color as the color of the progress bar | 1 | 1 |
| `ProgressBarColor` | The color of the progress bar if `ProgressBarUserPalette` is disabled | 0x7C00 | 0x7C00 |
| `UseAlphaBlend` | Whether or not to blend the colors of the top screen text (the date/time and username) with the colors of the background | 1 | 1 |
| `DarkLoading` | Whether or not to fade to black instead of white during loading screens | 0 | 0 |
| `RenderPhoto` | Whether or not to draw a photo on the top screen | 0 | 1 |
| `RotatingCubesRenderY` | The Y position on the top screen to draw the rotating cubes | 78 | |
| `PlayStartupJingle` | Whether or not to use the startup sound before the main BGM. See the [custom SFX](custom-dsi-3ds-sfx) page for more information | 1 | 0 |
| `StartupJingleDelayAdjust` | The amount of samples early in the startup sound the BGM should start at | 0 | 0 |
### Macro Mode options
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.
## Custom background music and sound effects
The DSi and 3DS themes also support custom music. See [DSi/3DS skins - Custom SFX](custom-dsi-3ds-sfx) for more details.
## Custom fonts
You may put [Custom Fonts](custom-fonts) in the `font` folder for use in the skin. You can also add override fonts for the date & time using `date_time.nftr`, and the console username with `username.nftr`.
## Custom palettes
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](https://skinpaltool.dvdo.dev/). When using the editor, import the image you would like to work with, then create a palette for each of the 16 DS Profile colors. You can use this [example palette file](/assets/files/example-palette.bin) as a starting point.
The 16 rows of the palette collection correspond to each profile color and should be in the following order:
1. Gray-Blue
2. Brown
3. 红
4. 粉
5. Orange
6. 黄
7. Lime Green
8. 绿
9. Dark Green
10. Turquoise
11. Cyan/Light Blue
12. 蓝
13. Dark Blue/Indigo
14. Violet/Dark Purple
15. 紫
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.
## Part 3: Adding to TWiLight Menu++
Once you've edited some graphics and would like to test your skin, simply copy your skin 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 skins respectively.
## Part 4: Sharing your skin
Once you've completed your skin, you can share it with the community by creating a Pull Request adding it to the [DS-Homebrew/twlmenu-extras](https://github.com/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 skin requesting it be added.
Reference in New Issue View Git Blame Copy Permalink