WeldFillBuilder Class — NXOpen Python API Reference 12.0.0 documentation

# WeldFillBuilder Class

class `NXOpen.Weld.``WeldFillBuilder`

  Bases: `NXOpen.Builder`

  A builder used to create or edit a `NXOpen.Weld.Fill` feature.

  To create a new instance of this class, use `NXOpen.Weld.WeldManager.CreateFillBuilder()`

  Default values.

  Property | Value
  --- | ---
  BoundaryMethod | Rectangle
  ChangeViewOrientation | 0
  ExtendDistance | -15.0 (millimeters part), -0.5 (inches part)
  ExtrudeHeight | 1
  SubdivideRegion | 0
  Width | 5
  WidthAlong | Xc

  New in version NX7.5.0.

# Properties

Property | Description
--- | ---
Boundary | Returns the section defining the boundary if the `NXOpen.Weld.WeldFillBuilderBoundaryMethodType.Curve` option is specified for the boundary type.
BoundaryMethod | Returns or sets the type of boundary to create the fill from.
ChangeViewOrientation | Returns or sets the indication if the view orientation should be changed automatically (true) upon initial creation of rectangles, or not (false)
Characteristics | Returns the characteristics information.
Corner1 | Returns or sets the first corner of the boundary if the `NXOpen.Weld.WeldFillBuilderBoundaryMethodType.Rectangle` option is specified for the boundary type.
Corner2 | Returns or sets the second corner of the boundary if the `NXOpen.Weld.WeldFillBuilderBoundaryMethodType.Rectangle` option is specified for the boundary type.
DistanceTolerance | Returns or sets the distance tolerance used in processing to determine if two points are coincident.
ExtendDistance | Returns or sets the distance to extend a strip.
ExtrudeHeight | Returns or sets the height of the extrusions representing the fill.
FillStripList | Returns the fill strip list.
InnerBoundary | Returns the section containing edges of interior openings which indicate that these openings should be filled over.
Orientation | Returns or sets the coordinate system that defines the alignment of the strips and rectangle.
PlacementFace | Returns the collector containing the faces to build the fill on.
SubdivideRegion | Returns or sets the indication if the fill is to be a collection of rectangles (true), or simply the enclosed boundary area (false).
Tag | Returns the Tag for this object.
UseSeedFace | Returns or sets the indication if the selected faces should be used as seed faces.
Width | Returns or sets the width of the rectangles.
WidthAlong | Returns or sets the width of the rectangles will be measured along this direction.

# Methods

Method | Description
--- | ---
Commit | Commits any edits that have been applied to the builder.
DeleteFillStrip | Delete a fill strip.
Destroy | Deletes the builder, and cleans up any objects created by the builder.
GetCommittedObjects | For builders that create more than one object, this method returns the objects that are created by commit.
GetObject | Returns the object currently being edited by this builder.
NewFillStrip | Create a new fill strip.
ShowResults | Updates the model to reflect the result of an edit to the model for all builders that support showing results.
Validate | Validate whether the inputs to the component are sufficient for commit to be called.

# Enumerations

WeldFillBuilderBoundaryMethodType Enumeration | Defines whether the initial boundary of the fill pattern is defined by a two point rectangle or a curve.
WeldFillBuilderWidthAlongType Enumeration | Defines the direction the fill strip’s length is aligned

# Property Detail

## Boundary

`WeldFillBuilder.``Boundary`

  Returns the section defining the boundary if the `NXOpen.Weld.WeldFillBuilderBoundaryMethodType.Curve` option is specified for the boundary type.

  `-------------------------------------`

  Getter Method

  Signature `Boundary`

  Returns: |
  Return type: | `NXOpen.Section`

  New in version NX7.5.0.

  License requirements: None.

## BoundaryMethod

`WeldFillBuilder.``BoundaryMethod`

  Returns or sets the type of boundary to create the fill from.

  `-------------------------------------`

  Getter Method

  Signature `BoundaryMethod`

  Returns: |
  Return type: | `NXOpen.Weld.WeldFillBuilderBoundaryMethodType`

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `BoundaryMethod`

  Parameters: | boundaryMethod (`NXOpen.Weld.WeldFillBuilderBoundaryMethodType`) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## ChangeViewOrientation

`WeldFillBuilder.``ChangeViewOrientation`

  Returns or sets the indication if the view orientation should be changed automatically (true) upon initial creation of rectangles, or not (false)

  `-------------------------------------`

  Getter Method

  Signature `ChangeViewOrientation`

  Returns: |
  Return type: | bool

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `ChangeViewOrientation`

  Parameters: | changeViewOrientation (bool) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## Characteristics

`WeldFillBuilder.``Characteristics`

  Returns the characteristics information.

  `-------------------------------------`

  Getter Method

  Signature `Characteristics`

  Returns: |
  Return type: | `NXOpen.Weld.CharacteristicsBuilder`

  New in version NX7.5.0.

  License requirements: None.

## Corner1

`WeldFillBuilder.``Corner1`

  Returns or sets the first corner of the boundary if the `NXOpen.Weld.WeldFillBuilderBoundaryMethodType.Rectangle` option is specified for the boundary type.

  `-------------------------------------`

  Getter Method

  Signature `Corner1`

  Returns: |
  Return type: | `NXOpen.Point`

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `Corner1`

  Parameters: | corner1 (`NXOpen.Point`) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## Corner2

`WeldFillBuilder.``Corner2`

  Returns or sets the second corner of the boundary if the `NXOpen.Weld.WeldFillBuilderBoundaryMethodType.Rectangle` option is specified for the boundary type.

  `-------------------------------------`

  Getter Method

  Signature `Corner2`

  Returns: |
  Return type: | `NXOpen.Point`

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `Corner2`

  Parameters: | corner2 (`NXOpen.Point`) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## DistanceTolerance

`WeldFillBuilder.``DistanceTolerance`

  Returns or sets the distance tolerance used in processing to determine if two points are coincident.

  `-------------------------------------`

  Getter Method

  Signature `DistanceTolerance`

  Returns: |
  Return type: | float

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `DistanceTolerance`

  Parameters: | distanceTolerance (float) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## ExtendDistance

`WeldFillBuilder.``ExtendDistance`

  Returns or sets the distance to extend a strip.

  `-------------------------------------`

  Getter Method

  Signature `ExtendDistance`

  Returns: |
  Return type: | float

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `ExtendDistance`

  Parameters: | distance (float) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## ExtrudeHeight

`WeldFillBuilder.``ExtrudeHeight`

  Returns or sets the height of the extrusions representing the fill.

  `-------------------------------------`

  Getter Method

  Signature `ExtrudeHeight`

  Returns: |
  Return type: | float

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `ExtrudeHeight`

  Parameters: | extrudeHeight (float) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## FillStripList

`WeldFillBuilder.``FillStripList`

  Returns the fill strip list.

  `-------------------------------------`

  Getter Method

  Signature `FillStripList`

  Returns: |
  Return type: | `NXOpen.Weld.WeldFillStripBuilderList`

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## InnerBoundary

`WeldFillBuilder.``InnerBoundary`

  Returns the section containing edges of interior openings which indicate that these openings should be filled over.

  `-------------------------------------`

  Getter Method

  Signature `InnerBoundary`

  Returns: |
  Return type: | `NXOpen.Section`

  New in version NX7.5.0.

  License requirements: None.

## Orientation

`WeldFillBuilder.``Orientation`

  Returns or sets the coordinate system that defines the alignment of the strips and rectangle.

  `-------------------------------------`

  Getter Method

  Signature `Orientation`

  Returns: |
  Return type: | `NXOpen.CoordinateSystem`

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `Orientation`

  Parameters: | csys (`NXOpen.CoordinateSystem`) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## PlacementFace

`WeldFillBuilder.``PlacementFace`

  Returns the collector containing the faces to build the fill on.

  Note that during processing additional faces will be obtained by getting adjacent tangent faces (within 45 degrees) so that the boundary of the area is covered. At least one face inside of every boundary must be selected.

  `-------------------------------------`

  Getter Method

  Signature `PlacementFace`

  Returns: |
  Return type: | `NXOpen.ScCollector`

  New in version NX7.5.0.

  License requirements: None.

## SubdivideRegion

`WeldFillBuilder.``SubdivideRegion`

  Returns or sets the indication if the fill is to be a collection of rectangles (true), or simply the enclosed boundary area (false).

  `-------------------------------------`

  Getter Method

  Signature `SubdivideRegion`

  Returns: |
  Return type: | bool

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `SubdivideRegion`

  Parameters: | subdivideRegion (bool) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## UseSeedFace

`WeldFillBuilder.``UseSeedFace`

  Returns or sets the indication if the selected faces should be used as seed faces.

  `-------------------------------------`

  Getter Method

  Signature `UseSeedFace`

  Returns: |
  Return type: | bool

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `UseSeedFace`

  Parameters: | useSeedFace (bool) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## Width

`WeldFillBuilder.``Width`

  Returns or sets the width of the rectangles.

  Only used if SubdivideRegion is true.

  `-------------------------------------`

  Getter Method

  Signature `Width`

  Returns: |
  Return type: | float

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `Width`

  Parameters: | width (float) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## WidthAlong

`WeldFillBuilder.``WidthAlong`

  Returns or sets the width of the rectangles will be measured along this direction.

  `-------------------------------------`

  Getter Method

  Signature `WidthAlong`

  Returns: |
  Return type: | `NXOpen.Weld.WeldFillBuilderWidthAlongType`

  New in version NX7.5.0.

  License requirements: None.

  `-------------------------------------`

  Setter Method

  Signature `WidthAlong`

  Parameters: | widthAlong (`NXOpen.Weld.WeldFillBuilderWidthAlongType`) –

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

# Method Detail

## DeleteFillStrip

`WeldFillBuilder.``DeleteFillStrip`

  Delete a fill strip.

  Signature `DeleteFillStrip(fillStrip)`

  Parameters: | fillStrip (`NXOpen.Weld.WeldFillStripBuilder`) – Fill strip to delete.

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## NewFillStrip

`WeldFillBuilder.``NewFillStrip`

  Create a new fill strip.

  Signature `NewFillStrip(center, length)`

  Parameters:

  - center (`NXOpen.Point3d`) – Center of the fill strip
  - length (float) – Length of the fill strip

  Returns: |
  Return type: | `NXOpen.Weld.WeldFillStripBuilder`

  New in version NX7.5.0.

  License requirements: ugweld (“UG WELD”)

## Validate

`WeldFillBuilder.``Validate`

  Validate whether the inputs to the component are sufficient for commit to be called.

  If the component is not in a state to commit then an exception is thrown. For example, if the component requires you to set some property, this method will throw an exception if you haven’t set it. This method throws a not-yet-implemented NXException for some components.

  Signature `Validate()`

  Returns: | Was self validation successful
  Return type: | bool

  New in version NX3.0.1.

  License requirements: None.