Description

Represents a surface stud tool.

Inheritance diagram for GoSurfaceStud:

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

k64f	GoSurfaceStud_BaseHeight (GoSurfaceStud tool)
	Returns the stud base height value. More...

GoSurfaceStudBaseX	GoSurfaceStud_BaseXMeasurement (GoSurfaceStud tool)
	Returns a GoSurfaceStud Base X measurement object. More...

GoSurfaceStudBaseY	GoSurfaceStud_BaseYMeasurement (GoSurfaceStud tool)
	Returns a GoSurfaceStud Base Y measurement object. More...

GoSurfaceStudBaseZ	GoSurfaceStud_BaseZMeasurement (GoSurfaceStud tool)
	Returns a GoSurfaceStud Base Z measurement object. More...

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

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

kStatus	GoSurfaceStud_EnableRegion (GoSurfaceStud tool, kBool enable)
	Sets the enabled state of the tool region. More...

GoSurfaceStudRadius	GoSurfaceStud_RadiusMeasurement (GoSurfaceStud tool)
	Returns a GoSurfaceStud Radius measurement object. More...

GoSurfaceRegion2d	GoSurfaceStud_RefRegionAt (GoSurfaceStud tool, kSize index)
	Returns the reference region object at the given index. More...

kSize	GoSurfaceStud_RefRegionCount (GoSurfaceStud tool)
	Returns the reference region count. More...

kBool	GoSurfaceStud_RefRegionsEnabled (GoSurfaceStud tool)
	Gets the enabled state of the reference regions. More...

GoRegion3d	GoSurfaceStud_Region (GoSurfaceStud tool)
	Returns the tool region object. More...

kBool	GoSurfaceStud_RegionEnabled (GoSurfaceStud tool)
	Gets the enabled state of the tool region. More...

kStatus	GoSurfaceStud_SetBaseHeight (GoSurfaceStud tool, k64f value)
	Sets the base height value. More...

kStatus	GoSurfaceStud_SetRefRegionCount (GoSurfaceStud tool, kSize count)
	Sets the reference region count. More...

kStatus	GoSurfaceStud_SetStudHeight (GoSurfaceStud tool, k64f value)
	Sets the stud height value. More...

kStatus	GoSurfaceStud_SetStudRadius (GoSurfaceStud tool, k64f value)
	Sets the stud radius value. More...

kStatus	GoSurfaceStud_SetTiltXAngle (GoSurfaceStud tool, k64f value)
	Sets the tilt X-angle value. More...

kStatus	GoSurfaceStud_SetTiltYAngle (GoSurfaceStud tool, k64f value)
	Sets the tilt Y-angle value. More...

kStatus	GoSurfaceStud_SetTipHeight (GoSurfaceStud tool, k64f value)
	Sets the tip height value. More...

k64f	GoSurfaceStud_StudHeight (GoSurfaceStud tool)
	Returns the stud height value. More...

k64f	GoSurfaceStud_StudRadius (GoSurfaceStud tool)
	Returns the stud radius value. More...

k64f	GoSurfaceStud_TiltXAngle (GoSurfaceStud tool)
	Gets the tilt X-angle value. More...

k64f	GoSurfaceStud_TiltYAngle (GoSurfaceStud tool)
	Returns the tilt Y-angle value. More...

k64f	GoSurfaceStud_TipHeight (GoSurfaceStud tool)
	Returns the stud tip height value. More...

GoSurfaceStudTipX	GoSurfaceStud_TipXMeasurement (GoSurfaceStud tool)
	Returns a GoSurfaceStud Tip X measurement object. More...

GoSurfaceStudTipY	GoSurfaceStud_TipYMeasurement (GoSurfaceStud tool)
	Returns a GoSurfaceStud Tip Y measurement object. More...

GoSurfaceStudTipZ	GoSurfaceStud_TipZMeasurement (GoSurfaceStud tool)
	Returns a GoSurfaceStud Tip 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 GoSurfaceStud_AutoTiltEnabled ( GoSurfaceStud tool )

Gets the enabled state of auto-tilt.

Parameters

tool	GoSurfaceStud object.

Returns: kTRUE if enabled and kFALSE if disabled.

k64f GoSurfaceStud_BaseHeight ( GoSurfaceStud tool )

Returns the stud base height value.

Parameters

tool	GoSurfaceStud object.

Returns: The stud base height value.

GoSurfaceStudBaseX GoSurfaceStud_BaseXMeasurement ( GoSurfaceStud tool )

Returns a GoSurfaceStud Base X measurement object.

Parameters

tool	GoSurfaceStud object.

Returns: A GoSurfaceStud Base X measurement.

GoSurfaceStudBaseY GoSurfaceStud_BaseYMeasurement ( GoSurfaceStud tool )

Returns a GoSurfaceStud Base Y measurement object.

Parameters

tool	GoSurfaceStud object.

Returns: A GoSurfaceStud Base Y measurement.

GoSurfaceStudBaseZ GoSurfaceStud_BaseZMeasurement ( GoSurfaceStud tool )

Returns a GoSurfaceStud Base Z measurement object.

Parameters

tool	GoSurfaceStud object.

Returns: A GoSurfaceStud Base Z measurement.

kStatus GoSurfaceStud_EnableAutoTilt	(	GoSurfaceStud	tool,
		kBool	enable
	)

Sets the enabled state of auto-tilt.

Parameters

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

Returns: Operation status.

kStatus GoSurfaceStud_EnableRefRegions	(	GoSurfaceStud	tool,
		kBool	enable
	)

Sets the enabled state of the reference regions.

Parameters

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

Returns: Operation status.

kStatus GoSurfaceStud_EnableRegion	(	GoSurfaceStud	tool,
		kBool	enable
	)

Sets the enabled state of the tool region.

Parameters

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

Returns: Operation status.

GoSurfaceStudRadius GoSurfaceStud_RadiusMeasurement ( GoSurfaceStud tool )

Returns a GoSurfaceStud Radius measurement object.

Parameters

tool	GoSurfaceStud object.

Returns: A GoSurfaceStud Radius measurement.

GoSurfaceRegion2d GoSurfaceStud_RefRegionAt	(	GoSurfaceStud	tool,
		kSize	index
	)

Returns the reference region object at the given index.

Parameters

tool	GoSurfaceStud object.
index	The index with which to return a reference region.

Returns: A GoSurfaceRegion2d object.

See also: GoSurfaceStud_RefRegionCount

kSize GoSurfaceStud_RefRegionCount ( GoSurfaceStud tool )

Returns the reference region count.

Parameters

tool	GoSurfaceStud object.

Returns: The reference region count.

kBool GoSurfaceStud_RefRegionsEnabled ( GoSurfaceStud tool )

Gets the enabled state of the reference regions.

Parameters

tool	GoSurfaceStud object.

Returns: enable kTRUE if the reference regions are enabled and kFALSE otherwise.

GoRegion3d GoSurfaceStud_Region ( GoSurfaceStud tool )

Returns the tool region object.

Parameters

tool	GoSurfaceStud object.

Returns: A GoRegion3d object.

kBool GoSurfaceStud_RegionEnabled ( GoSurfaceStud tool )

Gets the enabled state of the tool region.

Parameters

tool	GoSurfaceStud object.

Returns: kTRUE if enabled and kFALSE if disabled.

kStatus GoSurfaceStud_SetBaseHeight	(	GoSurfaceStud	tool,
		k64f	value
	)

Sets the base height value.

Parameters

tool	GoSurfaceStud object.
value	The base height value to set.

Returns: Operation status.

kStatus GoSurfaceStud_SetRefRegionCount	(	GoSurfaceStud	tool,
		kSize	count
	)

Sets the reference region count.

Parameters

tool	GoSurfaceStud object.
count	The number of reference regions to use.

Returns: Operation status.

See also: GO_SURFACE_STUD_MAX_REF_REGIONS

kStatus GoSurfaceStud_SetStudHeight	(	GoSurfaceStud	tool,
		k64f	value
	)

Sets the stud height value.

Parameters

tool	GoSurfaceStud object.
value	The stud height value to set.

Returns: Operation status.

kStatus GoSurfaceStud_SetStudRadius	(	GoSurfaceStud	tool,
		k64f	value
	)

Sets the stud radius value.

Parameters

tool	GoSurfaceStud object.
value	The stud radius value to set.

Returns: Operation status.

kStatus GoSurfaceStud_SetTiltXAngle	(	GoSurfaceStud	tool,
		k64f	value
	)

Sets the tilt X-angle value.

Parameters

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

Returns: Operation status.

kStatus GoSurfaceStud_SetTiltYAngle	(	GoSurfaceStud	tool,
		k64f	value
	)

Sets the tilt Y-angle value.

Parameters

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

Returns: Operation status.

kStatus GoSurfaceStud_SetTipHeight	(	GoSurfaceStud	tool,
		k64f	value
	)

Sets the tip height value.

Parameters

tool	GoSurfaceStud object.
value	The tip height value to set.

Returns: Operation status.

k64f GoSurfaceStud_StudHeight ( GoSurfaceStud tool )

Returns the stud height value.

Parameters

tool	GoSurfaceStud object.

Returns: The stud height value.

k64f GoSurfaceStud_StudRadius ( GoSurfaceStud tool )

Returns the stud radius value.

Parameters

tool	GoSurfaceStud object.

Returns: The stud radius value.

k64f GoSurfaceStud_TiltXAngle ( GoSurfaceStud tool )

Gets the tilt X-angle value.

Parameters

tool	GoSurfaceStud object.

Returns: The tilt X-angle value.

k64f GoSurfaceStud_TiltYAngle ( GoSurfaceStud tool )

Returns the tilt Y-angle value.

Parameters

tool	GoSurfaceStud object.

Returns: The tilt Y-angle value.

k64f GoSurfaceStud_TipHeight ( GoSurfaceStud tool )

Returns the stud tip height value.

Parameters

tool	GoSurfaceStud object.

Returns: The stud tip height value.

GoSurfaceStudTipX GoSurfaceStud_TipXMeasurement ( GoSurfaceStud tool )

Returns a GoSurfaceStud Tip X measurement object.

Parameters

tool	GoSurfaceStud object.

Returns: A GoSurfaceStud Tip X measurement.

GoSurfaceStudTipY GoSurfaceStud_TipYMeasurement ( GoSurfaceStud tool )

Returns a GoSurfaceStud Tip Y measurement object.

Parameters

tool	GoSurfaceStud object.

Returns: A GoSurfaceStud Tip Y measurement.

GoSurfaceStudTipZ GoSurfaceStud_TipZMeasurement ( GoSurfaceStud tool )

Returns a GoSurfaceStud Tip Z measurement object.

Parameters

tool	GoSurfaceStud object.

Returns: A GoSurfaceStud Tip 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