FastMapCelf16

Synopsis

void FastMapCelf16 (CCB *ccb,Point *quad)

Description

FastMapCelf16() maps a cel onto the four points specified by the quad argument. The mapping is created by setting the delta fields in the specified ccb argument. The deltas cause the cel to be rendered such that the four corners of the imagery map to the four corners.

The quad argument points to an array of four-point structures. In the normal configuration of the quad, the first entry refers to the top left-corner of the imagery, the second entry refers to top-right, the third to bottom-right, and the fourth to bottom-left. Those corners of the cel imagery map to those four entries in the quad, no matter what values are given to the quad entries.

FastMapCelf16() is different from MapCel() and FastMapCel() in that it expects the values in the quad structure to be frac16 values and not int32 values.

This call expects that the CCB structures width and height fields have been initialized by the FastMapCelInit() routine.

Arguments

ccb: Pointer to the CCB structure whose delta fields are modified to map to the quad.

quad: Pointer to a four-entry array of Point structures.

Implementation

Convenience call implemented graphics.lib V21.

Associated Files

graphics.h, graphics.lib

Caveats

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