home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 2 / MECOMP-CD-II.iso / amiga / datatypes / embed_datatype / embed.datatype.doc < prev    next >
Encoding:
Text File  |  1997-10-13  |  3.5 KB  |  113 lines
  1. TABLE OF CONTENTS
  2.  
  3. embed.datatype/--datasheed--
  4. embed.datatype/--datasheed--                     embed.datatype/--datasheed--
  5.  
  6.    NAME
  7.        embed.datatype -- data type which embeds other objects
  8.  
  9.    SUPERCLASS
  10.        text.datatype
  11.  
  12.    FUNCTION
  13.        The embed data type, a sub-class of the text.datatype, is used
  14.        to view documents with embedded datatypes objects.
  15.  
  16.    METHODS
  17.        OM_NEW -- Create a new text object from a embed document file. The
  18.            source may only be a file.
  19.  
  20.        OM_GET -- The DTA_Methods attribute is created from local context.
  21.  
  22.        GM_GOACTIVE
  23.        GM_GOINACTIVE
  24.        DTM_CLEARSELECTED --
  25.  
  26.        DTM_TRIGGER --
  27.  
  28.    ATTRIBUTES
  29.        DTA_Methods -- Set to the supported set of methods, based
  30.            on the set got from the superclass, extended with methods
  31.            got from members.
  32.  
  33.        DTA_TriggerMethods -- Set of trigger methods
  34.  
  35.    BUGS
  36.        Horrors !
  37.  
  38.        - The text rendered by text.datatype ignores and "height" in the
  39.          line node, this results in a crazy display of text.
  40.          The embedded objects are shown correctly.
  41.  
  42.        - Inside GM_HANDLEINPUT: Return codes GMR_PREVACTIVE and
  43.          GMR_NEXTACTIVE are not supported yet; the usage of string
  44.          gadgets is limmited therefore :-(
  45.  
  46.        - A line box is drawn around each datatype, but the line is
  47.          outside of the gadget box set in the struct Line node.
  48.          A result of this inconsisteny may be an overwritten
  49.          window border.
  50.  
  51.        - Embedding the document itself causes an endless loop until
  52.          memory is full (then the datatypes waits for more memory...).
  53.  
  54.        - A new stack frame is allocated for each method; a smarter
  55.          stack managing scheme should be used.
  56.  
  57.        - animation.datatype has problems when calculating the
  58.          gadget box for it's tapedeck.gadget.
  59.          This works usually fine, but sometimes a small part of the
  60.          left border will be overwritten.
  61.  
  62.        - Trigger methods are send as a broadcast method to all
  63.          members instead to specific ones.
  64.  
  65.        - DTM_PRINT, DTM_COPY, DTM_WRITE etc. are currently not supported.
  66.  
  67.  
  68.    HISTORY
  69.        V1.1
  70.          Released to dta@amigaworld.com mailinglist for comments.
  71.  
  72.        V1.2
  73.          - Implemented own GM_RENDER, which supersets text.datatypes renderin
  74. g
  75.            completely.
  76.  
  77.          - Minor corrections
  78.  
  79.        V1.3
  80.          - Recompiled with SAS/C 6.58
  81.  
  82.          - Added missing WaitBlit in GM_RENDER.
  83.  
  84.          - AllocBitMap used for Line rebdering now uses BMF_MINPLANES and a
  85.            friend bitmap.
  86.  
  87.          - Internal DescroyVisibleList now sets the object's domain box to
  88.            { SHRT_MAX, SHRT_MAX, 0, 0 } instead of { 0, 0, 0, 0 }.
  89.  
  90.            This should fix problems if a datatypes class has problems with
  91.            clipping (e.g. 0 width and/or height).
  92.  
  93.          - Fixed (hopefully) the bug that the box EraseRect'ed at GM_RENDER
  94.            was 1 pixel in x/y too large.
  95.  
  96.          - Now implements correct usage of DTSIF_LAYOUT. This avoids
  97.            rendering and other unwanted actions during layout (e.g. this
  98.            reduces flickering).
  99.  
  100.          - Now a black box is drawn around the object. This feature can be
  101.            turned off at compile time by disableing the
  102.            DRAW_BOX_AROUND_OBJECT define cpp statement.
  103.            A 0-color box would be more usefull if HAM pictures/anims are
  104.            shown (ide taken from cdgxl).
  105.  
  106.  
  107.    NOTES
  108.  
  109.    SEE ALSO
  110.        text.datatype, amigaguide.datatype,
  111.        document.datatype
  112.  
  113.