A calibration fixture is a physical object that you use as a reference point for the scanners' coordinate system. You use these parameters to tell JSDiag the location of the features that make up this object. The available features are CircleFeature's, SquareFeature's, and LineFeature's. A calibration fixture can be made up of many features of only one type, i.e. a lot of CircleFeature's with no SquareFeature's or LineFeature's.

You can put many different CalibFixture's in a single parameter file. A single ScannerConfig can have many different CalibFixture names listed with it's CalibrationFixtureNames parameter.

CalibFixture . 

There can be multiple CalibFixture blocks in a single parameter file, each one with a different name. Calibration fixtures are declared in the same parameter file as the ScannerConfig's. All the features must be the same type within a calibration fixture.

CalibrationFixtureNames . 

Goes in a ScannerConfig to tell those scanners to use the listed calibration fixtures in the Calibration Editor.

CircleFeature . 

The first number is the radius of the circle. The last two numbers are the x-y coordinates of the center of the circle. The radius must be greater than zero. It's easiest to calibrate against if the fixture is asymmetrical -- there's only one way to get it right. They cannot be mixed with SquareFeature's or LineFeature's.

#A sample CalibFixture with a few circles in it
CalibFixture SomeCircles
{
	#             Radius  CenterX  CenterY
	CircleFeature  1.0     -2.0     -3.0    #Radius is 1.0 Centered at the coordinates (-2.0", -3.0")
	CircleFeature  1.0      2.0      3.0    #Radius is 1.0 Centered at the coordinates ( 2.0",  3.0")
	CircleFeature  3.0      2.0     -1.0    #Radius is 3.0 Centered at the coordinates ( 2.0",  1.0")
}

SquareFeature . 

The first two numbers are the x-y coordinates of the lower-left corner. The third number is the width of the square, and the fourth number is the height of the square. The width and height must be greater than zero. They cannot be mixed with CircleFeature's or LineFeature's.

#A sample CalibFixture with a few squares in it
CalibFixture SomeSquares
{
	#             LeftX  BottomY  Width  Height
	SquareFeature  0.0    -1.0     1.0    2.0    #Bottom-Left corner at (0.0", 0.0"), 1.0" wide and 2.0" tall
	SquareFeature  1.0     2.0     3.0    4.0    #Bottom-Left corner at (1.0", 2.0"), 3.0" wide and 4.0" tall
}

LineFeature . 

The first two numbers are the x-y coordinates of the beginning of the line and the last two numbers are the x-y coordinates of the end of the line. They cannot be mixed with CircleFeature's or SquareFeature's.

#A sample CalibFixture with a few lines in it
CalibFixture SomeLines
{
	#            FirstX  FirstY  SecondX  SecondY
	LineFeature   0.0     0.0      1.0      1.0    #A line from (0.0", 0.0") to (1.0", 1.0")
	LineFeature   1.0     1.0      2.0      0.0    #A line from (1.0", 1.0") to (2.0", 0.0")
	LineFeature   2.0     0.0      3.0      3.0    #A line from (2.0", 0.0") to (3.0", 3.0")
}