home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 110 / af110sub.adf / DTConvert.lzx / DTConvert / DTConvert.doc < prev    next >
Text File  |  1998-03-11  |  8KB  |  203 lines
  1. DTConvert/DTConvert                                       DTConvert/DTConvert
  2.  
  3.     NAME
  4.        DTConvert -- DataTypes-based conversion tool
  5.  
  6.     FORMAT
  7.        DTConvert [FROM|NAME|SRCNAME <file>]
  8.                  [DESTDATATYPE|DATATYPE|DTN <datatype>] [IFF]
  9.                  [TO|DESTNAME <file>] [GUI] [PUBSCREEN <public screen>]
  10.  
  11.     TEMPLATE
  12.        FROM=NAME=SRCNAME,DESTDATATYPE=DATATYPE=DTN,IFF/S,TO=DESTNAME,
  13.        GUI/S,PUBSCREEN/K
  14.  
  15.     PURPOSE
  16.        Convert data from one format into another format using datatypes
  17.        classes.
  18.  
  19.     DESCRIPTION
  20.        DTConvert converts data from one format into another format,
  21.        e.g. picture -> picture,
  22.             animation -> anmation,
  23.             movie -> movie,
  24.             sound -> sound,
  25.             text -> text (n/a)
  26.  
  27.       You simply have to set the souce file name (SRCNAME), the
  28.       datatype to convert to (DATATYPE) (or the IFF switch if you want to
  29.       convert into the base-IFF format and the destination file name (TO).
  30.  
  31.     BUGS
  32.       - picture.datatype V43 interface not implemented.
  33.         This causes that any encoder only runs in V42 mode any may
  34.         only encode 8 bit data.
  35.  
  36.       - path names are limitted to 1024 chars, larger filenames may cause
  37.         mailfunctions
  38.  
  39.       - the IFF switch is incompatible to the GUI switch because the GUI
  40.         as no IFF checkbox gadget, nor does the GUI check if the IFF
  41.         switch was set.
  42.  
  43.       - datatypes.library versions V45.3 and V45.4 have a bug in
  44.         NewDTObjectA which causes that a descriptor is unlocked too often,
  45.         which results in an Alert( 3500000 ). V45.5 fixes this.
  46.  
  47.       - Added an error text in the case that a datatypes class does not
  48.         support an encoder part...
  49.  
  50.     NOTES
  51.       - picture.datatype V43 pixmap interface not supported.
  52.  
  53.       - text conversion not supported yet.
  54.  
  55.     TODO
  56.       - picture.datatype V43 compatibility
  57.  
  58.       - text conversion (GID_TEXT -> GID_TEXT), e.g. IFF FTXT <-> Ascii
  59.  
  60.       - document conversion (GID_DOCUMENT -> GID_DOCUMENT), after
  61.         Stefan Ruppert and I finsished the document.datatype concepts.
  62.  
  63.     HISTORY
  64.        V1.1:
  65.          - First release to dta@amigawolrd.com mailinglist.
  66.  
  67.        V1.2:
  68.          - Added support for animation.datatype subclasses
  69.  
  70.        V1.3:
  71.          - Minor fixes.
  72.  
  73.        V1.4
  74.          - Added support for sound.datatype V40 subclasses, partial support
  75.            for suggested sound.datatype V41 interface.
  76.  
  77.          - Added some usefull comments.
  78.  
  79.          - WriteAnimClass/WriteSoundClass now sets
  80.            SetIoErr( ERROR_REQUIRED_ARGUMENT_MISSING ); if something goes
  81.            wrong (this should abort the encoder; only ERROR_OBJECT_NOT_FOUND
  82.            is accepted here).
  83.  
  84.          - Fixed some holes in the error handling.
  85.  
  86.          - GUI added.
  87.  
  88.          - Added WB support
  89.  
  90.          - Added ENV variable support; a local or global (ENV) variable
  91.            "DTConvert" takes the same arguments as the shell template.
  92.            Variable settings can be overridden by any argument.
  93.  
  94.          - Project split in seperate sources (e.g. main, GUI, converters)
  95.  
  96.        V1.5
  97.          - Added the feature that the datatypes selection requester shows
  98.            only entries which match the source group IDs
  99.            (if a source has been already selected).
  100.  
  101.          - Added kluge which alows the conversion between GID_MOVIE
  102.            and GID_ANIMATION datatypes (both are based on
  103.            animation.datatype, here we have the same interface :-)
  104.  
  105.          - Fixed the bug that ConvertAnimation function did not deal
  106.            with truecolor bitmaps (e.g. CyberGFX bitmaps for example,
  107.            truecolor bitmaps are indicated by ADTA_NumColors == 0.
  108.            Fixed.
  109.  
  110.        V1.6
  111.          - Fixed the bug that ObtainDataTypeA was called for each
  112.            INTUITICK if the datatype selection requester was open.
  113.            Fixed.
  114.  
  115.        V1.7
  116.          - Fixed the bug that a descriptor was unlocked too often
  117.            in some cases. See BUGS section above about a matching bug
  118.            in datatypes.library V45.3 and V45.4 (V45.5 fixes this).
  119.            Fixed (both "datatypes.library" and "DTConvert").
  120.  
  121.          - The datatypes requester now accepts ESC as "Cancel" and
  122.            RETURN as OK.
  123.  
  124.          - The tool can now be aborted by SIGBREAKF_CTRL_C.
  125.  
  126.          - Fixed the bug that somtimes an error return code
  127.            was overwritting by the Message() function.
  128.  
  129.          - Fixed the bu that the IFF comandline switch did not work
  130.            (the GUI prompted everytimes in this case). But IFF and
  131.            GUI switches does currently not co-operate :-(
  132.  
  133.          - Fixed a bug in the WB startup code which caused that a project
  134.            without an icon wasn't processed. The code now uses
  135.            GetDiskObjectNew instead of GetDiskObject to fix this.
  136.            Fixed.
  137.  
  138.          - If launched from WB, "DTConvert" now opens a console window
  139.            manually. Previously, the default WB output channel was used
  140.            (which was NIL:).
  141.            Same for project childs.
  142.  
  143.          - Added output which prints a message if a subclass does not
  144.            implement a local encoder. This was only done to get rid
  145.            of mails like "your DTConvert has a bug: IFF ILBM -> PNG does
  146.            not work...". These mails should go to the authors of the
  147.            datatype classes, not to me. Sorry, but...
  148.  
  149.          - If more than one project icon is given at WB startup, "DTConvert"
  150.            now launches the matching number of projects instead
  151.            of processing the given icons in sequence.
  152.  
  153.          - Fixed problems with WB project startup and the current directory.
  154.  
  155.          - The icon now contains the (possible) options and sets the
  156.            stack size up to 16384 bytes.
  157.  
  158.     AUTHOR's REQUEST
  159.         By  releasing  this program I do  not  place any obligations on you,
  160.         feel free to share this program with your  friends (and enemies).
  161.  
  162.         If you want to blame me, report any bugs, or wants a new version
  163.         send your letter to:
  164.                         Roland Mainz
  165.                         Hohenstaufenstraße 8
  166.                         52388 Nörvenich
  167.                         GERMANY
  168.  
  169.         Phone: (+49)(0)2426/901568
  170.         Fax:   (+49)(0)2426/901569
  171.  
  172.         EMAIL is also available:
  173.         GISBURN@w-specht.rhein-ruhr.de
  174.  
  175.         If you want to send me attachments larger than 1MB (up to 5MB,
  176.         more with my permission):
  177.         Up to April 1998 I'm reachable using this email address, too:
  178.         Reinhold.A.Mainz@KBV.DE
  179.  
  180.         | Please put your name and address in your mails !
  181.         | German mailers should add their phone numbers.
  182.         | See BUGS section above when submitting bug reports.
  183.  
  184.         Sorry, but I can only look once a week for mails.
  185.         If you don't hear something from me within three weeks, please
  186.         send your mail again (but watch about new releases) (problems with
  187.         this email port are caused by reconfigurations, hackers, network
  188.         problems etc.).
  189.  
  190.         The  entire  "DTConvert"  package may  be  noncommercially
  191.         redistributed, provided  that  the package  is always  distributed
  192.         in it's complete  form (including it's documentation).  A small copy
  193.         fee for media costs is okay but any kind of commercial distribution
  194.         is strictly forbidden! Comments  and  suggestions  how  to  improve
  195.         this program  are generally appreciated!
  196.  
  197.         Thanks to Matt Dillon for his DICE, David Junod for this datatypes
  198.         environment and Olaf 'Olsen' Barthel for his help, ideas and some
  199.         text clips from his documentations.
  200.  
  201.     SEE ALSO
  202.  
  203.