# TransFixtureToWorld

Converts a 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.

## TransFixtureToWorld Inputs

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.

## TransFixtureToWorld Outputs

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