[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


NAME
    DrawImageState -- Draw an (extended) Intuition Image with
            special visual state. (V36)

SYNOPSIS
    DrawImageState( RPort, Image, LeftOffset, TopOffset, State, DrawInfo )
                    A0     A1     D0          D1         D2     A2

    VOID DrawImageState( struct RastPort *, struct Image *,
            WORD, WORD, ULONG, struct DrawInfo * );

FUNCTION
    This function draws an Intuition Image structure in a variety of
    "visual states," which are defined by constants in
    intuition/imageclass.h.  These include:
    IDS_NORMAL              - like DrawImage()
    IDS_SELECTED            - represents the "selected state" of a Gadget
    IDS_DISABLED            - the "ghosted state" of a gadget
    IDS_BUSY                - for future functionality
    IDS_INDETERMINATE       - for future functionality
    IDS_INACTIVENORMAL      - for gadgets in window border
    IDS_INACTIVESELECTED    - for gadgets in window border
    IDS_INACTIVEDISABLED    - for gadgets in window border

    Only IDS_NORMAL will make sense for traditional Image structures,
    this function is more useful when applied to new custom images
    or "object-oriented image classes."

    Each class of custom images is responsible for documenting which
    visual states it supports, and you typically want to use images
    which support the appropriate states with your custom gadgets.

    The DrawInfo parameter provides information invaluable to
    "rendered" images, such as pen color and resolution.  Each
    image class must document whether this parameter is required.

INPUTS
    RPort   - RastPort for rendering
    Image   - pointer to a (preferably custom) image
    LeftOffset,RightOffset - positional offsets in pixels
    State   - visual state selected from above
    DrawInfo - pointer to packed of pen selections and resolution.

RESULT
    None.

EXAMPLE
    Provided separately in the DevCon '90 disk set.

NOTES


BUGS


SEE ALSO
    DrawImage(), GetScreenDrawInfo(), intuition/imageclass.h