All Frameworks Class Hierarchy This Framework Previous Next Indexes
System.IUnknown | +---System.IDispatch | +---System.CATBaseUnknown | +---CATIInputDescription
Usage: you can reimplement this interface by deriving the supplied CATIniInputDescriptionAdaptor adapter class.
interface CATIInputDescription
Interface defining feature integration to the linearity concepts
applied to Ordered Geometrical Set.
Role:
This interface should be implemented for features
to insert into an Ordered Geometrical Set (see CATIGSMTool ).
It says through
GetFeatureType method whether a feature generates a new "geometrical base" or modifies an existing geometry.
Ordered Geometrical Set has introduced the concept of absorbed feature
(a feature F1 is absorbed if there is a feature F2 modifying F1 as input,
F1 is called absorbed feature and F2 absorbant feature). A modification
feature gives the list of the input features that are modified
(see
GetListOfModifiedFeatures ). Among them, one feature is considered as the main input (see
GetMainInput ).
The absorbed features have to be consistent with the result
of the feature. That is to say, if the feature is a geometrical element, their
inputs have to be also geometrical elements and the inputs behaviors (shape/volume/solid)
have to be the same as the feature behavior (see
CATIMf3DBehavior ), if the feature is a shape the inputs have to be shapes.
Absorption impacts, among other things, visualization (absorbed
features are not displayed), graphic properties management (feature properties
inherit from his main input feature properties), selection (absorbed
feature cannot be selected in specification tree), result body (see
CATIBodyRequest ), insertion.
The following table shows the rules which must be ensured regarding the methods results.
For instance, GetMainInput applied to a creation feature (GetFeatureType returning
FeatureType_Creation) must return E_FAIL and the argument oMainInput must be set to Nul.
==================================================================================== | GetFeatureType | GetMainInput | GetListOfModifiedFeatures | | | Returns oMainInput | Returns ioListOfModifiedFeatures | ==================================================================================== | Creation | E_FAIL Nul | E_FAIL {} | ==================================================================================== | ContextualCreation | S_OK Input | E_FAIL {} | ==================================================================================== | Modification | S_OK Input1 | S_OK {Input1[, Input2, ...]} | ====================================================================================
BOA information: this interface can be implemented using the BOA (Basic Object Adapter). To know more about the BOA, refer to the CAA Encyclopedia home page. Click Middleware at the bottom left, then click the Object Modeler tab page. Several articles deal with the BOA.
public virtual HRESULT GetFeatureType( | CATIInputDescription::FeatureType& | ioFeatureType) = 0 |
public virtual HRESULT GetListOfModifiedFeatures( | CATListValCATBaseUnknown_var& | ioListOfModifiedFeatures)= 0 |
public virtual HRESULT GetMainInput( | CATBaseUnknown_var& | oMainInput) = 0 |
enum FeatureType { FeatureType_Unset, FeatureType_Creation, FeatureType_Modification, FeatureType_ContextualCreation }Type of the feature.
Copyright © 2003, Dassault Systèmes. All rights reserved.