CIP JAVA documentation for class "com.ptc.pfc.pfcAssembly.Assembly"

Interface Assembly

package com.ptc.pfc.pfcAssembly; public interface Assembly extends com.ptc.pfc.pfcSolid.Solid

Description

This class describes an assembly.

Direct Known Subclasses:: WAssembly

Method Summary
`Feature`	`AssembleByCopy (String NewModelName, Solid ModelToCopy, boolean LeaveUnplaced)` Assembles a copy of a model into the assembly.
`Feature`	`AssembleComponent (Solid Model, /optional/ Transform3D Position)` Assembles the model into the assembly.
`void`	`AssembleSkeleton (Solid SkeletonModel)` Adds a skeleton model in the assembly.
`void`	`AssembleSkeletonByCopy (String NewSkeletonName, Solid SkeletonToCopy)` Copies the specified template model into the assembly as a skeleton model.
`void`	`DeleteSkeleton ()` Deletes the skeleton model from the assembly.
`void`	`Explode ()` Explodes the specified assembly. The function invalidates the display list, but the application needs to repaint the window.
`/optional/ ExplodedState`	`GetActiveExplodedState ()` Returns the current active exploded state in the assembly.
`ExplodedState`	`GetDefaultExplodedState ()` Returns the default exploded state in the assembly.
`boolean`	`GetDynamicPositioning ()` Get method for attribute "DynamicPositioning" If the assembly uses dynamic positioning, this attribute is `true`; otherwise, it is `false`
`boolean`	`GetIsExploded ()` Get method for attribute "IsExploded" If the assembly is exploded, this attribute is `true`; otherwise, it is`false`
`MassProperty`	`GetMassPropertyByCompPath ( /optional/ ComponentPath CompPath, /optional/ ModelItem CsysItem, /optional/ ComponentPath CsysPath)` Calculates the mass properties of solid referenced by the specified coordinate system, using respective component paths.
`Solid`	`GetSkeleton ()` Returns the skeleton model in the assembly.
`void`	`SetDynamicPositioning (boolean value)` Set method for attribute "DynamicPositioning" If the assembly uses dynamic positioning, this attribute is `true`; otherwise, it is `false`
`void`	`UnExplode ()` Unexplodes the assembly. The function invalidates the display list, but the application needs to repaint the window.

Methods Inherited from Interface `com.ptc.pfc.pfcFamily.FamilyMember`
`GetParent`, `GetImmediateGenericInfo`, `GetTopGenericInfo`, `ListColumns`, `ListRows`, `GetCell`, `SetCell`, `GetCellIsDefault`, `AddRow`, `GetRow`, `RemoveRow`, `AddColumn`, `RemoveColumn`, `GetColumn`, `CreateColumn`, `CreateParamColumn`, `CreateDimensionColumn`, `CreateFeatureColumn`, `CreateComponentColumn`, `CreateCompModelColumn`, `CreateGroupColumn`, `CreateMergePartColumn`, `CreateTolPlusColumn`, `CreateTolMinusColumn`, `CreateTolPlusMinusColumn`

Methods Inherited from Interface com.ptc.pfc.pfcFamily.FamilyMember

GetParent, GetImmediateGenericInfo, GetTopGenericInfo, ListColumns, ListRows, GetCell, SetCell, GetCellIsDefault, AddRow, GetRow, RemoveRow, AddColumn, RemoveColumn, GetColumn, CreateColumn, CreateParamColumn, CreateDimensionColumn, CreateFeatureColumn, CreateComponentColumn, CreateCompModelColumn, CreateGroupColumn, CreateMergePartColumn, CreateTolPlusColumn, CreateTolMinusColumn, CreateTolPlusMinusColumn

Methods Inherited from Interface `com.ptc.pfc.pfcObject.Parent`
`GetChild`

Methods Inherited from Interface `com.ptc.pfc.pfcModelItem.ModelItemOwner`
`GetItemByName`, `GetItemById`, `ListItems`

Methods Inherited from Interface `com.ptc.pfc.pfcView.ViewOwner`
`RetrieveView`, `GetView`, `SaveView`, `GetCurrentViewTransform`, `SetCurrentViewTransform`, `CurrentViewRotate`, `ListViews`, `GetCurrentView`

Methods Inherited from Interface `com.ptc.pfc.pfcObject.Child`
`GetDBParent`, `GetOId`

Methods Inherited from Interface `com.ptc.pfc.pfcBase.ActionSource`
`AddActionListener`, `RemoveActionListener`, `AddActionListenerWithType`

Methods Inherited from Interface `com.ptc.pfc.pfcModelItem.RelationOwner`
`DeleteRelations`, `GetRelations`, `SetRelations`, `RegenerateRelations`, `EvaluateExpression`

Methods Inherited from Interface `com.ptc.pfc.pfcModelItem.ParameterOwner`
`GetParam`, `CreateParam`, `ListParams`, `SelectParam`, `CreateParamWithUnits`, `SelectParameters`

Methods Inherited from Interface `com.ptc.pfc.pfcModel.Model`
`GetDescr`, `GetRelationId`, `GetIsModified`, `GetVersionStamp`, `GetRevision`, `GetVersion`, `GetBranch`, `GetReleaseLevel`, `GetCommonName`, `SetCommonName`, `IsCommonNameModifiable`, `GetFullName`, `GetInstanceName`, `GetGenericName`, `GetType`, `GetFileName`, `Backup`, `Copy`, `CopyAndRetrieve`, `Rename`, `Save`, `Erase`, `EraseWithDependencies`, `Delete`, `Display`, `DisplayInNewWindow`, `ListDependencies`, `ListDeclaredModels`, `CreateLayer`, `Export`, `Import`, `AccessExternalData`, `TerminateExternalData`, `CheckIsSaveAllowed`, `CheckIsModifiable`, `GetOrigin`, `GetPostRegenerationRelations`, `SetPostRegenerationRelations`, `RegeneratePostRegenerationRelations`, `DeletePostRegenerationRelations`, `CleanupDependencies`, `IsNativeModel`, `ExportIntf3D`, `SetIntf3DLayerSetupFile`, `IsIntf3DLayerSetupFileIgnored`, `IsIntf3DCsysIgnored`, `ClearIntf3DModelData`

Methods Inherited from Interface com.ptc.pfc.pfcModel.Model

GetDescr, GetRelationId, GetIsModified, GetVersionStamp, GetRevision, GetVersion, GetBranch, GetReleaseLevel, GetCommonName, SetCommonName, IsCommonNameModifiable, GetFullName, GetInstanceName, GetGenericName, GetType, GetFileName, Backup, Copy, CopyAndRetrieve, Rename, Save, Erase, EraseWithDependencies, Delete, Display, DisplayInNewWindow, ListDependencies, ListDeclaredModels, CreateLayer, Export, Import, AccessExternalData, TerminateExternalData, CheckIsSaveAllowed, CheckIsModifiable, GetOrigin, GetPostRegenerationRelations, SetPostRegenerationRelations, RegeneratePostRegenerationRelations, DeletePostRegenerationRelations, CleanupDependencies, IsNativeModel, ExportIntf3D, SetIntf3DLayerSetupFile, IsIntf3DLayerSetupFileIgnored, IsIntf3DCsysIgnored, ClearIntf3DModelData

Methods Inherited from Interface `com.ptc.pfc.pfcSolid.Solid`
`GetDefaultBody`, `GetSurfaceSolidBody`, `GetEdgeSolidBody`, `GetGeomOutline`, `GetRelativeAccuracy`, `SetRelativeAccuracy`, `GetAbsoluteAccuracy`, `SetAbsoluteAccuracy`, `Regenerate`, `ExecuteFeatureOps`, `EvalOutline`, `CreateLocalGroup`, `CreateNote`, `ListFailedFeatures`, `ListFeaturesByType`, `ListCrossSections`, `GetCrossSection`, `GetIsSkeleton`, `HasRetrievalErrors`, `GetFeatureByName`, `GetFeatureById`, `CreateImportFeat`, `ActivateSimpRep`, `GetActiveSimpRep`, `CreateSimpRep`, `SelectSimpRep`, `GetSimpRep`, `GetMasterRep`, `GetGraphicsRep`, `GetGeomRep`, `DeleteSimpRep`, `GetMassProperty`, `GetMassPropertyWithDensity`, `ListGroups`, `CreateFeature`, `CreateUDFGroup`, `ExportShrinkwrap`, `GetPrincipalUnits`, `SetPrincipalUnits`, `ListUnits`, `ListUnitSystems`, `GetUnit`, `CreateCustomUnit`, `CreateUnitSystem`

Methods Inherited from Interface com.ptc.pfc.pfcSolid.Solid

GetDefaultBody, GetSurfaceSolidBody, GetEdgeSolidBody, GetGeomOutline, GetRelativeAccuracy, SetRelativeAccuracy, GetAbsoluteAccuracy, SetAbsoluteAccuracy, Regenerate, ExecuteFeatureOps, EvalOutline, CreateLocalGroup, CreateNote, ListFailedFeatures, ListFeaturesByType, ListCrossSections, GetCrossSection, GetIsSkeleton, HasRetrievalErrors, GetFeatureByName, GetFeatureById, CreateImportFeat, ActivateSimpRep, GetActiveSimpRep, CreateSimpRep, SelectSimpRep, GetSimpRep, GetMasterRep, GetGraphicsRep, GetGeomRep, DeleteSimpRep, GetMassProperty, GetMassPropertyWithDensity, ListGroups, CreateFeature, CreateUDFGroup, ExportShrinkwrap, GetPrincipalUnits, SetPrincipalUnits, ListUnits, ListUnitSystems, GetUnit, CreateCustomUnit, CreateUnitSystem

Method Detail

GetIsExploded

boolean GetIsExploded ()

If the assembly is exploded, this attribute is true; otherwise, it isfalse

The exploded status of an assembly depends on the mode, in particular, while the drawing view is active, it does not represent the real explode state of the assembly, but the state of the assembly in the current drawing view.

Manual References:: Assemblies and Components: Exploded Assemblies, Assemblies and Components: Exploded Assemblies

GetDynamicPositioning/SetDynamicPositioning

`boolean`	`GetDynamicPositioning`	`()`
`void`	`SetDynamicPositioning`	`(boolean value)`

If the assembly uses dynamic positioning, this attribute is true; otherwise, it is false

Explode

void Explode ()

Explodes the specified assembly. The function invalidates the display list, but the application needs to repaint the window.

Exceptions thrown (but not limited to):

XToolkitNoChange - The specified assembly is already exploded.

Manual References:: Assemblies and Components: Exploded Assemblies, Assemblies and Components: Exploded Assemblies

Returns:

UnExplode

void UnExplode ()

Unexplodes the assembly. The function invalidates the display list, but the application needs to repaint the window.

Exceptions thrown (but not limited to):

XToolkitNoChange - The specified assembly is already unexploded.

Manual References:: Assemblies and Components: Exploded Assemblies, Assemblies and Components: Exploded Assemblies

Returns:

GetDefaultExplodedState

ExplodedState GetDefaultExplodedState ()

Returns the default exploded state in the assembly.

Manual References:: Assemblies and Components: Exploded Assemblies, Assemblies and Components: Exploded Assemblies

Returns:: The default exploded state.

GetActiveExplodedState

/*optional*/ ExplodedState GetActiveExplodedState ()

Returns the current active exploded state in the assembly.

Manual References:: Assemblies and Components: Exploded Assemblies, Assemblies and Components: Exploded Assemblies

Returns:: The active exploded state, or null, if the assembly is not exploded.

AssembleComponent

Feature AssembleComponent (Solid Model, /*optional*/ Transform3D Position)

Assembles the model into the assembly.

The new component will be packaged at the designated location.

Exceptions thrown (but not limited to):

XToolkitUnsupported - Unsupported model. For instance, models which come from Multi-CAD model approach, are not supported in this release.

Manual References:: Assemblies and Components: Assembling Components, Assemblies and Components: Assembling Components

Parameters:

Model: The model to assemble.
Position: The initial position of the component.

Returns:: The new component feature object.

AssembleByCopy

Feature AssembleByCopy (String NewModelName, Solid ModelToCopy, boolean LeaveUnplaced)

Assembles a copy of a model into the assembly.

Exceptions thrown (but not limited to):

XToolkitInvalidType - Template type does not correspond to component type.

XToolkitAbort - The model can not be used as a template or has external dependencies. Copy is aborted.

XToolkitNotValid - Required license not found.

XToolkitLineTooLong - comp_name length of the new component is more than 31 chars. This restriction will be removed in future releases.

XToolkitUnsupported - Unsupported model. For instance, models which come from Multi-CAD model approach, are not supported in this release.

Manual References:: Assemblies and Components: Assembling Components, Assemblies and Components: Assembling Components

Parameters:

NewModelName: The name of the new copy of the model.
ModelToCopy: The template model to copy.
LeaveUnplaced: true to leave the component unplaced, false to place the component in the default location.

Returns:: The new assembly component feature object.

AssembleSkeleton

void AssembleSkeleton (Solid SkeletonModel)

Adds a skeleton model in the assembly.

Exceptions thrown (but not limited to):

XToolkitInvalidType - Skeleton is a handle not to a skeleton model.

XToolkitFound - Skeleton model already exists in the assembly.

XToolkitNotValid - Required license not found.

Manual References:: Assemblies and Components: Skeleton Models, Assemblies and Components: Skeleton Models

Parameters:

SkeletonModel: The skeleton model.

Returns:

AssembleSkeletonByCopy

void AssembleSkeletonByCopy (String NewSkeletonName, Solid SkeletonToCopy)

Copies the specified template model into the assembly as a skeleton model.

Exceptions thrown (but not limited to):

XToolkitFound - Skeleton model already exists in the assembly.

XToolkitAbort - Template type is invalid (for example, is a manufacturing part), or has external external dependencies. Copying is aborted.

XToolkitNotValid - Required license is absent.

XToolkitUnsupported - Models which come from Multi-CAD approach are not supported as template model.

XToolkitLineTooLong - Name length of skeleton model is more than 31 chars.

Manual References:: Assemblies and Components: Skeleton Models, Assemblies and Components: Skeleton Models

Parameters:

NewSkeletonName: The name of the new skeleton model.
SkeletonToCopy: The template model to copy.

Returns:

GetSkeleton

Solid GetSkeleton ()

Returns the skeleton model in the assembly.

Exceptions thrown (but not limited to):

XToolkitNotFound - The specified assembly has no skeleton model.

XToolkitCantAccess - The skeleton exists, but can not be used.

XToolkitNotValid - Required license not found.

Manual References:: Assemblies and Components: Skeleton Models, Assemblies and Components: Skeleton Models

Returns:: The skeleton model.

DeleteSkeleton

void DeleteSkeleton ()

Deletes the skeleton model from the assembly.

Exceptions thrown (but not limited to):

XToolkitNotFound - The specified assembly has no skeleton model.

XToolkitNotValid - Required license not found.

Manual References:: Assemblies and Components: Skeleton Models, Assemblies and Components: Skeleton Models

Returns:

GetMassPropertyByCompPath

MassProperty GetMassPropertyByCompPath ( /*optional*/ ComponentPath CompPath, /*optional*/ ModelItem CsysItem, /*optional*/ ComponentPath CsysPath)

Calculates the mass properties of solid referenced by the specified coordinate system, using respective component paths.

Exceptions thrown (but not limited to):

XToolkitNotFound - The specified coordinate system was not found.

Manual References:: Solid: Mass Properties

Parameters:

CompPath: The component path of solid. If this is null, the top assembly is referred.
CsysItem: The csys model item. If this is null, default csys is referred.
CsysPath: The component path of csys. If this is null, default csys is referred.

Returns: