MapCelListToFPoint

Sets a list of cel's locations to a point.

Synopsis

void MapCelListToFPoint (CCB *list, FPoint *newPosition, Boolean copyPerspective)

Description

This function sets a list of cels to the given coordinates. It sets the X/Y coordinates of the first cel to the specified values. It then adjusts the X/Y coordinates of the rest of the cels in the list such that the cels maintain the same relative X/Y relationships to each other. The net effect is that the list of cels moves as if it were a single unit.

This function can optionally propagate the size and perspective values already present in the first cel to the rest of the cels in the list. This is useful if you are manipulating size and perspective values manually. To propagate the size and perspective without changing the positions, use one of the OffsetCelList() functions with delta values of zero.

Arguments

list: Pointer to a list of one or more cels to be mapped.

newPosition: Pointer to the FPoint to which the cel is to be mapped.

copyPerspective: TRUE to copy the size and perspective fields from the first cel to the rest of the list. FALSE to leave all size and perspective fields as is.

Implementation

Library call implemented in lib3do.lib.

Associated Files