Broken Sword - The Sleeping Dragon RWS - Revision history

imported>Ikskoks at 13:57, 3 January 2021

2021-01-03T13:57:44Z

← Older revision	Revision as of 13:57, 3 January 2021
(No difference)

imported>Ikskoks at 13:57, 3 January 2021

2021-01-03T13:57:44Z

← Older revision		Revision as of 13:57, 3 January 2021
Line 123:		Line 123:
	{{DEFAULTSORT:{{PAGENAME}}}}		{{DEFAULTSORT:{{PAGENAME}}}}
	[[Category:PC formats]]		[[Category:PC formats]]
			[[Category:File Format]]

imported>Dinoguy1000: some cleanup

2011-10-21T08:54:00Z

some cleanup

← Older revision	Revision as of 08:54, 21 October 2011
(No difference)

imported>Dinoguy1000: some cleanup

2011-10-21T08:54:00Z

some cleanup

← Older revision		Revision as of 08:54, 21 October 2011
Line 2:		Line 2:

	== RWS ==		== RWS ==
	{{GRAFPageMisc\|~~format_type={{FormatAudio}}\|date_posted=21:24, 24 March 2007 (EDT)~~}}		{{GRAFPageMisc\|Audio}}

	=== Format Specifications ===		=== Format Specifications ===
Line 121:		Line 121:
	{{GRAFPageFooter}}		{{GRAFPageFooter}}

	[[Category:~~Platform~~ PC~~\|Broken Sword - The Sleeping Dragon RWS]] [[Category:Complete Almost Done\|Broken Sword - The Sleeping Dragon RWS]] [[Category:CE Compressed\|Broken Sword - The Sleeping Dragon RWS~~]]		{{DEFAULTSORT:{{PAGENAME}}}}
			[[Category:PC formats]]

imported>DenizOezmen: improved example readability for smaller monitor resolutions

2007-03-25T15:03:34Z

improved example readability for smaller monitor resolutions

← Older revision	Revision as of 15:03, 25 March 2007
(No difference)

imported>DenizOezmen: improved example readability for smaller monitor resolutions

2007-03-25T15:03:34Z

improved example readability for smaller monitor resolutions

imported>DenizOezmen: added format description (phew)

2007-03-25T01:24:27Z

added format description (*phew*)

← Older revision	Revision as of 01:24, 25 March 2007
(No difference)

imported>DenizOezmen: added format description (phew)

2007-03-25T01:24:27Z

added format description (*phew*)

New page

{{GRAFPageHeader}}

== RWS ==
{{GRAFPageMisc|format_type={{FormatAudio}}|date_posted=21:24, 24 March 2007 (EDT)}}

=== Format Specifications ===
{{GRAFPageFormat|1=
uint32 {4}   - RWS chunk type {{Constant|(0x0000080d)}} 
uint32 {4}   - RWS chunk data size 
uint32 {4}   - RWS chunk version {{Constant|(0x1803ffff)}} 
:uint32 {4}   - RWS chunk type {{Constant|(0x0000080e)}} 
:uint32 {4}   - RWS chunk data size 
:uint32 {4}   - RWS chunk version {{Constant|(0x1803ffff)}} 
::uint32 {4}   - header size 
::uint32 {36}  - {{Unknown}} 
::uint32 {4}   - number of tracks 
::uint32 {20}  - {{Unknown}} 
::uint32 {16}  - {{Unknown|some kind of signature?}} 
::char {x}     - stream name 1 {{InlineComment|(zero-terminated, padded to 16 byte boundary)}} 
::uint32 {24}  - {{Unknown}} 
::uint32 {4}   - data size 
::uint32 {4}   - {{Unknown}} 
::{{BlockDescription|// for each track}} 
:::uint32 {4}   - {{Unknown}} 
::uint32 {16}  - {{Unknown|some kind of signature?}} 
::char {x}     - stream name 2 {{InlineComment|(zero-terminated, padded to 16 byte boundary)}} 
::{{BlockDescription|// for each track (physical organization)}} 
:::uint32 {16}  - {{Unknown}} 
:::uint32 {4}   - cluster size 
:::uint32 {12}  - {{Unknown}} 
:::uint32 {4}   - used bytes per cluster 
:::uint32 {4}   - track start offset 
::{{BlockDescription|// for each track (track parameters)}} 
:::uint32 {4}   - sample rate 
:::uint32 {4}   - {{Unknown}} 
:::uint32 {4}   - track data size 
:::byte {1}     - {{Unknown}} 
:::byte {1}     - number of channels 
:::uint16 {2}   - {{Unknown}} 
:::uint32 {12}  - {{Unknown}} 
:::uint32 {16}  - {{Unknown|some kind of signature?}} 
:::uint32 {4}   - {{Unknown}} 
::{{BlockDescription|// for each track}} 
:::uint32 {16}  - {{Unknown|some kind of signature?}} 
::{{BlockDescription|// for each track (track names)}} 
:::char {x}     - track name {{InlineComment|(zero-terminated, padded to 16 byte boundary)}} 
::uint32 {x}   - padding {{InlineComment|(until chunk has finished, cf. chunk data size)}} 
:uint32 {4}   - RWS chunk type {{Constant|(0x0000080f)}} 
:uint32 {4}   - RWS chunk data size 
:uint32 {4}   - RWS chunk version {{Constant|(0x1803ffff)}} 
::{{BlockDescription|// until tracks have finished (interleaved track clusters)}} 
:::{{BlockDescription|// for each track (single track cluster)}} 
::::{{BlockDescription|// until bytes used per cluster are finished (IMA ADPCM variant blocks)}} 
:::::{{BlockDescription|// for each channel (ADPCM header)}} 
::::::int16 {2}    - initial sample 
::::::byte {1}     - initial index 
::::::byte {1}     - unused {{Constant|(0x00)}} 
:::::{{BlockDescription|// 7 times}} 
::::::{{BlockDescription|// for each channel (ADPCM sample codes)}} 
:::::::byte {4}     - 8 sample codes 
:::::{{BlockDescription|// for each channel (ADPCM sample codes)}} 
::::::byte {4}     - 7 sample codes {{InlineComment|(final nibble unused)}} 
::::byte {x}     - padding {{InlineComment|(until cluster has finished)}} 
}}

=== Notes and Comments ===

==== General information ====

Broken Sword - The Sleeping dragon is based on the [http://renderware.com/ RenderWare] engine and utilizes its usual stream files to store the game's audio data. The chunk types encountered identify themselves as follows:
* <tt>0x0000080d</tt> - audio container
* <tt>0x0000080e</tt> - audio header
* <tt>0x0000080f</tt> - audio data
Note that all reviewed files consisted of exactly one audio container chunk which in turn was made up of exactly one audio header chunk and one audio data chunk (in that order).

==== Audio header ====

One single RWS file supports multiple single tracks which can be mixed on the fly during gameplay. The audio header lists parameters, physical layout organization information as well as names for each track. As the audio data itself is organized in a clustered manner, not only the sampling rate and frequency are relevant for extraction, but also
* the track offset, which specifies the track data position relative to the beginning of the audio data,
* the cluster size, which fixes the length of one informational unit,
* the number of bytes used within a cluster, as one cluster may actually only be partially filled by audio data and
* the track size, which specifies the size of one track's data measure in actual used bytes (i. e. not counting cluster waste).

==== Audio data ====

The audio data chunk contains the actual track data, organized in clusters as defined in the audio header. Each cluster contains data for exactly one track, while all tracks within a single RWS file are interleaved at cluster level. Thus, to extract one track, one cluster at a time has to be read (starting at the offset given in the audio header), then eventually skipping the other tracks' data before reaching the next cluster belonging to this track.
Note that parts of a cluster may be wasted. The number of used bytes in one each cluster can be looked up in the audio header.

Example: Assume three tracks in one RWS file. The data layout will look like this:

+-----------------+-----------------+-----------------+-----------------+-----------------+-----------------+
| Cluster 1 | Cluster 2 | Cluster 3 | Cluster 4 | Cluster 5 | Cluster 6 |
+ - - - - - - - - + - - - - - - - - + - - - - - - - - + - - - - - - - - + - - - - - - - - + - - - - - - - - +
| Track 1 part 1 | Track 2 part 1 | Track 3 part 1 | Track 1 part 2 | Track 2 part 2 | Track 3 part 2 | ...
+ - - - - + - - - + - - - - + - - - + - - - - + - - - + - - - - + - - - + - - - - + - - - + - - - - + - - - +
| data | waste | data | waste | data | waste | data | waste | data | waste | data | waste |
+---------+-------+---------+-------+---------+-------+---------+-------+---------+-------+---------+-------+

The wave data within each cluster is stored via [http://wiki.multimedia.cx/index.php?title=IMA_ADPCM IMA ADPCM] compressed sample codes. The single blocks are fairly small; each block encodes exactly 64 signed 16 bit PCM samples per channel. The first of these samples is explicitly given in each block's header structure. The remaining 63 samples are compressed and packed into 8 units, each 4 bytes in size, alternatingly for each channel. Every channel's very last nibble within the block is thus unused.

Example: Assuming two channels in one track, the sample layout of a given block will look as follows (X denoting the unused nibbles):

+---------------+---------------+---------------+---------------+ +---------------+---------------+
| Ch. 1 unit 1 | Ch. 2 unit 1 | Ch. 1 unit 2 | Ch. 2 unit 2 | | Ch. 1 unit 8 | Ch. 2 unit 8 |
+ - - - - - - - + - - - - - - - + - - - - - - - + - - - - - - - + ... + - - - - - - - + - - - - - - - +
| Smpl. 1...8 | Smpl. 1...8 | Smpl. 1...8 | Smpl. 1...8 | | Smpl. 1...7 X | Smpl. 1...7 X |
+---------------+---------------+---------------+---------------+ +---------------+---------------+

=== MultiEx BMS Script ===
{{NoBMSScript}}

=== Supported by Programs ===
[http://oezmen.eu/gameresources/ RWS2WAV]

=== Links ===
None

=== Games ===
* [[Broken Sword - The Sleeping Dragon]] [[RWS|*.rws]]

{{GRAFPageFooter}}

[[Category:Platform PC|Broken Sword - The Sleeping Dragon RWS]] [[Category:Complete Almost Done|Broken Sword - The Sleeping Dragon RWS]] [[Category:CE Compressed|Broken Sword - The Sleeping Dragon RWS]]

← Older revision		Revision as of 15:03, 25 March 2007
Line 89:		Line 89:
	Example: Assume three tracks in one RWS file. The data layout will look like this:		Example: Assume three tracks in one RWS file. The data layout will look like this:

	~~+-----------------+-----------------~~+-----------------+-----------------+-----------------+-----------------+		+-----------------+-----------------+-----------------+-----------------+
	\| Cluster 1 \| Cluster 2 \| Cluster 3 \| Cluster 4 ~~\| Cluster 5 \| Cluster 6~~ \|		\| Cluster 1 \| Cluster 2 \| Cluster 3 \| Cluster 4 \|
	~~+ - - - - - - - - + - - - - - - - -~~ + - - - - - - - - + - - - - - - - - + - - - - - - - - + - - - - - - - - +		+ - - - - - - - - + - - - - - - - - + - - - - - - - - + - - - - - - - - +
	\| Track 1 part 1 \| Track 2 part 1 \| Track 3 part 1 \| Track 1 ~~part 2 \| Track 2 part 2 \| Track 3~~ part 2 \| ...		\| Track 1 part 1 \| Track 2 part 1 \| Track 3 part 1 \| Track 1 part 2 \| ...
	~~+ - - - - + - - - + - - - - + - - -~~ + - - - - + - - - + - - - - + - - - + - - - - + - - - + - - - - + - - - +		+ - - - - + - - - + - - - - + - - - + - - - - + - - - + - - - - + - - - +
	\| ~~data \| waste~~ \| data \| waste \| data \| waste \| data \| waste \| data \| waste \| ~~data \| waste \|~~		\| data \| waste \| data \| waste \| data \| waste \| data \| waste \|
	~~+---------+-------+---------+-------~~+---------+-------+---------+-------+---------+-------+---------+-------+		+---------+-------+---------+-------+---------+-------+---------+-------+

	The wave data within each cluster is stored via [http://wiki.multimedia.cx/index.php?title=IMA_ADPCM IMA ADPCM] compressed sample codes. The single blocks are fairly small; each block encodes exactly 64 signed 16 bit PCM samples per channel. The first of these samples is explicitly given in each block's header structure. The remaining 63 samples are compressed and packed into 8 units, each 4 bytes in size, alternatingly for each channel. Every channel's very last nibble within the block is thus unused.		The wave data within each cluster is stored via [http://wiki.multimedia.cx/index.php?title=IMA_ADPCM IMA ADPCM] compressed sample codes. The single blocks are fairly small; each block encodes exactly 64 signed 16 bit PCM samples per channel. The first of these samples is explicitly given in each block's header structure. The remaining 63 samples are compressed and packed into 8 units, each 4 bytes in size, alternatingly for each channel. Every channel's very last nibble within the block is thus unused.
Line 101:		Line 101:
	Example: Assuming two channels in one track, the sample layout of a given block will look as follows (X denoting the unused nibbles):		Example: Assuming two channels in one track, the sample layout of a given block will look as follows (X denoting the unused nibbles):

	~~+---------------+---------------~~+---------------+---------------+ +---------------+---------------+		+---------------+---------------+ +---------------+---------------+
	\| Ch. 1 unit 1 \| Ch. 2 unit 1 ~~\| Ch. 1 unit 2 \| Ch. 2 unit 2~~ \| \| Ch. 1 unit 8 \| Ch. 2 unit 8 \|		\| Ch. 1 unit 1 \| Ch. 2 unit 1 \| \| Ch. 1 unit 8 \| Ch. 2 unit 8 \|
	~~+ - - - - - - - + - - - - - - -~~ + - - - - - - - + - - - - - - - + ... + - - - - - - - + - - - - - - - +		+ - - - - - - - + - - - - - - - + ... + - - - - - - - + - - - - - - - +
	~~\| Smpl. 1...8 \| Smpl. 1...8~~ \| Smpl. 1...8 \| Smpl. 1...8 \| \| Smpl. 1...7 X \| Smpl. 1...7 X \|		\| Smpl. 1...8 \| Smpl. 1...8 \| \| Smpl. 1...7 X \| Smpl. 1...7 X \|
	~~+---------------+---------------~~+---------------+---------------+ +---------------+---------------+		+---------------+---------------+ +---------------+---------------+

	=== MultiEx BMS Script ===		=== MultiEx BMS Script ===

Broken Sword - The Sleeping Dragon RWS - Revision history

imported>Ikskoks at 13:57, 3 January 2021

imported>Ikskoks at 13:57, 3 January 2021

imported>Dinoguy1000: some cleanup

imported>Dinoguy1000: some cleanup

imported>DenizOezmen: improved example readability for smaller monitor resolutions

imported>DenizOezmen: improved example readability for smaller monitor resolutions

imported>DenizOezmen: added format description (*phew*)

imported>DenizOezmen: added format description (*phew*)

imported>DenizOezmen: added format description (phew)

imported>DenizOezmen: added format description (phew)