FastMapCelInit

Synopsis

void FastMapCelInit (CCB *ccb)

Description

FastMapCelInit() initializes a CCB for use with MapCel. It requires that the ccb_Width and ccb_Height fields of the CCB are correct when the routine is called, and that the routine will replace the current values of the ccb_Width and ccb_Height fields. If the ccb_Width and ccb_Height of the cel are both powers of 2, then they are replaced by the log(base 2) of their respective values. If one or both fields are not a power of 2, the ccb_Width is replaced by (-0x10000/ccb_Width) and ccb_Height is replaced by (0x10000/ccb_Height).

Arguments

ccb: Pointer to the CCB structure to be modified.

Implementation

Convenience call implemented in graphics.lib V21.

Associated Files

graphics.h, graphics.lib

Caveats

The FastMapCel calls are not compatible with MapCel(), and cannot be called interchangeably.

Since this call modifies the ccb_Width and ccb_Height fields of the CCB, it cannot be called multiple times for the same CCB.