home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 25D / S612ZB.ZIP / S612ZB.DOC < prev    next >
Encoding:
Text File  |  1991-09-02  |  20.1 KB  |  468 lines

  1. Welcome Akai S612 Enthusiasts and Non-Enthusiasts!  Thank you for
  2. downloading or requesting the unregistered version of S612zb,
  3. developed by Zorch brotherz software.
  4.  
  5. This package should contain the following files:
  6.  
  7.   S612zb.EXE  - Akai S612 librarian/viewer program, unregistered version.
  8.  
  9.   S612zb.DOC  - This file, manual and documentation text.
  10.  
  11.   ORDER.FRM   - Order form for registering your copy.
  12.  
  13.   *.SMP       - Sample sound(s) in SampleVision file format.
  14.  
  15.   *.612       - Sample sound(s) in .612 file format.
  16.  
  17.   *.SYX       - Sample sound(s) in MIDIEX (or CakeWalk) format.
  18.  
  19.  
  20. INTRODUCTION
  21. ------------
  22. Although the Akai S612 MIDI Digital Sampler is a bit outdated these
  23. days (1991), there are those who still use them and appreciate the
  24. S612's simplicity, sound quality, and low-cost.  Unfortunately, there 
  25. is little or no program support for the S612.  The S612's dump format
  26. is non-standard and impractical to implement with generic system 
  27. exclusive librarian programs.  Software targetted specifically for the
  28. S612 has either been expensive ( > $250 ) or just plain cheezy.  With
  29. these things in mind, Zorch brotherz software has dug up an old
  30. version of our program S612zb, prettied it up with pull-down menus and
  31. pop-up windows, added mouse support, added support for several file
  32. formats, and made it available to S612 users at a Shareware registra-
  33. tion fee of $30.
  34.  
  35. And now a commercial from our sponsor:
  36.  
  37. **********************************************************************
  38. This manual and the software it pertains to are distributed as
  39. shareware, (C) Copyright 1991, Bret Costin.  The unregistered version
  40. of this material may be copied and distributed freely, provided the
  41. following conditions are met:
  42.  
  43.      - Any copying or distribution must be done free-of-charge.
  44.  
  45.      - The S612zb program, this manual, and any data or utility files
  46.        included in this package must be distributed together.
  47.  
  48.      - If you do decide to keep a copy of this material for your own
  49.        use, please register your copy so that we can keep you posted
  50.        on upgrades (there are already a few new revisions running in
  51.        the lab here - see FUTURE UPGRADES section).  Your registration
  52.        and money will help us to continue supporting our products and
  53.        make them available to users at a reasonable price.
  54.  
  55. Thank you in advance for supporting the shareware concept!
  56. **********************************************************************
  57.  
  58. Well, now that we've got the obligatory text out of the way, let's
  59. roll up our sleeves (some musician's still prefer them) and get down
  60. to business...
  61.  
  62.  
  63. HARDWARE REQUIREMENTS
  64. ---------------------
  65. To take advantage of all S612zb program features, you should have the
  66. following hardware:
  67.  
  68.      - Akai S612 MIDI Digital Sampler,
  69.  
  70.      - IBM PC/XT/AT compatible computer, with at least 512K bytes of
  71.        RAM,
  72.  
  73.      - A MIDI Interface that is Roland MPU-401 compatible (this 
  74.        includes Music Quest's line of MPU compatibles) - IRQ is not
  75.        critical as S612zb utilizes the MPU's UART, or dumb mode,
  76.  
  77.      - CGA or better video graphics card and monitor,  
  78.  
  79.      - An optional Microsoft, Logitech, or compatible mouse and its
  80.        software driver.
  81.  
  82. You should have more than 384k of free RAM available to run S612zb.
  83. Using the Dos Shell function from inside the program may require even
  84. more memory.  The DOS CHKDSK.COM program displays the number of free
  85. bytes in your machine, as does DOS 5.0's MEM.EXE command.  For more
  86. information, please consult your DOS manual.
  87.  
  88. Most IBM PC graphics cards are supported, including CGA, EGA, and VGA.
  89. The highest resolution video mode supported by S612zb is 640 x 350
  90. pixels (on EGA and VGA monitors).  On CGA monitors, the S612zb program 
  91. displays graphics in 640 X 200 pixel resolution.
  92.  
  93. S612zb will run with or without a mouse and/or MPU.  Without an MPU,
  94. don't expect to hear any sound except the hi-tech BEEP! of the PC
  95. speaker.  It is best to use the "no MPU" command line flag (see
  96. Running S612zb section) when no MPU is actually attached to the
  97. computer.
  98.  
  99. This program has not been tested with the Yamaha C-1 computer.
  100.  
  101.  
  102. WHAT S612zb CAN DO (AND CAN'T DO)
  103. ---------------------------------
  104. The S612zb program is available in two versions, the "registered" and
  105. the "unregistered" version.   Both operate in the same fashion with 
  106. a few exceptions:
  107.  
  108.      - The unregistered version displays a invocation message that 
  109.        informs the user that the program is unregistered.
  110.  
  111.      - The unregistered version's Info pull-down menu displays
  112.        information about registering the program.
  113.  
  114.      - The unregistered version will not save files to disk - it does
  115.        however have the same file loading capabilities as the 
  116.        registered version.  Sample save files are included with the
  117.        program and may be identified by .612 filename extensions.
  118.  
  119. The unregistered version contains no hidden "time bombs".  It does
  120. not automatically exit after a given session time, nor does it
  121. self-destruct after a few weeks.  If either occurs with your version, 
  122. please note your set-up and notify Zorch brotherz.  This software has
  123. been tested on several different brands and configurations of com-
  124. puters, but we can't guarantee it will work with them all.  If this
  125. software does not operate correctly on your machine, notify us and we
  126. will attempt to remedy the situation.
  127.  
  128.  
  129. RUNNING S612zb
  130. --------------
  131. Before starting S612zb, change directories to the directory that
  132. includes the file S612zb.EXE (or include its directory specification
  133. in your DOS PATH environment).  At the DOS prompt (in this example,
  134. we'll pretend we're on Drive A:), enter "S612zb" then press the Enter
  135. key:
  136.  
  137.      A:> s612zb     <Enter>
  138.  
  139. You may also specify optional command line flags to allow S612zb to
  140. run with your computer's configuration:
  141.  
  142.      -a            Auto-connect.  On invocation, S612zb polls MIDI
  143.                    channels 1 through 9 and attempts to detect an
  144.                    attached S612 unit.  If one is found, the
  145.                    program's MIDI channel will automatically be set.
  146.  
  147.      -n            No MPU attached.  This will allow the you to run
  148.                    the program without an MPU physically residing in
  149.                    the system.  If have no MPU and you forget this
  150.                    flag, the program will still run, but probably
  151.                    very slowly.
  152.  
  153.      -v            Use video bios calls.  This flag is required if
  154.                    your video card is a CGA or other type that
  155.                    displays snow whenever the program writes to the
  156.                    screen.  A side-effect of this flag is that the 
  157.                    screen will update slightly slower than without
  158.                    the flag.
  159.  
  160. Here's a few examples of flag usage:
  161.  
  162.      A:> s612zb -a      <Enter>     Auto-connect upon startup.
  163.  
  164.      A:> s612zb -n -v   <Enter>     The user has no MPU interface and
  165.                                     has a video card that "snows".
  166.  
  167.  
  168. Immediately after entering the command line, the program name and
  169. version, copyright notice, and Zorch brotherz logo will appear.  If
  170. you are running an unregistered copy, that fact will also be
  171. displayed.  Strike any key or press a mouse button to continue.  The
  172. screen should clear and the main screen should appear.
  173.  
  174.  
  175. USING THE INTERACTIVE MENU SYSTEM
  176. ---------------------------------
  177. S612zb implements an interactive pull-down menu system similar to
  178. many of today's commercial products.  The menu system makes the tasks
  179. associated with S612zb simpler and more intuitive.  Menus may be
  180. operated by either a mouse or the computer's keyboard.  Hot-keys are
  181. implemented that allow the user to execute S612zb functions with
  182. single keystrokes.
  183.  
  184. To select a menu via mouse, position the mouse cursor (a white or cyan
  185. pointer) on the top menu bar and hold down a mouse button.  If the
  186. cursor is on one of the top line menu fields, a pull-down menu will
  187. appear and will do so until all mouse buttons have been    released.  To
  188. select a pull-down menu item, while pressing the mouse button, "drag"
  189. the mouse cursor over the pull-down fields.  As the cursor passes over
  190. each field, it highlights that particular field.  To run a routine
  191. associated with a field, release the mouse button(s) as the mouse
  192. cursor selects the field.  If you don't want to run any of the
  193. routines on that pull-down menu, merely move the mouse cursor outside
  194. of the pull-down menu and release the mouse button(s).
  195.  
  196. Various pop-up windows will allow selection via single and double
  197. clicks.  Just place the mouse cursor over the selected field and
  198. click once or twice.
  199.  
  200. To select a menu via keyboard, hold down the <Alt> key and press the
  201. first letter of the top line menu topic you would like to pull-down.
  202. Once the pull-down menu appears, fields may be highlighted by using
  203. the keyboard's cursor keys, HOME, END, and ESC keys.  To run a routine
  204. from the pull-down, highlight the desired field and press ENTER.  To
  205. abort a pull-down menu, press ESC.
  206.  
  207. Notice that many of the functions displayed in the pull-down menus
  208. have a carat (^) next to some letter.  These indicate "hot keys" that
  209. allow the user to execute functions with one keystroke.  A hot key is
  210. executed by holding down the CTRL key and pressing the appropriate
  211. letter.  For example, to quit the program, type CTRL-Q.  Adios...
  212.  
  213. Now let's go over the various pull-down menus that are accessible from
  214. the top line menu.
  215.  
  216.  
  217. FILE Menu
  218. ---------
  219. The file menu allows the user to load files from disk to the S612,
  220. save files from the S612 to disk, shell to DOS, and quit the program.
  221.  
  222. FILE - Load
  223. -----------
  224. The Load function allows the user to load sample data files and 
  225. transfer the sample data to the Akai S612.  Once selected, a 
  226. directory window pops up, allowing the user to select a specific file
  227. to load.  Note that only files in the currently selected Load File
  228. format are displayed.
  229.  
  230. FILE - Select Load Format
  231. -------------------------
  232. The Select Load Format function allows the user to select the format
  233. of files to be loaded.  Each time this function is selected, the load
  234. file format is cycled between the .612, .SMP, and .SYX modes.  Mouse 
  235. users may also toggle the file format by double-clicking on the
  236. file format displayed in the upper right-hand corner of the display.
  237.  
  238. FILE - Save
  239. -----------
  240. The File Save function allows the user to transfer the current S612
  241. sample data and settings to the computer, then write them to disk in
  242. .612 file format.  When prompted for a file name, the user may choose
  243. the default name NONAME.612, or may edit that name by using the 
  244. cursor, insert, delete, backspace, home, end, and alphanumeric keys.
  245. The entered file name must conform to DOS conventions.  The unregis-
  246. tered version of S612zb does not allow the user to save files.
  247.  
  248. FILE - Dos Shell
  249. ----------------
  250. The DOS Shell function temporarily suspends execution of the S612zb
  251. program and allows command entry from the DOS prompt.  When ready to
  252. return to S612zb, enter "exit" at the DOS prompt.
  253.  
  254. FILE - Quit
  255. -----------
  256. The Quit function causes the S612zb program to terminate and return
  257. to DOS.
  258.  
  259.  
  260. EDIT Menu
  261. ---------
  262. The Edit menu selections allow zooming and panning of displayed wave-
  263. format data.
  264.  
  265. EDIT - Zoom In
  266. --------------
  267. "Zoom In" decreases the number of displayed wave data points.  This 
  268. makes the individual data points easier to view.  The amount of zoom 
  269. magnification is displayed numerically at the bottom right corner of
  270. the screen.  The Zoom In function may also be activated via hot key;
  271. simultaneously press the shift key and the upward cursor key.
  272.  
  273. EDIT - Zoom Out
  274. ---------------
  275. "Zoom Out" increases the number of displayed wave data points.  This 
  276. makes larger sections of the waveform visible and provides the best
  277. view of the wave's envelope.  The amount of zoom magnification is 
  278. displayed numerically at the bottom right corner of the screen.  The
  279. Zoom Out function may also be activated via hot key; simultaneously 
  280. press the shift key and the downward cursor key.
  281.  
  282. EDIT - Pan Right
  283. ----------------
  284. "Pan Right" allows the user to view later (chronologically) wave data
  285. points, allowing better view of the wave's decay.  The actual wave 
  286. data point number (0 being the very first data point) is displayed
  287. numerically at the bottom right corner of the screen.  The Pan Right
  288. function may also be activated via hot key; simultaneously press the
  289. shift key and the rightward cursor key.
  290.  
  291. EDIT - Pan Left
  292. ---------------
  293. "Pan Left" allows the user to view earlier (chronologically) wave data
  294. points, allowing better view of the wave's attack.  The actual wave 
  295. data point number (0 being the very first data point) is displayed
  296. numerically at the bottom right corner of the screen.  The Pan Left
  297. function may also be activated via hot key; simultaneously press the
  298. shift key and the leftward cursor key.
  299.  
  300.  
  301. MIDI Menu
  302. ---------
  303. S612zb transmits and receives MIDI data on a selectable MIDI channel. 
  304. The channel menu allows the user to set the channel corresponding to
  305. a connected S612 unit.  (The Akai S612 displays this value in its
  306. MIDI CH window on the front of the unit.)  To set the program's MIDI
  307. channel, pull-down the channel menu and highlight the desired channel
  308. number.  Then release the mouse button or strike ENTER (if using
  309. keyboard).  A check mark will appear in the pull-down window,
  310. indicating the current MIDI channel.  A channel may also be selected
  311. automatically upon startup (see command line -a flag), or via the MIDI
  312. pull-down menu.
  313.  
  314. The MIDI menu allows the user to reset the MPU (this is handy if a
  315. connection is pulled during MIDI transfer, or if you shell to another
  316. program that bombs the MPU), check connections with the S612 unit,
  317. and autoconnect with an S612 unit.  Connections are checked by
  318. requesting data from the S612 unit.  If the proper data is not
  319. received from the S612 within a two-second time period, "DISCONNECTED"
  320. is displayed.
  321.  
  322. MIDI - Auto Connection
  323. ----------------------
  324. The Auto Connection function scans MIDI channels 1 through 9 in 
  325. attempt to detect a connected Akai S612.  Once S612zb detects an Akai
  326. S612, the program's MIDI channel is automatically set to the connected
  327. unit's channel.  If no S612 is detected, an error message is displayed
  328. and the program's MIDI channel is not changed.  A connection check 
  329. failure does not necessarily mean that the S612 unit is not receiving 
  330. data from the computer.  Check that the S612 MIDI output is connected
  331. to the MPU input, either directly or through a MIDI patch bay.  
  332.  
  333. The Auto Connection function may also be run automatically upon 
  334. program startup by specifying the -a switch (see RUNNING S612zb 
  335. section).
  336.  
  337. MIDI - Check Connection
  338. -----------------------
  339. The Check Connection function polls the currently selected MIDI 
  340. channel for a connected Akai S612.  The status is displayed to the
  341. screen.  A connection check failure does not necessarily mean that the
  342. S612 unit is not receiving data from the computer.  To check that the 
  343. S612 is receiving data, watch the MIDI CH window of the S612 unit 
  344. while running Check Connect.  The display should brighten when data is
  345. being received.
  346.  
  347. MIDI - Reset MPU
  348. ----------------
  349. The Reset MPU function resets and initializes the MIDI interface to
  350. the proper mode of operation.  This function should not be required 
  351. unless some external event on the MIDI bus hangs up the MPU.
  352.  
  353.  
  354. MIDI - Set Channel
  355. ------------------
  356. The Set Channel function allows the user to manually set S612zb's
  357. MIDI channel to match a connected Akai S612's channel.  This command
  358. is not required if the S612 unit is displaying channel 0 (omni mode).
  359.  
  360.  
  361. INFO Menu
  362. ---------
  363. The info menu displays information about the program itself.  The
  364. unregistered version of S612zb displays information on how to
  365. register your copy of the program.  It even does so in a non-
  366. offensive manner (snuck in the word "please").
  367.  
  368.  
  369. QUITTING S612zb
  370. ---------------
  371. To quit the S612zb program, select the Quit function under the Files
  372. menu, or type Ctrl-Q from the keyboard.  You will be automatically 
  373. returned to the DOS directory that you entered S612zb from.  Since all
  374. data is saved to disk automatically when you invoke "Save S612 To 
  375. Disk" from the Files menu, you don't have to worry about saving your 
  376. work when you exit the program.
  377.  
  378.  
  379. FILE FORMATS
  380. ------------
  381. Three different file formats are supported by S612zb at this time:
  382. the native .612 format, SampleVision .SMP format, and MIDIEX or
  383. Cakewalk .SYX format. 
  384.  
  385. .612 format is optimized for use by S612zb.  Using the .612 format,
  386. S612 Settings and Wave Data are packed into the most compact, fastest 
  387. loading and storing files of the 3 formats.
  388.  
  389. .SMP format files are output by the SampleVision program and must
  390. be converted by S612zb while loading.  The advantage to .SMP files
  391. is that data from other samplers besides the S612 may be stored
  392. in this format.  S612zb's .SMP import function gives you access to
  393. other samplers sounds!  Because a .SMP file may contain more wave
  394. data points than the S612 is capable of storing, S612zb filters out
  395. excess data points and attempts to load as much of the original 
  396. wave's envelope as possible.
  397.  
  398. .SYX format files may be used with popular shareware such as MIDIEX,
  399. or with the CakeWalk sequencer.  When .SYX files are loaded by the
  400. S612zb program, the MIDI channel embedded in the .SYX file is
  401. replaced by S612zb's current MIDI channel setting.  In the same man-
  402. ner, .SYX files stored by S612zb will have the same MIDI channel
  403. as the S612 the data was received from.  .SYX files should be avoided
  404. when not required by other programs - the files may become quite
  405. large (~ 64k) and load/store very slowly in comparison with S612zb's
  406. native .612 file format.  The larger size and slower speed is due to
  407. the unpacked nature of the data within a .SYX file.
  408.  
  409.  
  410. ENVIRONMENT VARIABLES
  411. ---------------------
  412. Three special environment variables are implemented that specify de-
  413. fault directories for user data files.  The variable S612 specifies 
  414. the default directory for loading and storing .612 format files.  The
  415. variable S612SV specifies the default directory for loading .SMP
  416. SampleVision format files.  The variable S612SYX specifies the default 
  417. directory for loading .SYX MIDIEX/CakeWalk format files.  Any or all 
  418. of the three variables may be declared in the AUTOEXEC.BAT file of the 
  419. boot disk, or from the DOS command line.
  420.  
  421. For example, if your .612 files are usually in directory C:\612, your 
  422. .SMP files are usually in directory A:\SAMPLES\SVISION, and your .SYX
  423. files are usually in B:\THOSE\CRAZY\SOUNDS, then make these declar-
  424. ations in your AUTOEXEC.BAT file:
  425.  
  426.      set s612=c:\612
  427.      set s612sv=a:\samples\svision
  428.      set s612syx=b:\those\crazy\sounds
  429.  
  430. Keep in mind that these are the directories set up whenever S612zb is
  431. invoked.  Once in S612zb, they may be changed via the File Load menu.
  432.  
  433.  
  434. UPCOMING FEATURES
  435. -----------------
  436. Graphical Tool Box.
  437. Graphical loop and wave data editing.
  438. Editing of the various Akai S612 settings and parameters.
  439.  
  440.  
  441. MORE INFO
  442. ---------
  443. A great deal of time and effort went into developing this program.  If
  444. you experience problems with S612zb, please note the symptoms and
  445. contact us.  It is possible that unique system configurations cause 
  446. the program to operate erroneously.  It's always possible, even with
  447. the most expensive software, that the program has a bug.  If you have 
  448. any comments, questions, or suggestions about S612zb or other Zorch 
  449. brotherz products, we will be glad to answer them.  We can be con-
  450. tacted at:
  451.  
  452.   Bret Costin
  453.   c/o Zorch brotherz software
  454.   3475 Rolling Trail
  455.   Palm Harbor, FL  34684
  456.  
  457.   (813) 784-6158    6 PM - 10 PM   Weekdays
  458.                     Noon - 5 PM    Saturday
  459.  
  460. or leave us mail at either Bulletin Board System:
  461.  
  462.   Via Compuserve [70474,3534] (Bret Costin),
  463.   Via the MIDILINK Musicians' Network (708) 949-MIDI (Bret Costin),
  464.  
  465. ----------------------------------------------------------------------
  466. By the way, SampleVision is a trademark of Turtle Beach Softworks.
  467.             CakeWalk is a trademark of Twelve Tone Systems.
  468.