Unit 'intuition'	Package
[Overview][Constants][Types][Procedures and functions][Variables][Index]	[#amunits]

DrawImageState

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

Declaration

Source position: intuition.pas line 4097

procedure DrawImageState(

rp: pRastPort;

image: pImage;

leftOffset: LongInt;

topOffset: LongInt;

state: LongWord;

const drawInfo: pDrawInfo

);

Arguments

`rp`		RastPort for rendering
`image`		A pointer to a (preferably custom) image
`leftOffset`		Left positional offsets in pixels
`topOffset`		Top positional offsets in pixels
`state`		Visual state selected from above
`drawInfo`		A pointer to packed of pen selections and resolution.

Description

This function draws an Intuition Image structure in a variety of "visual states", 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.

DrawImage		Draw the specified Image structure into a RastPort.
GetScreenDrawInfo		Get pointer to rendering information.

DrawImageState

Declaration

Arguments

Description

See also