[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()