home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / GEOSApps / CZLIBV2.0.SFX / czlibv2.0docs (.txt) < prev   
GEOS ConVerT  |  1992-05-16  |  17KB  |  248 lines

  1. CZLIBv2.0docs
  2. PRG formatted GEOS file V1.0
  3. Comm. Compat.
  4. REDRAW
  5. BLASTER'S CONVERTER V2.5
  6. CZLIBV2.0DOCS
  7. MOUSERlink
  8. Write Image V2.0
  9. geoWrite    V2.1
  10. .Documentation for CZLIBRARIAN V2.0
  11. 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.
  12. This program contains 
  13. Psome
  14.  proprietary information and applicable rights are reserved. To the best of my knowledge, no copyrights or licenses have been infringed by this program.
  15. This program is not for sale and is not shareware, and may be copied and distributed for free.
  16. March, 1992
  17. INTRODUCTION
  18. @geoCZLIBRARIAN v2.0
  19.  is a four-bank MIDI patch librarian for the Casio
  20. @ CZ-series
  21.  of synthesizers
  22. Effects (Tone Mix, Bend Range, etc), sequencer data, and 
  23. @CZ-1
  24.  operation memory and keyboard set-ups are 
  25.  supported.. 
  26. @All versions of geoCZLIBRARIAN to date require a Passport-compatible MIDI interface. 
  27.     geoCZLIBRARIAN supports a Ram Expansion Unit (REU)---but not GEORAM---providing you are 
  28. @also
  29.  using a cartridge-port 
  30. @expander
  31.  (i.e, Aprospand) to accomodate 
  32. @both
  33.  the REU and the MIDI interface simultaneously. 
  34. 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. . . 
  35. @    Please be sure to read all of the information in these instructions.
  36. @OVERVIEW
  37. Before running, make sure:
  38.  your synthesizer is 
  39.  the 
  40. @write protect switch
  41.  the proper 
  42. @MIDI
  43.  connections have been made
  44.  your CZ is set to MIDI channel 1
  45. @Failure to do the above will crash the program!
  46. @Bank A
  47.  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 
  48. @C=A, C=B, C=C, 
  49. You can change the Bank in-use at any time after the completion of an Operation. 
  50.         There are twelve 
  51. @Operation
  52. @Icons
  53.  explained later.
  54.     Exit the program by selecting 
  55. @quit
  56.  in the 
  57. @geos
  58.  menu, or 
  59. @C=Q.
  60.  geoCZLIBRARIAN
  61. files are not automatically updated to disk. Unless your data have been saved to disk, they will be lost by 
  62. @quit
  63. @MIDI INTERFACES AND CHANNEL SELECTION
  64. There are essentially thre
  65. @MIDI INTERFACES AND CHANNEL SELECTION
  66. 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 
  67. @Sequential- and Datel-type
  68.  interfaces they 
  69. cannot
  70.  be used by this program. Only 
  71. Passport-type
  72.  interfaces will work.
  73. 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 
  74. . This will allow you to activate the interface without having to exit the program.
  75. 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. 
  76. Refer to Error Trapping section below.
  77. To change the MIDI channel
  78. , press 
  79.  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. 
  80. 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.
  81. @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.       
  82. @BANK CONFIGURATION
  83. geoCZLIBRARIAN follows the 
  84. @CZ101/1000
  85.  configuration of Memory Banks: sixteen-patches-per-bank x two banks. The 
  86. @CZ3000/5000
  87.  are somewhat different: eight-patches-per-bank x eight-banks. Due to this configuration, geoCZLIBRARIAN
  88. can only access patches in two of the CZ3000/5000's internal banks:
  89. geoCZLIBARARIAN & CZ101/1000
  90.         
  91. CZ3000/5000
  92.   Internal 1-16                                                = Memory A-1 thru B-8
  93.                     
  94. geoCZLIBRARIAN
  95. can only 
  96. access
  97.  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. 
  98. @FILE MANIPULATION
  99. The Librarian works with two types of CZ data files, its own 
  100. @geoCZ-type
  101.  and standard
  102. @ "CZ."-type.
  103. geoCZ
  104.  Application Data file
  105.  is created by geoCZLIBRARIAN when data is 
  106. @saved
  107.  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:
  108. This type of file 
  109. cannot
  110.  be converted to a "CZ"-type data file by the Librarian, nor loaded by non-GEOS librarians.
  111. Note that disk file data is 
  112. @copied
  113.  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 
  114. @must
  115.  save the changed data back to disk. 
  116. "CZ."-type
  117.  CZ data file
  118.  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. 
  119. "CZ."-type data files can only be imported for conversion from the drive/device #8, which must be a 
  120. @1541
  121. . 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?
  122. @geoCZLIBRARIAN can load both file formats, but will only save data as a geoCZ-type.
  123. To import 
  124. "CZ."-type
  125.  patch files:
  126.  Click on the 
  127. @file
  128.  menu and select 
  129. @Open CZ. file
  130. , or press
  131. @ C=O. 
  132. You will be instructed to insert a disk of "CZ."-prefixed files (CZPL or CZSL format) in drive A, which 
  133.  be a 
  134. @1541
  135. . The selected "CZ." file will be converted and loaded into the current in-use Bank. You should then save it as a 
  136. @geoCZ
  137.  file. The original "CZ." file will not be destroyed. See notes above on File Manipulation.
  138. @USING THE PROGRAM
  139.                                
  140. @USING THE PROGRAM
  141.                                                   
  142.     Select the Bank you wish to work with by pressing the Bank-select shortcuts 
  143. @C=A, C=B, C=C, or C=D. Bank A
  144.  is chosen on start up.
  145.     Choose an 
  146. @Operation
  147.  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.
  148.     Below are the 
  149. @Operation Icons
  150.  and their descriptions:
  151. @    Get 
  152. @nternal bank
  153.      Get 
  154. @artridge bank
  155.     Get patch (#)
  156. Get the designated bank, or a specified patch from the CZ. 
  157.     Patches loaded from the CZ's Internal and Cartridge banks are labeled "*** ? ***", and banks named "INTERNAL+" and "CARTRIDGE+". 
  158. @    Send bank to 
  159. @nternal 
  160.     Send bank to 
  161. @artridge
  162.     Send patch (#)
  163. Transmit the current Bank in-use, or an individual patch from the Bank in-use, to the CZ. 
  164. @    Rename
  165. Rename a patch from the in-use Bank. 
  166. @    Swap
  167. Swap two patches between two---or within one---loaded Banks.
  168. @                                            
  169. @Load 
  170.     Load a 
  171. @geoCZ
  172.  file into the current in-use Bank
  173. @                                            
  174. @Load 
  175.     Load a 
  176. @geoCZ
  177.  file into the current in-use Bank from disk.
  178. @Save 
  179. Save the current in-use Bank to disk as a 
  180. @geoCZ 
  181. file.
  182. @Audition
  183. 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.
  184. @Print
  185. Print the currently selected bank in your printer's 
  186. @draft
  187.  mode. The filename and its sixteen patch names will be printed vertically. 
  188. @Your GEOS printer driver must be in the same drive as geoCZLIBRARIAN. 
  189. @ERROR TRAPPING
  190. In the interest of data safety, several error traps and fail safes have been put in place.
  191.  If a MIDI interface is inaccessible, MIDI transmission operations will be prohibited. These include the send and retrieve data routines and Audition.
  192. The disk routines Load, Save, Convert, and the internal routines Swap, Rename, and Print remain functional without an interface.
  193.  If a selected Librarian Bank has yet to be loaded, MIDI transmission of that bank's data 
  194.  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.
  195.  Disk errors will result in a message box, and the operation canceled. 
  196. @Depending on the severity of the error, data could be destroyed.
  197.  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. 
  198. WARNING
  199. @THERE IS NO CHECK TO SEE IF YOUR CZ IS 
  200. @ OR 
  201. HCONNECTED
  202. @, OR IF THE CZ'S MIDI CHANNELS 
  203. HRECONCILE
  204. @, OR IF THE 
  205. HCZ'S WRITE PROTECT SWITCH IS OFF
  206.        
  207. HYOU 
  208. H DO THIS YOURSELF
  209. @!!! 
  210. @ADDENDA
  211.     1) geoCZLIBRARIAN was conceived for a 
  212. @drive
  213.  system, with a 
  214. @1541
  215.  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 
  216. @1541
  217. . This is a 40-column mode program, and has not been tested on the 128.
  218. @The REU. 
  219. 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.
  220. GEORAM cannot be used for MIDI applications. Periferals such as RAMLINK, and OS's like GATWAY have not been tested.
  221.     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. 
  222. Many thanks
  223.  to Jim Collette for answers to my early geosImponderables.
  224. Make sure your CZ is 
  225. . Make sure your CZ's write-protect switch is 
  226. @off.
  227.  Make sure your MIDI cables are plugged in correctly. Make sure MIDI channel settings agree. These oversights will 
  228. @definetly
  229.  crash the program.     
  230.     5) Look for my other GEOS/MIDI and music programs: geoCZEDITOR and CZ AUDITION, geoCHORD, and CALCBEAT.
  231. I am available in this place:
  232. Douglas Adams
  233. 3632 Pawtucket Avenue
  234. East Providence, RI  02915
  235. On Q-Link: 
  236. @DTAdams
  237. March 1992
  238. geoCZLIBRARIAN v2.0
  239.                               
  240. geoCZLIBRARIAN v2.0
  241.                               
  242. @page
  243. @PAGE
  244. v Jp$
  245. v Jp$
  246. Z8$Z0
  247. Z8$Z0
  248.