FastMapCel

Synopsis

void FastMapCel (CCB *ccb,Point *quad)

Description

FastMapCel() maps a cel onto the four points specified by the quad argument. The mapping is created by setting the delta fields specified in the 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.

This call requires that the CCB structures width and height fields are initialized by FastMapCelInit().

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 in graphics.lib V21.

Associated Files

graphics.h, graphics.lib

Caveats

The FastMapCel calls are not compatible with MapCel(), and cannot be called interchangeably. FastMapCel() operates less precisely than the MapCel(), and produces slightly different output.