([*]) is a link to the relevant page.
*NOTE*
- Microsoft .NET Framework 3.5 service pack 1 must be installed to run NW4C SoundMaker.
- This manual contains references to Viewer, but that feature has not been implemented yet.
Added/Modified Functionality
The interpolation type can now be selected in instrument lists and percussion lists on SoundMaker.
For details, read about interpolation types in the Instrument List or Percussion List section of the Bank Tab part of the Practical Guide of the manual.
In previous versions, the interpolation type as set using the nw::snd::SoundSystem::SetSrcType function only affected stream sounds and wave sounds. With the addition of the feature for selecting the interpolation type for instruments, sequence sounds are now also affected.
Added a checkbox for Output Labels by Item to the Convert tab of the Project Settings dialog.
When this check box is selected, ID headers are divided into files by type for export.
Added a check box to Display the full file path in the General tab of the Options dialog. When this check box is selected, the full path is given for the project name in the title bar.
Changed the specification so that now, when a waveform file has been set to loop but the same frame has been specified for both the starting and stopping points, it is handled as if the waveform file has been set to not loop.
cinl file.When instruments are disabled, the pertinent instruments are not included in the cinl file (the instrument label file) at conversion time.
This was done so that conversion errors occur in sequences that reference the labels of disabled instruments.
Added text to the manual's Troubleshooting chapter to explain what to do when characters no longer display in lists while using SoundMaker.
Added a feature to the nn::snd::SetClippingMode function to select the clipping mode.
This can be selected from the OutputMode screen.
SoundPlayer-TS.cia files.The feature for importing cia files was deleted from CTR_SDK-0.14.0 and later versions of DevMenu, so the feature for creating cia files has been deleted from SoundPlayer.
Bug Fixes
When sequence sounds with a time base of 480 and a tempo of 78 or slower were previewed on the PC, the sounds would not play. That problem has been corrected.
This symptom reoccurred from version NW4C-1.1.0.
An exception occured when the percussion tab was opened after deleting a key region. That problem has been fixed.
Noise occurred when extremely short, silent waveforms were played. That problem was fixed.
When the compression format for instruments was changed in SoundMaker, that change was not reflected in the result of the converter. That problem was fixed.
If a Sample Map was split in two and then one of the assigned waveform files was deleted, sound would play even when the deleted region was referenced when the note-on command was performed on the sequence sound.
This was due to a converter bug that resulted in waveform allocation remaining behind in the deleted region if the Sample Map had an empty region when it was split in two. The problem has now been corrected.
With this correction, regions with no waveform allocation do not make sounds when note-on is performed.
An error occured with the sound project converter (NW4C_SoundProjectConverter.exe) when options were written first. That problem has been corrected.
On SoundPlayer, it was possible to set negative values for the effect parameters listed below. That has been corrected.
- FxReverb::Param::m_EarlyReflectionTime
- FxReverb::Param::m_FusedTime
- FxReverb::FilterSize::m_Comb0
- FxReverb::FilterSize::m_Comb1
- FxReverb::FilterSize::m_AllPass
- FxDelay::Param::m_DelayTime
Known Issues
No timeframe has been set to correct this problem.
SoundMaker will crash when you try to preview a sequence on the computer that includes a sequence sound with the alloctrack command.
An exclamation point is always attached to instruments displayed in the Search Results window.
Even if you rename a Player and resolve broken links, the exclamation mark persists and conversion attempts result in an internal error.
To recover from this, reopen the project in which the error occurs.
When you select Copy Cell in the Duration column or Front Bypass column, nothing gets copied. The Copy Cell menu in the Play column dpes not appear grayed-out.
A warning icon ("!") is not being displayed in the sequence sound list even if a bank that doesn't exist in the project is specified as a sequence sound.
There is a bug where subsequent operations are not accepted if an attempt is made to play a stream sound using HioSoundPlayer.
There is a bug that causes failure to load data and inability to play sounds. It occurs under the condition described in (A) for banks and wave sounds when they are only registered to groups that meet the condition described in (B).
(A) Condition for banks and wave sounds:
- Automatic (Shared) selected for Waveform Archive.
(B) Condition for groups:
- Embedded selected for output format.
Added/Modified Functionality
Added Unspecified as an item to the MIDI Keyboard Input combo box in the Tools > Options > MIDI tab.
Up until now, when only one corresponding MIDI device was connected it would invariably be selected as MIDI Keyboard Input. The new item enables this device to be deselected.
It is now possible to import in units of NTR bank files.
When a UIC-MIDI device is directly connected to a TS Board, a PARTNER-CTR Debugger (white box), or a test unit, SoundPlayer can now receive the MIDI signals for Play Preview.
An explanation of the map files that are generated when converting has been added to this manual inside the section Basic Editing > Convert > Generated Files.
The map file provides information about such things as ROM size and bank capacity.
Bug Fixes
There were two problems when the parameter in the EnvR column was changed in SoundMaker's wave sound list:
- The change was not applied to the output binary (bcsar)
- Release did not work at runtime
Those problems have been fixed.
When an HTML sound list contained an empty sound set, the sound set filters did not display correctly. That problem has been fixed.
When the directory specified for Stream file output destination path was two or more levels deep, the playback of stream sounds would stop on an exception error when played on a SoundPlayer created using SoundPlayer creation. That problem has been fixed.
When Open File was performed using the All Files filter, an exception error would occur if any file other than a cbnk file was specified. That problem has been fixed.
NW4C_ROOT environment variable not set.If conversion was conducted without setting the NW4C_ROOT environment variable an exception error would occur after conversion. That problem has been fixed.
When a sound archive that did not contain a string table was loaded to SoundPlayer/HioSoundPlayer, the process would halt when the application was launching or when the sound archive was reloading. That problem has been fixed.
If the sound archive does not contain a string table, instead of item names (e.g., SE_YOSHI, etc.) the string "..." will display.
Revisions were made in this manual to correct shortcomings in the explanation about sharing in the description of wave archives in the Wave Sound and Bank items in the Sound Set Tab of the Practical Guide.
Added/Modified Functionality
Added frontbypass_on and frontbypass_off to sequence commands.
For details, see the Sequence Data Manual.
Also, changed the jump_seq sequence of SampleData/Sound/Projects/simple/seg/se.cseq (sequence sound SEQ_JUMP) to that which uses the corresponding command.
Changed the sounds in the read-only sound set so that preview playback is possible.
Made it so that surround pan can also be set under SoundPlayer like volume, pitch and pan.
Although sound Ids used to be reset when a sound archive was reloaded with HioSoundPlayer, this has been changed to that sound IDs are saved without reset.
However, if the specified sound ID is larger than the number of sounds stored in a sound archive after reloading, they are reset just as in the past.
Bug Fixes
Fixed a bug where NITRO-SoundMaker project import on the desktop would fail.
Fixed a bug where scales were not being displayed in the percussion list.
Fixed a bug where loop noise would occur when performing ADPCM encoding with the loop start frame set to 0.
Wave data must be re-converted.
Fixed a bug where noise would occur during stream data looping.
Wave data must be re-converted.
Fixed a bug where parameters such as volume and pitch were not being applied at the start of sound playback.
The description of volume that can be set in each SoundMaker list has been revised.
See the descriptino of volume for stream sounds and wave sounds. [*]
For more details see the chapter Operating Sound Parameter Controls in the Sound System Manual.
Added/Modified Functionality
The following columns were added to Wave Sound List for specifying the send volume for each bus.
- Send AUX A
- Send AUX B
- Send MAIN
Front Bypass mode is now supported by the various sounds (stream sounds, wave sounds and sequence sounds).
This can be set in the various SoundMaker lists.
Check the below-listed sounds in SampleData/Sound/Projects/simple.
- STRM_MARIOKART_FB
- SE_YOSHI_FB
- SE_STEREO_FB
- SEQ_CALL_FB
- SEQ_MARIOKART_FB
You can try out effects on SoundPlayer.
Bug Fixes
Creation of SoundPlayer would fail in some cases when some place other than output was set as the output destination for the Sound Archive. The bug has been fixed.
Fixed the following bugs relating to list operations.
- When a sequence file had an invalid string, an exception error would occur when the starting playback position was selected
- An exception error would occur when Copy Cell was performed in the Play and Duration columns.
When a DSP ADPCM-encoded stream sound was played, sometimes noise would be generated at data's end and when looping. That has been fixed.
A bug made it impossible to import SoundPlayer-TS.cia. That has been fixed
Bug Fixes
A bug has been fixed where noise was being introduced during looping when playing the sine waveform (SampleData/Sound/Projects/simple/aif/sin440.aiff) included in sample data.
Fixed a bug where parameters listed under the Velocity Region that can be set on the Percussion List or Parameter Panel were not being reflected correctly in binary sound archive files (bcsar) (or more accurately speaking, in binary bank files (bcbnk)).
- Volume
- Pitch (Semitones)
Fixed the following bugs with the waveform converter.
- No samples were output for PCM16/PCM8 encoding
- Invalid content was output for ADPCM encoding
Fixed a bug where sounds were broken off or did not play during PC emulation playback or playback on actual hardware using SoundPlayer when converting an 8-bit PCM .wav or .aiff file.
A bug was fixed where a dialog box not containing any warning message was being displayed when converting a project that accesses a non-existent bank (.bcnk) file.
There was a bug when a non-existent Starting Playback Position was specified during sequence sound conversion that made it hard to know the label and Starting Playback Position at which the error occurred.
This bug has been fixed so the user can know the Label and Starting Playback Position.
The following is an example.
- (Before bug fix) [Internal error] start label not found.
- (After bug fixe) [Error: SEQ_WIHAHO] The starting playback position label name "wihaho2" does not exist in sequence data.
The descriptions of item names that can be set in each SoundMaker list have been revised.
There are restrictions on the characters that can be used in a name. The following characters can be used.
- The first character of a name must be a single-byte letter or an underscore. [a-zA-Z_]
- Other characters must be single-byte alphanumeric or an underscore. [a-zA-Z0-9_]
Added/Modified Functionality
The TEG2 version SoundPlayer Create menu has been removed due to termination of CTR-TEG2 support.
The following additions have been made to the SoundPlayer display.
- DSP process load
- Number of voices being used
SoundPlayer now allows the output mode to be changed using the Y button and the surround depth value to be changed using the L/R buttons.
HioSoundPlayer.cci has been added. HioSoundPlayer.cci can reload Sound Archives via Host IO.
HioSoundPlayer.cci can be found in $NW4C_ROOT/tools/SoundPlayer/.
Bug Fixes
Fixed a bug where execution would freeze if interactive input was requested by a command being executed using Command before conversion or Command after conversion.
Such commands can be canceled by pressing the Cancel button.
Note that interactive input is not supported when using Command before conversion or Command after conversion.
Fixed a bug where waveform shapes were unstable in the loop end region when using ADPCM to convert looped waveforms.
Bug Fixes
If the starting playback position was changed for a text sequence sound that caused a conversion error, an error would occur. This bug has been fixed.
Added/Modified Functionality
$NW4C_ROOT/SampleData/Sound/Projects.(Overall) Moved the SoundMaker sample data to $NW4C_ROOT/SampleData/Sound/Projects.
- $NW4C_ROOT/tools/SoundMaker/samples/simple → $NW4C_ROOT/SampleData/Sound/Projects/simple
- $NW4C_ROOT/demos/snd/externalFile/dataSrc → $NW4C_ROOT/SampleData/Sound/Projects/externalFile
- $NW4C_ROOT/demos/snd/playerHeap/dataSrc → $NW4C_ROOT/SampleData/Sound/Projects/playerHeap
The OMakefile and vcproj files for the demo were adjusted to accomodate this change.
A feature was added to the SoundMaker menus to create a SoundPlayer executable file (SoundPlayer.cci).
Added a column to the following lists to display the duration of waveform data.
A column that displays the ticks was also added to some of the lists.
- Banks > Instrument List [*]
- Banks > Percussion List [*]
- Wave Sound List [*]
- Stream Sound List [*]
nn::snd::SendParameterToDsp function is now displayed.The processing time of the CTR-SDK function, nn::snd::SendParameterToDsp, is now displayed on the upper screen.
Bug Fixes
If SoundMaker was started by specifying a relative path to a project file as a startup parameter, the Project Settings file would not be saved properly, which caused an error when attempting to exit the program. This bug has been fixed.
The snapshot version of NW4C-0.7.0 had a bug that prevented SoundPlayer from being created if the absolute path of the project (.cspj) file contained a space. This bug has been fixed.
Fixed a bug that prevented intermediate files from being input and output correctly after editing and saving actor players, user data, or EnvelopeRelease.
If the demos were built in parallel, the build system would attempt to convert the same project file more than once, which caused a conversion error. This bug has been fixed.
Fixed a bug that caused a conversion error if an instrument's program number was set to a value of 255 or higher.
The correct maximum value is 32,767.
Fixed the following bugs with the Sound Project converter.
-A success code would always be returned, regardless of whether conversion was successful.
- Specifying a project file using a relative path would always cause conversion to fail due to an internal error.
Fixed a bug that caused the sound IDs within CSID files not to be output correctly during conversion of projects that contained multiple sound sets.
Bug Fixes
When the number of instrument region splits is a multiple of 4, playing the sequence sound when playing the instrument would cause the program to halt due to a failed assertion. This bug has been fixed.
Added/Modified Functionality
With the new CTR-TS board support in SoundPlayer, we added the following *.wsf files for creating the CCI files for both the TS and TEG2 versions.
- MakeSoundPlayer-TS.wsf
- MakeSoundPlayer-TEG2.wsf
We removed the MakeSoundPlayer.wsf file formerly included in the package.
Added/Modified Functionality
Made actor players and 3D sound parameters configurable in SoundMaker.
This entailed a version update to the (Project Name).cspj.settings file. The previous (Project Name).cspj.settings file is reset once.
Added support for converting 3D sound parameters.
Added the SoundPlayer tool that can be used with the CTR-TEG2.
See the $NW4C_ROOT/tools/SoundPlayer/Readme.txt file for details on use.
With the addition of this SoundPlayer tool, we have removed the old $NW4C_ROOT/demos/snd/SoundPlayer version.
Bug Fixes
Fixed a bug that caused errors and internal errors to occur during attempts to convert a project with groups that referenced disabled items.
Fixed a bug that prevented errors from being displayed correctly during conversion of a bank with duplicate program numbers or an instrument that was not between 0 and 255.
Fixed a bug that caused an internal error to occur if you attempted to convert a project satisfying the following conditions.
- It included a bank or wave sound set with a Waveform Archive setting of Automatic (Shared)
- The aforementioned item was registered with an embedded group.
- The aforementioned item was related to and referenced by an item registered with another group.
Added/Modified Functionality
Changed the maximum number of tracks that can be added to a stream to 4.
Specifications have changed so that a "!" icon is displayed when there are five or more tracks on the Multi-Track Setup dialog. This has been changed so the icon is displayed.
Attaching five or more tracks to a stream now causes an error.
Bug Fixes
Fixed a bug that resulted in a conversion error when 16 or more tracks were allocated by a sequence sound (alloctrack 0xffff for a .cseq text sequence).
Added/Modified Functionality
Removed unnecessary parameters from ADPCM-encoded waveform data.
This affects waveforms for bank instruments, wave sounds, and stream sounds.
Note that compatibility is not preserved with old versions of the data or libraries. You must reconvert data when you use version 0.5.0 or later of the NW4C libraries.
Bug Fixes
Fixed a bug that sometimes prevented preprocessor instructions in MUS files from being included in the CSEQ files when NITRO-SoundMaker intermediate files were imported.
Fixed a bug that caused per-region envelope specifications for banks to be lost when NITRO-SoundMaker intermediate files were imported.
Fixed a bug that caused waveform data conversion to fail for some sampling rates.
Bug Fixes
Fixed a bug that caused Sample Maps to be displayed backwards when PCM8 and ADPCM were used as compression formats for the waveform files.
Fixed a bug that caused an error when new sequence sounds were created and thus prevented items from being added.
Fixed the GUI to no longer display unsupported features.
- 3D sounds
- Effects
- SoundPlayer related
- Viewer related
- Preview Player Parameters window
- DLS imports
Added/Modified Functionality
The Register Related Items setting can now be specified from the Create New Group dialog box.
Added a feature that allows projects for other platforms (for example, NintendoWare for Revolution SoundMaker and NITRO-SoundMaker) to be imported.
Such projects can be imported by selecting File > Import > Project from Other Platform. Then, in the Open dialog box, select an .rspj, .sprj, or .sarc file with the Files of type: set to Project from other platform.
In order to support compilation with RVCT, the BOM was removed for CSID files.
Updated the binary waveform file format (.bcwav) in order to support the TEG2 hardware.
To play legacy sounds on a TEG2 board, you'll have to reconvert the Sound Archives.
Bug Fixes
Creating a new bank using the Create New Bank dialog box would create a file with the .rbnk extension, but this bug has been fixed.
If a new instrument was created when there were no items registered in the instrument list, the program number would start from [1] instead of [0]. That has been corrected.
Fixed a bug that prevented users from editing envelopes if an instrument's envelope setting was changed from Specify Envelopes by Instrument to Specify Envelopes by Region, unless the user reopened the project.
Editing an envelope for an instrument in the Parameters panel would cause an exception-type error to occur, but this bug has been fixed.
When sound set files were saved, the sound's Player priorities would not be saved correctly, but this bug has been fixed.
If the Project Tree was minimized while a sound set's name was being edited, the application would stop responding, but this bug has been fixed.
Specifying an item name that didn't exist among the group items used to cause an application error, but this bug has been fixed.
When multiple list items were dragged and dropped, the list order would change in the place where they were moved. The problem was fixed.
When reference waveforms for the sample maps were changed, the folder displayed in the Open File dialog box would not be the folder in which the waveforms are registered. That problem was fixed.
When the File Path list item was changed, the registered file name would not be filled in for Filename in the Open File dialog box. That problem has been fixed.
An exception error would occur after specifying a file by double-clicking in a blank part of the sample map. That problem has been fixed.
An exception error would occur if the Bank tab was closed while in the bank-list editing state. That problem has been fixed.
The names of the items in the Project Settings area of the project file were not being loaded correctly, but this bug has been fixed.
Running a conversion operation would cause all opened bank panels to close, but this bug has been fixed.
Corrected the following bugs in SoundMaker:
- Resizing the main window extremely small and then splitting the main window view would cause an exception-type error.
- After the application would crash as a result of this bug, an error would occur when restarting the application, and the user would be unable to get back into the program.
Update conversion would fail to run after the following operations were done, but this bug has since been fixed.
- Changing the compression format of a stream sound
- Changing a text sequence sound file
- Changing the waveform file referenced by a velocity region
If an error occurred while converting an instrument, the user would not be able to jump to the cause of the error from the Conversion Log pane, but this bug has now been fixed.
Added/Modified Functionality
Added the Register Related Items column to the group items list.
It is now possible to include all related items by changing this setting. For example, you can now register all banks and/or waveform archives referenced by a sequence sound within a group.
If the version of a Project Settings file supported by SoundMaker doesn't match the version of the Project Settings file being loaded, the application will no longer load the settings.
This specification change is a temporary fix; in future versions, it will be possible to load Project Settings files created using older versions of the application.
Bug Fixes
Attempting to open a project when banks are registered in the Preview Bank would always result in an error, after which the project could not be opened. This bug has been fixed.
Fixed a bug that prevented a group's Data Size value from being updated if the Output Method of that group group was set to "Don't output."
If a nested group contained any wave sound sets or a banks for which Waveform Archive was set to Automatic (Shared), a conversion error would occur, but this bug has been fixed.
Fixed a bug in which changing a bank within the Multibank Settings dialog would only change the display without actually changing the data internally.
Added/Modified Functionality
In order to use data that was created with Nintendo 0.2.0 with NintendoWare 0.2.1, keep in mind the following precautions:
- Sound project (.cspj) files can be used without any modification.
- Binary sound archive files (.bcsar) cannot be used. You'll need to reconvert the sound project file.
Added a button to the toolbar of the main window that displays the Preview Bank pane.
If a project file was moved and then reopened, an error message would be displayed, and users were unable to open the project until they deleted the Project Settings file. This bug has been fixed.
The code for creating a new sound set had a bug that prevented waveform archives from displaying in the project tree. This bug also prevented saved projects from being opened, but it has been fixed.
Copy and paste operations in the sequence sound list would cause the bank settings for sequence sounds to become invalid, after which they no longer displayed correctly. This bug has been fixed.
Searches for references to waveform archives would always return zero results in the Search Results pane, but this has been fixed.
It is now possible to perform batch edits on cells within waveform archives that are set to load individually.
MIDI signals received from the device configured in the MIDI Sequencer Input Devices field would not play through preview banks. This bug has been fixed.
Fixed a bug wherein attempts to change banks within sequence sound lists would only change the display without changing the actual banks.
Fixed a bug that prevented waveform archives from being selected In the Create New Group Item dialog box.
The following bugs in SoundMaker have been corrected:
- The names of instruments that are created by dragging and dropping a waveform file into the Bank List did not start with the prefix that the user had specified.
- A warning icon would appear for all items in the percussion list. アイコンが表示されてしまう
The output filenames for binary stream sounds were changed as follows.
- Before the change: (SoundName).(CompressionFormat).bcstm
- After the change: (SoundName).bcstm
Fixed a bug in which, if the user initiated an update and convert operation after changing the output location, some of the files would not be output to the new location.
Fixed a bug in which the items within HTML sound lists would always be output, regardless of whether they were configured for output.
Changes from NintendoWare for Revolution
NW4R SoundMaker projects can be imported.
The project file being imported will remain unaltered after the import operation. Another file (with a separate extension) will be generated for the imported project in the same folder.
The Waveform Archives node was added to the Project Tree.
The Waveform Archive tab can be displayed by double-clicking on the Waveform Archives node.
The Waveform Archive list shows three columns: Name, Load Individually, and Comments.
Right-clicking within the Waveform Archive list and selecting either Add Item or Insert Item will display a dialog box that allows you to enter the name of the new waveform archive, as well as whether it should be loaded individually.
The Waveform Sharing column was removed from the Group List window, and a new Output Method column was added in its place.
The Output Method column is a drop-down list that has three possible values: Embed, Link, and Don't output.
The context menu for Sequence lists now includes Multibank Settings... that opens the Multibank Settings dialog box.
Up to four multibanks can be specified.
Added the Preview Bank window to the preview functionality.
The banks that are registered in this window are used for playing back MIDI signals that are input from the MIDI sequencer.
Changed the method used to configure the MIDI Keyboard Input Device and MIDI Sequencer Input Devices settings.
MIDI signals that are input from the device set in the MIDI Keyboard Input Device field will be played back using the active bank in the Bank tab.
MIDI signals that are input from the device set in the MIDI Sequencer Input Devices field will be played back using the banks in the Preview Bank window.
The active Bank tab now defines which bank input from the MIDI keyboard should be played back with.
If the Bank tab is not active, no sound will be produced.
As a result of this specification change, the instrument display has been removed.
The specifications for previewing playback of sounds and instruments has been revised.
It is now possible to run conversion operations in parallel for sounds that don't have any mutual dependencies.
The number of conversion operations that can be run at the same time can be configured in the Options dialog.
In NW4R SoundMaker, string tables would always be output to sound archives. With NW4C SoundMaker, however, it is possible to disable this feature by deselecting the Output the string table check box under the Sound Archive tab within Project Settings.
If you won't be using strings to make calls to the sounds or other sound-related data in your project, you can reduce the size of your sound archives by disabling output of the string table.
Intermediate binary files will now always be output to the project's cache folder.
However, intermediate text sequence sounds (.cseq files) created from SMF files, as well as include files for banks (.cinl files) will continue to be output in the same directory as the source files.
Changed the format used for the sound archive map files that are generated during conversion. They used to be in text format, but are now in HTML format.
Wave sound sets and sequence sound sets now have item IDs assigned to them.
This change makes it possible to load these items by specifying the appropriate item ID.
The upper 8 bits of the IDs for all sound types (sequence sounds, wave sounds, and stream sounds) and other items in the Project Tree (sequence sound sets, wave sound sets, banks, waveform archives, groups, and Players) are now embedded with information that indicates the item category.
CONFIDENTIAL