Utilities

Table of Contents
2music
(Professional Edition only)


This program is designed for converting MIDI files to MUSIC files of a Cybiko computer. It is the most recent successor of 2mus.exe, with advanced algorithms and extra functionality.

USAGE:      2music <input_file>.mid <input_file>.music [/v=] [/t=] [/a=] [/i= /i= /i= ...] [/strict]
OR             2music <input_file>.mid \info=[full | brief]

   /v=
method of conversation (1 or 2):
  1 - the highest note is chosen from two simultaneously played notes.
  2 - the latest pressed note is chosen from two simultaneously played notes.


   /t=
transposition (note shift)(-127 ... +127) in semitones.


   /a=
turn autotransposition on (a=1) or turn off (a=0).
When autotransposition is on playing notes out of Cybiko computer sound range is prevented.


   /i=
instrument numbers to be converted (i < 256). If not selected all instruments will be converted.


   /strict=
if this option is turned on, MIDI files with errors are not converted and warning messages are displayed. if this option is turned off, all MIDI files with are converted, but there is slight possibility of incorrect conversion.


   /info=
run in full (info=full) or brief (info=brief) info mode to obtain track comments
Default settings: /v=1 /t=0 /a=1. If no tracks are selected? all tracks are to be converted.

Examples:
   2music chimes.mid chimes.music /v=1 /t=10 /a=1 /i=1 /i=2 /i=14
   2music chimes.mid /info=full /strict

2mus

The Cybiko SDK lets you work with sound effects and musical fragments, either stored in an application or in a file in internal sound format (*.mus). This utility converts from standard MIDI format to CYBIKO's internal sound effects format.

USAGE:      2mus [-option [-option...]] <input_file>.mid
   -b#[:##]
force ##-tick ( or 1-tick ) breaks after each #-th tick of a note.


   -i
enable .mid input file listing.


   -o
enable optimizations.


   -s[#]
separate same adjacent notes with # ( 1 if omitted ) ticks.


   -t[#]
transpose all notes by # ( AUTO if zero or omitted ) semitones.


   -u
enable .mus output file listing.


   <input_file>.mid
standart MIDI sequence file.
This utility creates <input_file>.mus which can be added to the application resources by filer utility.



mus2txt

This utility converts CYBIKO internal sound effects format to MIDI sequence text format.

USAGE:       mus2txt <infile>.mus <outfile>.txt
   <infile>.mus
internal CYBIKO format of sound effects.


   <outfile>.txt
text MIDI sequence Type 0 format.
You can use the freeware t2mf filter to convert <output>.txt to MIDI Type 0 file. For full description of this format see t2mf.



t2mf

This freeware utility converts MIDI sequence text files to standard MIDI sequence Type 0 files.

USAGE:       t2mf <<input>.txt> <output>.mid

   <input>.txt
text MIDI sequence Type 0 format.


   <output>.mid
standard MIDI sequence file.
See also mus2txt.



2pic

Cybiko SDK lets you work with lists of pictures, which can be composed from standard graphics files (currently only *.bmp, *.dib , *.fli, *.flc and *.cel formats are supported). All CYBIKO picture lists can contain from 1 to 255 pictures. Maximum resolution of each picture is 255 by 255 pixels with 4-bit color (WHITE, LIGHT GRAY, DARK GRAY, BLACK). One color can be marked as transparent color.

USAGE:       2pic [<mode>] <ofile>[.pic] <ifile>.{bmp|dib|fli|flc|cel}[<ifile> [...]]

   <ofile>[.pic]
CYBIKO picture list file.


   <ifile>.{bmp|dib|fli|flc|cel
standard graphics files.


   <mode>
0 - 2-bit bitmap, use WHITE as transparent color.
1 - 2-bit bitmap, use LIGHT GRAY as transparent color.
2 - 2-bit bitmap, use DARK GRAY as transparent color.
3 - 2-bit bitmap, use BLACK as transparent color.
-f - 1-bit font, treat WHITE as transparent and BLACK as opaque.
-p - 1-bit font, treat both WHITE and BLACK as opaque.
<ofile>[.pic] can be added to the application resources by filer utility.



filer

This is the CYBIKO compressor and archive utility. Files added to application resources (such as music, graphics or arbitrary data) can be used from the application using filename or resource ID.
To decrease the size of the application, files can be compressed by filer.

USAGE:      filer <command> <archive> [[<prefix>]<file1> [...]]]

   <command> is one of the following:
a - add files (create archive).
p - paranoid (same as above but unpacks and compares files afterwards).
e - extract files (unpack archive).
l - list files (display contents of archive).
[[<prefix>]<file1> [...]]] is list of the files.

   <prefix> (more than one prefix allowed, in any order):
@ - this file is actually a list (read and process its contents). See packlist.
+ - compress this file (even if '-' applied to the list).
- - do not compress this file (even if '+' applied to the list).
* - do not store file name (will be accessible by index only).
? - do not store file extension (but store name).
# - ignore file (this character starts comments in list files).

pack list

This utility creates a pack list file, which can be used as input to filer.

USAGE:      packlist <listfile> <filename1> [ <filename2> [ ... ]]

   <listfile>
<filename1> [ <filename2> [ ... ]]


   <filename1> [ <filename2> [ ... ]]
list of the files.

vrm

vrm removes files specified by "names". The read-only files are not removed unless the "-f" option is supplied.

USAGE:      vrm [-f] <names>

   <names>
Specifies a list of one or more files or directories. Wildcards may be used to delete multiple files.


    -f
remove readonly files.