[comp.binaries.apple2] GS Sound Studio v1.10 digitized sound processor DOCS

nakada@husc7.HARVARD.EDU (Paul Nakada) (05/09/88)

Comments:     Originally-From: <AJL2568@RITVAX>
Subject:      Sound Studio docs
Status: R

                               SOUND STUDIO

                               Version 1.10

                                    by

                                Paul James


                               USER'S MANUAL


1.0    PRODUCT OVERWIEW

Sound Studio is an applications program written specifically for the Apple
IIGS computer for the purpose of loading, editing, and playing digitized
binary sound files.  With Sound Studio, you can manipulate sounds in a manner
similar to that of most graphics word processors.  Sound Studio was designed
to run on a system having at least 512 Kbytes of memory and allows a user to
perform the following functions:

  a. Input a binary or text sound file
  b. Display the sound data graphically
  c. Zoom in on selected areas of the data
  d. Cut and Paste selected areas
  e. Play the sound forward or backward
  f. Control the playback speed and volume
  g. Play sounds with echo
  h. Fade in and Fade out selected areas
  i. Scale the amplitude up or down
  j. Erase portions of the file
  k. Save edited files to disk


2.0     THE MENUS

Most of Sound Studio's options are selected by choosing an item from one of
the pull-down menus.  The following paragraphs describe the items in each
of the menus.


2.1     FILE MENU

OPEN    - Used to load a sound file.

CLOSE   - Used to close a sound file.

SAVE    - Saves the selected area or the whole file to disk.  If no area is
          selected then the whole file is saved.

SAVE AS - Same as SAVE but user can select a new filename.

QUIT    - Exits the program.



2.2     EDIT MENU

UNDO           - Not implimented in this version.

CUT            - Removes the selected area from the file and copies it to
                 the cut buffer.

COPY           - Copies the selected area to the cut buffer but does not
                 affect the original file.

PASTE          - Inserts the contents of the cut buffer at the current
                 cursor position.  The data is inserted to the left of the
                 cursor.

CLEAR          - Removes the selected area from the file without affecting
                 the current contents of the cut buffer.

SELECT ALL     - Selects the whole file for some operation.

PLAY CLIPBOARD - Plays the current contents of the cut buffer.



2.3     GOODIES MENU


REVERSE DATA  - Reverses the selected area or the whole data file for playing
                backwards.

ERASE DATA    - Erases the data in the selected area of the file.

SCALE UP      - Increases the amplitude of the selected area by 25%.

SCALE DOWN    - Decreases the amplitude of the selected area by 25%.

FADE IN       - Increases the amplitude of the selected area exponentially.

FADE OUT      - Decreases the amplitude of the selected area exponentially.

SHOW INFO     - Shows information about the file and GS memory usage.

SET FILE TYPE - Select the type files to be seen in the OPEN file dialog.


2.4     HELP MENU

BUTTONS  - Gives information about the programs buttons.

CONTROLS - Gives information about the programs controls.



3.0     THE CONTROLS

Sound Studio was designed to provide quick access to the most frequently
used controls needed for playing sound files.  The following paragraphs
describe the function of each.


3.1     BUTTONS

PLAY - Plays the selected area or the whole sound file.

STOP - Stops all sounds currently playing.

LOOP - The selected area or the whole file is played continuously until the
       stop button is pressed.

ECHO - Plays the selected area or the whole file with echo.

ZOOM - Plots a high resolution graph of the selected area.


3.2     SCROLL BARS

DELAY -        The bar labeled 'D' controls the echo seperation.

VOLUME -       The bar labeled 'V' controls the volume.

SPEED -        The bar labeled 'S' controls the playback speed.

LEFT CURSOR -  The pair of left-right arrows below the STOP button are used to
               control the position of the left edge of the cursor.

RIGHT CURSOR - The pair of left-right arrows below the ECHO button are used to
               control the position of the right edge of the cursor.



4.0     PLAYING SOUND FILES

To play a sound file, use the OPEN option in the FILE menu to load a file into
the sound buffer.  The volume and speed may need to be adjusted for proper
playback.


5.0     SELECTING AN AREA OF THE FILE

Most of Sound Studio's controls work on a selected area or the whole file.  To
select an area of the file, move the mouse cursor into the graph area and
click the mouse button one time.  This will cause a tiny cursor line to appear
in the graph.  The width of the cursor can now be adjusted by using the
left/right cursor control arrows.  To unselect an area, simply click the mouse
button one more time in the graph area.

A faster way of selecting an area can be done by clicking and holding down the
mouse button while dragging the mouse pointer left or right.  The cursor will
follow the mouse pointer until the mouse button is released.


6.0     SAVING FILES

Files can be saved by selecting the SAVE or SAVE AS options in the FILE menu.
When files are saved, the current speed setting is also saved so the next time
the file is loaded the speed will be correct.


7.0     LOOPING WITH ECHO

To play the sound continuously with echo, click the LOOP button then click the
ECHO button.  Clicking the STOP button will stop the sound.


8.0     SOURCE CODE

Sound Studio is a public domain program written and compiled using the APW
version 1.1 of the TML pascal compiler.  Please feel free to distribute this
program as you wish.

For a copy of the source code on a 3.5" disk send $20.00 to:

        Paul James
        P.O. Box 5
        Adamstown, MD.
        21710

Note: The Source Code for Sound Studio is copyrighted and not to be
      distributed freely.  Please allow 2-3 weeks for delivery.