# TransFixtureToWorld

Converts a fixture A fixture is a coordinate location on the image that keeps the tool in the place determined by the fixture. from pixel coordinates to real-world coordinates.

Note: The output of any vision tool that reports in real-world coordinates cannot be used as a fixture or region input to another vision tool.
Inputs

The TransFixtureToWorld function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. has the following syntax:

TransFixtureToWorld(Calib, Fixture, Show)

See the table for a description of the available parameters.

Parameter | Description
Calib | A reference to a spreadsheet cell containing a valid Calib data structure.
Fixture | Specifies the fixture coordinate system.
X | The X-offset of the origin, in fixture coordinates.
Y | The Y-offset of the origin, in fixture coordinates.
Theta | The rotation from the image X-axis, in the image coordinate system. (+/-360 degrees clockwise)
Show | Specifies the display mode for the TransPixelToWorld graphic overlay on the image.
0 = hide all (default) | The fixture is hidden, except when the cell containing the TransPixelToWorld function is highlighted in the spreadsheet.
2 = input graphics only | The fixture is always displayed.

Outputs

Returns | A Fixture data structure containing the transformed fixture, or #ERR if any of the input parameters are invalid.