View source for SBank

<div align="center"><span style="font-size: 22pt">SBank</span><br />''Version 1.51''<br />''Author: [[Jamie O'Connell]]''<br />''1994-02-11''</div></div>

{{SoftwareInfobox
| Software = SBank
| Image = 
| Version = 1.51
| ReleaseDate = {{1994}}-02-11<ref>From included SBANK.TXT</ref>
| Company = {{NAToolCo}}
| DevStatus = {{UnmaintainedDev}}
| Published = {{Published}}
| Developers = {{JamieO'ConnellToolDev}}
| Interface = {{CLI}} {{NAInterface}}
| ProgLanguage = {{C++}}
| OpenSource = {{ClosedSRC}}
| Source = {{NoSourceSW}}
| License = {{CopyrightedFreeware}}
| Type = {{InstrumentLibrarianTool}}, {{InstrumentConvrtr}}, {{PatConvrtr}}
| Engine = {{NAEngTool}}
| Platform = {{DOSTool}}
| Localization = {{EnglishTool}}
| Website = {{NAURL}}
}}

<br />
==<br /> Description ==

<blockquote>
Jamie O'Connell's SBank is a command line utility for managing Sound Blaster and  Adlib  instrument files and sound  banks.  It  will translate  between .INS, .SBI, .BNK, and .IBK  files.  In addition, it will report instrument names stored in  bank files,  and  display musical parameters contained  in  the instrument definitions.
</blockquote>

==<br /> Features ==

<blockquote>
SBANK is a command line utility for managing Sound Blaster and  Adlib  instrument files and sound  banks. Compatible with the Sound Blaster and Adlib music cards. It  will translate  between .INS, .SBI, .BNK, and .IBK  files.  In addition, it will report instrument names stored in  bank files,  and  display musical parameters contained  in  the instrument definitions.
</blockquote>

==<br /> Requirements ==

<blockquote>
<!-- Add requirements here -->
</blockquote>

==<br /> Version History ==

<blockquote>
Changes to SBANK

-- Version 1.51

94-02-11 

-- Version 1.10

92.12.08 Fix Bank View display for non-bank files

-- Version 1.09

92.06.29 Reformatted Parameter display -- Information is easier to read.

-- Version 1.08

92.06.25 It seems that CL is now using the 12th byte of the Timbre record
     to store a percussive voice. Zero means melodic, any other
     value is the voice number of the instrument.

-- Version 1.07

92.06.02 Added Generation of underbars for Timbre names containing spaces.
     The underbars are only used when outputting a DOS filename (SBI, 
     INS files).

-- Version 1.06

91.09.21 Added the -I ListFName option for translating bankfiles. 
     Removed the -Q option (too unclean for a command line utility).

-- Version 1.05

91.08.11 After experimentation, it was felt that it would be better to
     copy the Op0 parameters to the Op1 parameters instead of
     zeroing out the Op1 parameters (percussion mode). Fixed
     many small annoying bugs. Changed the format for parameter
     display.

-- Version 1.04

91.04.12 Made several performance enhancements. Corrected error messages.
     Cleaned up the code.

-- Version 1.03

91.02.03 Facilitated zeroing out the carrier parameters when writing an
     IBK or SBI instrument (they have no way of storing PERC info)
</blockquote>

==<br /> Development Status ==

<blockquote>
Jamie O'Connell's SBank SBANK is a command line librarian - file Converter for instruments 
and sound banks compatible with the Sound Blaster and Adlib music 
cards. See the SBANK.TXT text file for information on how to use it. SBank is no longer actively maintained.
</blockquote>

==<br /> Usage ==

<blockquote>
<pre>SBANK BankFile [-AUMDXLVSTI?] [BankFile|Instrument...]

   BankFile    is the name or path of a BNK or IBK instrument
          bankfile -- It will be created if appropriate.
   Instrument   is the name of an instrument or the name or 
          path of an .INS or .SBI instrument file.</pre></blockquote>

==<br /> Options ==

<blockquote>
Option letters are case insensitive and may be preceded by either - or /.  They specify the operations to perform.<code>
{|
| width="25"| -A || append the specified instruments (INS or SBI files) to the named bank file. Wildcards (* and ?) may be used to select the instrument files. The bank file is created if it does not exist. Duplicate instrument names in the bank file are not updated unless the| -U option also appears.
|- valign="top"
| -U || update the specified existing instruments in the named bank file. Wildcards are allowed. Specified instruments that do not exist are not added unless the| -A option also appears.
|- valign="top"
| -M || move the specified instruments to the named bank file. Specifying| -M implies both append and update. After a successful insertion, the instrument file is deleted. Wildcards are allowed.
|- valign="top"
| -D || delete and discard the named instruments from the bank file. This can be used with the| -X option to remove an instrument from a bank file.
|- valign="top"
| -X || extract the named instruments from the bank file. The type of instrument file to create is determined from the filename suffix.
|- valign="top"
| -L || list the names of the instruments contained in the bank file. This option formats the names one per line. Only instrument names are displayed. It is useful for creating input for command line filters or file redirection.
|- valign="top"
| -V || list the names of the instruments contained in the bank file. The instruments are formatted eight names to a line in the same order they are encountered in the bank file. For a BNK file, they will be sorted alphabetically; for an IBK bank, they are presented in the order they were appended. This is also the order of increasing MIDI program change numbers.
|- valign="top"
| -S || show the parameters for an instrument or instruments. This option formats and displays the parameters that comprise the instrument sound.
|- valign="top"
| -T || translate from one file type to another. For this option the first named file is the source and the second is the target. This is the only option that will operate between instrument files as well as between bank files. If the source and target are bank files, this option acts as a merge command, merging the source into the target; and the -I ListFile option may be used to select instruments to translate.
|- valign="top"
| -I || FName specifies an ASCII text file containing a list of instrument names to be used when translating between two bank files. This file should be formatted with one instrument name per line. The -L option will output a list in the proper format, which may be redirected to a file, and then edited (See Examples).
|- valign="top"
| -? || display brief help information.
|}</code>
See SBANK.TXT for more information
</blockquote>

<div id="DL">

==<br /> Download ==

<blockquote>
Download from here:<br />
'''SBank 1.51:'''
* [[Image:ZIP.png|ZIP File]] [[File:SBANK151.zip|SBANK151.zip]] <span class="DLInfo"> (ZIP file) [24.2 KB]</span><br /><blockquote>'''SBank 1.10:'''</blockquote>
** [[Image:ZIP.png|ZIP File]] [[File:SBANK110.zip|SBANK110.zip]] <span class="DLInfo"> (ZIP file) [24.5 KB]</span>
</blockquote>

==<br /> Known Issues ==



==<br /> Credits ==

* [[Jamie O'Connell]]

==<br /> Legal ==



==<br /> References ==

<references /><!-- Do not edit this section. It is autopopulated by <ref></ref> tags -->

==<br /> Also See ==

* [[:Category:Sound Instrument Librarians|Instrument Librarians]]
* [[:Category:Instrument Converters|Instrument Converters]]
* [[:Category:Patch Converters|Patch Converters]]
* [[SCI Specifications: Chapter 1 - Introduction#SND| in the SCI Specifications]]
* [[:Category:Sound Resources|Sound Resource Articles]]
&nbsp;
[[Category:Technical Info]]
[[Category:Development]]
[[Category:Development Tools]]
[[Category:General Tools]]
[[Category:Sound Resources]]