wiki/pages/_it-IT/twilightmenu/custom-dsi-3ds-sfx.md

lang	layout	section	category	title	description
it-IT	wiki	twilightmenu	customization	DSi/3DS Skins - Custom SFX	Come utilizzare musica di sottofondo ed effetti sonori personalizzati nelle skin DSi e 3DS per TWiLight Menu++

TWiLight Menu++ supports custom sound files in themes. Place your sound files under the sound subdirectory in your theme folder, for example for the white theme, you would place the files at themes/white/sound/sfx.bin and themes/white/sound/bgm.pcm.raw respectively. Both files are optional, if bmg.pcm.raw is missing, the default music will be used. The same thing would happen with the sound effects if sfx.bin is missing as well.

Queste istruzioni presuppongono che tu abbia devkitPro installato con mmutil. Puoi scaricare devkitPro sul sito ufficiale devkitPro website.

Raccolta di Effetti Sonori

The sound effect bank (sfx.bin) contains sound effects such as the icon select sound, etc.

File	Descrizione
startup.wav	Riprodotto all'avvio. Vedi la sezione suono di avvio per maggiori dettagli
back.wav	Indietro
launch.wav	Riprodotto quando si avvia una partita
select.wav	Played when moving the cursor in the per-game settings and select menu
wrong.wav	Riprodotto quando si raggiunge la fine della pagina
switch.wav	Riprodotto quando si cambia pagina
stop.wav	Riprodotto sul tema DSi quando il cursore smette di muoversi

All the files listed above are required to build a custom sound effect bank. If you want a sound to be mute, you can use a silent audio file. The .wav format is mandatory and the encoding must be PCM.

To build the sound effect bank you need to download this file and put it next to all the .wav files that will be used. After all the files are on the same folder, open your terminal (or command line if you are using Windows), change the current directory (cd) to the folder where Makefile is, and then run the make command.

You will get a resulting sfx.bin file that can be copied to the sound subfolder in your theme folder. This file must be under 512000B = 512 kB. Any file larger than that will result in either crashes or some sounds not playing fully.

Suono d'avvio

While the other sound effects will work with any WAV file with PCM encoding, the startup sound must be in a specific format in order to work properly, otherwise there will be a gap between when the startup sound stops and the background music begins.

The startup.wav file must be 16-bit 16 kHz. You can use Audacity for example to convert to this format. Once the file is loaded in Audacity, change the Project Rate (Hz) to 16000, then press Shift+M, and change the Format to 16-bit PCM.

If your file is in Stereo, you should also go to Tracks > Mix > Mix Stereo down to Mono.

You must set PlayStartupJingle=1 in your theme.ini for the startup jingle to play.

Menu BGM

Menu BGM needs to be a 16-bit 16 kHz Mono raw PCM file. Below are two methods for converting audio files into that format.

Unlike sfx.bin, bgm.pcm.raw can be arbitrarily large.

ffmpeg

The simplest way to convert music for use in TWiLight Menu++ is to run this ffmpeg command in a terminal:

ffmpeg -i [input file] -f s16le -acodec pcm_s16le -ac 1 -ar 16k bgm.pcm.raw

Replace [input file] with the name of the file you want to convert. You can usually do this by simply dragging the file onto the terminal window with the cursor in the correct location.

Audacity

If you don't want to use the command line you can also convert using Audacity.

To convert the audio:

1. Load the file in Audacity
2. If your file is in stereo, click on the song then select Tracks > Mix > Mix Stereo down to Mono
3. Change the Project Rate (Hz) in the bottom left to 16000

To export in the correct format:

1. Select File > Export > Export Audio...
2. Set File Type to Other uncompressed files
3. Set Header to RAW (header-less)
4. Set Encoding to Signed 16-bit PCM
5. Set the output name to bgm.pcm.raw and click Save
6. Click OK to the metadata editing

Now you have a bgm.pcm.raw file that can be copied to the sound subfolder in your theme folder.

You should then set the DSi/3DS Theme Music option in TWiLight Menu++ settings to "Theme" for your custom BGM to play on the menu.