Digital Sound Elements - Revision history

UniqueGeek: Redirect

2017-10-14T20:30:11Z

Redirect

← Older revision		Revision as of 20:30, 14 October 2017
Line 6:		Line 6:
	{{DISPLAYTITLE:Procyon Studios Digital Sound Elements}}		{{DISPLAYTITLE:Procyon Studios Digital Sound Elements}}

	~~== General Information ==~~		{{#externalredirect: https://projectpokemon.org/docs/mystery-dungeon-nds/procyon-studios-digital-sound-elements-r12/}}
	~~The ''Digital Sound Elements'' sound driver is an audio engine for games on the Nintendo DS, and Wii. It supports sequenced music and streamed audio.~~
	~~It was used by several games on the NDS including ''Pokémon Mystery Dungeon~~ : ~~Explorers of Sky/Time/Darkness''.~~

	~~This article will focus mainly on the implementation in PMD2 however.~~

	~~== Known Versions ==~~
	~~So far, two versions of the DSE engine have been spotted in NDS games.~~

	{\|
	~~!Version Number~~
	~~!Description~~
	\|-
	~~\| 0x415~~
	~~\| Most common version. Used in all versions of PMD2.~~
	\|-
	~~\| 0x402~~
	~~\| Much rarer version. Used only in the game Luminous Arc this far.~~
	\|}

	~~Only the format of SWDL containers seems to differs significantly between versions this far.~~

	~~== Inner Workings ==~~
	~~The sound driver adds a few layers of extra processing over the data fed to the audio registers of the NDS.~~

	~~=== Memory Structure ===~~
	The system creates 2 chunks in memory, the "mseq", and "mdev" chunks. They're only labeled as such in a few games using DSE, like PMD2. In other games, like ''Fushigi no Dungeon - Fuurai no Shiren DS 2'' and ''Professor Layton and the Last Specter'', the labels are not there in memory.

	~~The "mseq" chunk contains a set of sequencer wide variables, like counters and such, along with data structs for holding the state of each tracks during playback.~~

	~~The "mdev" chunk contains a set of channels wide variables, and data structs for every sound channels the driver has. Those structs hold the state for each channels during playback.~~

	Apart from this, the smdl and swdl for a track currently playing are copied once to memory. And then the entries in the swdl for samples, and program splits are copied and any overridable properties samples have are overriden by the program split's shared properties, like volume envelope and etc..(See swdl structure)

	~~=== Code Structure ===~~
	~~(Offsets are from the North American Explorers of Sky game's disassembled game code, not the ROM !!!)~~

	~~The channels state are updated at line 0x0207448C. A loop begins further down. And the track~~
	~~Volume envelopes are updated here~~: ~~0x02074E0C~~

	~~The function that updates the sequencer tracks begins at 0x020713E8. The actual loop begins at 02071648.~~
	~~The function that parses DSE events begins at 0x02071224.~~
	~~The table containing the function pointers for all DSE events begins at 0x020B0B90.~~

	~~== File~~/~~Data Formats ==~~
	~~The system uses the following formats:~~
	* [[dse_swdl\|swdl]] : Container for programs/~~presets data, and optionally sample data, used by the sequencer engine~~.
	* [[dse_smdl\|smdl]] : Container for sequenced music.
	* [[dse_sedl\|sedl]] : Container for sequenced sound effects, and sound presets/~~programs.~~
	* [[dse_sadl\|sadl]] : Container for streamed audio.

	~~== File Layout ==~~
	~~Game using DSE can store the various container formats in many different ways. Here are some of the known approaches:~~

	* '''PMD2 :''' There is a main sample bank called bgm.swd, which is referred to by the SWDL files accompanying every SMDL music sequences file. Each SWDL contains only program/~~presets data, and refers to samples from the main bank.~~

	* '''Fushigi no Dungeon - ~~Fuurai no Shiren DS 2~~ - Sabaku no Majou :''' Here, the SMDL and SWDL are stored in their own separate folder. They're loaded in pair, just like PMD2, but there is no main bank. Instead sample data is stored within every SWDL. Which result in lots of duplicate samples throughout all SWDL.

	* '''Zombi Daisuki:''' This game uses SMDL+SWDL pairs as well, without a main bank. But instead of having the SMDL and SWDL for a single music track stored in their own respective file, they're both stored within a [[pmd2_SIR0\|SIR0]] container, with the extension ".sd".

	* '''Professor Layton and the Last Specter :''' This game works like PMD2, it has a main bank, however, all its SMDL + SWDL pairs are stored within an archive "ll_common.darc". And oddly enough, there are 2 copies of the main bank! One is named "bgm_common.SWD" and is stored outside the "ll_common.darc" archive, while the other is named "BG.SWD" and stored within the archive.

	~~== External Resources ==~~
	* Official Website (in Japanese) [http:/~~/www.~~procyon-~~studio.co.jp~~/~~dse/]~~

UniqueGeek: Updated tag

2017-02-02T23:37:31Z

Updated tag

← Older revision		Revision as of 23:37, 2 February 2017
Line 2:		Line 2:
	[[Category:ROM Hacking]]		[[Category:ROM Hacking]]
	[[Category:Technical References]]		[[Category:Technical References]]
	[[Category:~~Pokemon~~ Mystery Dungeon ~~Series~~]]		[[Category:NDS Mystery Dungeon]]
	[[Category:Audio]]		[[Category:Audio]]
	{{DISPLAYTITLE:Procyon Studios Digital Sound Elements}}		{{DISPLAYTITLE:Procyon Studios Digital Sound Elements}}

Psy commando: /* Known Versions */

2016-05-05T04:14:47Z

Known Versions

← Older revision		Revision as of 04:14, 5 May 2016
Line 20:		Line 20:
	\|-		\|-
	\| 0x415		\| 0x415
			\| Most common version. Used in all versions of PMD2.
			\|-
	\| 0x402		\| 0x402
	\|-
	~~\| Most common version. Used in all versions of PMD2.~~
	\| Much rarer version. Used only in the game Luminous Arc this far.		\| Much rarer version. Used only in the game Luminous Arc this far.
	\|}		\|}

	Only the format of SWDL containers seems to differs significantly between versions this far.		Only the format of SWDL containers seems to differs significantly between versions this far.

	== Inner Workings ==		== Inner Workings ==

Psy commando: Added a short section about the various DSE versions.

2016-05-05T04:12:49Z

Added a short section about the various DSE versions.

← Older revision		Revision as of 04:12, 5 May 2016
Line 11:		Line 11:

	This article will focus mainly on the implementation in PMD2 however.		This article will focus mainly on the implementation in PMD2 however.

			== Known Versions ==
			So far, two versions of the DSE engine have been spotted in NDS games.

			{\|
			!Version Number
			!Description
			\|-
			\| 0x415
			\| 0x402
			\|-
			\| Most common version. Used in all versions of PMD2.
			\| Much rarer version. Used only in the game Luminous Arc this far.
			\|}

			Only the format of SWDL containers seems to differs significantly between versions this far.

	== Inner Workings ==		== Inner Workings ==

Psy commando: /* Code Structure */

2016-04-12T19:01:50Z

Code Structure

← Older revision		Revision as of 19:01, 12 April 2016
Line 25:		Line 25:

	=== Code Structure ===		=== Code Structure ===
	(Offsets are from the North American Explorers of Sky game ~~version~~ !!!)		(Offsets are from the North American Explorers of Sky game's disassembled game code, not the ROM !!!)

	The channels state are updated at line 0x0207448C. A loop begins further down. And the track		The channels state are updated at line 0x0207448C. A loop begins further down. And the track

Psy commando: /* Inner Workings */ removed some dubious assumption I made.

2015-08-28T21:08:14Z

Inner Workings: removed some dubious assumption I made.

← Older revision		Revision as of 21:08, 28 August 2015
Line 13:		Line 13:

	== Inner Workings ==		== Inner Workings ==
	The sound driver ~~doesn't replace the NDS's sound engine, but merely build up on it. It~~ adds a few layers of extra processing over the data fed to the audio registers of the NDS.		The sound driver adds a few layers of extra processing over the data fed to the audio registers of the NDS.

	=== Memory Structure ===		=== Memory Structure ===

Psy commando: I added a hub page for the DSE sound driver. Eventually I'll add a lot more data on how the whole system works. This will be very useful, because there is a lot to say on this system and I don't want to clog the PMD2 page with that stuff

2015-08-26T04:01:22Z

I added a hub page for the DSE sound driver. Eventually I'll add a lot more data on how the whole system works. This will be very useful, because there is a lot to say on this system and I don't want to clog the PMD2 page with that stuff

New page

[[Category:Incomplete Articles]]
[[Category:ROM Hacking]]
[[Category:Technical References]]
[[Category:Pokemon Mystery Dungeon Series]]
[[Category:Audio]]
{{DISPLAYTITLE:Procyon Studios Digital Sound Elements}}

== General Information ==
The ''Digital Sound Elements'' sound driver is an audio engine for games on the Nintendo DS, and Wii. It supports sequenced music and streamed audio.
It was used by several games on the NDS including ''Pokémon Mystery Dungeon : Explorers of Sky/Time/Darkness''.

This article will focus mainly on the implementation in PMD2 however.

== Inner Workings ==
The sound driver doesn't replace the NDS's sound engine, but merely build up on it. It adds a few layers of extra processing over the data fed to the audio registers of the NDS.

=== Memory Structure ===
The system creates 2 chunks in memory, the "mseq", and "mdev" chunks. They're only labeled as such in a few games using DSE, like PMD2. In other games, like ''Fushigi no Dungeon - Fuurai no Shiren DS 2'' and ''Professor Layton and the Last Specter'', the labels are not there in memory.

The "mseq" chunk contains a set of sequencer wide variables, like counters and such, along with data structs for holding the state of each tracks during playback.

The "mdev" chunk contains a set of channels wide variables, and data structs for every sound channels the driver has. Those structs hold the state for each channels during playback.

Apart from this, the smdl and swdl for a track currently playing are copied once to memory. And then the entries in the swdl for samples, and program splits are copied and any overridable properties samples have are overriden by the program split's shared properties, like volume envelope and etc..(See swdl structure)

=== Code Structure ===
(Offsets are from the North American Explorers of Sky game version !!!)

The channels state are updated at line 0x0207448C. A loop begins further down. And the track
Volume envelopes are updated here: 0x02074E0C

The function that updates the sequencer tracks begins at 0x020713E8. The actual loop begins at 02071648.
The function that parses DSE events begins at 0x02071224.
The table containing the function pointers for all DSE events begins at 0x020B0B90.

== File/Data Formats ==
The system uses the following formats:
* [[dse_swdl|swdl]] : Container for programs/presets data, and optionally sample data, used by the sequencer engine.
* [[dse_smdl|smdl]] : Container for sequenced music.
* [[dse_sedl|sedl]] : Container for sequenced sound effects, and sound presets/programs.
* [[dse_sadl|sadl]] : Container for streamed audio.

== File Layout ==
Game using DSE can store the various container formats in many different ways. Here are some of the known approaches:

* '''PMD2 :''' There is a main sample bank called bgm.swd, which is referred to by the SWDL files accompanying every SMDL music sequences file. Each SWDL contains only program/presets data, and refers to samples from the main bank.

* '''Fushigi no Dungeon - Fuurai no Shiren DS 2 - Sabaku no Majou :''' Here, the SMDL and SWDL are stored in their own separate folder. They're loaded in pair, just like PMD2, but there is no main bank. Instead sample data is stored within every SWDL. Which result in lots of duplicate samples throughout all SWDL.

* '''Zombi Daisuki:''' This game uses SMDL+SWDL pairs as well, without a main bank. But instead of having the SMDL and SWDL for a single music track stored in their own respective file, they're both stored within a [[pmd2_SIR0|SIR0]] container, with the extension ".sd".

* '''Professor Layton and the Last Specter :''' This game works like PMD2, it has a main bank, however, all its SMDL + SWDL pairs are stored within an archive "ll_common.darc". And oddly enough, there are 2 copies of the main bank! One is named "bgm_common.SWD" and is stored outside the "ll_common.darc" archive, while the other is named "BG.SWD" and stored within the archive.

== External Resources ==
* Official Website (in Japanese) [http://www.procyon-studio.co.jp/dse/]