FIXTURE function

Synopsis
This function returns a fixture object created using an X and Y-coordinate (or a point object) and an angle.
Variations
FIXTURE(X, Y, Angle)
Returns a fixture object from an X and Y-coordinate and an angle.
Details | Examples | Details and examples
Parameters
X

Specifies the X-coordinate of the fixture's origin.

Supported types: Numeric.
Y

Specifies the Y-coordinate of the fixture's origin.

Supported types: Numeric.
Angle

Specifies the angle, in degrees, of the fixture.

Supported types: Numeric.
Returns
Returned types: Fixture.
Examples
1.

The following example returns a fixture object with the coordinates (10, 10) and an angle of 20º.

FIXTURE(10, 10, 20)
FIXTURE(Point, Angle)
Returns a fixture object from a point object and an angle.
Details | Examples | Details and examples
Parameters
Point

Specifies a point object that will be used as the origin for the fixture.

Supported types: Point.
Angle

Specifies the angle, in degrees, of the fixture.

Supported types: Numeric.
Returns
Returned types: Fixture.
Examples
1.

The following example returns a fixture object with the coordinates (10, 10) and an angle of 20º.

FIXTURE(POINT(10, 10), 20)
2.

The following example returns a fixture object with coordinates based on where a blob was found, with an angle of 90º. Note that the X and Y-coordinates of the blob found are contained in their own fixture, BlobAnalysis.BlobFound(1).Fixture. The POINT function returns those coordinates from the first fixture and ignores its angle. The FIXTURE function then adds its own specified angle to create a new fixture.

FIXTURE(POINT(BlobAnalysis.BlobFound(1).Fixture), 90)