home *** CD-ROM | disk | FTP | other *** search
/ Hidden Truth / Hidden Truth.iso / amiga / other / v43datatypes / picturedt-v43 / readme < prev   
Encoding:
Text File  |  1996-10-30  |  10.6 KB  |  331 lines
  1.  
  2.                         picture.datatype V43
  3.                           Copyright 1995-96
  4.                            Ralph Schmidt
  5.            Additional libs/tools/changes by F.Mariak/M.Scheler
  6.            All sub datatypes by Matthias Scheler
  7.  
  8.  
  9. This  version is a freely available picture.datatype that MUST ONLY be used
  10. with  a  licenced  CyberGraphX(TM)  software  package  when using non 8 bit
  11. screenmodes.  You aren't allowed to use this software with any non licenced
  12. CyberGraphX(TM)  "emulation"  in these modes.  You are allowed to use it on
  13. ECS/AGA only machines with the freely available cyberncg.library included.
  14.  
  15.  
  16.  
  17.  
  18. This is a
  19.  
  20. #######  ####### ######### ########
  21. #      # #           #     #      #
  22. #      # #           #     #      #
  23. #######  #####       #     ########
  24. #      # #           #     #      #
  25. #      # #           #     #      #
  26. #######  #######     #     #      #
  27.  
  28. Release
  29.  
  30. This means...not fully done, not fully tested, use it at your own risk.  It
  31. may cause problems...perhaps the world will end after you've installed it.
  32.  
  33. IF YOU CAN┤T ACCEPT THAT , PLEASE DO NOT INSTALL THIS PIECE OF SOFTWARE
  34.  
  35. THE DATE EXPIRATION CODE HAS BEEN REMOVED. IT DOES NOT EXPIRE AFTER 4MONTH
  36. ANYMORE.
  37.  
  38. cyberncg.library support for non CyberGraphX machines has been dropped.
  39.  
  40. ******************************************************************************
  41.  
  42. Reporting bugs:
  43.  
  44. If   you   find   any   bugs   in   this  software,  please  send  them  to
  45. cybergfx.dtbugs@vgr.com.   Since  this  software is unsupported, we make no
  46. guarantees  about  how  long  it will take to fix the bug, or if it will be
  47. fixed  at  all.   Bug fixes will be cheerfully accepted.  Please include as
  48. much detailed information as possible, including:
  49.  
  50.     1) the version numbers of the related libraries/datatypes you are
  51.        using
  52.     2) the data file that caused the bug (if its not too big)
  53.     3) the OS version and machine type you ran the program on
  54.  
  55. ******************************************************************************
  56.  
  57. #########################
  58. #                       #
  59. #Important Informations #
  60. #                       #
  61. #########################
  62.  
  63. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  64. IF YOU'RE USING THE APPS THAT ARE IN THE COMPATIBILITY LIST( CHECK OUT SOME
  65. LINES  BELOW)  YOU  HAVE  TO NAME YOUR APPLICATION EXACTLY LIKE IN THE LIST
  66. OTHERWISE WON'T RECOGNIZE IT.
  67. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  68.  
  69. The  Aminet  release  of the png.datatype supports the V43 picture.datatype
  70. but  because  of  a  late change to the API(DTA_ErrorLevel,DTA_ErrorNumber)
  71. these  don't  support  these  tags.   I  hope  that  the authors of these 2
  72. datatype update their datatypes in the next time.
  73.  The  tags  are VERY important in a low memory situation.
  74.  
  75.  A  V43  compatible tiff.datatype as well as an bmp.datatype have also been
  76. released so far.
  77.  
  78.  
  79. Problems
  80.  
  81. o PPaint doesn't load 24bit images. Well..PPaint checks the BMHD.depth of
  82.   the raw data for >8...too bad
  83.  
  84. o Picview outputs "not a standard bitmap or something like that". This
  85.   is caused by the cgfx "PLANESTOFAST" option.
  86.  
  87. The following functions aren't implemented yet.
  88.  
  89. o 24bit dithering to a very small depth planar bitmap may cause
  90.   "problems". No time to test this out.
  91. o Sorry...also no time(lazyness) to test out PixMap support. I hope
  92.   it works as defined.
  93. o Right now it also doesn't really care for Ham6/8 and Halfbright.
  94. o DTM_Print for truecolour pictures should differ the picture to 256 colours
  95.   and then print it.
  96. o Make a Gauge interface so it may be controlled by tags(but does that
  97.   really make sense ? imagine a gauge popping up when iprefs is loading
  98.   your background)
  99. o scrollable transparent picture handling should be improved.
  100.   Now it only switches back in nonmask mode.
  101. o ******* AMosaic crashes ******* in 16Bit mode...i don't know why
  102.   yet(it worked in that mode in summer of 95 ......).
  103.  
  104.  
  105. ############################################################################
  106.  
  107.  
  108. The jfif.datatype is using the "jpeg.codec"
  109.  
  110. The JPEG codec is Copyright ⌐ 1994 Christoph Feck, TowerSystems.
  111. All Rights Reserved.  It is based in part on the work of the
  112. Independent JPEG Group.
  113.  
  114. ############################################################################
  115.  
  116.  
  117.  
  118.  
  119. ****************************************************************************
  120.  
  121. ATTENTION:
  122.  
  123. YOU  NEED TO HAVE AT LEAST VERSION 40.66 OF CYBERGRAPHICS.LIBRARY INSTALLED
  124. TO  USE THIS RELEASE OF PICTURE.DATATYPE V43 IN CONJUNCTION WITH A GRAPHICS
  125. CARD !
  126.  
  127. IF YOU INSTALL THIS ARCHIVE ON A DRACO BASED SYSTEM PLEASE MAKE SURE NOT TO
  128. INSTALL THE CYBERGRAPHICS.LIBRARY COMING WITH THIS ARCHIVE !
  129.  
  130. ****************************************************************************
  131.  
  132. Release Notes
  133.  
  134. V43.755
  135.  
  136.  o new pcdt prefs program v43.3 included. It also works now when the v43
  137.    picture.datatype is actually not running
  138.  o new sub classes included
  139.  o added stack swapping code to picture.datatype dispatcher in order to fix
  140.    stack overflow related problems with applications which do not allocate
  141.    enough stack space
  142.  
  143. V43.754
  144.  
  145.  o fixed some bugs in method DTM_DRAW
  146.  o fixed some problems in conjunction with halfbrite source data
  147.  o new gif.datatype 43.14 included
  148.  
  149. V43.753
  150.  
  151.  o new pcdt prefs program v43.2 included
  152.  o the preferences file now has moved to env:sys
  153.  o new gif.datatype 43.13 included which fixes some strange crash problems
  154.  o fixed some problems in conjunction with planar graphic formats which
  155.    occasionally led to strange looking mwb-patterns
  156.  
  157. V43.751
  158.  
  159.  o the public semaphore is now available even if the picture.datatype is
  160.    expunged. This fixes a severe crash when the library is expunged
  161.  
  162. V43.750
  163.  o fixed a BYTE-READ from $0 when non v43 compatible applications called the 
  164.    picture.datatype
  165.  
  166. V43.748
  167.  
  168.  o gtlayout.library included in this archive. (required for the prefs
  169.    program)
  170.  o The application list which contains all V43 compatible applications may
  171.    now be configured with a seperate prefs program.
  172.  o removed support for environment variable "cybergraphics/pcdt_dither"
  173.    Please use the supplied prefs program PCDT to change dither settings now
  174.  o the expiration time is now 4 month instead of 1 month. So users who
  175.    can not access the net but get the datatype from an aminet cd are able
  176.    to use the picture.datatype release  for a certain amount of time
  177.    until a new version is released on cd
  178.  o there is an installer script now for v43 datatype installation which
  179.    also includes a backup option
  180.  o Tower JPEG Codec Class included as seperate archive
  181.  o new gif.datatype sub class V43.12 included
  182.  
  183. V43.718
  184.  
  185.  o bug fix in conjunction with datatype objects which require
  186.    mask planes and use planar bitmaps
  187.  o API-Demo source for datatype to ppm conversion added
  188.  o new versions of sub datatypes included
  189.  
  190. V43.716
  191.  
  192.  o ENV: "cybergraphics/pcdt_dither"
  193.    0 == Floyd Dithering(Better,slower) (DEFAULT)
  194.    1 == Ordered Dithering(Faster,Not so good gfx quality)
  195.  
  196. V43.713
  197.  
  198.  o new cybergraphics.library prerelease included
  199.  o the picture.datatype now uses ordered dithering as default.
  200.    A switch to select between floyd or ordered may follow in the
  201.    future
  202.  o included a new cyberncg.library which fixes a problem with
  203.    transparent images
  204.  o added V43 compatible PCX sub datatype to archive
  205.  
  206. V43.695
  207.  
  208.  o now supports AGA/ECS machines with cyberncg.library included in this archive.
  209.  
  210. V43.684
  211.  
  212.  o some internal structures have changed. Please use the new
  213.    cybergraphics.library coming with this archive
  214.  o the picture.datatype expires after a few weeks now
  215.    (all pre release versions will do that in the future)
  216.  o fixed a problem in conjunction with PDTA_DestBitMap and
  217.    ODF_USEFRIENDBITMAP which caused twice freed BitMaps in
  218.    the past
  219.  
  220. V43.667
  221.  o Fixed a 24bit->8Bit(OldBitmap) Dither problem.
  222.    Was caused by a change of the CyberBitmap checking code.
  223.    This may be the problem some experienced with PPaint which
  224.    i don't have to test it out...
  225.  
  226. V43.658
  227.  o Fixed a MUI Pattern problem
  228.  o Added DTM_DRAW...not tested
  229.  
  230. V43.647
  231.  o Fixed the remap problem some people experienced
  232.  
  233. V43.629
  234.  o Finally fixed the mysterious crash bug.
  235.  
  236. V43.6xx
  237.  o Multiview cludge
  238.  o Smarter Monitor ID overruling
  239.  o Alphachannel support
  240.  o fixed PDTA_DestMode,MODE_V42 fallback..
  241.  o Added an internal V43 compatibility list with the current entries:
  242.     "½ IPrefs ╗",
  243.     "multiview",
  244.     "amigaguide",
  245.     "amosaic",
  246.     "amosaic-as225",
  247.     "amosaic-amitcp",
  248.     "DirectoryOpus",
  249.         NULL
  250.  o Fixed Aspect=0 save problem
  251.  o smarter PDTA_UseFriendBitMap that only does something when needed
  252.  o Truecolour alphachannel mask generation activated...will be used
  253.    automaticly by OM_RENDER
  254.  o 8Bit transparent mask generation activated...will be used automaticly
  255.    by OM_RENDER
  256.  o Fixed V42 fallback mode mungwall problems with dithering..hopefully.
  257.  o OM_Render transparent special handling..see docs for more infos
  258.  o Subdatatype Error API improvement
  259.  o creating transparent mask without layout if needed
  260.  o Fixed long outstanding V42 fallback color problem bug visible with DirOpus and others.
  261.  
  262. V43.451
  263.  o Important!!!!!
  264.    Include Change
  265.    DTM_BLITPIXELARRAY -> DTM_WRITEPIXELARRAY
  266.  
  267.  o PDTA_DEST works now. This means if PDTA_DEST,MODE_V43 isn't set
  268.    by application programs, a slow old planar bitmap is returned to
  269.    not break old programs that can only handle that bitmap.
  270.    Sigh..i could add an application list that works bitmaps format
  271.    independent.
  272.    Only exception is IPrefs for now...it gets a chunky bitmap.
  273.  
  274.  o PDTA_UseFriendBitMap is implemented(Stuntzi)
  275.  
  276.  o PDTA_NumPixMapDir
  277.    DTM_CREATEPIXMAPDIR
  278.    DTM_FIRSTPIXMAPDIR
  279.    DTM_NEXTPIXMAPDIR
  280.    DTM_PREVPIXMAPDIR
  281.    DTM_BESTPIXMAPDIR
  282.  
  283.    added to support multi-volume gfx formats like TIFF.
  284.  
  285.  o DTM_READPIXELARRAY added to avoid the sub datatype data sharing
  286.    design problem of the picture.datatype. If you ask me i would
  287.    have disallowed any data sharing at all because it destroys the
  288.    meaning of OO.
  289.  
  290.  o GAUGE disabled...there should be GAUGE Method imho
  291.  
  292. V43.395
  293.  
  294.  o Added a cludge to avoid a BestModeID crash
  295.  o Added a Volume Gauge...will be configurable in the future
  296.  o ilbm.datatype that handles 24bit...thanx Matthias
  297.  
  298. V43.352
  299.  
  300.  o Fixed a problem with WBPattern(not only this) and some pictures.
  301.    The reason was that BestCModeIDTagList() doesn't always work
  302.    and i had no fallback mode so the returned monitorid was INVALID.
  303.    This caused a lot problems..expecially the HAM/HALFBRIGHT bit test
  304.    on the modeid resulted into a wrong decision because INVALID=-1.
  305.  
  306. V43.340
  307.  
  308.  o DTM_PRINT added. It does nothing for 24Bit bitmaps.
  309.  
  310. V43.338
  311.  
  312.  o DTM_COPY added. It writes 8Bit and 24Bit output.
  313.  
  314. V43.335
  315.  
  316.  o DTM_WRITE added. It writes 8Bit and 24Bit output.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324. Questions&Bugreports
  325. Don't expect fast response.
  326.  
  327. Ralfph Schmidt
  328. laire@popmail.owl.de
  329.  
  330.  
  331.