/****** palette.requester/--datasheet-- ******************************************
*
*   NAME
*       palette.requester -- Requester for editing a color palette
*
*   REQUIRES
*       supermodel.class
*       tcpalette.gadget
*       Reaction gadgets
*
*   METHODS
*       OM_NEW - 
*       OM_DISPOSE
*       OM_SET
*       OM_GET
*       RM_DOREQUEST - open requester
*       RM_DOREQUESTASYNC - unimplemented
*
*   ATTRIBUTES
*       PR_Screen - Screen to open requester on.
*       (OM_NEW, OM_SET)
*       
*       PR_Window - Parent Window
*       (OM_NEW, OM_SET)
*
*       PR_PubScreenName - Public Screen Name
*       (OM_NEW, OM_SET)
*
*       PR_Colors - Number of colors to edit 1..256
*       (OM_NEW, OM_SET)
*
*       PR_Palette - Palette to edit, must be at least 
*         PR_Colors entries in the array of struct prRGB.
*         When you get this attribute, you must supply a buffer
*         with enough memory to hold and PR_Colors size array of 
*         struct prRGB
*       (OM_NEW, OM_SET, OM_GET)
*
*       PR_TextAttr - TextAttr of gadget Text.
*       (OM_SET)
*
*       PR_TitleText - Text of window
*       (OM_NEW, OM_SET)
*
*       PR_PositiveText - "Ok"
*       (OM_NEW, OM_SET)
*
*       PR_NegativeText - "Cancel"
*       (OM_NEW, OM_SET)
*
*       PR_InitialTopEdge,LeftEdge,Width,Height - Initial values for window. 
*         not implemented.
*       (OM_NEW, OM_SET)
*
*       PR_Red/Green/BlueBits - Bits per component. not implemented. 
*
*   RESULT
*
*   EXAMPLE
*
*   NOTES
*       While this requester keeps 32bit per component (RGB), due to limitations
*       of the slider gadget, edits only 8bits per component, only 256 levels.  
*       Future versions may fix this.
*
*   BUGS
*       Bad things will happen if you OM_GET PR_Palette with an array that 
*       doesn't have atleast PR_Colors entries.
*
*       The Undo gadget won't disable on the first pen edited.
*
*   SEE ALSO
*
******************************************************************************
*
*/

/****** palette.requester/PREQ_NewRequester ******************************************
*
*   NAME
*       PREQ_NewRequester -- Allocate a new Palette requester.
*
*   SYNOPSIS
*       Object = PREQ_NewRequester(Tags,...)
*
*       Object *PREQ_NewRequester(Tag, ...);
*       a0                        a0
*
*       Object *PREQ_NewRequesterA(struct TagItem *)
*       a0                                a0
*
*   FUNCTION
*       Allocates a new Palette requester object.
*       The palette requester is a BOOPSI object.
*       Further settings can be changed or read
*       with SetAttrs() or GetAttr().
*
*
*   SEE ALSO
*       palette.requester/--datasheet--
*
******************************************************************************
*
*/

/****** palette.requester/PREQ_DisposeRequester ******************************************
*
*   NAME
*       PREQ_DisposeRequester -- Dispose palette requester.
*
******************************************************************************
*
*/

/****** palette.requester/--history-- ******************************************
*
*   To Do -
*       * Maybe cause requester to notify other object WHILE open?
*       * Create pop-up gadget class (similar to GetScreenMode etc.)
*
*   44.1 - 
*       * OM_GET wasn't handled in the dispatcher.
*       * Getting PR_Palette now works - requester was kinda useless before.
*       * Setting PR_Screen, Window, PubScreenName will center the requester
*   44.2 - 
*       *Included version string
*
******************************************************************************
*
*/