home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / sounds / convert / convert.doc next >
Text File  |  1995-05-18  |  5KB  |  128 lines
  1.                             CONVERT
  2.                           Version 3.0
  3.                          July  9, 1993
  4.  
  5.       Copyright (c) 1993  Covox, Inc.  All Rights Reserved
  6.  
  7. INTRODUCTION
  8.  
  9. Different sound cards and software often make use of different and
  10. incompatible formats for files they use to record sounds on disk. 
  11. Convert offers a way to translate sound files between several common
  12. formats.
  13.  
  14. GENERAL DESCRIPTION
  15.  
  16. CONVERT can understand all Covox sound file formats as well as .VOC
  17. and .WAV files.  It can translate these formats to any of the formats
  18. it understands, except .VMD and .VMF files.
  19.  
  20. CONVERT has two mode of operation. If run without any command line
  21. parameters, it operates in "menu mode".  Menu mode allows the easy
  22. selection of files to convert using a point and shoot type of
  23. interface.
  24.  
  25. CONVERT can also be run completely from the command line, allowing
  26. easy use from within batch files, or quick "one shot" conversions for
  27. which menus are unnecessary.
  28.  
  29.  
  30. When Covert is started in menu mode, a list of options will be
  31. displayed horizontally across the top of the screen.  These
  32. selections are arranged, from left to right, in the order they are
  33. likely to be used.  You can navigate the selections using the cursor
  34. keys on your keyboard to move the highlight through the selections.
  35. When the selection you want is highlighted, press <Return>.  Pressing
  36. <Esc> at any time backs you out of the current menu.
  37.  
  38. The main menu selections are:
  39.  
  40. OPTIONS:
  41.    Selecting this brings up a submenu of a number of
  42.    parameters that will affect any conversions made.
  43.    The parameters listed here are:
  44.  
  45.    Playback Rate:  Selecting this allows you to specify
  46.            the speed at which the converted files will
  47.            be played back.  This rate is specified in
  48.            Hertz. Specifying zero for this option tells
  49.            CONVERT to keep the same playback rate as in
  50.            the original file.  NOTE:  Not all possible
  51.            rates can be specified, so after you enter a
  52.            value here, it will be changed to match the
  53.            closest valid value.
  54.  
  55.    Silence Threshold:  This only has an effect when you
  56.            are converting to a format with Silence
  57.            encoding.  This value can be from 0 to 5, and
  58.            specifies how many units from dead silence 
  59.            CONVERT will still consider as silence.
  60.  
  61.    Treble Output:  This toggles between 'Y' and 'N',
  62.            telling CONVERT to add more treble to the
  63.            resulting file.  Only effective when
  64.            converting from .V4S, .V3S, and .V2S file
  65.            formats.
  66.  
  67.    Noise Fill:  This toggles between 'Y' and 'N', and is
  68.            only effective when converting from .V4S,
  69.            .V3S, and .V2S file formats.  Causes silence
  70.            to be replaced by low level noise.
  71.  
  72.    Dest. Path:  Specifies the directory the resulting
  73.            converted files are to be placed in.  This
  74.            defaults to the directory you are in when you
  75.            run CONVERT.  The current destination path is
  76.            always displayed at the bottom of the screen.
  77.  
  78. FILE MASKS:
  79.    By default, CONVERT will only see files with
  80.    extensions representing the file formats it knows. 
  81.    You can change the file masks in this menu.  A file
  82.    mask is a list of file masks, separated by commas,
  83.    semicolons, or spaces.  If a file name matches any of
  84.    the file masks on this list, it will be displayed in 
  85.    the directory window.
  86.  
  87. SORTING:
  88.    This allows the directory window to be sorted
  89.    according to your tastes. Has no other effect on the
  90.    program's operation.
  91.  
  92. FORMAT:
  93.    This brings up a menu allowing you to specify which
  94.    format you wish to convert to.  The current target
  95.    format is always displayed at the bottom of the
  96.    screen
  97.  
  98. CONVERT:
  99.    Brings up a menu to perform the actual conversions: 
  100.    The menu has three options:
  101.  
  102.    Select files to convert:  When you pick this, a
  103.      highlight bar will appear in the directory window. 
  104.      This bar can be moved around using the cursor keys. 
  105.      You then need to select which files you want to
  106.      convert by moving the highlight to them, and pressing
  107.      either <Return> or the spacebar.  A check mark will
  108.      appear next to the file name to indicate that you
  109.      have selected that file.  If you mistakenly select
  110.      the wrong file, pressing <Return> on it again will
  111.      deselect it.
  112.  
  113.      Names that appear in angle brackets ( < and > ) are
  114.      directories.  Pressing <Return> on these changes the
  115.      directory  being displayed.  You can select any
  116.      number of files, in any directories you wish.  When
  117.      you have selected all the files you want to convert,
  118.      press <Esc>.
  119.  
  120.    Convert All Selected Files:  Selecting this item will
  121.      initiate the conversion off all the files you have
  122.      selected using the "Select Files to Convert" option.
  123.  
  124.    Exit Convert:   This is the same as pressing <Esc>
  125.      from the main menu, allowing you to leave the
  126.      program.
  127.                         
  128.