`Flare`

A flare.

Example

application = cf.Application.GetInstance()
project = application:NewProject()

    -- Create a flare with its base centre at the specified 'Point'

baseCentre = cf.Point(-0.25, -0.25, 0)
flare = project.Contents.Geometry:AddFlare(baseCentre, 0.5, 0.5, 1.0, 0.3, 0.3)

Inheritance

The Flare object is derived from the Geometry object.

Usage locations

The Flare object can be accessed from the following locations:

Methods
- GeometryCollection collection has method AddFlare(table).
- GeometryCollection collection has method AddFlare(Point, Expression, Expression, Expression, Expression, Expression).
- GeometryCollection collection has method AddFlareWithBaseCentreAndFlareAngles(Point, Expression, Expression, Expression, Expression, Expression).
- GeometryCollection collection has method AddFlareWithBaseCorner(Point, Expression, Expression, Expression, Expression, Expression).
- GeometryCollection collection has method AddFlareWithBaseCornerAndTopCorner(Point, Point, Expression, Expression).

Property List

AngleU: The flare angle from the UN plane (degrees). Only valid if DefinitionMethod is BaseCentreAndFlareAngles. (Read/Write AngularDimension)
AngleV: The flare angle from the VN plane (degrees). Only valid if DefinitionMethod is BaseCentreAndFlareAngles. (Read/Write AngularDimension)
Base: The flare base corner/centre origin point. (Read/Write LocalCoordinate)
BottomDepth: The flare bottom depth. (Read/Write Dimension)
BottomWidth: The flare bottom width. (Read/Write Dimension)
BoundingBox: A box indicating the bounding box of this entity. (Read only Box). (Read only Box)
DefinitionMethod: Flare definition method specified by the FlareDefinitionMethodEnum, e.g. BaseCentreAndAllDimensions, BaseCornerAndAllDimensions, etc. (Read/Write FlareDefinitionMethodEnum)
Faulty: Indicates whether the geometry has faults. (Read only boolean)
Height: The flare height. Only valid if DefinitionMethod is BaseCentreAndAllDimensions, BaseCornerAndAllDimensions or BaseCentreAndFlareAngles. (Read/Write NormalDimension)
Label: The object label. (Read/Write string)
LocalMeshSettingsEnabled: Control if the locally defined mesh settings should be used for the entity. (Read/Write boolean)
LocalWorkplane: The source workplane. (Read/Write LocalWorkplane)
MeshSettings: The locally defined mesh setting to use. (Read/Write MeshSettings)
Parent: The parent part of this geometry. If this is a top level part nil will be returned. (Read only Geometry)
Top: The flare top corner point. Only valid if DefinitionMethod is BaseCornerAndTopCorner. (Read/Write LocalCoordinate)
TopDepth: The flare top depth. Only valid if DefinitionMethod is BaseCentreAndAllDimensions or BaseCornerAndAllDimensions. (Read/Write Dimension)
TopWidth: The flare top width. Only valid if DefinitionMethod is BaseCentreAndAllDimensions or BaseCornerAndAllDimensions. (Read/Write Dimension)
Type: The object type string. (Read only string)
Visible: Specifies whether the geometry must be shown or hidden. (Read/Write boolean)

Collection List

Edges: The collection of edges of the operator. (EdgeCollection of Edge.)
Faces: The collection of faces of the operator. (FaceCollection of Face.)
Regions: The collection of regions of the operator. (RegionCollection of Region.)
Transforms: The collection of transforms on the operator. (TransformCollection of Transform.)
Wires: The collection of wires of the operator. (WireCollection of Edge.)

Method List

ConvertToPrimitive (): Convert the geometry into its primitive base form, returning a new part without the concrete type properties. The reference to the original part will become invalid. (Returns a Geometry object.)
CopyAndMirror (properties table): Apply a copy and mirror using a table defining the properties. (Returns a Object object.)
CopyAndRotate (properties table, count number): Apply a copy and rotate using a table defining the properties. (Returns a List of Object object.)
CopyAndRotate (origin Point, rotationaxis Vector, angle number, count number): Copy and rotate the geometry. (Returns a List of Object object.)
CopyAndTranslate (properties table, count number): Apply a copy and translate using a table defining the properties. (Returns a List of Object object.)
CopyAndTranslate (from Point, to Point, count number): Copy and translate the geometry. (Returns a List of Object object.)
Delete (): Deletes the entity.
Duplicate (): Duplicates the entity. (Returns a Object object.)
Explode (): Explode the geometry into separate surface and edge parts. The new parts represent a snapshot of the geometry at the time it was exploded. (Returns a List of Geometry object.)
GetProperties (): Returns a table of properties representing the state of the object. The properties table can be used with the SetProperties method to change multiple properties of the object in one step. (Returns a table object.)
ReverseFaceNormals (): Reverse the geometry face normals.
ReverseFaceNormals (faces List of Face): Reverse the geometry face normals.
SetProperties (properties Object): Modifies the state of the object using the provided table of properties. This method is used to modify multiple properties of the object in a single step.
UnlinkMesh (unlinkoption UnlinkMeshOptionEnum): Unlinks the geometry's associated simulation mesh. (Returns a Mesh object.)

Static Function List

GetDefaultProperties (): Creates a table containing the default settings to create an object. (Returns a table object.)

Property Details

AngleU

The flare angle from the UN plane (degrees). Only valid if DefinitionMethod is BaseCentreAndFlareAngles.

Type: AngularDimension
Access: Read/Write

AngleV

The flare angle from the VN plane (degrees). Only valid if DefinitionMethod is BaseCentreAndFlareAngles.

Type: AngularDimension
Access: Read/Write

Base

The flare base corner/centre origin point.

Type: LocalCoordinate
Access: Read/Write

BottomDepth

The flare bottom depth.

Type: Dimension
Access: Read/Write

BottomWidth

The flare bottom width.

Type: Dimension
Access: Read/Write

BoundingBox

A box indicating the bounding box of this entity. (Read only Box).

Type: Box
Access: Read only

DefinitionMethod

Flare definition method specified by the FlareDefinitionMethodEnum, e.g. BaseCentreAndAllDimensions, BaseCornerAndAllDimensions, etc.

Type: FlareDefinitionMethodEnum
Access: Read/Write

Faulty

Indicates whether the geometry has faults.

Type: boolean
Access: Read only

Height

The flare height. Only valid if DefinitionMethod is BaseCentreAndAllDimensions, BaseCornerAndAllDimensions or BaseCentreAndFlareAngles.

Type: NormalDimension
Access: Read/Write

Label

The object label.

Type: string
Access: Read/Write

LocalMeshSettingsEnabled

Control if the locally defined mesh settings should be used for the entity.

Type: boolean
Access: Read/Write

LocalWorkplane

The source workplane.

Type: LocalWorkplane
Access: Read/Write

MeshSettings

The locally defined mesh setting to use.

Type: MeshSettings
Access: Read/Write

Parent

The parent part of this geometry. If this is a top level part nil will be returned.

Type: Geometry
Access: Read only

Top

The flare top corner point. Only valid if DefinitionMethod is BaseCornerAndTopCorner.

Type: LocalCoordinate
Access: Read/Write

TopDepth

The flare top depth. Only valid if DefinitionMethod is BaseCentreAndAllDimensions or BaseCornerAndAllDimensions.

Type: Dimension
Access: Read/Write

TopWidth

The flare top width. Only valid if DefinitionMethod is BaseCentreAndAllDimensions or BaseCornerAndAllDimensions.

Type: Dimension
Access: Read/Write

Type

The object type string.

Type: string
Access: Read only

Visible

Specifies whether the geometry must be shown or hidden.

Type: boolean
Access: Read/Write

Collection Details

Edges

The collection of edges of the operator.

Type: EdgeCollection

Faces

The collection of faces of the operator.

Type: FaceCollection

Regions

The collection of regions of the operator.

Type: RegionCollection

Transforms

The collection of transforms on the operator.

Type: TransformCollection

Wires

The collection of wires of the operator.

Type: WireCollection

Method Details

ConvertToPrimitive ()

Convert the geometry into its primitive base form, returning a new part without the concrete type properties. The reference to the original part will become invalid.

Return

Geometry: The new primitive geometry base.

CopyAndMirror (properties table)

Apply a copy and mirror using a table defining the properties.

Input Parameters

properties(table): A table of properties defining the mirror transform.

Return

Object: The mirrored geometry.

CopyAndRotate (properties table, count number)

Apply a copy and rotate using a table defining the properties.

Input Parameters

properties(table): A table of properties defining the rotate transform.
count(number): The number of transform copies.

Return

List of Object: The list of rotated geometry.

CopyAndRotate (origin Point, rotationaxis Vector, angle number, count number)

Copy and rotate the geometry.

Input Parameters

origin(Point): The coordinates of the origin of the rotation.
rotationaxis(Vector): The axis of rotation.
angle(number): The angle of rotation (degrees).
count(number): The number of copies.

Return

List of Object: The list of rotated geometry.

CopyAndTranslate (properties table, count number)

Apply a copy and translate using a table defining the properties.

Input Parameters

properties(table): A table of properties defining the translate transform.
count(number): The number of transform copies.

Return

List of Object: The list of translated geometry.

CopyAndTranslate (from Point, to Point, count number)

Copy and translate the geometry.

Input Parameters

from(Point): Translate from coordinate.
to(Point): Translate to coordinate.
count(number): The number of copies.

Return

List of Object: The list of translated geometry.

Delete ()

Deletes the entity.

Duplicate ()

Duplicates the entity.

Return

Object: The new (duplicated) entity.

Explode ()

Explode the geometry into separate surface and edge parts. The new parts represent a snapshot of the geometry at the time it was exploded.

Return

List of Geometry: The list of new surface and edge parts.

GetProperties ()

Returns a table of properties representing the state of the object. The properties table can be used with the SetProperties method to change multiple properties of the object in one step.

Return

table: A table defining the properties.

ReverseFaceNormals ()

Reverse the geometry face normals.

ReverseFaceNormals (faces List of Face)

Reverse the geometry face normals.

Input Parameters

faces(List of Face): The list of faces to reverse normal.

SetProperties (properties Object)

Modifies the state of the object using the provided table of properties. This method is used to modify multiple properties of the object in a single step.

Input Parameters

properties(Object): A table of properties defining the new state of the object.

UnlinkMesh (unlinkoption UnlinkMeshOptionEnum)

Unlinks the geometry's associated simulation mesh.

Input Parameters

unlinkoption(UnlinkMeshOptionEnum): Mesh ports are created. Solution entities are either keep with their original assignment or reassigned to the new port.

Return

Mesh: The unlinked mesh.

Static Function Details

GetDefaultProperties ()

Creates a table containing the default settings to create an object.

Return

table: A table containing the default properties.