DrawCels

Draws a list of cels (one or more) to the buffer of a bitmap.

Synopsis

Err DrawCels (Item bitmapItem,CCB *ccb)

Description

This call sets up the cel engine according to parameters in the bitmapItem, and then submits to the cel hardware the list of cels specified by the ccb argument. When the call returns, the cels have been rendered.

Arguments

bitmapItem: Item number of a bitmap.

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.

GRAFERR_CELTIMEOUT is returned if the cel engine times out during the rendering process. The most likely cause of a cel engine time-out is a bad cel or CCB data being passed to the cel engine.

Implementation

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

Associated Files

graphics.h, graphics.lib

Notes

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