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

DrawImage

Draw the specified Image structure into a RastPort.

Declaration

Source position: intuition.pas line 3820

procedure DrawImage(

  Rp: PRastPort;

  Image: PImage;

  LeftOffset: LongInt;

  TopOffset: LongInt

);

Arguments

Rp

  

A pointer to the RastPort to receive image rendering

Image

  

A pointer to an image structure

LeftOffset

  

The offset which will be added to the image's x coordinate

TopOffset

  

The offset which will be added to the image's y coordinate

Description

First, sets up the draw mode and pens in the RastPort according to the arguments of the Image structure. Then, moves the image data of the image argument into the RastPort, offset by the left and top offsets.

This routine does window layer clipping if you pass your window's (layered) RastPort -- if you draw an image outside of your window, your imagery will be clipped at the window's edge. If you pass a (non-layered) screen RastPort, you must be sure your image is wholly contained within the rastport bounds.

If the NextImage field of the image argument is non-nil, the next image is rendered as well, and so on until some NextImage field is found to be nil.

Note:

Intuition always has and will continue to assume there are at least as many planes of data pointed to by ImageData as there are '1' bits in the PlanePick field. Please ensure that this is so.

See also

DrawImageState

  

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

EraseImage

  

Erases an Image.


Documentation generated on: 2021-07-30