NX Open C++ Reference Guide
Public Types | Public Member Functions | List of all members
NXOpen::Weld::DatumSurfaceBuilder Class Reference

Used to create or edit a NXOpen::Weld::DatumSurface feature. More...

Inheritance diagram for NXOpen::Weld::DatumSurfaceBuilder:
NXOpen::Weld::DatumCommonBuilder NXOpen::Builder NXOpen::TaggedObject NXOpen::GeometricUtilities::IComponentBuilder

Public Types

enum  Types { TypesDirect, TypesMirror }
 Settings to indicate the construction type used for the datum surface. More...
 
- Public Types inherited from NXOpen::Weld::DatumCommonBuilder
enum  ControlMethodTypes { ControlMethodTypesPrincipalAxis, ControlMethodTypesUseSectionPlane }
 Settings for the method used to define the control direction. More...
 
enum  CreationDirectionMethods { CreationDirectionMethodsDefault, CreationDirectionMethodsOpposite }
 Settings to define the creation direction. More...
 
enum  CustomTypes {
  CustomTypesDefault, CustomTypesCustom1, CustomTypesCustom2, CustomTypesCustom3,
  CustomTypesCustom4, CustomTypesCustom5, CustomTypesCustom6, CustomTypesCustom7
}
 The custom type of the datum specified for creation. More...
 
enum  SolidTypes { SolidTypesSphere, SolidTypesCylinder, SolidTypesCone }
 Settings for defining the solid type to create for the datum object. More...
 

Public Member Functions

NXOpen::Weld::SelectDatumSurfaceDerivedDatum ()
 Returns the derived datum
Created in NX8.5.0. More...
 
double GridSnapTolerance ()
 Returns the grid snap tolerance
Created in NX8.5.0. More...
 
void InitializeAxis (const NXOpen::Point3d &approximatePoint)
 Update the axis origin to a point specified, and direction to closest principal axis to face normal. More...
 
NXOpen::PlaneMirrorPlane ()
 Returns the plane used for mirroring a reference surface locator. More...
 
void MoveMinimumDistance ()
 Moves a point to the nearest location on the resting face
Created in NX8.5.0. More...
 
NXOpen::ScCollectorRestingFace ()
 Returns the resting face
Created in NX8.5.0. More...
 
void SetGridSnapTolerance (double gridSnapTolerance)
 Sets the grid snap tolerance
Created in NX8.5.0. More...
 
void SetMirrorPlane (NXOpen::Plane *mirrorPlane)
 Sets the plane used for mirroring a reference surface locator. More...
 
void SetSnapPointToGrid (bool snapPointToGrid)
 Sets the snap point to grid option. More...
 
void SetType (NXOpen::Weld::DatumSurfaceBuilder::Types type)
 Sets the construction type used to create the datum surface. More...
 
void SetXCoordinate (double xCoordinate)
 Sets the x coordinate position for the surface datum location. More...
 
void SetYCoordinate (double yCoordinate)
 Sets the y coordinate position for the surface datum location
Created in NX8.5.0. More...
 
void SetZCoordinate (double zCoordinate)
 Sets the z coordinate position for the datum surface location
Created in NX8.5.0. More...
 
bool SnapPointToGrid ()
 Returns the snap point to grid option. More...
 
NXOpen::Weld::DatumSurfaceBuilder::Types Type ()
 Returns the construction type used to create the datum surface. More...
 
void UpdateAxisData ()
 Updates data related to the axis. More...
 
void UpdateWithReferenceDatum ()
 Initialize the builder with the inputs from an existing datum surface locator. More...
 
double XCoordinate ()
 Returns the x coordinate position for the surface datum location. More...
 
double YCoordinate ()
 Returns the y coordinate position for the surface datum location
Created in NX8.5.0. More...
 
double ZCoordinate ()
 Returns the z coordinate position for the datum surface location
Created in NX8.5.0. More...
 
- Public Member Functions inherited from NXOpen::Weld::DatumCommonBuilder
NXOpen::Assemblies::SelectComponentListAdditionalReferences ()
 Returns the additional references. More...
 
NXOpen::Weld::CharacteristicsBuilderCharacteristics ()
 Returns the characteristics. More...
 
NXOpen::Weld::DatumCommonBuilder::ControlMethodTypes ControlMethod ()
 Returns the control method. More...
 
bool CreateDirectionVector ()
 Returns the option to control if a reference datum axis should be output with this feature. More...
 
bool CreatePlane ()
 Returns the option to control if a reference datum plane should be output with the this feature. More...
 
bool CreatePoint ()
 Returns the option to control if a reference point should be output with this feature. More...
 
NXOpen::Weld::DatumCommonBuilder::CreationDirectionMethods CreationDirection ()
 Returns the creation direction. More...
 
double CustomAboveLength ()
 Returns the length above the datum reference point. More...
 
double CustomRadius ()
 Returns the radius of the solid sphere, cylinder or cone created. More...
 
double CustomTotalLength ()
 Returns the total length of the cylinder or cone along the direction axis. More...
 
NXOpen::Weld::DatumCommonBuilder::CustomTypes CustomType ()
 Returns the custom datum type. More...
 
NXString CustomTypeName ()
 Returns the custom name used to create the datum. More...
 
bool Derived ()
 Returns the indicator if this should be marked as a derived from another datum. More...
 
NXOpen::AxisDirectionAxis ()
 Returns the direction axis. More...
 
double DirectionLength ()
 Returns the length of the datum axis vector created. More...
 
double ModelingTolerance ()
 Returns the modeling distance tolerance. More...
 
double PlaneHeight ()
 Returns the plane height along the direction axis. More...
 
double PlaneWidth ()
 Returns the plane width perpendicular to the direction axis. More...
 
bool PrincipalAxisX ()
 Returns the principal axis x. More...
 
bool PrincipalAxisY ()
 Returns the principal axis y. More...
 
bool PrincipalAxisZ ()
 Returns the principal axis z. More...
 
bool ProjectAlongDirection ()
 Returns the project along direction. More...
 
NXOpen::DirectionSectionPlaneNormal ()
 Returns the section plane normal. More...
 
void SetControlMethod (NXOpen::Weld::DatumCommonBuilder::ControlMethodTypes controlMethod)
 Sets the control method. More...
 
void SetCreateDirectionVector (bool createDirectionVector)
 Sets the option to control if a reference datum axis should be output with this feature. More...
 
void SetCreatePlane (bool createPlane)
 Sets the option to control if a reference datum plane should be output with the this feature. More...
 
void SetCreatePoint (bool createPoint)
 Sets the option to control if a reference point should be output with this feature. More...
 
void SetCreationDirection (NXOpen::Weld::DatumCommonBuilder::CreationDirectionMethods creationDirection)
 Sets the creation direction. More...
 
void SetCustomAboveLength (double directionLength)
 Sets the length above the datum reference point. More...
 
void SetCustomRadius (double customRadius)
 Sets the radius of the solid sphere, cylinder or cone created. More...
 
void SetCustomTotalLength (double customTotalLength)
 Sets the total length of the cylinder or cone along the direction axis. More...
 
void SetCustomType (NXOpen::Weld::DatumCommonBuilder::CustomTypes customType)
 Sets the custom datum type. More...
 
void SetCustomTypeName (const NXString &customTypeName)
 Sets the custom name used to create the datum. More...
 
void SetCustomTypeName (const char *customTypeName)
 Sets the custom name used to create the datum. More...
 
void SetDerived (bool derived)
 Sets the indicator if this should be marked as a derived from another datum. More...
 
void SetDirectionAxis (NXOpen::Axis *directionAxis)
 Sets the direction axis. More...
 
void SetDirectionLength (double directionLength)
 Sets the length of the datum axis vector created. More...
 
void SetModelingTolerance (double modelingTolerance)
 Sets the modeling distance tolerance. More...
 
void SetPlaneHeight (double planeHeight)
 Sets the plane height along the direction axis. More...
 
void SetPlaneWidth (double planeWidth)
 Sets the plane width perpendicular to the direction axis. More...
 
void SetPrincipalAxisX (bool principalAxisX)
 Sets the principal axis x. More...
 
void SetPrincipalAxisY (bool principalAxisY)
 Sets the principal axis y. More...
 
void SetPrincipalAxisZ (bool principalAxisZ)
 Sets the principal axis z. More...
 
void SetProjectAlongDirection (bool projectAlongDirection)
 Sets the project along direction. More...
 
void SetSectionPlaneNormal (NXOpen::Direction *sectionPlaneNormal)
 Sets the section plane normal. More...
 
void SetSolidType (NXOpen::Weld::DatumCommonBuilder::SolidTypes solidType)
 Sets the solid body type specified. More...
 
NXOpen::Weld::DatumCommonBuilder::SolidTypes SolidType ()
 Returns the solid body type specified. More...
 
void UpdateWithDerivedDatum ()
 Initialize the builder with the inputs from an existing datum. More...
 
- Public Member Functions inherited from NXOpen::Builder
NXOpen::NXObjectCommit ()
 Commits any edits that have been applied to the builder. More...
 
void Destroy ()
 Deletes the builder, and cleans up any objects created by the builder. More...
 
std::vector< NXOpen::NXObject * > GetCommittedObjects ()
 For builders that create more than one object, this method returns the objects that are created by commit. More...
 
NXOpen::NXObjectGetObject ()
 Returns the object currently being edited by this builder. More...
 
void ShowResults ()
 Updates the model to reflect the result of an edit to the model for all builders that support showing results. More...
 
virtual bool Validate ()
 Validate whether the inputs to the component are sufficient for commit to be called. More...
 
- Public Member Functions inherited from NXOpen::TaggedObject
tag_t Tag () const
 Returns the tag of this object. More...
 

Detailed Description

Used to create or edit a NXOpen::Weld::DatumSurface feature.


To create a new instance of this class, use NXOpen::Weld::WeldManager::CreateDatumSurfaceBuilder
Default values.

Property Value

ControlMethod

PrincipalAxis

CreateDirectionVector

1

CreatePlane

1

CreatePoint

1

Derived

0

DirectionLength

20 (millimeters part), 1.0 (inches part)

GridSnapTolerance

1 (millimeters part), 0.05 (inches part)

ModelingTolerance

0.0254

PlaneHeight

20 (millimeters part), 1.0 (inches part)

PlaneWidth

20 (millimeters part), 1.0 (inches part)

PrincipalAxisX

0

PrincipalAxisY

0

PrincipalAxisZ

0

ProjectAlongDirection

1

SnapPointToGrid

1

XCoordinate

0.0

YCoordinate

0.0

ZCoordinate

0.0


Created in NX8.5.0.

Member Enumeration Documentation

Settings to indicate the construction type used for the datum surface.

Enumerator
TypesDirect 

direct location

TypesMirror 

mirror location

Member Function Documentation

NXOpen::Weld::SelectDatumSurface* NXOpen::Weld::DatumSurfaceBuilder::DerivedDatum ( )

Returns the derived datum
Created in NX8.5.0.



License requirements : None

double NXOpen::Weld::DatumSurfaceBuilder::GridSnapTolerance ( )

Returns the grid snap tolerance
Created in NX8.5.0.



License requirements : None

void NXOpen::Weld::DatumSurfaceBuilder::InitializeAxis ( const NXOpen::Point3d approximatePoint)

Update the axis origin to a point specified, and direction to closest principal axis to face normal.

The point will be adjusted by snapping to a grid.
Created in NX8.5.0.

License requirements : ugweld ("UG WELD")

Parameters
approximatePointapproximatepoint
NXOpen::Plane* NXOpen::Weld::DatumSurfaceBuilder::MirrorPlane ( )

Returns the plane used for mirroring a reference surface locator.


Created in NX9.0.0.

License requirements : None

void NXOpen::Weld::DatumSurfaceBuilder::MoveMinimumDistance ( )

Moves a point to the nearest location on the resting face
Created in NX8.5.0.



License requirements : ugweld ("UG WELD")

NXOpen::ScCollector* NXOpen::Weld::DatumSurfaceBuilder::RestingFace ( )

Returns the resting face
Created in NX8.5.0.



License requirements : None

void NXOpen::Weld::DatumSurfaceBuilder::SetGridSnapTolerance ( double  gridSnapTolerance)

Sets the grid snap tolerance
Created in NX8.5.0.



License requirements : ugweld ("UG WELD")

Parameters
gridSnapTolerancegridsnaptolerance
void NXOpen::Weld::DatumSurfaceBuilder::SetMirrorPlane ( NXOpen::Plane mirrorPlane)

Sets the plane used for mirroring a reference surface locator.


Created in NX9.0.0.

License requirements : ugweld ("UG WELD")

Parameters
mirrorPlanemirrorplane
void NXOpen::Weld::DatumSurfaceBuilder::SetSnapPointToGrid ( bool  snapPointToGrid)

Sets the snap point to grid option.

Specified locations will be adjusted based on the grid snap tolerance
Created in NX8.5.0.

License requirements : ugweld ("UG WELD")

Parameters
snapPointToGridsnappointtogrid
void NXOpen::Weld::DatumSurfaceBuilder::SetType ( NXOpen::Weld::DatumSurfaceBuilder::Types  type)

Sets the construction type used to create the datum surface.


Created in NX9.0.0.

License requirements : ugweld ("UG WELD")

Parameters
typetype
void NXOpen::Weld::DatumSurfaceBuilder::SetXCoordinate ( double  xCoordinate)

Sets the x coordinate position for the surface datum location.


Created in NX8.5.0.

License requirements : ugweld ("UG WELD")

Parameters
xCoordinatexcoordinate
void NXOpen::Weld::DatumSurfaceBuilder::SetYCoordinate ( double  yCoordinate)

Sets the y coordinate position for the surface datum location
Created in NX8.5.0.



License requirements : ugweld ("UG WELD")

Parameters
yCoordinateycoordinate
void NXOpen::Weld::DatumSurfaceBuilder::SetZCoordinate ( double  zCoordinate)

Sets the z coordinate position for the datum surface location
Created in NX8.5.0.



License requirements : ugweld ("UG WELD")

Parameters
zCoordinatezcoordinate
bool NXOpen::Weld::DatumSurfaceBuilder::SnapPointToGrid ( )

Returns the snap point to grid option.

Specified locations will be adjusted based on the grid snap tolerance
Created in NX8.5.0.

License requirements : None

NXOpen::Weld::DatumSurfaceBuilder::Types NXOpen::Weld::DatumSurfaceBuilder::Type ( )

Returns the construction type used to create the datum surface.


Created in NX9.0.0.

License requirements : None

void NXOpen::Weld::DatumSurfaceBuilder::UpdateAxisData ( )

Updates data related to the axis.

The origin will be adjusted based on grid snapping, and projection direction. In addition the control direction information will be updated.
Created in NX8.5.0.

License requirements : ugweld ("UG WELD")

void NXOpen::Weld::DatumSurfaceBuilder::UpdateWithReferenceDatum ( )

Initialize the builder with the inputs from an existing datum surface locator.


Created in NX9.0.0.

License requirements : ugweld ("UG WELD")

double NXOpen::Weld::DatumSurfaceBuilder::XCoordinate ( )

Returns the x coordinate position for the surface datum location.


Created in NX8.5.0.

License requirements : None

double NXOpen::Weld::DatumSurfaceBuilder::YCoordinate ( )

Returns the y coordinate position for the surface datum location
Created in NX8.5.0.



License requirements : None

double NXOpen::Weld::DatumSurfaceBuilder::ZCoordinate ( )

Returns the z coordinate position for the datum surface location
Created in NX8.5.0.



License requirements : None


The documentation for this class was generated from the following file:
Copyright 2017 Siemens Product Lifecycle Management Software Inc. All Rights Reserved.