home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource1 / program6 / vdfe.hlp < prev    next >
Encoding:
Text File  |  1993-11-14  |  15.6 KB  |  319 lines
  1.  *   *   *   *   *   *   *   VDFE v2.0 Help File   *   *   *   *   *   *   *
  2.  
  3.          ┌──────────────────────────────────────────────────────────┐
  4.          │ »»»»»»»»»»»»»»»»»»  NON-MENU ACTIONS ««««««««««««««««««« │
  5.          ├─────────────────────────────────────┬────────────────────┤
  6.          │ Action                  Key         │ Action         Key │
  7.          ├─────────────────────────────────────┼────────────────────┤
  8.          │ Selected a Value                │ Redraw Screen  F9  │
  9.          │ Selected Value + 1      Shift+     │ Activate Menu  F10 │
  10.          │ Selected Value + 100    Shift+PgDn  │                    │
  11.          │ Selected Value + 10000  Shift+End   │                    │
  12.          │ Selected Value - 1      Shift+     │                    │
  13.          │ Selected Value - 100    Shift+PgUp  │                    │
  14.          │ Selected Value - 10000  Shift+Home  │                    │
  15.          └─────────────────────────────────────┴────────────────────┘
  16. ┌────────────────────────────────────────────────────────────────────────────┐
  17. │ »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»  MENU ACTIONS ««««««««««««««««««««««««««««« │
  18. ├────────────────────────────┬───────────────────────────────────────────────┤
  19. │ Action             Key     │ Action                           Key          │
  20. ├────────────────────────────┼───────────────────────────────────────────────┤
  21. │ Load Index File    Alt+I   │ Play the Block                   Enter        │
  22. │ Load Data File     Alt+D   │ Merge Current Block with Next    M            │
  23. │ Change File Names  Alt+N   │ Split Current Block              S            │
  24. │ Save Index File    Ctrl+I  │ Cut Block to Clipboard           Del          │
  25. │ Save Data File     Ctrl+D  │ Paste from Clipboard             Insert       │
  26. │ Save Both          Ctrl+S  │ Copy Block to Clipboard          Shift+Insert │
  27. │ Create Index       I       │ Delete the Block                 Shift+Del    │
  28. │ Pack Data          Ctrl+P  │ Write Clipboard to File          W            │
  29. │ Help               F1      │ Read File into Clipboard         R            │
  30. │ Exit               Esc     │ Record into Clipboard            F3           │
  31. │                            │ Play Clipboard Contents          F4           │
  32. │                            │ Select COM Port (for recording)  F2           │
  33. │                            │ Select Playback Device           F5           │
  34. └────────────────────────────┴───────────────────────────────────────────────┘
  35.  
  36.  ══════════════════════════════╡ Introduction ╞══════════════════════════════
  37.  
  38.  VDFE is designed to work with pairs of files, one containing the actual
  39.  digitized voice data and the other providing an index into the words,
  40.  phrases, and sounds stored in the data file. This allows a reasonable level
  41.  of programming flexibility, especially for systems using large amounts of
  42.  voice data. VDFE works only with data files in their uncompressed form.
  43.  
  44.  Data files are unlimited in length. Index files may contain at most 4096
  45.  entries. An index file consists only of a number of index entries packed
  46.  together. Each entry is 8 bytes long, so the file length will be 8 times
  47.  the number of entries. One entry in an index file is formatted as follows:
  48.  
  49.         Bytes 0 - 3:     Offset from beginning of data file in bytes.
  50.         Bytes 4 - 7:     Length of sound in bytes.
  51.  
  52.  Each of the two parts of the entry is a "long" (4-byte) integer, stored
  53.  in "low byte first" order.
  54.  
  55.  In this document, a "block" refers to a segment of a voice data file as
  56.  referenced by an entry in the corresponding index file. The length of a
  57.  block may range from 1 byte to the length of the entire data file. Note,
  58.  however, that VDFE requires blocks to be sequential and non-overlapping.
  59.  Gaps may exist, but no voice data byte may be a part of two blocks.
  60.  
  61.  ═════════════════════╡ Explanation of Screen Contents ╞═════════════════════
  62.  
  63.  Menu Bar:
  64.    Works in the conventional way. Activate by pressing F10. The mouse is not
  65.    supported in this version. Use of the menu bar is optional, since all
  66.    commands are accessible through direct keystrokes.
  67.  
  68.  Blk # (Block number):
  69.    Shows a sequential reference number for each index entry.
  70.  
  71.  Start:
  72.    Shows the starting byte number within the data file for each block. Can be
  73.    changed from the keyboard.
  74.  
  75.  Stop:
  76.    Shows the ending byte number within the data file for each block. Can be
  77.    changed from the keyboard. The number actually saved in the index file for
  78.    each block is <Stop> - <Start>.
  79.  
  80.  Block count:
  81.    This is the total number of blocks currently defined for the index file.
  82.  
  83.  Data file size:
  84.    The total number of bytes currently in the data file.
  85.  
  86.  Buffer size:
  87.    This is the number of bytes in the RAM buffer. This number has no effect
  88.    on the size of the data file that may be edited, or the size of files that
  89.    may be read and written through the clipboard. It affects only actual
  90.    recording and playback. It is the maximum size allowed for any block to be
  91.    played through the speaker, although larger blocks may be otherwise
  92.    manipulated. It is also the maximum number of bytes that can be
  93.    continuously recorded into the clipboard.
  94.  
  95.  Digitizer port:
  96.    This is the COM port number to which the voice digitizer hardware is
  97.    attached. It can be set with the F2 key. Used for recording only.
  98.  
  99.  Sound Output:
  100.    This is either the PC internal speaker or an LPT (printer) port into
  101.    which you have plugged a Farpoint EAR-WIZARD device (and, of course, a
  102.    set of headphones or a speaker). The F5 key sets this parameter.
  103.  
  104.  Index file:
  105.    The name of the current index file. Change by pressing Alt+N. The current
  106.    index will be written to this file name by Ctrl+I or Ctrl+S.
  107.  
  108.  Data file:
  109.    The name of the current data file. Change by pressing Alt+N. The current
  110.    data will be written to this file name by Ctrl+D or Ctrl+S.
  111.  
  112.  Instruction area:
  113.    Always displays a very brief set of operating instructions.
  114.  
  115.  ══════════════════╡ Descriptions of Individual Commands ╞═══════════════════
  116.  
  117.  Selected a Value  (   ):
  118.    When there are entries in the index list (Blk #, Start, & Stop) then one
  119.    of these entries is always "selected", as indicated by highlighting. The
  120.    highlight can be moved up and down with the vertical arrow keys. The
  121.    horizontal arrow keys select either the Start or Stop value. The selected
  122.    value can then be manipulated. Its numerical value can be changed with the
  123.    Shift key in combination with various cursor pad keys (see the following
  124.    commands). The selected block is also the target of the Play, Merge,
  125.    Split, Cut, Paste, Copy, and Delete commands.
  126.  
  127.  Selected Value + 1  (Shift+):
  128.    Adds 1 to the selected value unless it would cause an overlap.
  129.  
  130.  Selected Value + 100  (Shift+PgDn):
  131.    Adds 100 to the selected value unless it would cause an overlap.
  132.  
  133.  Selected Value + 10000  (Shift+End):
  134.    Adds 10000 to the selected value unless it would cause an overlap.
  135.  
  136.  Selected Value - 1  (Shift+):
  137.    Subtracts 1 from the selected value unless it would cause an overlap.
  138.  
  139.  Selected Value - 100  (Shift+PgUp):
  140.    Subtracts 100 from the selected value unless it would cause an overlap.
  141.  
  142.  Selected Value - 10000  (Shift+Home):
  143.    Subtracts 10000 from the selected value unless it would cause an overlap.
  144.  
  145.  Redraw Screen  (F9):
  146.    Redraws the entire screen. Intended primarily as a means of recovering
  147.    after screen is trashed by "Abort, Retry, Ignore, Fail?" message from DOS.
  148.  
  149.  Activate Menu  (F10):
  150.    Highlights the first selection in the menu bar. Use <Enter> key to show
  151.    pull-downs, select with arrow keys, then use <Enter> to perform the action
  152.    or <Esc> to back out.
  153.  
  154.  Load Index File  (Alt+I):
  155.    The cursor will appear in the "Index file" area (near the bottom of the
  156.    screen) allowing a file name to be entered and/or edited. Press <Enter>
  157.    to load the specified index file or <Esc> to do nothing.
  158.  
  159.  Load Data File  (Alt+D):
  160.    The cursor will appear in the "Data file" area (near the bottom of the
  161.    screen) allowing a file name to be entered and/or edited. Press <Enter>
  162.    to load the specified data file or <Esc> to do nothing.
  163.  
  164.  Change File Names  (Alt+N):
  165.    This allows the user to alter the current names of the index and data
  166.    files. Use the arrow keys to switch between file names. Press <Enter>
  167.    when done.
  168.  
  169.  Save Index File  (Ctrl+I):
  170.    The current index listing will be written to the file name shown at the
  171.    bottom of the screen as the "Index file". Use Alt+N to change this name.
  172.  
  173.  Save Data File  (Ctrl+D):
  174.    The current voice data will be written to the file name shown at the
  175.    bottom of the screen as the "Index file". Use Alt+N to change this name.
  176.  
  177.  Save Both  (Ctrl+S):
  178.    This combines the two save operations (see Save Index and Save Data).
  179.  
  180.  Create Index  (I):
  181.    This operation will analyze the entire data file, attempting to
  182.    distinguish between areas of sound and areas of silence. The areas of
  183.    sound will become blocks in the newly created index. The areas of silence
  184.    will become gaps in the index (i.e. parts of the data file that are not
  185.    included in any indexed block). NOTE: This will erase the current index
  186.    in memory (but not the one on disk, unless you then Save Index without
  187.    changing the file name). If a data file has already been stripped of its
  188.    silent areas by editing and the use of the Pack Data command, then Create
  189.    Index will not succeed because it will be unable to find areas of silence
  190.    in the file. Create Index is actually intended to be used only once on a
  191.    newly recorded data file.
  192.  
  193.  Pack Data  (Ctrl+P):
  194.    This will remove all areas of the data file which are not currently part
  195.    of any index entry. The indexed blocks will be packed together with no
  196.    addressing gaps. The index Start and Stop values will be adjusted
  197.    accordingly. This command is intended for use after careful editing to
  198.    strip out unused voice data and save disk space in the finished file.
  199.  
  200.  Help  (F1):
  201.    Displays this file.
  202.  
  203.  Exit  (Esc):
  204.    Exits to DOS from VDFE (after a last-chance prompt).
  205.  
  206.  Play the Block  (Enter):
  207.    The currently selected block is played through the speaker.
  208.  
  209.  Merge Current Block with Next  (M):
  210.    The currently selected block and the next sequential block will be
  211.    combined into a single block. The total block count will be decremented.
  212.  
  213.  Split Current Block  (S):
  214.    The currently selected block will be split into two blocks, each half the
  215.    size of the original. The total block count will be incremented.
  216.  
  217.  Cut Block to Clipboard  (Del):
  218.    The voice data of the currently selected block will be copied to the
  219.    clipboard (a temporary file), overwriting the previous clipboard contents.
  220.    The block will then be deleted from the voice data and index.
  221.  
  222.  Paste from Clipboard  (Insert):
  223.    This is the reverse of Cut to Clipboard. A new block will be created in
  224.    the index and data. The contents of the clipboard will then be copied into
  225.    this new block. The clipboard contents remain unchanged. NOTE: If the
  226.    currently selected value is a Start value, then the new block will be
  227.    inserted BEFORE it. If the currently selected value is a Stop value, then
  228.    the new block will be inserted AFTER it.
  229.  
  230.  Copy Block to Clipboard  (Shift+Insert):
  231.    The voice data of the currently selected block will be copied to the
  232.    clipboard (a temporary file), overwriting the previous clipboard contents.
  233.    The index and data will not be changed.
  234.  
  235.  Delete the Block  (Shift+Del):
  236.    The currently selected block will be deleted from the index and data. The
  237.    block count and data size will decrease.
  238.  
  239.  Write Clipboard to File  (W):
  240.    This will simply write the current clipboard voice data to a file. The
  241.    user will be prompted for a file name.
  242.  
  243.  Read File into Clipboard  (R):
  244.    This reads a user-specified voice data file into the clipboard,
  245.    overwriting the previous clipboard contents.
  246.  
  247.  Record into Clipboard  (F3):
  248.    The previous contents of the clipboard will be deleted, and recording will
  249.    start into the memory buffer. Once recording has terminated, either
  250.    through a keypress, the use of the "stop" switch on the digitizer board,
  251.    or running out of memory, the buffer will be copied into the clipboard.
  252.    NOTE: A common error consists of forgetting to set the COM port number
  253.    prior to recording.
  254.  
  255.  Play Clipboard Contents  (F4):
  256.    The current clipboard contents will be played through the speaker.
  257.  
  258.  Select COM Port  (F2):
  259.    This increments the digitizer COM port number, wrapping at 4.
  260.  
  261.  Select Sound Playback Destination  (F5):
  262.    Cycles the sound output destination through all its possible values,
  263.    including the internal speaker ("Spkr"), LPT1, LPT2, and LPT3. If one
  264.    or more LPT ports is missing as the list is cycled, it means that the
  265.    program has detected that the port is not physically present in the
  266.    computer.
  267.  
  268.  ═══════════════════════╡ A Typical Editing Session ╞════════════════════════
  269.  
  270.  Prepare a list of words, phrases, and sounds that you wish to record,
  271.  including the order in which they are to appear in the voice data file.
  272.  
  273.  If you have not already done so, read the section of the digitizer
  274.  documentation that concerns input volume levels and the indicator LEDs.
  275.  
  276.  Attach the digitizer to a COM port. Execute VDFE by typing its name at the
  277.  command prompt. You must not be running in a DOS box under Microsoft Windows
  278.  in enhanced mode. Press F2 repeatedly until the correct port number shows in
  279.  the "Digitizer port" box.
  280.  
  281.  If you want to play the sound through the PC internal speaker, set "Sound
  282.  Output" to "Spkr". If you are using a Farpoint EAR-WIZARD, plug it into one
  283.  of the parallel printer ports and set "Sound Output" to the correct port.
  284.  Press the F5 key repeatedly until the desired choice is displayed.
  285.  
  286.  If you are creating a new voice data file, press Alt+N and type both an
  287.  index file name and a data file name into the appropriate slots.
  288.  
  289.  To record new data: turn the digitizer on, then press F3 and start talking
  290.  (or whatever is appropriate). There is a delay of about one second between
  291.  the keypress and the start of data recording. VDFE will say "Go" at the
  292.  moment recording begins. Press a key on the keyboard or the "stop" switch on
  293.  the digitizer when finished. You can listen to the recording just made by
  294.  pressing F4. If the recording is not satisfactory, re-record it by pressing
  295.  F3.
  296.  
  297.  Once the recording in the clipboard is considered satisfactory, it may be
  298.  inserted into the main data file by pressing Insert. If more data must be
  299.  recorded than will fit into the memory buffer, then repeat the previous
  300.  procedure until all desired sounds have been accumulated as blocks in the
  301.  data file. Be sure that you have enough free disk space before starting.
  302.  Remember also to turn off the digitizer when not in use to conserve the
  303.  batteries.
  304.  
  305.  If you want to use the automatic indexing capability, press the "I" key at
  306.  this point and a new index will be created.
  307.  
  308.  Use the Selected Value increment and decrement commands to adjust the
  309.  position and size of each block as required. Some sounds intended as one
  310.  block will probably appear as several, due to embedded silence. Use the
  311.  Merge command to combine them. As you adjust each block, use the Enter key
  312.  to listen to it in its current state.
  313.  
  314.  Once all blocks are correct, and you are sure that the data in the
  315.  inter-block gaps is not needed, press Ctrl+P to remove the unneeded data and
  316.  minimize the file size. Press Ctrl+S to save the index and data files.
  317.  
  318.  *   *   *   *   *   *   *     End of Help File     *   *   *   *   *   *   *
  319.