IShapeCreator¶
- class IShapeCreator¶
Bases:
ImpactCOMWrapperBase- Description:
Use this object to create shapes (IShape objects)
- Remarks:
Assign the relevent shape creator properties, then use the Perform method to create a new shape. Introduced in Impact 8.0.0.66
Wraps a COM object or another wrapper instance. Accepts: - A valid impact_object - An existing impact_com_wrapper_base-derived instance
- property entities¶
Gets Entities.
- Description:
A collection of entities from which to create the shape.
- Remarks:
This property should be assigned if you are using Perform with either sctEntities or sctInsert mode. Note that any non-geometric entities (such as text and dimensions) will be ignored. Introduced in Impact 8.0.0.66
- property entity¶
Gets Entity.
- Description:
An entity from which to create the “sausage” shape.
- Remarks:
This property should be assigned if you are using Perform with sctSausage mode. Introduced in Impact 8.0.0.74
- property matrix¶
Gets Matrix.
- Description:
The transformation matrix to be applied to an existing shape.
- Remarks:
Please see the Perform method for a description of which modes use the Matrix property. Introduced in Impact 8.0.0.74
- property points¶
Gets Points.
- Description:
The array of vector positions from which to generate the shape.
- Remarks:
This property should be assigned if you are using Perform with sctPoints mode. Introduced in Impact 9.0.0.57
- Returns:
The value of Points.
- Return type:
points (any)
- property sausage_distance¶
Gets sausage_distance.
- Description:
The offset distance used to create the “sausage” shape around an entity.
- Remarks:
This property should be assigned if you are using Perform with sctSausage mode. Introduced in Impact 8.0.0.74
- Returns:
The value of sausage_distance.
- Return type:
sausage_distance (float)
- property sausage_end_mode¶
Gets sausage_end_mode.
- Description:
Defines whether a “sausage” shape has square or round ends.
- Remarks:
This property should be assigned if you are using Perform with sctSausage mode. Introduced in Impact 8.0.0.74
- Returns:
The value of sausage_end_mode.
- Return type:
- property shape¶
Gets Shape.
- Description:
An existing shape from which to create a new shape.
- Remarks:
This property should be assigned if you are using Perform with sctShape mode. Introduced in Impact 8.0.0.74
- perform(creation_type)¶
- Description:
Create one or more shapes, using the specified method.
- Remarks:
Ensure that you set the appropriate IShapeCreator properties before calling ths Perform method: sctEntities requires Entities to be set; Matrix is ignored sctInsert requires Entities to be set; Matrix is optional sctSausage requires Entity, sausage_distance and sausage_end_mode to be set; Matrix is ignored sctShape requires Shape to be set; Matrix is optional sctPoints requires Points to be set; Matrix is ignored sctHoles does not require any properties; it uses all visible entities in the current block Note that this operation does not affect the current drawing; no entities are created or modified. Shape objects may be manipulated independently of any drawing. Introduced in Impact 8.0.0.66. The methods sctPoints and sctHoles were added in Impact 9.0.0.57. Note: A bug fix was applied in Impact 13 so that this method now finds nested shapes.
- Returns:
An IShape object, representing the shape.
- Parameters:
creation_type (ipShapeCreationType) – The method to be used to create the shape.
- reset()¶
- Description:
Resets all the IShapeCreator properties back to the default values.
- Remarks:
This method should be used if a single IShapeCreator object is to be used to create several shapes. Introduced in Impact 8.0.0.66
- shapes()¶
- Description:
Creates an IShapes object, which provides a way to perform operations on several shapes at once.
- Remarks:
Introduced in Impact 10.0.0.59