SBank: Difference between revisions

From Sierra Wiki
Jump to navigationJump to search
Andrew Branscom (talk | contribs)
Andrew Branscom (talk | contribs)
No edit summary
Line 1: Line 1:
[[Category:Temp Tool Pages]]
<div align="center"><span style="font-size: 22pt">SBank</span><br />''Version 1.10''<br />''Author: [[Jamie O'Connell]]''<br />''Developer: <br />''1992-12-08''</div>
[[Category:Tool Pages to be Edited]]
{{TechToolStub}}


<div align="center"><span style="font-size: 22pt"></span></div>
{{FanSoftwareInfobox
| Software = SBank
| Image =
| Version = 1.10
| ReleaseDate = {{1992}}-12-08<ref>From included SBANK.TXT</ref>
| Company =
| DevStatus = {{UnmaintainedDev}}
| Published = {{Published}}
| Developers = {{JamieO'ConnellToolDev}}
| Interface = {{CLI}}
| ProgLanguage = {{C++}}
| OpenSource =
| Source = {{NoSourceSW}}
| License = {{CopyrightedFreeware}}
| Type = {{FanSndInstrumentLibrarianTool}}, {{FanSndInstrumentConvertorTool}}
| Engine = {{NAEngTool}}
| Platform = {{DOSTool}}
| Localization = {{EnglishTool}}
| Website = {{NAURL}}
}}


<br />
<br />
==<br /> Introduction ==
==<br /> Description ==
 
<blockquote>
Jamie O'Connell's SBank SBANK is a command line librarian - file convertor 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.
</blockquote>
 
==<br /> Features ==
 
<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.
</blockquote>
 
==<br /> Requirements ==
 
<blockquote>
<!-- Add requirements here -->
</blockquote>
 
==<br /> Version History ==
 
<blockquote>
* Changes to SBANK
 
-- 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 convertor 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.
<pre>
-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.
 
-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.
 
-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.
 
-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.
 
-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.</pre>
 
See SBANK.TXT for more information
 
</blockquote>
 
<div id="DL">
==<br /> Download ==
 
<blockquote>
Download from here:
* [[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 ==
 


'''SBank 1.06''' - By [[Jamie O'Connell]]. Manages SoundBlaster and Adlib instrument files and sound banks. It will translate between .INS, .SBI, InsMaker's .BNK, and Sound Blaster's .IBK files. It will also report instrument names stored in bank files and display musical parameters contained in the instrument definitions. See included doc for usage.


==<br /> References ==
==<br /> References ==


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


==<br /> Related Links ==
==<br /> Also See ==


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

Revision as of 19:14, 12 July 2025

SBank
Version 1.10
Author: Jamie O'Connell
Developer:
1992-12-08
  This article is a tool stub page. You can
help the Sierra Wiki by expanding it.
SBank
Latest Version:  1.10
Release Date:  1992-12-08[1]
Company:
Development Status:  Unmaintained
Publication Status:  Published
Developer(s): Jamie O'Connell
Interface: CLI
Language: C++
Open Source:
Source Availability:  No
License: Copyrighted Freeware
Type: Template:FanSndInstrumentLibrarianTool, Template:FanSndInstrumentConvertorTool
Relevant Engine: N/A
Platform: DOS
Localization: English
Website: N/A




Description

Jamie O'Connell's SBank SBANK is a command line librarian - file convertor 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.


Features

  • 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.


Requirements


Version History

  • Changes to SBANK

-- 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 convertor 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 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.

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

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

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

 -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:


Known Issues


Credits

Jamie O'Connell


Legal


References

  1. ↑ From included SBANK.TXT


Also See