Class OCCTTransforms

نقل أشكال OpenCascade وتدويرها وتحجيمها وعكسها مرآتيا، وبناء مصفوفات 4x4 التي تصف مثل هذه الحركات. تعيد كل دالة شكلا جديدا وتترك المدخل كما كان. الزوايا بالدرجات، والمسافات بوحدات النموذج، ويمر محور التدوير بنقطة الأصل ما لم تأخذ الدالة مركزا. المصفوفات 16 رقما بترتيب الأعمدة (يقع النقل عند الفهارس من 12 إلى 14)؛ وتطبق قائمة المصفوفات من الأولى إلى الأخيرة كحركة مركبة واحدة، وهكذا يتكامل transformByMatrix مع بانيات ...ToMatrix.

Constructors

constructor

new OCCTTransforms(): OCCTTransforms
Returns OCCTTransforms

by matrix

transformByMatrix

transformByMatrix(
inputs: TransformByMatrixDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يطبق مصفوفة 4x4، أو قائمة مصفوفات تُطبق من الأولى إلى الأخيرة، على شكل.

المصفوفة بترتيب الأعمدة، فيقع النقل في الفهارس من 12 إلى 14. يُسمح بمصفوفة تمط أو تقص؛ ابن المصفوفات بطرق ...ToMatrix وركّبها بـ multiplyTransforms. المصفوفة التي لا تستطيع النواة تطبيقها ترمي خطأ.
Parameters
- inputs: TransformByMatrixDto<TopoDSShapePointer>
  الشكل والمصفوفة أو قائمة المصفوفات
Returns Promise<TopoDSShapePointer>
الشكل المحوّل
Example
```
const move = await bitbybit.occt.transforms.translationToMatrix({ translation: [10, 0, 0] });
const turn = await bitbybit.occt.transforms.rotationAxisAngleToMatrix({ axis: [0, 1, 0], angle: 90, center: [0, 0, 0] });
const placed = await bitbybit.occt.transforms.transformByMatrix({ shape: box, transformation: [turn, move] });
```
- Defined in bitbybit-docs.d.ts:47272

transformShapesByMatrix

transformShapesByMatrix(
inputs: TransformShapesByMatrixDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer[]>
يطبق مصفوفة 4x4 نفسها، أو قائمة مصفوفات تُطبق من الأولى إلى الأخيرة، على عدة أشكال، كما تفعل transformByMatrix لشكل واحد.
Parameters
- inputs: TransformShapesByMatrixDto<TopoDSShapePointer>
  الأشكال والمصفوفة أو قائمة المصفوفات
Returns Promise<TopoDSShapePointer[]>
الأشكال المحوّلة، بالترتيب نفسه
Example
```
const moved = await bitbybit.occt.transforms.transformShapesByMatrix({ shapes: [box, sphere], transformation: matrix });
```
- Defined in bitbybit-docs.d.ts:47286

getShapeTransform

getShapeTransform(
inputs: ShapeTransformQueryDto<TopoDSShapePointer>,
): Promise<ShapeTransformInfo>
يقرأ الوضع الذي يحمله شكل، التحويل المخزن عليه لا المدمج في هندسته، كمصفوفة مع نقلها ورباعي تدويرها وتحجيمها المنتظم.

الشكل الموضوع بـ align أو عبر تجميع يحمل مثل هذا الوضع؛ ومعظم الطرق الأخرى هنا تدمج النقل في الهندسة، ومثل هذا الشكل يبلغ عن مصفوفة الوحدة.
Parameters
- inputs: ShapeTransformQueryDto<TopoDSShapePointer>
  الشكل المراد قراءته
Returns Promise<ShapeTransformInfo>
المصفوفة والنقل والرباعي بصيغة [x, y, z, w] والتحجيم
Example
```
const placement = await bitbybit.occt.transforms.getShapeTransform({ shape: movedBox });
console.log(placement.translation, placement.scale);
```
- Defined in bitbybit-docs.d.ts:47304

matrix builders

identityTransform

identityTransform(): Promise<TransformMatrix>
يبني مصفوفة الوحدة، التحويل الذي لا يغير شيئا، كنقطة بداية لتركيب غيرها.

Returns Promise<TransformMatrix>
مصفوفة الوحدة، بترتيب الأعمدة
Example
```
const identity = await bitbybit.occt.transforms.identityTransform();
```
- Defined in bitbybit-docs.d.ts:47317

composeTransform

composeTransform(inputs: ComposeTransformDto): Promise<TransformMatrix>
يبني مصفوفة واحدة من نقل وثلاث زوايا تدوير بالدرجات حول X و Y و Z وتحجيم منتظم.

يُطبق التحجيم أولا، ثم التدويرات (Z أولا، ثم Y، ثم X)، ثم النقل، وهو الترتيب الذي تستخدمه أوضاع التجميع. أي جزء متروك يُعد بلا تغيير.
Parameters
- inputs: ComposeTransformDto
  النقل وزوايا التدوير الثلاث بالدرجات ومعامل التحجيم
Returns Promise<TransformMatrix>
المصفوفة المركبة، بترتيب الأعمدة
Example
```
const placement = await bitbybit.occt.transforms.composeTransform({ translation: [10, 0, 0], rotation: [0, 90, 0], scale: 1 });
```
- Defined in bitbybit-docs.d.ts:47335

multiplyTransforms

multiplyTransforms(inputs: MultiplyTransformsDto): Promise<TransformMatrix>
يطوي قائمة مصفوفات في مصفوفة واحدة، تُطبق من الأولى إلى الأخيرة، فتصبح سلسلة الحركات مصفوفة واحدة.

تُعاد المصفوفة الواحدة دون تغيير والقائمة الفارغة تعطي مصفوفة الوحدة.
Parameters
- inputs: MultiplyTransformsDto
  المصفوفة أو قائمة المصفوفات
Returns Promise<TransformMatrix>
المصفوفة المركبة، بترتيب الأعمدة
Example
```
const combined = await bitbybit.occt.transforms.multiplyTransforms({ transformation: [turn, move] });
```
- Defined in bitbybit-docs.d.ts:47351

invertTransform

invertTransform(inputs: InvertTransformDto): Promise<TransformMatrix>
يعكس مصفوفة، معطيا التحويل الذي يلغيها: تطبيق مصفوفة ثم معكوسها يعيد الشكل إلى حيث كان.
Parameters
- inputs: InvertTransformDto
  المصفوفة المراد عكسها
Returns Promise<TransformMatrix>
المصفوفة المعكوسة، بترتيب الأعمدة
Example
```
const back = await bitbybit.occt.transforms.invertTransform({ transformation: placement });
```
- Defined in bitbybit-docs.d.ts:47365

translationToMatrix

translationToMatrix(inputs: TranslationToMatrixDto): Promise<TransformMatrix>
يبني مصفوفة النقل بمتجه، بوحدات النموذج.
Parameters
- inputs: TranslationToMatrixDto
  متجه النقل
Returns Promise<TransformMatrix>
مصفوفة النقل، بترتيب الأعمدة
Example
```
const move = await bitbybit.occt.transforms.translationToMatrix({ translation: [10, 0, 0] });
```
- Defined in bitbybit-docs.d.ts:47378

rotationAxisAngleToMatrix

rotationAxisAngleToMatrix(
inputs: RotationAxisAngleToMatrixDto,
): Promise<TransformMatrix>
يبني مصفوفة التدوير بزاوية بالدرجات حول محور، يمر بنقطة الأصل أو بنقطة مركز اختيارية.

يتبع التدوير قاعدة اليد اليمنى حول axis.
Parameters
- inputs: RotationAxisAngleToMatrixDto
  اتجاه المحور والزاوية بالدرجات والنقطة الاختيارية التي يمر بها المحور
Returns Promise<TransformMatrix>
مصفوفة التدوير، بترتيب الأعمدة
Example
```
const turn = await bitbybit.occt.transforms.rotationAxisAngleToMatrix({ axis: [0, 1, 0], angle: 90, center: [5, 0, 5] });
```
- Defined in bitbybit-docs.d.ts:47394

scaleUniformToMatrix

scaleUniformToMatrix(inputs: ScaleUniformToMatrixDto): Promise<TransformMatrix>
يبني مصفوفة التحجيم المنتظم بمعامل حول نقطة الأصل أو نقطة مركز اختيارية.
Parameters
- inputs: ScaleUniformToMatrixDto
  المعامل والنقطة الاختيارية التي يتم التحجيم حولها
Returns Promise<TransformMatrix>
مصفوفة التحجيم، بترتيب الأعمدة
Example
```
const grow = await bitbybit.occt.transforms.scaleUniformToMatrix({ factor: 2, center: [0, 0, 0] });
```
- Defined in bitbybit-docs.d.ts:47408

mirrorPointToMatrix

mirrorPointToMatrix(inputs: MirrorPointToMatrixDto): Promise<TransformMatrix>
يبني مصفوفة الانعكاس المرآتي عبر نقطة، التحويل الذي تطبقه mirrorAboutPoint.
Parameters
- inputs: MirrorPointToMatrixDto
  النقطة التي يتم العكس عبرها
Returns Promise<TransformMatrix>
مصفوفة الانعكاس المرآتي، بترتيب الأعمدة
Example
```
const invert = await bitbybit.occt.transforms.mirrorPointToMatrix({ point: [0, 0, 0] });
```
- Defined in bitbybit-docs.d.ts:47421

mirrorAxisToMatrix

mirrorAxisToMatrix(inputs: MirrorAxisToMatrixDto): Promise<TransformMatrix>
يبني مصفوفة الانعكاس المرآتي عبر خط، التحويل الذي تطبقه mirror: المحور المار بـ origin على طول direction.
Parameters
- inputs: MirrorAxisToMatrixDto
  نقطة على المحور واتجاه المحور
Returns Promise<TransformMatrix>
مصفوفة الانعكاس المرآتي، بترتيب الأعمدة
Example
```
const flip = await bitbybit.occt.transforms.mirrorAxisToMatrix({ origin: [0, 0, 0], direction: [0, 1, 0] });
```
- Defined in bitbybit-docs.d.ts:47435

mirrorPlaneToMatrix

mirrorPlaneToMatrix(inputs: MirrorPlaneToMatrixDto): Promise<TransformMatrix>
يبني مصفوفة الانعكاس المرآتي عبر مستوى، التحويل الذي تطبقه mirrorAlongNormal: المستوى المار بـ origin بالناظم المعطى.
Parameters
- inputs: MirrorPlaneToMatrixDto
  نقطة على المستوى وناظم المستوى
Returns Promise<TransformMatrix>
مصفوفة الانعكاس المرآتي، بترتيب الأعمدة
Example
```
const reflect = await bitbybit.occt.transforms.mirrorPlaneToMatrix({ origin: [0, 0, 0], normal: [1, 0, 0] });
```
- Defined in bitbybit-docs.d.ts:47449

quaternionToMatrix

quaternionToMatrix(inputs: QuaternionToMatrixDto): Promise<TransformMatrix>
يبني مصفوفة التدوير لرباعي معطى بصيغة [x, y, z, w].

يُطبّع الرباعي أولا، فلا يهم طوله.
Parameters
- inputs: QuaternionToMatrixDto
  الرباعي
Returns Promise<TransformMatrix>
مصفوفة التدوير، بترتيب الأعمدة
Example
```
const turn = await bitbybit.occt.transforms.quaternionToMatrix({ quaternion: [0, 0.7071, 0, 0.7071] });
```
- Defined in bitbybit-docs.d.ts:47464

on shapes

transformShapes

transformShapes(
inputs: TransformShapesDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer[]>
يطبق transform على عدة أشكال، كل منها بنقله ومحور تدويره وزاويته ومعامل تحجيمه الخاصة.

يجب أن يكون لكل القوائم الطول نفسه، وإلا رُمي خطأ.
Parameters
- inputs: TransformShapesDto<TopoDSShapePointer>
  الأشكال ونقل واحد ومحور تدوير وزاوية بالدرجات ومعامل تحجيم لكل شكل
Returns Promise<TopoDSShapePointer[]>
الأشكال المحوّلة، بالترتيب نفسه
Example
```
const moved = await bitbybit.occt.transforms.transformShapes({
    shapes: [box, sphere],
    translations: [[10, 0, 0], [-10, 0, 0]],
    rotationAxes: [[0, 1, 0], [0, 1, 0]],
    rotationAngles: [45, 0],
    scaleFactors: [1, 2],
});
```
- Defined in bitbybit-docs.d.ts:47041

rotateShapes

rotateShapes(
inputs: RotateShapesDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer[]>
يطبق rotate على عدة أشكال، كل منها حول محوره الخاص المار بنقطة الأصل وبزاويته الخاصة بالدرجات.

يجب أن يكون لكل القوائم الطول نفسه، وإلا رُمي خطأ.
Parameters
- inputs: RotateShapesDto<TopoDSShapePointer>
  الأشكال ومحور واحد وزاوية واحدة لكل شكل
Returns Promise<TopoDSShapePointer[]>
الأشكال المدوّرة، بالترتيب نفسه
Example
```
const turned = await bitbybit.occt.transforms.rotateShapes({ shapes: [box, sphere], axes: [[0, 1, 0], [1, 0, 0]], angles: [90, 45] });
```
- Defined in bitbybit-docs.d.ts:47057

rotateAroundCenterShapes

rotateAroundCenterShapes(
inputs: RotateAroundCenterShapesDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer[]>
يطبق rotateAroundCenter على عدة أشكال، كل منها بزاويته الخاصة بالدرجات ومركزه ومحوره.

يجب أن يكون لكل القوائم الطول نفسه، وإلا رُمي خطأ.
Parameters
- inputs: RotateAroundCenterShapesDto<TopoDSShapePointer>
  الأشكال وزاوية ومركز ومحور واحد لكل شكل
Returns Promise<TopoDSShapePointer[]>
الأشكال المدوّرة، بالترتيب نفسه
Example
```
const turned = await bitbybit.occt.transforms.rotateAroundCenterShapes({
    shapes: [box, sphere],
    angles: [90, 45],
    centers: [[5, 0, 5], [0, 0, 0]],
    axes: [[0, 1, 0], [0, 1, 0]],
});
```
- Defined in bitbybit-docs.d.ts:47078

alignShapes

alignShapes(
inputs: AlignShapesDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer[]>
يطبق align على عدة أشكال، كل منها بإطاري المصدر والهدف الخاصين به.

يجب أن يكون لكل القوائم الطول نفسه، وإلا رُمي خطأ.
Parameters
- inputs: AlignShapesDto<TopoDSShapePointer>
  الأشكال ونقطة أصل واتجاه مصدر ونقطة أصل واتجاه هدف لكل شكل
Returns Promise<TopoDSShapePointer[]>
الأشكال المحاذاة، بالترتيب نفسه
Example
```
const placed = await bitbybit.occt.transforms.alignShapes({
    shapes: [cylinder, cylinder2],
    fromOrigins: [[0, 0, 0], [0, 0, 0]],
    fromDirections: [[0, 1, 0], [0, 1, 0]],
    toOrigins: [[10, 0, 0], [20, 0, 0]],
    toDirections: [[1, 0, 0], [0, 0, 1]],
});
```
- Defined in bitbybit-docs.d.ts:47099

alignAndTranslateShapes

alignAndTranslateShapes(
inputs: AlignAndTranslateShapesDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer[]>
يطبق alignAndTranslate على عدة أشكال، كل منها باتجاهه ومركزه الخاصين.

يجب أن يكون لكل القوائم الطول نفسه، وإلا رُمي خطأ.
Parameters
- inputs: AlignAndTranslateShapesDto<TopoDSShapePointer>
  الأشكال واتجاه ومركز واحد لكل شكل
Returns Promise<TopoDSShapePointer[]>
الأشكال الموضوعة، بالترتيب نفسه
Example
```
const placed = await bitbybit.occt.transforms.alignAndTranslateShapes({
    shapes: [profile, profile2],
    directions: [[1, 0, 0], [0, 0, 1]],
    centers: [[10, 0, 0], [0, 0, 10]],
});
```
- Defined in bitbybit-docs.d.ts:47118

translateShapes

translateShapes(
inputs: TranslateShapesDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer[]>
يطبق translate على عدة أشكال، كل منها بمتجهه الخاص.

يجب أن يكون للقائمتين الطول نفسه، وإلا رُمي خطأ.
Parameters
- inputs: TranslateShapesDto<TopoDSShapePointer>
  الأشكال ومتجه نقل واحد لكل شكل
Returns Promise<TopoDSShapePointer[]>
الأشكال المنقولة، بالترتيب نفسه
Example
```
const moved = await bitbybit.occt.transforms.translateShapes({ shapes: [box, sphere], translations: [[10, 0, 0], [-10, 0, 0]] });
```
- Defined in bitbybit-docs.d.ts:47133

scaleShapes

scaleShapes(
inputs: ScaleShapesDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer[]>
يطبق scale على عدة أشكال، كل منها بانتظام حول نقطة الأصل بمعامله الخاص.

يجب أن يكون للقائمتين الطول نفسه، وإلا رُمي خطأ.
Parameters
- inputs: ScaleShapesDto<TopoDSShapePointer>
  الأشكال ومعامل واحد لكل شكل
Returns Promise<TopoDSShapePointer[]>
الأشكال المحجّمة، بالترتيب نفسه
Example
```
const scaled = await bitbybit.occt.transforms.scaleShapes({ shapes: [box, sphere], factors: [2, 0.5] });
```
- Defined in bitbybit-docs.d.ts:47148

scale3dShapes

scale3dShapes(
inputs: Scale3DShapesDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer[]>
يطبق scale3d على عدة أشكال، كل منها بمعاملاته الثلاثة ومركزه الخاصة.

يجب أن يكون لكل القوائم الطول نفسه، وإلا رُمي خطأ.
Parameters
- inputs: Scale3DShapesDto<TopoDSShapePointer>
  الأشكال ومتجه تحجيم ومركز واحد لكل شكل
Returns Promise<TopoDSShapePointer[]>
الأشكال المحجّمة، بالترتيب نفسه
Example
```
const scaled = await bitbybit.occt.transforms.scale3dShapes({
    shapes: [box, sphere],
    scales: [[1, 2, 1], [2, 2, 2]],
    centers: [[0, 0, 0], [10, 0, 0]],
});
```
- Defined in bitbybit-docs.d.ts:47167

mirrorShapes

mirrorShapes(
inputs: MirrorShapesDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer[]>
يطبق mirror على عدة أشكال، كل منها عبر محوره الخاص.

يجب أن يكون لكل القوائم الطول نفسه، وإلا رُمي خطأ.
Parameters
- inputs: MirrorShapesDto<TopoDSShapePointer>
  الأشكال ونقطة أصل واتجاه محور واحد لكل شكل
Returns Promise<TopoDSShapePointer[]>
الأشكال المعكوسة مرآتيا، بالترتيب نفسه
Example
```
const flipped = await bitbybit.occt.transforms.mirrorShapes({
    shapes: [box, sphere],
    origins: [[0, 0, 0], [0, 0, 0]],
    directions: [[0, 1, 0], [1, 0, 0]],
});
```
- Defined in bitbybit-docs.d.ts:47186

mirrorAlongNormalShapes

mirrorAlongNormalShapes(
inputs: MirrorAlongNormalShapesDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer[]>
يطبق mirrorAlongNormal على عدة أشكال، كل منها عبر مستواه الخاص.

يجب أن يكون لكل القوائم الطول نفسه، وإلا رُمي خطأ.
Parameters
- inputs: MirrorAlongNormalShapesDto<TopoDSShapePointer>
  الأشكال ونقطة أصل وناظم مستوى واحد لكل شكل
Returns Promise<TopoDSShapePointer[]>
الأشكال المعكوسة مرآتيا، بالترتيب نفسه
Example
```
const others = await bitbybit.occt.transforms.mirrorAlongNormalShapes({
    shapes: [leftArm, leftLeg],
    origins: [[0, 0, 0], [0, 0, 0]],
    normals: [[1, 0, 0], [1, 0, 0]],
});
```
- Defined in bitbybit-docs.d.ts:47205

on single shape

transform

transform(
inputs: Bit.Inputs.OCCT.TransformDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يحجّم شكلا ويدوّره وينقله دفعة واحدة: أولا التحجيم حول نقطة الأصل، ثم التدوير حول محور يمر بنقطة الأصل، ثم النقل.

ولأن التحجيم والتدوير يحدثان حول نقطة الأصل، فإن الشكل الذي ليس هناك يدور حولها أيضا؛ انقله أولا، أو استخدم rotateAroundCenter و scale3d لمركز مختار.
Parameters
- inputs: Bit.Inputs.OCCT.TransformDto<TopoDSShapePointer>
  الشكل والنقل ومحور التدوير وزاويته بالدرجات ومعامل التحجيم
Returns Promise<TopoDSShapePointer>
الشكل المحوّل
Example
```
const moved = await bitbybit.occt.transforms.transform({
    shape: box,
    translation: [10, 0, 0],
    rotationAxis: [0, 1, 0],
    rotationAngle: 45,
    scaleFactor: 2,
});
```
- Defined in bitbybit-docs.d.ts:46843

rotate

rotate(
inputs: Bit.Inputs.OCCT.RotateDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يدوّر شكلا حول محور يمر بنقطة الأصل، بزاوية بالدرجات.

يتبع التدوير قاعدة اليد اليمنى: مع الإبهام على طول axis، تبين الأصابع الاتجاه الموجب. الشكل البعيد عن نقطة الأصل يدور حولها؛ rotateAroundCenter يدوّر حول نقطة مختارة بدلا من ذلك.
Parameters
- inputs: Bit.Inputs.OCCT.RotateDto<TopoDSShapePointer>
  الشكل واتجاه المحور والزاوية بالدرجات
Returns Promise<TopoDSShapePointer>
الشكل المدوّر
Example
```
const turned = await bitbybit.occt.transforms.rotate({ shape: box, axis: [0, 1, 0], angle: 90 });
```
- Defined in bitbybit-docs.d.ts:46860

rotateAroundCenter

rotateAroundCenter(
inputs: RotateAroundCenterDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يدوّر شكلا حول محور يمر بنقطة مختارة، بزاوية بالدرجات.

يُنقل الشكل بحيث تقع النقطة عند نقطة الأصل، ويُدوّر هناك بقاعدة اليد اليمنى حول axis، ثم يُعاد إلى مكانه.
Parameters
- inputs: RotateAroundCenterDto<TopoDSShapePointer>
  الشكل والزاوية بالدرجات والنقطة التي يمر بها المحور واتجاه المحور
Returns Promise<TopoDSShapePointer>
الشكل المدوّر
Example
```
const turned = await bitbybit.occt.transforms.rotateAroundCenter({ shape: box, angle: 90, center: [5, 0, 5], axis: [0, 1, 0] });
```
- Defined in bitbybit-docs.d.ts:46876

align

align(inputs: AlignDto<TopoDSShapePointer>): Promise<TopoDSShapePointer>
ينقل شكلا بحيث تحط نقطة واتجاه عليه على نقطة واتجاه آخرين: يُحمل الإطار fromOrigin مع fromDirection إلى toOrigin مع toDirection.

هذه هي الطريقة لإيقاف شكل على سطح أو توجيهه على طول خط: يُنقل الشكل ويُدار معا، ولا يُحجّم أبدا.
Parameters
- inputs: AlignDto<TopoDSShapePointer>
  الشكل والنقطة والاتجاه المأخوذ منهما والنقطة والاتجاه المراد الوصول إليهما
Returns Promise<TopoDSShapePointer>
الشكل المحاذى
Example
```
const standing = await bitbybit.occt.transforms.align({
    shape: cylinder,
    fromOrigin: [0, 0, 0],
    fromDirection: [0, 1, 0],
    toOrigin: [10, 5, 0],
    toDirection: [1, 0, 0],
});
```
- Defined in bitbybit-docs.d.ts:46899

alignNormAndAxis

alignNormAndAxis(
inputs: AlignNormAndAxisDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
ينقل شكلا بحيث يحط إطار كامل عليه على إطار آخر: نقطة وناظمها ومحور واحد في مستوى ذلك الناظم تُحمل إلى أهدافها.

حيث تثبت align اتجاها واحدا وتترك الدوران حوله حرا، تثبت هذه الدالة الدوران أيضا، وهو ما يهم للأشكال غير المستديرة حول محورها.
Parameters
- inputs: AlignNormAndAxisDto<TopoDSShapePointer>
  الشكل والنقطة والناظم والمحور المأخوذ منها والنقطة والناظم والمحور المراد الوصول إليها
Returns Promise<TopoDSShapePointer>
الشكل المحاذى
Example
```
const placed = await bitbybit.occt.transforms.alignNormAndAxis({
    shape: bracket,
    fromOrigin: [0, 0, 0],
    fromNorm: [0, 1, 0],
    fromAx: [1, 0, 0],
    toOrigin: [10, 0, 0],
    toNorm: [0, 0, 1],
    toAx: [0, 1, 0],
});
```
- Defined in bitbybit-docs.d.ts:46924

alignAndTranslate

alignAndTranslate(
inputs: AlignAndTranslateDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يدير شكلا بحيث يشير محوره Y على طول direction، ثم ينقله إلى center.

الأشكال المسطحة والأشكال الأولية في هذه الحزمة تُبنى على الأرضية مع Y للأعلى، فهذا هو الاستدعاء الوحيد الذي يضع أيا منها: يصبح الاتجاه اتجاهها الجديد للأعلى، والمركز حيث تقع.
Parameters
- inputs: AlignAndTranslateDto<TopoDSShapePointer>
  الشكل والاتجاه الذي يجب أن يشير إليه محوره Y والنقطة المراد نقله إليها
Returns Promise<TopoDSShapePointer>
الشكل الموضوع
Example
```
const placed = await bitbybit.occt.transforms.alignAndTranslate({ shape: profile, direction: [1, 0, 0], center: [10, 0, 0] });
```
- Defined in bitbybit-docs.d.ts:46941

translate

translate(
inputs: Bit.Inputs.OCCT.TranslateDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
ينقل شكلا بمتجه، بوحدات النموذج.
Parameters
- inputs: Bit.Inputs.OCCT.TranslateDto<TopoDSShapePointer>
  الشكل والمتجه المراد نقله بمقداره
Returns Promise<TopoDSShapePointer>
الشكل المنقول
Example
```
const moved = await bitbybit.occt.transforms.translate({ shape: box, translation: [10, 0, 0] });
```
- Defined in bitbybit-docs.d.ts:46954

scale

scale(
inputs: Bit.Inputs.OCCT.ScaleDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يحجّم شكلا بانتظام حول نقطة الأصل بمعامل.

الشكل البعيد عن نقطة الأصل يبتعد عنها أو يقترب منها أيضا؛ scaleFromCenter يحجّم حول نقطة مختارة و scale3d يحجّم كل محور بمعامله الخاص.
Parameters
- inputs: Bit.Inputs.OCCT.ScaleDto<TopoDSShapePointer>
  الشكل والمعامل
Returns Promise<TopoDSShapePointer>
الشكل المحجّم
Example
```
const bigger = await bitbybit.occt.transforms.scale({ shape: box, factor: 2 });
```
- Defined in bitbybit-docs.d.ts:46970

scale3d

scale3d(
inputs: Bit.Inputs.OCCT.Scale3DDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يحجّم شكلا بمعامل منفصل على طول X و Y و Z، حول نقطة مركز مختارة.

المعاملات غير المتساوية تمط الشكل، مما يحول الدوائر إلى قطوع ناقصة ويمكن أن يجعل العمليات اللاحقة، مثل التقويسات، أبطأ أو يفشلها؛ أبق المعاملات متساوية عندما لا يحتاج الشكل إلا إلى النمو.
Parameters
- inputs: Bit.Inputs.OCCT.Scale3DDto<TopoDSShapePointer>
  الشكل والمعاملات الثلاثة والنقطة التي يتم التحجيم حولها
Returns Promise<TopoDSShapePointer>
الشكل المحجّم
Example
```
const stretched = await bitbybit.occt.transforms.scale3d({ shape: box, scale: [1, 2, 1], center: [0, 0, 0] });
```
- Defined in bitbybit-docs.d.ts:46987

mirror

mirror(
inputs: Bit.Inputs.OCCT.MirrorDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يعكس شكلا مرآتيا عبر خط: المحور المار بـ origin على طول direction.

تحط كل نقطة على بعد خلف الخط بقدر ما كانت أمامه، وهو في الفضاء ثلاثي الأبعاد مطابق لنصف دورة حول ذلك المحور.
Parameters
- inputs: Bit.Inputs.OCCT.MirrorDto<TopoDSShapePointer>
  الشكل ونقطة على المحور واتجاه المحور
Returns Promise<TopoDSShapePointer>
الشكل المعكوس مرآتيا
Example
```
const flipped = await bitbybit.occt.transforms.mirror({ shape: box, origin: [0, 0, 0], direction: [0, 1, 0] });
```
- Defined in bitbybit-docs.d.ts:47003

mirrorAlongNormal

mirrorAlongNormal(
inputs: MirrorAlongNormalDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يعكس شكلا مرآتيا عبر مستوى معطى بنقطة عليه وناظمه.

هذه هي الصورة المرآتية المعتادة، من النوع الذي يحتاجه الجزء المتناظر؛ تُقلب النتيجة من الداخل إلى الخارج بمعنى أن الشكل الأيسر يصبح أيمن.
Parameters
- inputs: MirrorAlongNormalDto<TopoDSShapePointer>
  الشكل ونقطة على مستوى المرآة وناظم المستوى
Returns Promise<TopoDSShapePointer>
الشكل المعكوس مرآتيا
Example
```
const other = await bitbybit.occt.transforms.mirrorAlongNormal({ shape: leftHalf, origin: [0, 0, 0], normal: [1, 0, 0] });
```
- Defined in bitbybit-docs.d.ts:47019

scaleFromCenter

scaleFromCenter(
inputs: ScaleFromCenterDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يحجّم شكلا بانتظام حول نقطة مختارة بمعامل.

تبقى النقطة في مكانها ويبتعد كل شيء آخر عنها أو يقترب منها.
Parameters
- inputs: ScaleFromCenterDto<TopoDSShapePointer>
  الشكل والمعامل والنقطة التي يتم التحجيم حولها
Returns Promise<TopoDSShapePointer>
الشكل المحجّم
Example
```
const bigger = await bitbybit.occt.transforms.scaleFromCenter({ shape: box, factor: 2, center: [5, 0, 5] });
```
- Defined in bitbybit-docs.d.ts:47220

mirrorAboutPoint

mirrorAboutPoint(
inputs: MirrorAboutPointDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يعكس شكلا مرآتيا عبر نقطة: تحط كل نقطة من الشكل على بعد ما بعد النقطة بقدر ما كانت قبلها، على الجانب المقابل.

تُقلب النتيجة من الداخل إلى الخارج، كما تحول المرآة المستوية اليد اليسرى إلى يمنى.
Parameters
- inputs: MirrorAboutPointDto<TopoDSShapePointer>
  الشكل والنقطة التي يتم العكس عبرها
Returns Promise<TopoDSShapePointer>
الشكل المعكوس مرآتيا
Example
```
const inverted = await bitbybit.occt.transforms.mirrorAboutPoint({ shape: box, point: [0, 0, 0] });
```
- Defined in bitbybit-docs.d.ts:47236

rotateByQuaternion

rotateByQuaternion(
inputs: RotateByQuaternionDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
يدوّر شكلا حول نقطة الأصل برباعي معطى بصيغة [x, y, z, w].

يُطبّع الرباعي أولا، فلا يهم طوله. الرباعيات هي ما تعطيه مكتبات التحريك والفيزياء، فهذا يوفر تحويلها إلى محور وزاوية.
Parameters
- inputs: RotateByQuaternionDto<TopoDSShapePointer>
  الشكل والرباعي
Returns Promise<TopoDSShapePointer>
الشكل المدوّر
Example
```
const turned = await bitbybit.occt.transforms.rotateByQuaternion({ shape: box, quaternion: [0, 0.7071, 0, 0.7071] });
```
- Defined in bitbybit-docs.d.ts:47253

Class OCCTTransforms

Index

Constructors

by matrix

matrix builders

on shapes

on single shape

Constructors

constructor

Returns OCCTTransforms

by matrix

transformByMatrix

Parameters

Returns Promise<TopoDSShapePointer>

Example

transformShapesByMatrix

Parameters

Returns Promise<TopoDSShapePointer[]>

Example

getShapeTransform

Parameters

Returns Promise<ShapeTransformInfo>

Example

matrix builders

identityTransform

Returns Promise<TransformMatrix>

Example

composeTransform

Parameters

Returns Promise<TransformMatrix>

Example

multiplyTransforms

Parameters

Returns Promise<TransformMatrix>

Example

invertTransform

Parameters

Returns Promise<TransformMatrix>

Example

translationToMatrix

Parameters

Returns Promise<TransformMatrix>

Example

rotationAxisAngleToMatrix

Parameters

Returns Promise<TransformMatrix>

Example

scaleUniformToMatrix

Parameters

Returns Promise<TransformMatrix>

Example

mirrorPointToMatrix

Parameters

Returns Promise<TransformMatrix>

Example

mirrorAxisToMatrix

Parameters

Returns Promise<TransformMatrix>

Example

mirrorPlaneToMatrix

Parameters

Returns Promise<TransformMatrix>

Example

quaternionToMatrix

Parameters

Returns Promise<TransformMatrix>

Example

on shapes

transformShapes

Parameters

Returns Promise<TopoDSShapePointer[]>

Example

rotateShapes

Parameters

Returns Promise<TopoDSShapePointer[]>

Example

rotateAroundCenterShapes

Parameters

Returns Promise<TopoDSShapePointer[]>

Example