SBank: Difference between revisions

From Sierra Wiki
Jump to navigationJump to search
Andrew Branscom (talk | contribs)
Andrew Branscom (talk | contribs)
 
(47 intermediate revisions by the same user not shown)
Line 1: Line 1:
<div align="center"><span style="font-size: 22pt">SBank</span><br />''Version 1.51''<br />''Author: [[Jamie O'Connell]]''<br />''Developer: N/A<br />''1994-02-11''</div>
<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>
{{TechToolStub}}


{{FanSoftwareInfobox
{{SoftwareInfobox
| Software = SBank
| Software = SBank
| Image =  
| Image =  
| Version = 1.51
| Version = 1.51
| ReleaseDate = {{1994}}-02-11<ref>From included SBANK.TXT</ref>
| ReleaseDate = {{1994}}-02-11<ref>From included SBANK.TXT</ref>
| Company = {{N/A}}
| Company = {{NAToolCo}}
| DevStatus = {{UnmaintainedDev}}
| DevStatus = {{UnmaintainedDev}}
| Published = {{Published}}
| Published = {{Published}}
| Developers = {{JamieO'ConnellToolDev}}
| Developers = {{JamieO'ConnellToolDev}}
| Interface = {{CLI}}
| Interface = {{CLI}} {{NAInterface}}
| ProgLanguage = {{C++}}
| ProgLanguage = {{C++}}
| OpenSource = {{ClosedSRC}}
| OpenSource = {{ClosedSRC}}
| Source = {{NoSourceSW}}
| Source = {{NoSourceSW}}
| License = {{CopyrightedFreeware}}
| License = {{CopyrightedFreeware}}
| Type = {{FanInstrumentLibrarianTool}}, {{FanInstrumentConvertorTool}}
| Type = {{InstrumentLibrarianTool}}, {{InstrumentConvrtr}}, {{PatConvrtr}}
        {{FanSndInstrumentLibrarianTool}}, {{FanSndInstrumentConvertorTool}}
| Engine = {{NAEngTool}}
| Engine = {{NAEngTool}}
| Platform = {{DOSTool}}
| Platform = {{DOSTool}}
Line 34: Line 32:


<blockquote>
<blockquote>
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.
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>
</blockquote>


Line 99: Line 97:


<blockquote>
<blockquote>
Jamie O'Connell's SBank SBANK is a command line librarian - file convertor for instruments  
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  
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.
cards. See the SBANK.TXT text file for information on how to use it. SBank is no longer actively maintained.
Line 112: Line 110:
           bankfile -- It will be created if appropriate.
           bankfile -- It will be created if appropriate.
   Instrument  is the name of an instrument or the name or  
   Instrument  is the name of an instrument or the name or  
           path of an .INS or .SBI instrument file.</pre>
           path of an .INS or .SBI instrument file.</pre></blockquote>
</blockquote>


==<br /> Options ==
==<br /> Options ==


<blockquote>
<blockquote>
Option letters are case insensitive and may be preceded by
Option letters are case insensitive and may be preceded by either - or /.  They specify the operations to perform.<code>
either - or /.  They specify the operations to perform.
{|
<pre>
| 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.
-A append the specified instruments (INS or SBI files) to
|- valign="top"
  the named bank file. Wildcards (* and ?) may be used  
| -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.
  to select the instrument files. The bank file is created  
|- valign="top"
  if it does not exist. Duplicate instrument names in the  
| -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.
  bank file are not updated unless the -U option also appears.
|- 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.
-U update the specified existing instruments in the named
|- valign="top"
  bank file. Wildcards are allowed. Specified instruments
| -X || extract the named instruments from the bank file. The type of instrument file to create is determined from the filename suffix.
  that do not exist are not added unless the -A option also
|- valign="top"
  appears.
| -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"
-M move the specified instruments to the named bank file.
| -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.
  Specifying -M implies both append and update. After a
|- valign="top"
  successful insertion, the instrument file is deleted.
| -S || show the parameters for an instrument or instruments. This option formats and displays the parameters that comprise the instrument sound.
  Wildcards are allowed.
|- 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.
-D delete and discard the named instruments from the bank
|- valign="top"
  file. This can be used with the -X option to remove an
| -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).
  instrument from a bank file.
|- valign="top"
 
| -? || display brief help information.
-X extract the named instruments from the bank file. The
|}</code>
  type of instrument file to create is determined from the
  filename suffix.
 
-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.
 
-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.
 
-S show the parameters for an instrument or instruments.
  This option formats and displays the parameters that
  comprise the instrument sound.
 
-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.
 
-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).
 
-? display brief help information.</pre>
 
See SBANK.TXT for more information
See SBANK.TXT for more information
</blockquote>
</blockquote>


Line 189: Line 147:


<blockquote>
<blockquote>
Download from here:
Download from here:<br />
'''SBank 1.51:'''
'''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:SBANK151.zip|SBANK151.zip]] <span class="DLInfo"> (ZIP file) [24.2 KB]</span><br /><blockquote>'''SBank 1.10:'''</blockquote>
Line 201: Line 159:
==<br /> Credits ==
==<br /> Credits ==


[[Jamie O'Connell]]
* [[Jamie O'Connell]]


==<br /> Legal ==
==<br /> Legal ==
Line 213: Line 171:
==<br /> Also See ==
==<br /> Also See ==


* [[:Category:Sound Instrument Librarian Tools|Sound Instrument Librarian Tools]]
* [[:Category:Sound Instrument Librarians|Instrument Librarians]]
* [[:Category:Sound Instrument Convertor Tools|Sound Instrument Convertor Tools]]
* [[:Category:Instrument Converters|Instrument Converters]]
* [[:Category: Tools| Tools]]
* [[:Category:Patch Converters|Patch Converters]]
* [[Sound Resource (SCI)]]
* [[SCI Specifications: Chapter 1 - Introduction#SND| in the SCI Specifications]]
* [[SCI Specifications: Chapter 1 - Introduction#SND| in the SCI Specifications]]
* [[:Category:Sound Resources|Sound Resource Articles]]
* [[:Category:Sound Resources|Sound Resource Articles]]
Line 223: Line 180:
[[Category:Development]]
[[Category:Development]]
[[Category:Development Tools]]
[[Category:Development Tools]]
[[Category:General Tools]]
[[Category:Sound Resources]]
[[Category:Sound Resources]]
[[Category:General Tools]]

Latest revision as of 22:45, 16 September 2025

SBank
Version 1.51
Author: Jamie O'Connell
1994-02-11
SBank
Latest Version:  1.51
Release Date:  1994-02-11[1]
Company: N/A
Development Status:  Unmaintained
Publication Status:  Published
Developer(s): Jamie O'Connell
Interface: CLI N/A
Language: C++
Open Source: Closed
Source Availability:  No
License: Copyrighted Freeware
Type: Instrument Librarian, Instrument Converter, Patch Converter
Relevant Engine: N/A
Platform: DOS
Localization: English
Website: N/A




Description

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.


Features

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.


Requirements


Version History

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)


Development Status

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.


Usage

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.


Options

Option letters are case insensitive and may be preceded by either - or /. They specify the operations to perform.

-A -U option also appears.
-U -A option also appears.
-M -M implies both append and update. After a successful insertion, the instrument file is deleted. Wildcards are allowed.
-D -X option to remove an instrument from a bank file.
-X extract the named instruments from the bank file. The type of instrument file to create is determined from the filename suffix.
-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.
-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.
-S show the parameters for an instrument or instruments. This option formats and displays the parameters that comprise the instrument sound.
-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.
-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).
-? display brief help information.

See SBANK.TXT for more information


Download

Download from here:
SBank 1.51:


Known Issues


Credits


Legal


References

  1. ↑ From included SBANK.TXT


Also See