Description

Represents a surface hole tool.

Inheritance diagram for GoSurfaceHole:

Public Member Functions
kBool	GoSurfaceHole_AutoTiltEnabled (GoSurfaceHole tool)
	Gets the enabled state of auto-tilt. More...

kStatus	GoSurfaceHole_EnableAutoTilt (GoSurfaceHole tool, kBool enable)
	Sets the enabled state of auto-tilt. More...

kStatus	GoSurfaceHole_EnablePartialDetection (GoSurfaceHole tool, kBool enable)
	Sets the enabled state of partial detection. More...

kStatus	GoSurfaceHole_EnableRefRegions (GoSurfaceHole tool, kBool enable)
	Sets the enabled state of reference regions. More...

kStatus	GoSurfaceHole_EnableRegion (GoSurfaceHole tool, kBool enable)
	Sets the enabled state of the tool region. More...

k64f	GoSurfaceHole_NominalRadius (GoSurfaceHole tool)
	Gets the current nominal radius value. More...

kBool	GoSurfaceHole_PartialDetectionEnabled (GoSurfaceHole tool)
	Gets the enabled state of partial detection. More...

GoSurfaceHoleRadius	GoSurfaceHole_RadiusMeasurement (GoSurfaceHole tool)
	Returns a GoSurfaceHole Radius measurement object. More...

k64f	GoSurfaceHole_RadiusTolerance (GoSurfaceHole tool)
	Gets the current radius tolerance value. More...

GoSurfaceRegion2d	GoSurfaceHole_RefRegionAt (GoSurfaceHole tool, kSize index)
	Gets a reference region object at the given index. More...

kSize	GoSurfaceHole_RefRegionCount (GoSurfaceHole tool)
	Gets the reference region count. More...

kBool	GoSurfaceHole_RefRegionsEnabled (GoSurfaceHole tool)
	Gets the enabled state of reference regions. More...

GoRegion3d	GoSurfaceHole_Region (GoSurfaceHole tool)
	Returns the tool's region object. More...

kBool	GoSurfaceHole_RegionEnabled (GoSurfaceHole tool)
	Gets the enabled state of the tool region. More...

kStatus	GoSurfaceHole_SetNominalRadius (GoSurfaceHole tool, k64f nominalRadius)
	Sets the nominal radius value. More...

kStatus	GoSurfaceHole_SetRadiusTolerance (GoSurfaceHole tool, k64f radiusTolerance)
	Sets the radius tolerance value. More...

kStatus	GoSurfaceHole_SetRefRegionCount (GoSurfaceHole tool, kSize count)
	Sets the reference region count. More...

kStatus	GoSurfaceHole_SetTiltXAngle (GoSurfaceHole tool, k64f value)
	Sets the tilt X-angle value. More...

kStatus	GoSurfaceHole_SetTiltYAngle (GoSurfaceHole tool, k64f value)
	Sets the tilt Y-angle value. More...

k64f	GoSurfaceHole_TiltXAngle (GoSurfaceHole tool)
	Gets the tilt X-angle value. More...

k64f	GoSurfaceHole_TiltYAngle (GoSurfaceHole tool)
	Gets the tilt Y-angle value. More...

GoSurfaceHoleX	GoSurfaceHole_XMeasurement (GoSurfaceHole tool)
	Returns a GoSurfaceHole X measurement object. More...

GoSurfaceHoleY	GoSurfaceHole_YMeasurement (GoSurfaceHole tool)
	Returns a GoSurfaceHole Y measurement object. More...

GoSurfaceHoleZ	GoSurfaceHole_ZMeasurement (GoSurfaceHole tool)
	Returns a GoSurfaceHole Z measurement object. More...

kStatus	GoSurfaceTool_SetSource (GoSurfaceTool tool, GoDataSource source)
	Sets the data source. More...

kStatus	GoSurfaceTool_SetXAnchor (GoSurfaceTool tool, k32s id)
	Sets the X-anchoring source. More...

kStatus	GoSurfaceTool_SetYAnchor (GoSurfaceTool tool, k32s id)
	Sets the Y-anchoring source. More...

kStatus	GoSurfaceTool_SetZAnchor (GoSurfaceTool tool, k32s id)
	Sets the Z-anchoring source. More...

GoDataSource	GoSurfaceTool_Source (GoSurfaceTool tool)
	Gets the data source. More...

k32u	GoSurfaceTool_SourceOptionAt (GoSurfaceTool tool, kSize index)
	Gets the data source option at the given index. More...

kSize	GoSurfaceTool_SourceOptionCount (GoSurfaceTool tool)
	Gets the data source option list count. More...

k32s	GoSurfaceTool_XAnchor (GoSurfaceTool tool)
	Gets the current X-anchoring source. More...

kBool	GoSurfaceTool_XAnchorEnabled (GoSurfaceTool tool)
	Returns a boolean value representing whether or not a valid X-anchoring source has been set for X-anchoring. More...

k32u	GoSurfaceTool_XAnchorOptionAt (GoSurfaceTool tool, kSize index)
	Gets the X-anchoring option at the given index. More...

kSize	GoSurfaceTool_XAnchorOptionCount (GoSurfaceTool tool)
	Gets the X-anchoring option list count. More...

k32s	GoSurfaceTool_YAnchor (GoSurfaceTool tool)
	Gets the current Y-anchoring source. More...

kBool	GoSurfaceTool_YAnchorEnabled (GoSurfaceTool tool)
	Returns a boolean value representing whether or not a valid Y-anchoring source has been set for Y-anchoring. More...

k32u	GoSurfaceTool_YAnchorOptionAt (GoSurfaceTool tool, kSize index)
	Gets the Y-anchoring option at the given index. More...

kSize	GoSurfaceTool_YAnchorOptionCount (GoSurfaceTool tool)
	Gets the Y-anchoring option list count. More...

k32s	GoSurfaceTool_ZAnchor (GoSurfaceTool tool)
	Gets the current Z-anchoring source. More...

kBool	GoSurfaceTool_ZAnchorEnabled (GoSurfaceTool tool)
	Returns a boolean value representing whether or not a valid Z-anchoring source has been set for Z-anchoring. More...

k32u	GoSurfaceTool_ZAnchorOptionAt (GoSurfaceTool tool, kSize index)
	Gets the Z-anchoring option at the given index. More...

kSize	GoSurfaceTool_ZAnchorOptionCount (GoSurfaceTool tool)
	Gets the Z-anchoring option list count. More...

GoMeasurement	GoTool_FindMeasurementByType (GoTool tool, GoMeasurementType type)
	Retrieves the first found instance of a measurement for a given enumeration type. More...

GoMeasurement	GoTool_MeasurementAt (GoTool tool, kSize index)
	Retrieves the measurement at the given index. More...

kSize	GoTool_MeasurementCount (GoTool tool)
	Returns the measurement count. More...

kStatus	GoTool_Name (GoTool tool, kChar *name, kSize capacity)
	Retrieves the name of the tool. More...

kStatus	GoTool_SetName (GoTool tool, const kChar *name)
	Sets the name of the tool. More...

GoToolType	GoTool_Type (GoTool tool)
	Retrieves the tool type enumeration value of the tool. More...

Member Function Documentation

kBool GoSurfaceHole_AutoTiltEnabled ( GoSurfaceHole tool )

Gets the enabled state of auto-tilt.

Parameters

tool	GoSurfaceHole object.

Returns: kTRUE if enabled and kFALSE if disabled.

kStatus GoSurfaceHole_EnableAutoTilt	(	GoSurfaceHole	tool,
		kBool	enable
	)

Sets the enabled state of auto-tilt.

Parameters

tool	GoSurfaceHole object.
enable	kTRUE to enable it and kFALSE to disable it.

Returns: Operation status.

kStatus GoSurfaceHole_EnablePartialDetection	(	GoSurfaceHole	tool,
		kBool	enable
	)

Sets the enabled state of partial detection.

Parameters

tool	GoSurfaceHole object.
enable	kTRUE to enable partial detection and kFALSE to disable it.

Returns: Operation status.

kStatus GoSurfaceHole_EnableRefRegions	(	GoSurfaceHole	tool,
		kBool	enable
	)

Sets the enabled state of reference regions.

Parameters

tool	GoSurfaceHole object.
enable	kTRUE to enable reference regions and kFALSE to disable it.

Returns: Operation status.

kStatus GoSurfaceHole_EnableRegion	(	GoSurfaceHole	tool,
		kBool	enable
	)

Sets the enabled state of the tool region.

Parameters

tool	GoSurfaceHole object.
enable	kTRUE to enable the tool region and kFALSE to disable it.

Returns: Operation status.

k64f GoSurfaceHole_NominalRadius ( GoSurfaceHole tool )

Gets the current nominal radius value.

Parameters

tool	GoSurfaceHole object.

Returns: The nominal radius value.

kBool GoSurfaceHole_PartialDetectionEnabled ( GoSurfaceHole tool )

Gets the enabled state of partial detection.

Parameters

tool	GoSurfaceHole object.

Returns: kTRUE if enabled and kFALSE if disabled.

GoSurfaceHoleRadius GoSurfaceHole_RadiusMeasurement ( GoSurfaceHole tool )

Returns a GoSurfaceHole Radius measurement object.

Parameters

tool	GoSurfaceHole object.

Returns: A GoSurfaceHole Radius measurement.

k64f GoSurfaceHole_RadiusTolerance ( GoSurfaceHole tool )

Gets the current radius tolerance value.

Parameters

tool	GoSurfaceHole object.

Returns: The radius tolerance value.

GoSurfaceRegion2d GoSurfaceHole_RefRegionAt	(	GoSurfaceHole	tool,
		kSize	index
	)

Gets a reference region object at the given index.

Parameters

tool	GoSurfaceHole object.
index	The index with which to retrieve a reference region.

Returns: A GoSurfaceRegion2d object.

See also: GoSurfaceHole_RefRegionCount

kSize GoSurfaceHole_RefRegionCount ( GoSurfaceHole tool )

Gets the reference region count.

Parameters

tool	GoSurfaceHole object.

Returns: The reference region count.

kBool GoSurfaceHole_RefRegionsEnabled ( GoSurfaceHole tool )

Gets the enabled state of reference regions.

Parameters

tool	GoSurfaceHole object.

Returns: kTRUE if enabled and kFALSE if disabled.

GoRegion3d GoSurfaceHole_Region ( GoSurfaceHole tool )

Returns the tool's region object.

Parameters

tool	GoSurfaceHole object.

Returns: A GoRegion3d object.

kBool GoSurfaceHole_RegionEnabled ( GoSurfaceHole tool )

Gets the enabled state of the tool region.

Parameters

tool	GoSurfaceHole object.

Returns: kTRUE if enabled and kFALSE if disabled.

kStatus GoSurfaceHole_SetNominalRadius	(	GoSurfaceHole	tool,
		k64f	nominalRadius
	)

Sets the nominal radius value.

Parameters

tool	GoSurfaceHole object.
nominalRadius	Nominal radius value to set.

Returns: Operation status.

kStatus GoSurfaceHole_SetRadiusTolerance	(	GoSurfaceHole	tool,
		k64f	radiusTolerance
	)

Sets the radius tolerance value.

Parameters

tool	GoSurfaceHole object.
radiusTolerance	The radius tolerance value to set.

Returns: Operation status.

kStatus GoSurfaceHole_SetRefRegionCount	(	GoSurfaceHole	tool,
		kSize	count
	)

Sets the reference region count.

Parameters

tool	GoSurfaceHole object.
count	The reference region count.

Returns: Operation status.

See also: GO_SURFACE_HOLE_MAX_REF_REGIONS

kStatus GoSurfaceHole_SetTiltXAngle	(	GoSurfaceHole	tool,
		k64f	value
	)

Sets the tilt X-angle value.

Parameters

tool	GoSurfaceHole object.
value	The tilt X-angle value to set.

Returns: Operation status.

kStatus GoSurfaceHole_SetTiltYAngle	(	GoSurfaceHole	tool,
		k64f	value
	)

Sets the tilt Y-angle value.

Parameters

tool	GoSurfaceHole object.
value	The tilt Y-angle value to set.

Returns: Operation status.

k64f GoSurfaceHole_TiltXAngle ( GoSurfaceHole tool )

Gets the tilt X-angle value.

Parameters

tool	GoSurfaceHole object.

Returns: Tilt X-angle value.

k64f GoSurfaceHole_TiltYAngle ( GoSurfaceHole tool )

Gets the tilt Y-angle value.

Parameters

tool	GoSurfaceHole object.

Returns: Tilt Y-angle value.

GoSurfaceHoleX GoSurfaceHole_XMeasurement ( GoSurfaceHole tool )

Returns a GoSurfaceHole X measurement object.

Parameters

tool	GoSurfaceHole object.

Returns: A GoSurfaceHole X measurement.

GoSurfaceHoleY GoSurfaceHole_YMeasurement ( GoSurfaceHole tool )

Returns a GoSurfaceHole Y measurement object.

Parameters

tool	GoSurfaceHole object.

Returns: A GoSurfaceHole Y measurement.

GoSurfaceHoleZ GoSurfaceHole_ZMeasurement ( GoSurfaceHole tool )

Returns a GoSurfaceHole Z measurement object.

Parameters

tool	GoSurfaceHole object.

Returns: A GoSurfaceHole Z measurement.

kStatus GoSurfaceTool_SetSource	(	GoSurfaceTool	tool,
		GoDataSource	source
	)

inherited

Sets the data source.

Parameters

tool	GoSurfaceTool object.
source	GoDataSource object.

Returns: Operation status.

kStatus GoSurfaceTool_SetXAnchor	(	GoSurfaceTool	tool,
		k32s	id
	)

inherited

Sets the X-anchoring source.

Parameters

tool	GoSurfaceTool object.
id	The measurement ID of a valid X-anchoring source.

Returns: Operation status.

kStatus GoSurfaceTool_SetYAnchor	(	GoSurfaceTool	tool,
		k32s	id
	)

inherited

Sets the Y-anchoring source.

Parameters

tool	GoSurfaceTool object.
id	The measurement ID of a valid Y-anchoring source.

Returns: Operation status.

kStatus GoSurfaceTool_SetZAnchor	(	GoSurfaceTool	tool,
		k32s	id
	)

inherited

Sets the Z-anchoring source.

Parameters

tool	GoSurfaceTool object.
id	The measurement ID of a valid Z-anchoring source.

Returns: Operation status.

GoDataSource GoSurfaceTool_Source ( GoSurfaceTool tool )

inherited

Gets the data source.

Parameters

tool	GoSurfaceTool object.

Returns: The data source.

k32u GoSurfaceTool_SourceOptionAt	(	GoSurfaceTool	tool,
		kSize	index
	)

inherited

Gets the data source option at the given index.

Parameters

tool	GoSurfaceTool object.
index	The index of the option list to access.

Returns: The tool data source option at the given index, or k32U_MAX if an invalid index is given.

kSize GoSurfaceTool_SourceOptionCount ( GoSurfaceTool tool )

inherited

Gets the data source option list count.

Parameters

tool	GoSurfaceTool object.

Returns: The current tool data source option list count.

k32s GoSurfaceTool_XAnchor ( GoSurfaceTool tool )

inherited

Gets the current X-anchoring source.

Parameters

tool	GoSurfaceTool object.

Returns: The X-anchoring source or -1 if no source is currently set.

kBool GoSurfaceTool_XAnchorEnabled ( GoSurfaceTool tool )

inherited

Returns a boolean value representing whether or not a valid X-anchoring source has been set for X-anchoring.

Parameters

tool	GoSurfaceTool object.

Returns: kTRUE if a valid anchoring source is currently set and kFALSE otherwise.

k32u GoSurfaceTool_XAnchorOptionAt	(	GoSurfaceTool	tool,
		kSize	index
	)

inherited

Gets the X-anchoring option at the given index.

Parameters

tool	GoSurfaceTool object.
index	The index of the option list to access.

Returns: The X-anchoring option at the given index or k32U_MAX if invalid.

kSize GoSurfaceTool_XAnchorOptionCount ( GoSurfaceTool tool )

inherited

Gets the X-anchoring option list count.

Parameters

tool	GoSurfaceTool object.

Returns: The X-anchoring option list count.

k32s GoSurfaceTool_YAnchor ( GoSurfaceTool tool )

inherited

Gets the current Y-anchoring source.

Parameters

tool	GoSurfaceTool object.

Returns: The Y-anchoring source or -1 if no source is currently set.

kBool GoSurfaceTool_YAnchorEnabled ( GoSurfaceTool tool )

inherited

Returns a boolean value representing whether or not a valid Y-anchoring source has been set for Y-anchoring.

Parameters

tool	GoSurfaceTool object.

Returns: kTRUE if a valid anchoring source is currently set and kFALSE otherwise.

k32u GoSurfaceTool_YAnchorOptionAt	(	GoSurfaceTool	tool,
		kSize	index
	)

inherited

Gets the Y-anchoring option at the given index.

Parameters

tool	GoSurfaceTool object.
index	The index of the option list to access.

Returns: The Y-anchoring option at the given index or k32U_MAX if invalid.

kSize GoSurfaceTool_YAnchorOptionCount ( GoSurfaceTool tool )

inherited

Gets the Y-anchoring option list count.

Parameters

tool	GoSurfaceTool object.

Returns: The Y-anchoring option list count.

k32s GoSurfaceTool_ZAnchor ( GoSurfaceTool tool )

inherited

Gets the current Z-anchoring source.

Parameters

tool	GoSurfaceTool object.

Returns: The Z-anchoring source or -1 if no source is currently set.

kBool GoSurfaceTool_ZAnchorEnabled ( GoSurfaceTool tool )

inherited

Returns a boolean value representing whether or not a valid Z-anchoring source has been set for Z-anchoring.

Parameters

tool	GoSurfaceTool object.

Returns: kTRUE if a valid anchoring source is currently set and kFALSE otherwise.

k32u GoSurfaceTool_ZAnchorOptionAt	(	GoSurfaceTool	tool,
		kSize	index
	)

inherited

Gets the Z-anchoring option at the given index.

Parameters

tool	GoSurfaceTool object.
index	The index of the option list to access.

Returns: The Z-anchoring option at the given index or k32U_MAX if invalid.

kSize GoSurfaceTool_ZAnchorOptionCount ( GoSurfaceTool tool )

inherited

Gets the Z-anchoring option list count.

Parameters

tool	GoSurfaceTool object.

Returns: The X-anchoring option list count.

GoMeasurement GoTool_FindMeasurementByType	(	GoTool	tool,
		GoMeasurementType	type
	)

inherited

Retrieves the first found instance of a measurement for a given enumeration type.

Parameters

tool	GoTool object.
type	A GoMeasurementType representing the measurement type to find in the given tool.

Returns: A measurement object if one is found, otherwise kNULL.

GoMeasurement GoTool_MeasurementAt	(	GoTool	tool,
		kSize	index
	)

inherited

Retrieves the measurement at the given index.

Parameters

tool	GoTool object.
index	The index of the measurement.

Returns: The measurement at the given index or kNULL if an invalid index is provided.

kSize GoTool_MeasurementCount ( GoTool tool )

inherited

Returns the measurement count.

Parameters

tool	GoTool object.

Returns: The measurement count.

kStatus GoTool_Name	(	GoTool	tool,
		kChar *	name,
		kSize	capacity
	)

inherited

Retrieves the name of the tool.

Parameters

tool	GoTool object.
name	Receives the name of the tool.
capacity	The maximum capacity of the name array.

Returns: Operation status.

kStatus GoTool_SetName	(	GoTool	tool,
		const kChar *	name
	)

inherited

Sets the name of the tool.

Parameters

tool	GoTool object.
name	The name to be set for the tool.

Returns: Operation status.

GoToolType GoTool_Type ( GoTool tool )

inherited

Retrieves the tool type enumeration value of the tool.

Parameters

tool	GoTool object.

Returns: The tool type enumeration value.

The documentation for this class was generated from the following file:

Tools/GoSurfaceTools.h

Description

Public Member Functions

Member Function Documentation