DrawImageState.md

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 * );

Links: Image DrawInfo RastPort Image 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