DrawImageState

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

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.

RPort

RastPort for rendering

Image

pointer to a (preferably custom) image

LeftOffset

see next

RightOffset

positional offsets in pixels

State

visual state selected from above

DrawInfo

pointer to packed of pen selections and resolution.

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