This program performs according to the documentation herein. I cannot be responsible or liable for data corruption or emotional distress which the program may have caused through misuse or usage for which it was not intended.
This program contains
Psome
proprietary information and applicable rights are reserved. To the best of my knowledge, no copyrights or licenses have been infringed by this program.
This program is not for sale and is not shareware, and may be copied and distributed for free.
March, 1992
INTRODUCTION
@geoCZLIBRARIAN v2.0
is a four-bank MIDI patch librarian for the Casio
@ CZ-series
of synthesizers
Effects (Tone Mix, Bend Range, etc), sequencer data, and
@CZ-1
operation memory and keyboard set-ups are
supported..
@All versions of geoCZLIBRARIAN to date require a Passport-compatible MIDI interface.
geoCZLIBRARIAN supports a Ram Expansion Unit (REU)---but not GEORAM---providing you are
@also
using a cartridge-port
@expander
(i.e, Aprospand) to accomodate
@both
the REU and the MIDI interface simultaneously.
Version 2.0 supports data files created with all v1.x versions. However, there are some radical enhancements in appearance and operations since v1.4, so. . .
@ Please be sure to read all of the information in these instructions.
@OVERVIEW
Before running, make sure:
your synthesizer is
the
@write protect switch
the proper
@MIDI
connections have been made
your CZ is set to MIDI channel 1
@Failure to do the above will crash the program!
@Bank A
is selected on start up, indicated by its reverse video header and display in the STATUS box. Only one of the four banks can be used at a time. Change among the banks by pressing the Bank-select shortcuts
@C=A, C=B, C=C,
You can change the Bank in-use at any time after the completion of an Operation.
There are twelve
@Operation
@Icons
explained later.
Exit the program by selecting
@quit
in the
@geos
menu, or
@C=Q.
geoCZLIBRARIAN
files are not automatically updated to disk. Unless your data have been saved to disk, they will be lost by
@quit
@MIDI INTERFACES AND CHANNEL SELECTION
There are essentially thre
@MIDI INTERFACES AND CHANNEL SELECTION
There are essentially three standard types of MIDI interfaces, the Passport-type, Sequential-type, and Datel/SIEL-type. But because GEOS uses addresses required by
@Sequential- and Datel-type
interfaces they
cannot
be used by this program. Only
Passport-type
interfaces will work.
If the MIDI interface is inaccessible, "NO" appears in the STATUS box. At any time you can confirm the status of the interface by pressing
. This will allow you to activate the interface without having to exit the program.
Before any operation that requires MIDI transmission, the interface status is checked and displayed in the STATUS box. However, you can still perform disk and other internal routines without an interface.
Refer to Error Trapping section below.
To change the MIDI channel
, press
to increase the MIDI channel by 1, from 1 to 16. It will be displayed in the Status Box. The default channel at start-up is 1, as it is on the CZ.
This is a convenient feature if you have more than one CZ in your set up, allowing you to transmit data without cable swapping. However, you MUST make sure the proper MIDI connections to your CZs have been made, ie: MIDI INs and MIDI OUTs of all devices are connected to the interface through a MIDI matrix or mixer hardware device.
@Be CERTAIN that after setting the MIDI channel on geoCZLIBRARIAN the CZ is set to the same channel. Failure to do so will crash the program.
@BANK CONFIGURATION
geoCZLIBRARIAN follows the
@CZ101/1000
configuration of Memory Banks: sixteen-patches-per-bank x two banks. The
@CZ3000/5000
are somewhat different: eight-patches-per-bank x eight-banks. Due to this configuration, geoCZLIBRARIAN
can only access patches in two of the CZ3000/5000's internal banks:
geoCZLIBARARIAN & CZ101/1000
CZ3000/5000
Internal 1-16 = Memory A-1 thru B-8
geoCZLIBRARIAN
can only
access
patches in CZ3000/5000 Memory Bank A thru B. The Compare/Recall sound area and Cartridge Memory configuration are the same on all CZ devices. Preset patches are not accessible.
@FILE MANIPULATION
The Librarian works with two types of CZ data files, its own
@geoCZ-type
and standard
@ "CZ."-type.
geoCZ
Application Data file
is created by geoCZLIBRARIAN when data is
@saved
by the program. Like any GEOS Application Data file it has a GEOS header and icon, Write Protect, date, and info box access, and looks like this on the deskTop:
This type of file
cannot
be converted to a "CZ"-type data file by the Librarian, nor loaded by non-GEOS librarians.
Note that disk file data is
@copied
into the Librarian. When working on a loaded file, you are not altering the file on the disk. In order to preserve changes you have made with the Librarian you
@must
save the changed data back to disk.
"CZ."-type
CZ data file
refers to the type of sequential data file created by non-GEOS CZ librarians, so-called here because of the "CZ." prefixed filenames, sometimes called "Dr.T", CZPL, or CZSL format. Many Commodore CZ librarians save data in this format.
"CZ."-type data files can only be imported for conversion from the drive/device #8, which must be a
@1541
. In order for GEOS to access files from this drive, the GEOS Turbo has to be "purged" from the drive. I was unable to do this with the REU, nor do I believe it can be done. Secondly, your stash of "CZ." files are presumably already on disk---how would they get into the REU?
@geoCZLIBRARIAN can load both file formats, but will only save data as a geoCZ-type.
To import
"CZ."-type
patch files:
Click on the
@file
menu and select
@Open CZ. file
, or press
@ C=O.
You will be instructed to insert a disk of "CZ."-prefixed files (CZPL or CZSL format) in drive A, which
be a
@1541
. The selected "CZ." file will be converted and loaded into the current in-use Bank. You should then save it as a
@geoCZ
file. The original "CZ." file will not be destroyed. See notes above on File Manipulation.
@USING THE PROGRAM
@USING THE PROGRAM
Select the Bank you wish to work with by pressing the Bank-select shortcuts
@C=A, C=B, C=C, or C=D. Bank A
is chosen on start up.
Choose an
@Operation
by clicking on the appropriate Icon. During most Operations, "WORKING" appears in reverse video in the status box to let you know there is activity. When "WORKING" disappears, the Operation is completed.
Below are the
@Operation Icons
and their descriptions:
@ Get
@nternal bank
Get
@artridge bank
Get patch (#)
Get the designated bank, or a specified patch from the CZ.
Patches loaded from the CZ's Internal and Cartridge banks are labeled "*** ? ***", and banks named "INTERNAL+" and "CARTRIDGE+".
@ Send bank to
@nternal
Send bank to
@artridge
Send patch (#)
Transmit the current Bank in-use, or an individual patch from the Bank in-use, to the CZ.
@ Rename
Rename a patch from the in-use Bank.
@ Swap
Swap two patches between two---or within one---loaded Banks.
@
@Load
Load a
@geoCZ
file into the current in-use Bank
@
@Load
Load a
@geoCZ
file into the current in-use Bank from disk.
@Save
Save the current in-use Bank to disk as a
@geoCZ
file.
@Audition
Select a patch to be sent to the Compare/Recall slot of the CZ, so you can immediately "audition" it on the keyboard. None of the CZ's other data is disturbed.
@Print
Print the currently selected bank in your printer's
@draft
mode. The filename and its sixteen patch names will be printed vertically.
@Your GEOS printer driver must be in the same drive as geoCZLIBRARIAN.
@ERROR TRAPPING
In the interest of data safety, several error traps and fail safes have been put in place.
If a MIDI interface is inaccessible, MIDI transmission operations will be prohibited. These include the send and retrieve data routines and Audition.
The disk routines Load, Save, Convert, and the internal routines Swap, Rename, and Print remain functional without an interface.
If a selected Librarian Bank has yet to be loaded, MIDI transmission of that bank's data
the CZ will be prohibited. The Save to Disk, Rename, Print, or Swap routines will also be inoperative. This is to ensure that "blank" data is not transmitted or saved. It could "re-arrange" internal data of the CZ.
Disk errors will result in a message box, and the operation canceled.
@Depending on the severity of the error, data could be destroyed.
If you enter values in a Dialog Box which are out of range, you will be re-presented that Dialog Box to re-enter correct information, or Cancel.
WARNING
@THERE IS NO CHECK TO SEE IF YOUR CZ IS
@ OR
HCONNECTED
@, OR IF THE CZ'S MIDI CHANNELS
HRECONCILE
@, OR IF THE
HCZ'S WRITE PROTECT SWITCH IS OFF
HYOU
H DO THIS YOURSELF
@!!!
@ADDENDA
1) geoCZLIBRARIAN was conceived for a
@drive
system, with a
@1541
disk drive as device #8 and a Ram Expansion Unit or second drive as device #9. "CZ."-type files can only be imported from device #8, which must be a
@1541
. This is a 40-column mode program, and has not been tested on the 128.
@The REU.
There have been some questions about how a REU and MIDI interface can work simultaneously using a cartridge port expander. Frankly, I'm unsure myself. I put my interface in slot 1 and the REU in slot 2. I leave the slots switched on all the time. The MIDI interface has no affect on normal GEOS operations, and I have never had a problem that I'm aware of.
GEORAM cannot be used for MIDI applications. Periferals such as RAMLINK, and OS's like GATWAY have not been tested.
3) Some MIDI routines in this program are based on Alan Bland's public domain CZPL/CZSL librarians. Distinctive sub-routines courtesy of Bill Coleman's BLASTERPAK, of which I am a registered possessor.
Many thanks
to Jim Collette for answers to my early geosImponderables.
Make sure your CZ is
. Make sure your CZ's write-protect switch is
@off.
Make sure your MIDI cables are plugged in correctly. Make sure MIDI channel settings agree. These oversights will
@definetly
crash the program.
5) Look for my other GEOS/MIDI and music programs: geoCZEDITOR and CZ AUDITION, geoCHORD, and CALCBEAT.