home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Enter 1999 March / enter_03_1999_1.iso / MMEDIA / DZWIEK / codaxe / ReadMe.txt < prev    next >
Text File  |  1998-08-04  |  15KB  |  408 lines
  1. README.TXT for CodAxe V1.30 (released 8/5/98)
  2.  
  3.  
  4.  
  5.  
  6.                     CodAxe V1.30
  7.                     ------------
  8.  
  9.           (Copyright 1998 by Mathias Doenitz)
  10.  
  11.  
  12.  
  13.  
  14.      Table of content:   1. What is CodAxe ?
  15.                          2. Features
  16.                          3. Installation
  17.                          4. Directory Modes
  18.                          5. Tips
  19.                          6. Version history
  20.                          7. Copyright stuff
  21.                          8. Feedback and contact
  22.  
  23.  
  24.  
  25. 1. What is CodAxe ?
  26. -------------------
  27.  
  28.    CodAxe is a Graphical User Interface (GUI) to the
  29.    Windows 95/NT Audio Codec Manager (ACM).
  30.    It was designed to provide a convenient and efficient
  31.    way of using the functionality of the audio compression
  32.    (and decompression) drivers available for windows.
  33.    It is NOT a Codec itself, and no Codecs are delivered
  34.    with CodAxe.
  35.  
  36.  
  37. 2. Features
  38. -----------
  39.  
  40.    - converting (recoding) of audio files to any compression
  41.      codec that is available in the Windows ACM
  42.  
  43.    - capable "batch" processing:
  44.      At this point I want to explain the basic idea behind
  45.      CodAxe. The way CodAxe works isn't really batch
  46.      processing like the one used in several other programs.
  47.      CodAxe was designed to be a kind of "consumer" in
  48.      a "producer-consumer" surrounding.
  49.      Imagine the following scenario:
  50.      You have got two computer connected together in a LAN.
  51.      One acts as a kind of server and the other one is
  52.      your workstation. Now you want to use the computing
  53.      power of the server for certain tasks you dont want to
  54.      stress you workstation with, e.g. recoding audio files.
  55.      The thing you want to do is to move some files over to
  56.      the server and get them recoded automatically (i.e.
  57.      without the need of invoking any further process on the
  58.      server). You simply move a file in a shared directory
  59.      of the server and some minutes (or seconds) after you
  60.      pick up the recoded one in another (or the same) place.
  61.      CodAxe is able to provide exactly this functionality.
  62.  
  63.      It continuously looks for files in one (or several)
  64.      directory(-ies) and activates a recoding job if a file
  65.      shows up.
  66.  
  67.    - automatic spreading of recoded files over several
  68.      disk volumes:
  69.      You can specify a list of target directories CodAxe
  70.      will create the recoded files in. The way these
  71.      directories are filled depends on the selected
  72.      operating mode (see section 4).
  73.  
  74.    - full priority control:
  75.      You can easily change the priority of the recoding job
  76.      to your needs (and for example still work normally on
  77.      your machine if you set it to very low).
  78.  
  79.    - a suspend/resume function:
  80.      You can easily suspend and resume the recoding job if
  81.      you temporarily need full CPU performance for other
  82.      tasks.
  83.  
  84.    - drag & drop support:
  85.      You can directly drag directories from the any explorer
  86.      windows into CodAxe's directory lists.
  87.  
  88.    - fully automatic background operation:
  89.      If you put Codaxe in your Autostart folder it can run
  90.      on startup minimized to the taskbar or the system tray.
  91.      Codaxe can even power down your system after completion
  92.      of all jobs ! (if your system supports soft power off)
  93.  
  94.  
  95. 3. Installation
  96. ---------------
  97.  
  98.    As CodAxe is a very "light-weight" program, no further
  99.    setup is necessary.
  100.    All you have to do is to unzip the archive to a
  101.    directoy of you choice and start the EXE-file.
  102.  
  103.    Your registry won't get affected in any way !
  104.  
  105.    If you don't like CodAxe or decide to abandon usage
  106.    simply delete all files and CodAxe is gone.
  107.  
  108.  
  109.  
  110. 4. Directory Modes
  111. ------------------
  112.  
  113.    Since version 1.20 CodAxe offers several directory modes:
  114.  
  115.    - classical:
  116.      Up to version 1.20 there was only one way the specified
  117.      target directories were filled: one after the other as
  118.      free space on the different drives was dropping below
  119.      the specified MB limit.
  120.      This mode is still available as the "classical" mode.
  121.  
  122.    - direct link:
  123.      In this mode the files of a source directory go
  124.      directly to its corresponding target directory, i.e.
  125.      the first source dir gets recoded the the first target
  126.      dir, the second to the second and so on. So you can
  127.      assign each source directory its own target directory.
  128.      If there are less target dirs than source dirs the last
  129.      target dir takes all the rest.
  130.      If the free space in the corresponding target dir sinks
  131.      below the free space limit then recoding goes on to the
  132.      next target dir (if this fills up to the next and so on).
  133.  
  134.    - rebound:
  135.      This mode is the simpliest (but one of the most wanted
  136.      features ... :-). It simply writes every file back to
  137.      its source directory. The target dirs have no function.
  138.  
  139.    Additionally you can specify a root directory of a whole
  140.    directory branch and let CodAxe create the same directory
  141.    structure in the target dir(s).
  142.  
  143.  
  144.  
  145. 5. Tips
  146. -------
  147.  
  148.    Most of the interface elements will be self
  149.    explaining, but here are some useful hints:
  150.  
  151.    - Copy buffer:
  152.  
  153.         The preferences dialog allows you to specify a
  154.         copy buffer size (let's call it X):
  155.         CodAxe internally reads X KBytes from the source
  156.         file and writes them through the target codec
  157.         to the destination file. Then a screen update is
  158.         performed. If you set this value too high the update
  159.         of the progress bar and the time info will be too
  160.         slow, if you set it too low you will waste CPU
  161.         time with dispensable screen updates.
  162.         Try to find a value that updates the screen once or
  163.         twice a second and you will be fine.
  164.  
  165.     - Changing settings while a job is running:
  166.  
  167.         You will notice that you can change all settings
  168.         while a recoding job is running or while it is
  169.         suspended.
  170.         It's no problem if you do so, if you know when
  171.         the changes will be applied.
  172.         If you change source or target directories, the
  173.         target format, recoding mode (speed/quality),copy
  174.         buffer size,... while a job is running the changes
  175.         will apply when the next job is started (not when
  176.         the current job is resumed).
  177.         If you change the way source files are treated after
  178.         successful recoding your changes will already apply
  179.         to the current job.
  180.  
  181.     - Shared network directories
  182.  
  183.         You can specify directories directly by their
  184.         network name like '\\ray\wavs2encode\' if you want
  185.         to but if you do so CodAxe is unable to determine
  186.         the amount of free space in that directory.
  187.         Additionally CodAxe would block for several
  188.         seconds if a former network resource isn't
  189.         accessible any more (You may know this effect
  190.         from your daily work on shared resources ...).
  191.         That's why CodAxe doesn't remember such
  192.         directories from the last session.
  193.         The best way to handle shared network
  194.         directories is to map them to an explicit drive
  195.         letter (like "P:\"). This also enables CodAxe to
  196.         see how much space is left on that drive.
  197.  
  198.     - Selection of "What to do if target file exists":
  199.  
  200.         If you specify "Treat source files like already
  201.         processed" and selected "Delete" on the left side
  202.         be aware of the fact that source files will be
  203.         deleted without any further comment if there is a
  204.         file with the same name as the target file in the
  205.         destination directory, even if it's just empty or
  206.         invalid in any other way !
  207.  
  208.     - Selection of high speed / high quality:
  209.  
  210.         This selection only tells the codec what encoding
  211.         mode you'd like to use. Whether this selection
  212.         has any effect depends on the abilities of the
  213.         specific codec.
  214.         Not all codecs support different modes.
  215.  
  216.     - Running more than one CodAxe on the same source dirs
  217.  
  218.         Although CodAxe does not explicitly prevent you
  219.         from doing so, it is not reasonable to run more
  220.         than one incarnation of CodAxe at the same time on
  221.         a single-CPU machine because the task-switching
  222.         between the two or more CodAxes will waste time.
  223.         But you may want to run CodAxe more than once at
  224.         a time on a multi processor machine (if you are the
  225.         lucky owner of such a computer).
  226.         Probably the most common reason for running more
  227.         than one job at a time on the same set of source
  228.         file directories is the wish to use the computing
  229.         power of several computers connected together by
  230.         a LAN.
  231.         If more than one CodAxe run on the same source
  232.         files there is the problem of preventing CodAxe
  233.         from starting jobs other computers are already
  234.         dealing with. Currently CodAxe simply checks
  235.         whether a source file is already opened by other
  236.         programs. In that case the file is ignored.
  237.         Most of the time this will allow multiple recoding.
  238.         There is only one small chance for misoperation:
  239.         For deleting (or moving) the source file it's
  240.         necessary for the file to be closed. That means
  241.         that in the short time between closing and deleting
  242.         a source file is unprotected from being opened
  243.         by other recoding jobs. In this case the job trying
  244.         to delete (or move) the file will stop with an
  245.         error message and the other job will overwrite
  246.         the already generated target file (if you
  247.         configured CodAxe for Overwriting).
  248.         But as I already mentioned the probability for this
  249.         to happen is rather small.
  250.         Comments on multiple recoding with CodAxe are
  251.         (like all others) greatly appreciated.
  252.  
  253.  
  254. 6. Version history
  255. ------------------
  256.  
  257.  
  258.     Version 1.00 (28/4/98)
  259.  
  260.         first public release
  261.  
  262.     Version 1.01 (29/4/98)
  263.  
  264.         - fix of a time info problem with jobs running over
  265.           midnight
  266.         - The time a job is suspended is not counted any
  267.           more.
  268.  
  269.     Version 1.05 (5/6/98)
  270.  
  271.         - included selection of high speed / high quality
  272.           recoding
  273.           (all prior versions _always_ used high quality !)
  274.         - added "Delete/Move source file" option in case of
  275.           selection of "Stop after finishing this file"
  276.         - first release on the homepage
  277.  
  278.     Version 1.06 (5/23/98)
  279.  
  280.         - Bugfix:
  281.           The target format selection and saving sometimes
  282.           didn't work properly (wrong formats were written)
  283.         - Bugfix:
  284.           The size of the main window didn't adapt correctly
  285.           if the system wide font size was set to "large".
  286.         - Bugfix:
  287.           CodAxe hang if you entered more than one source
  288.           format and pressed the "select-source-folder-button".
  289.         - The currently set target format is preselected
  290.           properly now when opening the target format
  291.           selection dialog
  292.  
  293.     Version 1.10 (6/2/98)
  294.  
  295.         - Bugfix:
  296.           The target files were slightly bigger than
  297.           necessary (in almost every case, depending on
  298.           the copy buffer setting).
  299.         - Bugfix:
  300.           Files with more than one "." like "R.E.M.wav"
  301.           were not processed correctly.
  302.         - Bugfix:
  303.           CodAxe hang if you selected a certain combination
  304.           of "Stop after this file", "Delete source file"
  305.           and "Treat source files as already processed".
  306.         - Bugfix:
  307.           If you tried to generate a stereo file out of a
  308.           mono file (which is not allowed) the error was
  309.           not reported properly.
  310.         - Added target drive free space info
  311.         - Simplified directory handling
  312.         - Added drag & drop support:
  313.           You can now drag directories directly from the
  314.           explorer into the lists.
  315.         - Added playback of a WAV-file option for the
  316.           notification of job completion
  317.  
  318.     Version 1.11 (6/20/98)
  319.  
  320.         - Bugfix:
  321.           On startup a messagebox showing an error poped up
  322.           for every directory which has been deleted or
  323.           renamed since the last run.
  324.         - Bugfix:
  325.           Sometimes CodAxe blocked for some seconds if a
  326.           former network resource was not accessible any more.
  327.         - Added percentage and file information of the current
  328.           job the application title so that you can see what's
  329.           going on even with the CodAxe window minimized.
  330.  
  331.     Version 1.20 (7/1/98)
  332.  
  333.         - GUI heavily revised (main window is smaller now)
  334.         - Added two new directory modes (see section 4)
  335.         - Added "Recurse subdirectories" and
  336.           "Copy relative directory structures" options
  337.         - Changed a lot "under the hood"
  338.        (-> Added new bugs ? ;-)
  339.  
  340.     Version 1.20a (7/7/98)
  341.  
  342.         - Bugfix: Sometimes files or directories weren't found
  343.                   correctly
  344.         - Bugfix: Sometimes the "Try-Again time" could not
  345.                   properly specified.
  346.  
  347.     Version 1.30 (8/5/98)
  348.  
  349.         - Added system tray option
  350.         - Added new "Anti Overwrite Mode"
  351.         - Added instant go and instant minimize on startup
  352.         - Added power down option (Does it work under NT ?)
  353.         - from now on all error messages should pop up in front
  354.         - minor bugfixes and changes
  355.  
  356.  
  357. 7. Copyright stuff
  358. ------------------
  359.  
  360.     This software is FREEWARE, you are free to use it at no
  361.     charge. It may be distributed freely, as long as it is
  362.     not sold commercially without permission from me
  363.     <Mathias.Doenitz@gmx.net>.
  364.     Spreading this software and its documentation by
  365.     electronic networks or including it on CD ROMs
  366.     containing other free software is explicitly permitted
  367.     even when a modest distribution fee is charged for the
  368.     CD, as long as this software is not a primary selling
  369.     argument for the CD.
  370.     However, the program and its documentation must stay
  371.     unchanged and complete, including copyright notice
  372.     and disclaimer in all parts.
  373.  
  374.  
  375.     THIS PRODUCT IS SUPPLIED AS IS. The author disclaims all
  376.     warranties, expressed or implied, including, without
  377.     limitation, the warranties of merchantability and of
  378.     fitness for any purpose. The author assumes no liability
  379.     for damages, direct or consequential, which may result
  380.     from the use of this product.
  381.  
  382.  
  383.     CodAxe uses parts of a freeware ACM-Toolkit not written
  384.     by me but a person called Armin Sander.
  385.     These parts are (c) 1997 by Armin Sander and Digital
  386.     SimpleX GmbH.
  387.     Thanks to them for making CodAxe possible.
  388.  
  389.  
  390.  
  391. 8. Feedback and contact information
  392. -----------------------------------
  393.  
  394.  
  395.     The main part of this software was written within only 6
  396.     days and probably isn't bugfree. I wrote it primarily
  397.     for myself and thought it may be of use for others too.
  398.     All comments, critics, opinions, bugreports or anything
  399.     else related to this program are greatly appreciated if
  400.     sent to the following address:
  401.  
  402.                Mathias.Doenitz@gmx.net
  403.  
  404.  
  405.     Look on the CodAxe homepage "http://codaxe.home.pages.de/"
  406.     for updated versions !
  407.  
  408.