====== 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.

==== See Also ====

''%%DrawScreenCels%%''()