Description

Creates a new McSpatialCalib instance and adds it to the McSpatialCalibs collection.

Return Type

A McSpatialCalib object.  

McSpatialCalib* the new calibration.

Syntax

object.AddEx (Name, Flags)

The AddEx Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McSpatialCalibs.
NameRequired. A String value.

The name given to the McSpatialCalib.Name property. If an empty name is supplied, the Name is “calibration#”. See McSpatialCalib.Name for more details.

FlagsRequired. A mccfCalibFlags enumeration, as described in settings.

The calibration flags applied to the new calibration.

Settings

The settings for Flags are:

ConstantValueDescription
 mccfIsReference1

If set, the calibration is a reference calibration

 mccfIsSystem2

If set, the calibration is the system calibration

 mccfWasDerived256

If set, the calibration was derived from another calibration masks

 mccfUserFlags-65536

Flags for use by user

 mccfAddFlags-65281

All unmasked flags are ignored by AddEx and Flags property assignment

 mccfNoFlags0
 mccfAllFlags-1

Remarks

An McSpatialCalib instance is created with the specified name and flags. Other properties are initialized to default values. The new calibration is also added to the SpatialCalibs collection.

“For each” enumerations will only find McSpatialCalib instances which are part of the collection, and there is no need to keep an AddRef on the interface instance. McSpatialCalibs.Item will return only collection members for numeric (index value) arguments, but it will find any calibration with a matching Name for string arguments, whether the calibration is part of the calibrations collection or not.

Exceptions

Resource limits.

Notes

The new calibration is also added to the SpatialCalibs collection.