Cicode Programming Reference > Cicode Function Categories > Display Functions Introduction > DspAnNewRel

DspAnNewRel

Note: This function is only used for V3.xx and V4.xx animations, and was superseded in later releases.

Creates an AN at a distance of x,y pixels from a specified AN.

Syntax

DspAnNewRel(AN, X, Y)

AN:

The AN used as a reference for the new AN.

X:

The distance in the x plane (in pixels) from the reference AN to the new AN.

Y:

The distance in the y plane (in pixels) from the reference AN to the new AN.

Return Value

If successful, the new AN is returned. If the AN cannot be created, -1 is returned. If an AN already exists at this location, that AN is returned.

Related Functions

DspAnNew, DspGetAnCur

Example

AN=DspAnNewRel(20,100,200);
/* Creates an AN at 100x and 200y pixels from AN20 */

See Also

Display Functions