DrawScreenCels

Draws a list of cels (one or more) to the bitmaps of a screen.

Synopsis

Err DrawScreenCels (Item screenItem,CCB *ccb)

Description

DrawScreenCels traverses the list of bitmaps associated with the screen specified by the screenItem argument, calling DrawCels() for each bitmap. When this call returns, all cels are rendered into all bitmaps of the screen.

Arguments

screenItem: Item number of a screen structure.

ccb: Pointer to the first of one or more CCB structures.

Return Value

The call returns 0 if successful or an error code (a negative value) if an error occurs.

Implementation

Folio call implemented in Graphics folio V20. It became an SWI in Graphics folio V24.

Associated Files

graphics.h, graphics.lib

Notes

DrawScreenCels() operates faster when the task or thread calling it owns bitmap, as opposed to simply calling OpenItem() on the bitmap.