UG Secondary Program - Create and Edit Features

stephen zhang

Most features use a builder method to create new features and to edit existing features.  Features that do not use the builder method use constructor methods that are specific to the feature. The feature specific constructors are defined in the language reference guides.  This section discusses the general concepts of the builder method.
Builder Method
The builder method uses the following general steps.
; q* A* e! I* b) O" l' Y: T: ?Create a New Feature
Create an instance of the builder object for the desired feature type providing a null object as input.
- `  U" n$ E% n7 j( o# MEdit the properties of the builder object to set the feature parameters and options.
Use the Commit method of the builder object to create an instance of the feature.  The Commit method will return the new feature object.
Use the Destroy method of the builder object to delete the builder object.
' l* o, c; q# n( pEdit an Existing Feature (same steps except provide an existing object)
Create an instance of the builder object for the desired feature type providing the object of the feature to edit.
' B' C% j1 P; q1 S" yEdit the properties of the builder object to edit the feature parameters and options.
/ n( N4 w; F! Y! KUse the Commit method of the builder object to edit the existing feature.
4 o, v8 N  T' y5 RUse the Destroy method of the builder object to delete the builder object.
Each type of feature that uses the builder method will have a specific builder class.  All builder classes can be found in the Features name space. For instance the class for the Block Feature builder is found in: Features.BlockFeatureBuilder.
The create a builder object, the Part Class contains a Features property that contains create methods for each builder class.  For instance, given "workPart" as an instance of a part object, the create method for a Block Feature builder is workPart.Features.CreateBlockFeatureBuilder(), and the create method for an Edge Blend Feature builder is workPart.Features.CreateEdgeBlendFeatureBuilder().
Create and Edit Features - Language Specific Details
NX Open for C++
; \; o+ \3 b2 C# ^6 o( s& p! k( q8 ONX Open for .NET
3 w* @% S# P5 \NX Open for Java
7 x1 ~+ D4 N" R0 p& oNX Open for C++
The following examples shows how to create a feature builder for a Block Feature and then use the feature builder to create a new Block Feature.  A feature builder is then created to edit the Block Feature.
Session *NXSession = Session::GetSession();
Part *workPart (NXSession->Parts()->Work());

. |; F) z. K) p+ g/ o  ]Feature *nullFeature (NULL);
$ \$ k4 C  H# V; |, H" {, k
  g) r9 b3 p" J: XPoint3d origin = new Point3d(0.0, 0.0, 0.0);
2 B1 Z- O0 u- ]# \( h% {" g  x
8 U/ V( [. {5 ^7 }9 q2 z//**************************************************************************
//CREATE BLOCK

+ v8 i- @6 C' o8 N6 @8 Z) cBlockFeatureBuilder *newBlock = NULL;
5 Y! S$ D) S" }# g- y2 [) wnewBlock = workPart->Features()->CreateBlockFeatureBuilder(nullFeature);

  f1 U: I( v) R5 S1 ynewBlock->SetOriginAndLengths(origin, "50", "80", "100");
- V8 x0 }. o' Q
2 w3 K* y7 l$ I/ RFeature *blockFeature = newBlock->CommitFeature();
4 ~/ `4 J6 j8 A$ G
. ~5 Z+ K* ^% Y. _newBlock->Destroy();
5 z& P8 t* r$ j* x# s
$ F" ^, [! l6 l# F0 z//**************************************************************************
//EDIT BLOCK

BlockFeatureBuilder *oldBlock = workPart->Features()->CreateBlockFeatureBuilder(blockFeature);
$ a, j& C- a+ p/ u' t) y
oldBlock->SetOriginAndLengths(origin, "100", "20", "50");

oldBlock->CommitFeature();

7 H! r+ p% G% {oldBlock->Destroy();
NX Open for .NET
1 `3 n3 U9 g* p$ lThe following examples shows how to create a feature builder for a Block Feature and then use the feature builder to create a new Block Feature.  A feature builder is then created to edit the Block Feature.
Dim NXSession As Session = Session.GetSession()
            Dim workPart As Part = NXSession.Parts.Work

4 I9 B3 S. ^1 O            Dim nullFeature As Feature = Nothing

            Dim origin As Point3d = New Point3d(0.0, 0.0, 0.0)

, h8 l* i6 V6 S            '**************************************************************************
; s# t: W. I  |2 B- \8 F# ]: z            'CREATE BLOCK
& B- V4 K: _* x# e( S
  O& G. Y: ^  r            Dim newBlock As BlockFeatureBuilder = workPart.Features.CreateBlockFeatureBuilder(nullFeature)
3 e( D$ T$ y, \. L
3 I& s' C4 g' Y/ J# a/ C5 D            newBlock.SetOriginAndLengths(origin, "50", "80", "100")

& Y& i5 i9 Y. }+ L            Dim blockFeature As Feature = newBlock.CommitFeature()

            newBlock.Destroy()

9 g5 d3 a6 `. C6 j            '**************************************************************************
) B. [" E9 V# s* [/ I2 A            'EDIT BLOCK

            Dim oldBlock As BlockFeatureBuilder = workPart.Features.CreateBlockFeatureBuilder(blockFeature)

            oldBlock.SetOriginAndLengths(origin, "100", "20", "50")
5 o8 @: {/ q# ?- j. e9 t
2 i- ^4 M4 z, v8 A, q4 J$ k            oldBlock.Commit()

            oldBlock.Destroy()
& z" x4 d( o- h( H5 YNX Open for Java
* C/ g% z5 y4 f- {% SThe following examples shows how to create a feature builder for a Block Feature and then use the feature builder to create a new Block Feature.  A feature builder is then created to edit the Block Feature.
' B0 [8 e" x9 z4 _5 e: Z/ wSession NXSession = (Session)SessionFactory.get("Session");
( l  _- ~# C! l+ Z1 B& g. }+ gPart workPart = NXSession.parts().work();
7 Y: G8 h2 u# F8 r- p" x1 T& SPoint3d origin = new Point3d(0.0, 0.0, 0.0, 0.0);
* `5 \. |$ p- z. Y* a0 Tnxopen.features.Feature nullFeature = null;
//**************************************************************************
//CREATE BLOCK
nxopen.features.BlockFeatureBuilder newBlock = workPart.features().createBlockFeatureBuilder(nullFeature);
+ U) w" e- R" F( HnewBlock.setOriginAndLengths(origin,  "50", "80", "100");
5 Y, H: m0 E9 x' c; M) rnxopen.features.Feature blockFeature = newBlock.commitFeature();
newBlock.destroy();
* \* }5 B: g, O: w//**************************************************************************
6 T- N2 T3 _' h3 _2 r$ C//EDIT BLOCK
, I& N6 a# K8 ^# Jnxopen.features.BlockFeatureBuilder oldBlock = workPart.features().createBlockFeatureBuilder(blockFeature);
5 J6 |, B' k9 i- Z2 G% j3 }oldBlock.setOriginAndLengths(origin,  "100", "20", "50");
+ y9 T8 [2 C, K% D1 W; p  L* loldBlock.commitFeature();
! ~! A* u+ W6 M5 }" }oldBlock.destroy();