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


NAME
    DrawImage -- Draw the specified Image structure into a RastPort.

SYNOPSIS
    DrawImage( RastPort, Image, LeftOffset, TopOffset )
               A0        A1     D0          D1

    VOID DrawImage( struct RastPort *, struct Image    *, WORD, WORD );

FUNCTION
    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-NULL,
    the next image is rendered as well, and so on until some
    NextImage field is found to be NULL.

INPUTS
    RastPort = pointer to the RastPort to receive image rendering
    Image = 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

RESULT
    None

NOTES
    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 the intuition.h include file for full details
    on using PlanePick).

BUGS

SEE ALSO
    DrawImageState(), EraseImage()