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