Version: 8.3.0
Home
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
GEOM_ITransformOperations Interface Reference

Interface for shapes transforming. More...

import "GEOM_Gen.idl";

Public Member Functions

GEOM_Object TranslateTwoPoints (in GEOM_Object theObject, in GEOM_Object thePoint1, in GEOM_Object thePoint2)
 Translate the given object along the vector, specified by its end points. More...
 
GEOM_Object TranslateTwoPointsCopy (in GEOM_Object theObject, in GEOM_Object thePoint1, in GEOM_Object thePoint2)
 Translate the given object along the vector, specified by its end points, creating its copy before the translation. More...
 
GEOM_Object TranslateDXDYDZ (in GEOM_Object theObject, in double theDX, in double theDY, in double theDZ)
 Translate the given object along the vector, specified by its components. More...
 
GEOM_Object TranslateDXDYDZCopy (in GEOM_Object theObject, in double theDX, in double theDY, in double theDZ)
 Translate the given object along the vector, specified by its components, creating its copy before the translation. More...
 
GEOM_Object TranslateVector (in GEOM_Object theObject, in GEOM_Object theVector)
 Translate the given object along the given vector. More...
 
GEOM_Object TranslateVectorCopy (in GEOM_Object theObject, in GEOM_Object theVector)
 Translate the given object along the given vector, creating its copy before the translation. More...
 
GEOM_Object TranslateVectorDistance (in GEOM_Object theObject, in GEOM_Object theVector, in double theDistance, in boolean theCopy)
 Translate the given object along the given vector on given distance, creating its copy before the translation. More...
 
GEOM_Object MultiTranslate1D (in GEOM_Object theObject, in GEOM_Object theVector, in double theStep, in long theNbTimes)
 Translate the given object along the given vector a given number times. More...
 
GEOM_Object MultiTranslate2D (in GEOM_Object theObject, in GEOM_Object theVector1, in double theStep1, in long theNbTimes1, in GEOM_Object theVector2, in double theStep2, in long theNbTimes2)
 Conseqently apply two specified translations to theObject specified number of times. More...
 
GEOM_Object RotateThreePoints (in GEOM_Object theObject, in GEOM_Object theCentPoint, in GEOM_Object thePoint1, in GEOM_Object thePoint2)
 Rotate given object around vector perpendicular to plane containing three points. More...
 
GEOM_Object RotateThreePointsCopy (in GEOM_Object theObject, in GEOM_Object theCentPoint, in GEOM_Object thePoint1, in GEOM_Object thePoint2)
 Rotate given object around vector perpendicular to plane containing three points. More...
 
GEOM_Object Rotate (in GEOM_Object theObject, in GEOM_Object theAxis, in double theAngle)
 Rotate the given object around the given axis on the given angle. More...
 
GEOM_Object RotateCopy (in GEOM_Object theObject, in GEOM_Object theAxis, in double theAngle)
 
GEOM_Object MultiRotate1D (in GEOM_Object theObject, in GEOM_Object theAxis, in long theNbObjects)
 Rotate the given object around the given axis a given number times. More...
 
GEOM_Object MultiRotate1DByStep (in GEOM_Object theObject, in GEOM_Object theAxis, in double theAngleStep, in long theNbSteps)
 Rotate the given object around the given axis a given number times on the given angle. More...
 
GEOM_Object MultiRotate2DNbTimes (in GEOM_Object theObject, in GEOM_Object theAxis, in long theNbObjects, in double theRadialStep, in long theNbSteps)
 Rotate the given object around the given axis a given number times and multi-translate each rotation result. More...
 
GEOM_Object MultiRotate2DByStep (in GEOM_Object theObject, in GEOM_Object theAxis, in double theAngleStep, in long theNbSteps1, in double theRadialStep, in long theNbSteps2)
 Rotate the given object around the given axis on the given angle a given number times and multi-translate each rotation result. More...
 
GEOM_Object MultiRotate2D (in GEOM_Object theObject, in GEOM_Object theAxis, in double theAngleStep, in long theNbSteps1, in double theRadialStep, in long theNbSteps2)
 Rotate the given object around the given axis on the given angle a given number times and multi-translate each rotation result. More...
 
GEOM_Object MirrorPlane (in GEOM_Object theObject, in GEOM_Object thePlane)
 Replace the given object by an object, symmetrical to it relatively the given plane. More...
 
GEOM_Object MirrorPlaneCopy (in GEOM_Object theObject, in GEOM_Object thePlane)
 Create an object, symmetrical to the given one relatively the given plane. More...
 
GEOM_Object MirrorAxis (in GEOM_Object theObject, in GEOM_Object theAxis)
 Replace the given object by an object, symmetrical to it relatively the given axis. More...
 
GEOM_Object MirrorAxisCopy (in GEOM_Object theObject, in GEOM_Object theAxis)
 Create an object, symmetrical to the given one relatively the given axis. More...
 
GEOM_Object MirrorPoint (in GEOM_Object theObject, in GEOM_Object thePoint)
 Replace the given object by an object, symmetrical to it relatively the given point. More...
 
GEOM_Object MirrorPointCopy (in GEOM_Object theObject, in GEOM_Object thePoint)
 Create an object, symmetrical to the given one relatively the given point. More...
 
GEOM_Object OffsetShape (in GEOM_Object theObject, in double theOffset)
 Replace the given object by its offset. More...
 
GEOM_Object OffsetShapeCopy (in GEOM_Object theObject, in double theOffset)
 Create new object as offset of the given one. More...
 
GEOM_Object ProjectShapeCopy (in GEOM_Object theSource, in GEOM_Object theTarget)
 Create new object as projection of the given one on a 2D surface. More...
 
double ProjectPointOnWire (in GEOM_Object thePoint, in GEOM_Object theWire, out GEOM_Object thePointOnEdge, out long theEdgeInWireIndex)
 Create a projection projection of the given point on a wire or an edge. More...
 
GEOM_Object ScaleShape (in GEOM_Object theObject, in GEOM_Object thePoint, in double theFactor)
 Scale the given object by the factor. More...
 
GEOM_Object ScaleShapeCopy (in GEOM_Object theObject, in GEOM_Object thePoint, in double theFactor)
 Scale the given object by the factor, creating its copy before the scaling. More...
 
GEOM_Object ScaleShapeAlongAxes (in GEOM_Object theObject, in GEOM_Object thePoint, in double theFactorX, in double theFactorY, in double theFactorZ)
 Scale the given object by different factors along coordinate axes. More...
 
GEOM_Object ScaleShapeAlongAxesCopy (in GEOM_Object theObject, in GEOM_Object thePoint, in double theFactorX, in double theFactorY, in double theFactorZ)
 Scale the given object by different factors along coordinate axes, creating its copy before the scaling. More...
 
GEOM_Object PositionShape (in GEOM_Object theObject, in GEOM_Object theStartLCS, in GEOM_Object theEndLCS)
 Modify the Location of the given object by LCS. More...
 
GEOM_Object PositionShapeCopy (in GEOM_Object theObject, in GEOM_Object theStartLCS, in GEOM_Object theEndLCS)
 Modify the Location of the given object by LCS, creating its copy before the setting. More...
 
GEOM_Object PositionAlongPath (in GEOM_Object theObject, in GEOM_Object thePath, in double theDistance, in boolean theCopy, in boolean theReverse)
 Modify the Location of the given object by Path,. More...
 
GEOM_Object RecomputeObject (in GEOM_Object theObject)
 Recompute the shape from its arguments. More...
 
GEOM_Object MakeProjectionOnCylinder (in GEOM_Object theObject, in double theRadius, in double theStartAngle, in double theAngleLength, in double theAngleRotation)
 Compute the projection of a wire or a face on a cylinder. More...
 
boolean IsDone ()
 To know, if the operation was successfully performed. More...
 
void SetErrorCode (in string theErrorID)
 Set the operation error code. More...
 
string GetErrorCode ()
 Get the operation error code. More...
 
long GetStudyID ()
 Get ID of study, where the operation is defined. More...
 
void StartOperation ()
 Opens a new transaction. More...
 
void FinishOperation ()
 Closes the previously opened trasaction. More...
 
void AbortOperation ()
 Aborts the previously opened transaction. More...
 

Detailed Description

Interface for shapes transforming.

Translation, rotation, scaling, mirroring, offset, projection, recomputing.

Member Function Documentation

GEOM_Object TranslateTwoPoints ( in GEOM_Object  theObject,
in GEOM_Object  thePoint1,
in GEOM_Object  thePoint2 
)

Translate the given object along the vector, specified by its end points.

Parameters
theObjectThe object to be translated.
thePoint1Start point of translation vector.
thePoint2End point of translation vector.
Returns
theObject.
GEOM_Object TranslateTwoPointsCopy ( in GEOM_Object  theObject,
in GEOM_Object  thePoint1,
in GEOM_Object  thePoint2 
)

Translate the given object along the vector, specified by its end points, creating its copy before the translation.

Parameters
theObjectThe object to be translated.
thePoint1Start point of translation vector.
thePoint2End point of translation vector.
Returns
New GEOM_Object, containing the translated object.
GEOM_Object TranslateDXDYDZ ( in GEOM_Object  theObject,
in double  theDX,
in double  theDY,
in double  theDZ 
)

Translate the given object along the vector, specified by its components.

Parameters
theObjectThe object to be translated.
theDX,theDY,theDZComponents of translation vector.
Returns
theObject.
GEOM_Object TranslateDXDYDZCopy ( in GEOM_Object  theObject,
in double  theDX,
in double  theDY,
in double  theDZ 
)

Translate the given object along the vector, specified by its components, creating its copy before the translation.

Parameters
theObjectThe object to be translated.
theDX,theDY,theDZComponents of translation vector.
Returns
New GEOM_Object, containing the translated object.
GEOM_Object TranslateVector ( in GEOM_Object  theObject,
in GEOM_Object  theVector 
)

Translate the given object along the given vector.

Parameters
theObjectThe object to be translated.
theVectorTranslation vector, giving both direction and distance.
Returns
theObject.
GEOM_Object TranslateVectorCopy ( in GEOM_Object  theObject,
in GEOM_Object  theVector 
)

Translate the given object along the given vector, creating its copy before the translation.

Parameters
theObjectThe object to be translated.
theVectorTranslation vector, giving both direction and distance.
Returns
New GEOM_Object, containing the translated object.
GEOM_Object TranslateVectorDistance ( in GEOM_Object  theObject,
in GEOM_Object  theVector,
in double  theDistance,
in boolean  theCopy 
)

Translate the given object along the given vector on given distance, creating its copy before the translation.

Parameters
theObjectThe object to be translated.
theVectorTranslation vector, giving a direction.
theDistanceTranslation distance, giving a distance.
theCopyTranslation copy, creating its copy if true.
Returns
New GEOM_Object, containing the translated object.
GEOM_Object MultiTranslate1D ( in GEOM_Object  theObject,
in GEOM_Object  theVector,
in double  theStep,
in long  theNbTimes 
)

Translate the given object along the given vector a given number times.

Parameters
theObjectThe object to be translated.
theVectorDirection of the translation. DX if None.
theStepDistance to translate on.
theNbTimesQuantity of translations to be done.
Returns
New GEOM_Object, containing compound of all the shapes, obtained after each translation.
GEOM_Object MultiTranslate2D ( in GEOM_Object  theObject,
in GEOM_Object  theVector1,
in double  theStep1,
in long  theNbTimes1,
in GEOM_Object  theVector2,
in double  theStep2,
in long  theNbTimes2 
)

Conseqently apply two specified translations to theObject specified number of times.

Parameters
theObjectThe object to be translated.
theVector1Direction of the first translation. DX if None.
theStep1Step of the first translation.
theNbTimes1Quantity of translations to be done along theVector1.
theVector2Direction of the second translation. DY if None.
theStep2Step of the second translation.
theNbTimes2Quantity of translations to be done along theVector2.
Returns
New GEOM_Object, containing compound of all the shapes, obtained after each translation.
GEOM_Object RotateThreePoints ( in GEOM_Object  theObject,
in GEOM_Object  theCentPoint,
in GEOM_Object  thePoint1,
in GEOM_Object  thePoint2 
)

Rotate given object around vector perpendicular to plane containing three points.

Parameters
theObjectThe object to be rotated.
theCentPointcentral point - the axis is the vector perpendicular to the plane containing the three points.
thePoint1,thePoint2- in a perpendicular plan of the axis.
Returns
theObject.
GEOM_Object RotateThreePointsCopy ( in GEOM_Object  theObject,
in GEOM_Object  theCentPoint,
in GEOM_Object  thePoint1,
in GEOM_Object  thePoint2 
)

Rotate given object around vector perpendicular to plane containing three points.

Creating its copy before the rotatation.

Parameters
theObjectThe object to be rotated.
theCentPointcentral point - the axis is the vector perpendicular to the plane containing the three points.
thePoint1,thePoint2- in a perpendicular plan of the axis.
Returns
New GEOM_Object, containing the rotated object.
GEOM_Object Rotate ( in GEOM_Object  theObject,
in GEOM_Object  theAxis,
in double  theAngle 
)

Rotate the given object around the given axis on the given angle.

Parameters
theObjectThe object to be rotated.
theAxisRotation axis.
theAngleRotation angle in radians.
Returns
theObject.
GEOM_Object RotateCopy ( in GEOM_Object  theObject,
in GEOM_Object  theAxis,
in double  theAngle 
)

Rotate the given object around the given axis on the given angle, creating its copy before the rotatation.

Parameters
theObjectThe object to be rotated.
theAxisRotation axis.
theAngleRotation angle in radians.
Returns
New GEOM_Object, containing the rotated object.
GEOM_Object MultiRotate1D ( in GEOM_Object  theObject,
in GEOM_Object  theAxis,
in long  theNbObjects 
)

Rotate the given object around the given axis a given number times.

Rotation angle will be 2*PI/theNbObjects.

Parameters
theObjectThe object to be rotated.
theAxisThe rotation axis. DZ if None.
theNbObjectsQuantity of rotations to be done.
Returns
New GEOM_Object, containing compound of all the shapes, obtained after each rotation.
GEOM_Object MultiRotate1DByStep ( in GEOM_Object  theObject,
in GEOM_Object  theAxis,
in double  theAngleStep,
in long  theNbSteps 
)

Rotate the given object around the given axis a given number times on the given angle.

Parameters
theObjectThe object to be rotated.
theAxisThe rotation axis. DZ if None.
theAngleStepRotation angle in radians.
theNbStepsQuantity of rotations to be done.
Returns
New GEOM_Object, containing compound of all the shapes, obtained after each rotation.
GEOM_Object MultiRotate2DNbTimes ( in GEOM_Object  theObject,
in GEOM_Object  theAxis,
in long  theNbObjects,
in double  theRadialStep,
in long  theNbSteps 
)

Rotate the given object around the given axis a given number times and multi-translate each rotation result.

Rotation angle will be 2*PI/theNbObjects. Translation direction passes through center of gravity of rotated shape and its projection on the rotation axis.

Parameters
theObjectThe object to be rotated.
theAxisRotation axis. DZ if None.
theNbObjectsQuantity of rotations to be done.
theRadialStepTranslation distance.
theNbStepsQuantity of translations to be done.
Returns
New GEOM_Object, containing compound of all the shapes, obtained after each transformation.
GEOM_Object MultiRotate2DByStep ( in GEOM_Object  theObject,
in GEOM_Object  theAxis,
in double  theAngleStep,
in long  theNbSteps1,
in double  theRadialStep,
in long  theNbSteps2 
)

Rotate the given object around the given axis on the given angle a given number times and multi-translate each rotation result.

Translation direction passes through center of gravity of rotated shape and its projection on the rotation axis.

Parameters
theObjectThe object to be rotated.
theAxisRotation axis. DZ if None.
theAngleStepRotation angle in radians.
theNbSteps1Quantity of rotations to be done.
theRadialStepTranslation distance.
theNbSteps2Quantity of translations to be done.
Returns
New GEOM_Object, containing compound of all the shapes, obtained after each transformation.
GEOM_Object MultiRotate2D ( in GEOM_Object  theObject,
in GEOM_Object  theAxis,
in double  theAngleStep,
in long  theNbSteps1,
in double  theRadialStep,
in long  theNbSteps2 
)

Rotate the given object around the given axis on the given angle a given number times and multi-translate each rotation result.

Translation direction passes through center of gravity of rotated shape and its projection on the rotation axis.

Parameters
theObjectThe object to be rotated.
theAxisRotation axis. DZ if None.
theAngleStepRotation angle in degrees.
theNbSteps1Quantity of rotations to be done.
theRadialStepTranslation distance.
theNbSteps2Quantity of translations to be done.
Returns
New GEOM_Object, containing compound of all the shapes, obtained after each transformation.
GEOM_Object MirrorPlane ( in GEOM_Object  theObject,
in GEOM_Object  thePlane 
)

Replace the given object by an object, symmetrical to it relatively the given plane.

Parameters
theObjectThe object to be mirrored.
thePlanePlane of symmetry.
GEOM_Object MirrorPlaneCopy ( in GEOM_Object  theObject,
in GEOM_Object  thePlane 
)

Create an object, symmetrical to the given one relatively the given plane.

Parameters
theObjectThe object to be mirrored.
thePlanePlane of symmetry.
Returns
New GEOM_Object, containing the mirrored shape.
GEOM_Object MirrorAxis ( in GEOM_Object  theObject,
in GEOM_Object  theAxis 
)

Replace the given object by an object, symmetrical to it relatively the given axis.

Parameters
theObjectThe object to be mirrored.
theAxisAxis of symmetry.
Returns
theObject.
GEOM_Object MirrorAxisCopy ( in GEOM_Object  theObject,
in GEOM_Object  theAxis 
)

Create an object, symmetrical to the given one relatively the given axis.

Parameters
theObjectThe object to be mirrored.
theAxisAxis of symmetry.
Returns
New GEOM_Object, containing the mirrored object.
GEOM_Object MirrorPoint ( in GEOM_Object  theObject,
in GEOM_Object  thePoint 
)

Replace the given object by an object, symmetrical to it relatively the given point.

Parameters
theObjectThe object to be mirrored.
thePointPoint of symmetry.
Returns
theObject.
GEOM_Object MirrorPointCopy ( in GEOM_Object  theObject,
in GEOM_Object  thePoint 
)

Create an object, symmetrical to the given one relatively the given point.

Parameters
theObjectThe object to be mirrored.
thePointPoint of symmetry.
Returns
New GEOM_Object, containing the mirrored object.
GEOM_Object OffsetShape ( in GEOM_Object  theObject,
in double  theOffset 
)

Replace the given object by its offset.

Parameters
theObjectThe base object for the offset.
theOffsetOffset value.
Returns
theObject.
GEOM_Object OffsetShapeCopy ( in GEOM_Object  theObject,
in double  theOffset 
)

Create new object as offset of the given one.

Parameters
theObjectThe base object for the offset.
theOffsetOffset value.
Returns
New GEOM_Object, containing the offset object.
GEOM_Object ProjectShapeCopy ( in GEOM_Object  theSource,
in GEOM_Object  theTarget 
)

Create new object as projection of the given one on a 2D surface.

Parameters
theSourceThe source object for the projection. It can be a point, edge or wire.
theTargetThe target object. It can be planar or cylindrical face.
Returns
New GEOM_Object, containing the projection.
double ProjectPointOnWire ( in GEOM_Object  thePoint,
in GEOM_Object  theWire,
out GEOM_Object  thePointOnEdge,
out long  theEdgeInWireIndex 
)

Create a projection projection of the given point on a wire or an edge.

If there are no solutions or there are 2 or more solutions It throws an exception.

Parameters
thePointthe point to be projected.
theWirethe wire. The edge is accepted as well.
thePointOnEdgethe projection point.
theEdgeInWireIndexthe index of an edge in a wire.
Returns
the parameter of projection point on edge.
GEOM_Object ScaleShape ( in GEOM_Object  theObject,
in GEOM_Object  thePoint,
in double  theFactor 
)

Scale the given object by the factor.

Parameters
theObjectThe object to be scaled.
thePointCenter point for scaling.
theFactorScaling factor value.
Returns
theObject.
GEOM_Object ScaleShapeCopy ( in GEOM_Object  theObject,
in GEOM_Object  thePoint,
in double  theFactor 
)

Scale the given object by the factor, creating its copy before the scaling.

Parameters
theObjectThe object to be scaled.
thePointCenter point for scaling.
theFactorScaling factor value.
Returns
New GEOM_Object, containing the scaled shape.
GEOM_Object ScaleShapeAlongAxes ( in GEOM_Object  theObject,
in GEOM_Object  thePoint,
in double  theFactorX,
in double  theFactorY,
in double  theFactorZ 
)

Scale the given object by different factors along coordinate axes.

Parameters
theObjectThe object to be scaled.
thePointCenter point for scaling.
theFactorX,theFactorY,theFactorZScaling factors along each axis.
Returns
theObject.
GEOM_Object ScaleShapeAlongAxesCopy ( in GEOM_Object  theObject,
in GEOM_Object  thePoint,
in double  theFactorX,
in double  theFactorY,
in double  theFactorZ 
)

Scale the given object by different factors along coordinate axes, creating its copy before the scaling.

Parameters
theObjectThe object to be scaled.
thePointCenter point for scaling.
theFactorX,theFactorY,theFactorZScaling factors along each axis.
Returns
New GEOM_Object, containing the scaled shape.
GEOM_Object PositionShape ( in GEOM_Object  theObject,
in GEOM_Object  theStartLCS,
in GEOM_Object  theEndLCS 
)

Modify the Location of the given object by LCS.

Parameters
theObjectThe object to be displaced.
theStartLCSCoordinate system to perform displacement from it. If theStartLCS is NULL, displacement will be performed from global CS. If theObject itself is used as theStartLCS, its location will be changed to theEndLCS.
theEndLCSCoordinate system to perform displacement to it.
Returns
theObject.
GEOM_Object PositionShapeCopy ( in GEOM_Object  theObject,
in GEOM_Object  theStartLCS,
in GEOM_Object  theEndLCS 
)

Modify the Location of the given object by LCS, creating its copy before the setting.

Parameters
theObjectThe object to be displaced.
theStartLCSCoordinate system to perform displacement from it. If theStartLCS is NULL, displacement will be performed from global CS. If theObject itself is used as theStartLCS, its location will be changed to theEndLCS.
theEndLCSCoordinate system to perform displacement to it.
Returns
New GEOM_Object, containing the displaced shape.
GEOM_Object PositionAlongPath ( in GEOM_Object  theObject,
in GEOM_Object  thePath,
in double  theDistance,
in boolean  theCopy,
in boolean  theReverse 
)

Modify the Location of the given object by Path,.

Parameters
theObjectThe object to be displaced.
thePathWire or Edge along that the object will be translated.
theDistanceprogress of Path (0 = actual location, 1 = end of path location).
theCopyis a true or false parameter. true is to create a copy, false to move the object.
theReverseis a true or false parameter. True is to reverse direction, false is to move normal direction.
Returns
New GEOM_Object, containing the displaced shape.
GEOM_Object RecomputeObject ( in GEOM_Object  theObject)

Recompute the shape from its arguments.

Parameters
theObjectThe object to be recomputed.
Returns
theObject.
GEOM_Object MakeProjectionOnCylinder ( in GEOM_Object  theObject,
in double  theRadius,
in double  theStartAngle,
in double  theAngleLength,
in double  theAngleRotation 
)

Compute the projection of a wire or a face on a cylinder.

This method computes a wire or a face or a compound of faces that represents a projection of the source shape onto cylinder. The cylinder's coordinate system is the same as the global coordinate system.

Parameters
theObjectThe object to be projected. It can be either a planar wire or a face.
theRadiusThe radius of the cylinder.
theStartAngleThe starting angle from the cylinder's X axis around Z axis. The angle from which the projection is started.
theAngleLengthThe projection length angle. The angle in which to project the total length of the wire. If it is negative the projection is not scaled and natural wire length is kept for the projection.
theAngleRotationthe desired angle between the tangent vector to the first curve at the first point of the theObject's projection in 2D space and U-direction of cylinder's 2D space.
Returns
A wire or a face or a compound of faces that represents a projection of the source shape onto a cylinder.
boolean IsDone ( )
inherited

To know, if the operation was successfully performed.

void SetErrorCode ( in string  theErrorID)
inherited

Set the operation error code.

Parameters
theErrorIDis a string describing the error occured
Note
This method is supposed to be used only by interfaces inheriting from IOperations.
string GetErrorCode ( )
inherited

Get the operation error code.

long GetStudyID ( )
inherited

Get ID of study, where the operation is defined.

void StartOperation ( )
inherited

Opens a new transaction.

void FinishOperation ( )
inherited

Closes the previously opened trasaction.

void AbortOperation ( )
inherited

Aborts the previously opened transaction.