home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource1 / program6 / vdfe.hlp < prev    next >
Text File  |  1993-11-14  |  16KB  |  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) al