DSPTOOL_DLL.pdf

(66 KB) Pobierz
Revolution DSPTOOL.DLL
Version 1.00
The contents in this document are highly
confidential and should be handled accordingly.
© 2006-2007 Nintendo
CONFIDENTIAL
RVL-06-0034-001-B
Released: October 22, 2007
Revolution DSPTOOL.DLL
Revolution SDK
Confidential
These coded instructions, statements, and computer programs contain proprietary information of Nintendo
of America Inc. and/or Nintendo Company Ltd. and are protected by Federal copyright law. They may not be
disclosed to third parties or copied or duplicated in any form, in whole or in part, without the prior written
consent of Nintendo.
RVL-06-0034-001-B
Released: October 22, 2007
2
© 2006-2007 Nintendo
CONFIDENTIAL
Revolution SDK
Revolution DSPTOOL.DLL
Contents
Revision History .................................................................................................................................. 4
1 Description.................................................................................................................................... 5
2 Exported Functions....................................................................................................................... 6
2.1 getBytesForAdpcmBuffer() ................................................................................................. 6
2.2 getBytesForAdpcmSamples()............................................................................................. 6
2.3 getBytesForPcmBuffer() ..................................................................................................... 6
2.4 getBytesForPcmSamples() ................................................................................................. 7
2.5 getSampleForAdpcmNibble() ............................................................................................. 7
2.6 getBytesForAdpcmInfo()..................................................................................................... 7
2.7 getNibbleAddress() ............................................................................................................. 7
2.8 getLoopContext() ................................................................................................................ 8
2.9 encode ................................................................................................................................ 9
2.10 decode .............................................................................................................................. 10
3 Usage ......................................................................................................................................... 11
3.1 Initialization ....................................................................................................................... 11
3.2 Encoding........................................................................................................................... 13
3.3 Decoding........................................................................................................................... 14
Code Examples
Code 3–1 Invoking DSPTOOL.DLL ................................................................................................. 11
Code 3–2 Encoding (pseudocode example).................................................................................... 13
Code 3–3 Decoding (pseudocode example).................................................................................... 14
© 2006-2007 Nintendo
CONFIDENTIAL
3
RVL-06-0034-001-B
Released: October 22, 2007
Revolution DSPTOOL.DLL
Revolution SDK
Revision History
Version
1.00
Date
Revised
2006/03/01
Item
-
Description
First release by Nintendo of America Inc.
RVL-06-0034-001-B
Released: October 22, 2007
4
© 2006-2007 Nintendo
CONFIDENTIAL
Revolution SDK
Revolution DSPTOOL.DLL
1
Description
DSPTOOL.DLL
is a Win32 runtime dynamic linked library. It provides an API for encoding and decoding 16-
bit PCM samples to and from the
DSP-ADPCM
compression format.
The
DSP-ADPCM
sample format provides (approximately) 3.5:1 compression and is proprietary to the Nin-
tendo Revolution audio DSP. The audio DSP contains special hardware to decompress
DSP-ADPCM
sam-
ples for free.
This DLL is intended for developers who wish to create their own tools for generating and previewing
DSP-
ADPCM
samples.
Note:
This DLL is single-threaded.
© 2006-2007 Nintendo
CONFIDENTIAL
5
RVL-06-0034-001-B
Released: October 22, 2007
Zgłoś jeśli naruszono regulamin