home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 13 / AACD13.ISO / AACD / Programming / MR_Classes / Dev / Docs / palette_req.doc next >
Encoding:
Text File  |  2000-08-04  |  3.2 KB  |  123 lines
  1. TABLE OF CONTENTS
  2.  
  3. palette.requester/--datasheet--
  4. palette.requester/--history--
  5. palette.requester/PREQ_DisposeRequester
  6. palette.requester/PREQ_NewRequester
  7. palette.requester/--datasheet--               palette.requester/--datasheet--
  8.  
  9.    NAME
  10.        palette.requester -- Requester for editing a color palette
  11.  
  12.    REQUIRES
  13.        supermodel.class
  14.        tcpalette.gadget
  15.        Reaction gadgets
  16.  
  17.    METHODS
  18.        OM_NEW - 
  19.        OM_DISPOSE
  20.        OM_SET
  21.        OM_GET
  22.        RM_DOREQUEST - open requester
  23.        RM_DOREQUESTASYNC - unimplemented
  24.  
  25.    ATTRIBUTES
  26.        PR_Screen - Screen to open requester on.
  27.        (OM_NEW, OM_SET)
  28.        
  29.        PR_Window - Parent Window
  30.        (OM_NEW, OM_SET)
  31.  
  32.        PR_PubScreenName - Public Screen Name
  33.        (OM_NEW, OM_SET)
  34.  
  35.        PR_Colors - Number of colors to edit 1..256
  36.        (OM_NEW, OM_SET)
  37.  
  38.        PR_Palette - Palette to edit, must be at least 
  39.          PR_Colors entries in the array of struct prRGB.
  40.          When you get this attribute, you must supply a buffer
  41.          with enough memory to hold and PR_Colors size array of 
  42.          struct prRGB
  43.        (OM_NEW, OM_SET, OM_GET)
  44.  
  45.        PR_TextAttr - TextAttr of gadget Text.
  46.        (OM_SET)
  47.  
  48.        PR_TitleText - Text of window
  49.        (OM_NEW, OM_SET)
  50.  
  51.        PR_PositiveText - "Ok"
  52.        (OM_NEW, OM_SET)
  53.  
  54.        PR_NegativeText - "Cancel"
  55.        (OM_NEW, OM_SET)
  56.  
  57.        PR_InitialTopEdge,LeftEdge,Width,Height - Initial values for window. 
  58.          not implemented.
  59.        (OM_NEW, OM_SET)
  60.  
  61.        PR_Red/Green/BlueBits - Bits per component. not implemented. 
  62.  
  63.    RESULT
  64.  
  65.    EXAMPLE
  66.  
  67.    NOTES
  68.        While this requester keeps 32bit per component (RGB), due to limitatio
  69. ns
  70.        of the slider gadget, edits only 8bits per component, only 256 levels.
  71.   
  72.        Future versions may fix this.
  73.  
  74.    BUGS
  75.        Bad things will happen if you OM_GET PR_Palette with an array that 
  76.        doesn't have atleast PR_Colors entries.
  77.  
  78.        The Undo gadget won't disable on the first pen edited.
  79.  
  80.    SEE ALSO
  81.  
  82. palette.requester/--history--                   palette.requester/--history--
  83.  
  84.    To Do -
  85.        * Maybe cause requester to notify other object WHILE open?
  86.        * Create pop-up gadget class (similar to GetScreenMode etc.)
  87.  
  88.    44.1 - 
  89.        * OM_GET wasn't handled in the dispatcher.
  90.        * Getting PR_Palette now works - requester was kinda useless before.
  91.        * Setting PR_Screen, Window, PubScreenName will center the requester
  92.    44.0 - 
  93.  
  94. palette.requester/PREQ_DisposeRequesteralette.requester/PREQ_DisposeRequester
  95.  
  96.    NAME
  97.        PREQ_DisposeRequester -- Dispose palette requester.
  98.  
  99. palette.requester/PREQ_NewRequester       palette.requester/PREQ_NewRequester
  100.  
  101.    NAME
  102.        PREQ_NewRequester -- Allocate a new Palette requester.
  103.  
  104.    SYNOPSIS
  105.        Object = PREQ_NewRequester(Tags,...)
  106.  
  107.        Object *PREQ_NewRequester(Tag, ...);
  108.        a0                        a0
  109.  
  110.        Object *PREQ_NewRequesterA(struct TagItem *)
  111.        a0                                a0
  112.  
  113.    FUNCTION
  114.        Allocates a new Palette requester object.
  115.        The palette requester is a BOOPSI object.
  116.        Further settings can be changed or read
  117.        with SetAttrs() or GetAttr().
  118.  
  119.  
  120.    SEE ALSO
  121.        palette.requester/--datasheet--
  122.  
  123.