DspAnNewRel

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

Note: This function was designed to only be used on Cicode objects, or the animation point object from the version 3.xx/4.xx toolbox.

Syntax

DspAnNewRel(nAN, X, Y)

nAN:

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