home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga 12 / MA_Cover_12.iso / libs / mysticlib / readme < prev    next >
Encoding:
Text File  |  1999-06-07  |  2.1 KB  |  72 lines
  1. Short:    RTG image viewing library
  2. Author:   Timm S. Müller
  3. Uploader: Timm S. Müller (Timm.Mueller@darmstadt.netsurf.de)
  4. Type:     dev/misc
  5. Version:  4.2
  6. Requires: Kickstart 3.0 (v39), MC68020
  7.  
  8.  
  9.   mysticview.library is the third abstraction layer in top of
  10.   guigfx.library and render.library.
  11.   
  12.   mysticview.library implements an RTG image display class. it
  13.   renders images of any kind to a RastPort on any screenmode.
  14.  
  15.   there are no considerations on the programmer's side
  16.   required for issues such as screenmodes, aspect ratios,
  17.   scaling, OCS/ECS/AGA, HAM, chunky/planar, 8bit, 1bit, 24bit
  18.   or alike. all you have to do is to specify a Screen, a
  19.   RastPort, a guigfx.library 'picture' and some attributes.
  20.   images will be rendered, scaled and dithered automatically,
  21.   when needed.
  22.  
  23.   rendering and layouting takes place in the background. you
  24.   create the object, and forget it. the background task
  25.   instantly reacts to changes of attributes and will redraw
  26.   the display when needed. opaque scaling and SIMPLE_REFRESH
  27.   is easily implemented, you only need to supply new
  28.   attributes. a protection mechanism is implemented for
  29.   sharing the RastPort between your application and the
  30.   background task of mysticview.library.
  31.  
  32.   this library makes it REALLY EASY to display any kind of
  33.   pictures inside any kind of application. there are no
  34.   examples included in this archive - the basic implementation
  35.   looks like this:
  36.   
  37.   APTR picture, mview;
  38.   
  39.   picture = LoadPicture("filename", TAG_DONE);
  40.  
  41.   mview = MV_Create(screen, rastport, MVIEW_Picture, picture,
  42.      TAG_DONE);
  43.  
  44.   if (mview)
  45.   {
  46.     MV_DrawOn(mview);
  47.     while(...) { /* image visible */ }
  48.   }
  49.   
  50.   MV_Delete(mview);
  51.   DeletePicture(picture);  
  52.  
  53.   mysticview.library is the fully encapsulated display engine
  54.   of the image viewer 'MysticView'. you are free to use this
  55.   library in freeware and shareware applications.
  56.  
  57.  
  58. requirements
  59. --------------------------------------
  60.  
  61.   - os3.0 (v39)
  62.   - 68020, minimum suggested: 68030/50
  63.   - guigfx.library v16 (dev/misc/guigfxlib.lha)
  64.   - render.library v30 (dev/misc/renderlib.lha)
  65.  
  66.   supports
  67.   
  68.   - higher cpu, fpu
  69.   - os3.1 (v40)
  70.   - cybergraphics, picasso96
  71.  
  72.