Class OCCTTransforms

Déplacer, tourner, mettre à l'échelle et mettre en miroir des formes OpenCascade, et construire les matrices 4x4 qui décrivent de tels mouvements. Chaque méthode renvoie une nouvelle forme et laisse l'entrée telle quelle. Les angles sont en degrés, les distances en unités du modèle, et un axe de rotation passe par l'origine sauf si une méthode prend un centre. Les matrices sont 16 nombres en ordre colonne (la translation se trouve aux indices 12 à 14) ; une liste de matrices est appliquée de la première à la dernière comme un seul mouvement combiné, ce qui est la façon dont transformByMatrix et les constructeurs ...ToMatrix s'assemblent.

Constructors

constructor

new OCCTTransforms(): OCCTTransforms
Returns OCCTTransforms

by matrix

transformByMatrix

transformByMatrix(
inputs: TransformByMatrixDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
Applique une matrice 4x4, ou une liste de matrices appliquées de la première à la dernière, à une forme.

La matrice est en ordre colonne, la translation se trouve donc aux indices 12 à 14. Une matrice qui étire ou cisaille est autorisée ; construisez les matrices avec les méthodes ...ToMatrix et combinez-les avec multiplyTransforms. Une matrice que le noyau ne peut pas appliquer lève une erreur.
Parameters
- inputs: TransformByMatrixDto<TopoDSShapePointer>
  La forme et la matrice ou la liste de matrices
Returns Promise<TopoDSShapePointer>
La forme transformée
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[]>
Applique la même matrice 4x4, ou liste de matrices appliquées de la première à la dernière, à plusieurs formes, comme transformByMatrix le fait pour une seule.
Parameters
- inputs: TransformShapesByMatrixDto<TopoDSShapePointer>
  Les formes et la matrice ou la liste de matrices
Returns Promise<TopoDSShapePointer[]>
Les formes transformées, dans le même ordre
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>
Lit le placement qu'une forme porte, la transformation stockée sur elle plutôt qu'intégrée dans sa géométrie, sous forme de matrice plus sa translation, son quaternion de rotation et son échelle uniforme.

Une forme placée avec align ou via un assemblage porte un tel placement ; la plupart des autres méthodes d'ici intègrent le déplacement dans la géométrie, et une telle forme rapporte l'identité.
Parameters
- inputs: ShapeTransformQueryDto<TopoDSShapePointer>
  La forme à lire
Returns Promise<ShapeTransformInfo>
La matrice, la translation, le quaternion sous forme [x, y, z, w] et l'échelle
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>
Construit la matrice identité, la transformation qui ne change rien, comme point de départ pour en composer d'autres.

Returns Promise<TransformMatrix>
La matrice identité, en ordre colonne
Example
```
const identity = await bitbybit.occt.transforms.identityTransform();
```
- Defined in bitbybit-docs.d.ts:47317

composeTransform

composeTransform(inputs: ComposeTransformDto): Promise<TransformMatrix>
Construit une seule matrice à partir d'une translation, de trois angles de rotation en degrés autour de X, Y et Z, et d'une échelle uniforme.

L'échelle est appliquée en premier, puis les rotations (Z d'abord, puis Y, puis X), puis la translation, ce qui est l'ordre utilisé par les placements d'assemblage. Toute partie omise est prise comme sans changement.
Parameters
- inputs: ComposeTransformDto
  La translation, les trois angles de rotation en degrés et le facteur d'échelle
Returns Promise<TransformMatrix>
La matrice combinée, en ordre colonne
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>
Replie une liste de matrices en une seule, appliquées de la première à la dernière, de sorte qu'une chaîne de déplacements devient une seule matrice.

Une matrice seule est renvoyée inchangée et une liste vide donne l'identité.
Parameters
- inputs: MultiplyTransformsDto
  La matrice ou la liste de matrices
Returns Promise<TransformMatrix>
La matrice combinée, en ordre colonne
Example
```
const combined = await bitbybit.occt.transforms.multiplyTransforms({ transformation: [turn, move] });
```
- Defined in bitbybit-docs.d.ts:47351

invertTransform

invertTransform(inputs: InvertTransformDto): Promise<TransformMatrix>
Inverse une matrice, donnant la transformation qui la défait : appliquer une matrice puis son inverse remet une forme là où elle était.
Parameters
- inputs: InvertTransformDto
  La matrice à inverser
Returns Promise<TransformMatrix>
La matrice inverse, en ordre colonne
Example
```
const back = await bitbybit.occt.transforms.invertTransform({ transformation: placement });
```
- Defined in bitbybit-docs.d.ts:47365

translationToMatrix

translationToMatrix(inputs: TranslationToMatrixDto): Promise<TransformMatrix>
Construit la matrice d'un déplacement d'un vecteur, en unités du modèle.
Parameters
- inputs: TranslationToMatrixDto
  Le vecteur de translation
Returns Promise<TransformMatrix>
La matrice de translation, en ordre colonne
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>
Construit la matrice d'une rotation d'un angle en degrés autour d'un axe, passant par l'origine ou par un point central facultatif.

La rotation suit la règle de la main droite autour de axis.
Parameters
- inputs: RotationAxisAngleToMatrixDto
  La direction de l'axe, l'angle en degrés et le point facultatif par lequel passe l'axe
Returns Promise<TransformMatrix>
La matrice de rotation, en ordre colonne
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>
Construit la matrice d'une mise à l'échelle uniforme d'un facteur autour de l'origine ou d'un point central facultatif.
Parameters
- inputs: ScaleUniformToMatrixDto
  Le facteur et le point facultatif autour duquel mettre à l'échelle
Returns Promise<TransformMatrix>
La matrice d'échelle, en ordre colonne
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>
Construit la matrice d'un miroir à travers un point, la transformation que mirrorAboutPoint applique.
Parameters
- inputs: MirrorPointToMatrixDto
  Le point par rapport auquel faire le miroir
Returns Promise<TransformMatrix>
La matrice de miroir, en ordre colonne
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>
Construit la matrice d'un miroir par rapport à une ligne, la transformation que mirror applique : l'axe passant par origin le long de direction.
Parameters
- inputs: MirrorAxisToMatrixDto
  Un point sur l'axe et la direction de l'axe
Returns Promise<TransformMatrix>
La matrice de miroir, en ordre colonne
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>
Construit la matrice d'un miroir par rapport à un plan, la transformation que mirrorAlongNormal applique : le plan passant par origin avec la normale donnée.
Parameters
- inputs: MirrorPlaneToMatrixDto
  Un point sur le plan et la normale du plan
Returns Promise<TransformMatrix>
La matrice de miroir, en ordre colonne
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>
Construit la matrice de rotation d'un quaternion donné sous forme [x, y, z, w].

Le quaternion est d'abord normalisé, sa longueur n'a donc pas d'importance.
Parameters
- inputs: QuaternionToMatrixDto
  Le quaternion
Returns Promise<TransformMatrix>
La matrice de rotation, en ordre colonne
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[]>
Applique transform à plusieurs formes, chacune avec sa propre translation, son axe de rotation, son angle et son facteur d'échelle.

Toutes les listes doivent avoir la même longueur, sinon une erreur est levée.
Parameters
- inputs: TransformShapesDto<TopoDSShapePointer>
  Les formes et une translation, un axe de rotation, un angle en degrés et un facteur d'échelle par forme
Returns Promise<TopoDSShapePointer[]>
Les formes transformées, dans le même ordre
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[]>
Applique rotate à plusieurs formes, chacune autour de son propre axe passant par l'origine et de son propre angle en degrés.

Toutes les listes doivent avoir la même longueur, sinon une erreur est levée.
Parameters
- inputs: RotateShapesDto<TopoDSShapePointer>
  Les formes et un axe et un angle par forme
Returns Promise<TopoDSShapePointer[]>
Les formes tournées, dans le même ordre
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[]>
Applique rotateAroundCenter à plusieurs formes, chacune avec son propre angle en degrés, son centre et son axe.

Toutes les listes doivent avoir la même longueur, sinon une erreur est levée.
Parameters
- inputs: RotateAroundCenterShapesDto<TopoDSShapePointer>
  Les formes et un angle, un centre et un axe par forme
Returns Promise<TopoDSShapePointer[]>
Les formes tournées, dans le même ordre
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[]>
Applique align à plusieurs formes, chacune avec ses propres repères de départ et d'arrivée.

Toutes les listes doivent avoir la même longueur, sinon une erreur est levée.
Parameters
- inputs: AlignShapesDto<TopoDSShapePointer>
  Les formes et une origine de départ, une direction de départ, une origine d'arrivée et une direction d'arrivée par forme
Returns Promise<TopoDSShapePointer[]>
Les formes alignées, dans le même ordre
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[]>
Applique alignAndTranslate à plusieurs formes, chacune avec sa propre direction et son propre centre.

Toutes les listes doivent avoir la même longueur, sinon une erreur est levée.
Parameters
- inputs: AlignAndTranslateShapesDto<TopoDSShapePointer>
  Les formes et une direction et un centre par forme
Returns Promise<TopoDSShapePointer[]>
Les formes placées, dans le même ordre
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[]>
Applique translate à plusieurs formes, chacune de son propre vecteur.

Les deux listes doivent avoir la même longueur, sinon une erreur est levée.
Parameters
- inputs: TranslateShapesDto<TopoDSShapePointer>
  Les formes et un vecteur de translation par forme
Returns Promise<TopoDSShapePointer[]>
Les formes déplacées, dans le même ordre
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[]>
Applique scale à plusieurs formes, chacune uniformément autour de l'origine de son propre facteur.

Les deux listes doivent avoir la même longueur, sinon une erreur est levée.
Parameters
- inputs: ScaleShapesDto<TopoDSShapePointer>
  Les formes et un facteur par forme
Returns Promise<TopoDSShapePointer[]>
Les formes mises à l'échelle, dans le même ordre
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[]>
Applique scale3d à plusieurs formes, chacune avec ses trois propres facteurs et son centre.

Toutes les listes doivent avoir la même longueur, sinon une erreur est levée.
Parameters
- inputs: Scale3DShapesDto<TopoDSShapePointer>
  Les formes et un vecteur d'échelle et un centre par forme
Returns Promise<TopoDSShapePointer[]>
Les formes mises à l'échelle, dans le même ordre
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[]>
Applique mirror à plusieurs formes, chacune par rapport à son propre axe.

Toutes les listes doivent avoir la même longueur, sinon une erreur est levée.
Parameters
- inputs: MirrorShapesDto<TopoDSShapePointer>
  Les formes et une origine et une direction d'axe par forme
Returns Promise<TopoDSShapePointer[]>
Les formes en miroir, dans le même ordre
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[]>
Applique mirrorAlongNormal à plusieurs formes, chacune par rapport à son propre plan.

Toutes les listes doivent avoir la même longueur, sinon une erreur est levée.
Parameters
- inputs: MirrorAlongNormalShapesDto<TopoDSShapePointer>
  Les formes et une origine et une normale de plan par forme
Returns Promise<TopoDSShapePointer[]>
Les formes en miroir, dans le même ordre
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>
Met à l'échelle, tourne et déplace une forme en une seule fois : d'abord l'échelle autour de l'origine, puis la rotation autour d'un axe passant par l'origine, puis la translation.

Comme l'échelle et la rotation se font autour de l'origine, une forme qui ne s'y trouve pas bascule aussi autour d'elle ; déplacez-la d'abord, ou utilisez rotateAroundCenter et scale3d pour un centre choisi.
Parameters
- inputs: Bit.Inputs.OCCT.TransformDto<TopoDSShapePointer>
  La forme, la translation, l'axe et l'angle de rotation en degrés, et le facteur d'échelle
Returns Promise<TopoDSShapePointer>
La forme transformée
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>
Tourne une forme autour d'un axe passant par l'origine, d'un angle en degrés.

La rotation suit la règle de la main droite : le pouce le long de axis, les doigts indiquent le sens positif. Une forme éloignée de l'origine bascule autour d'elle ; rotateAroundCenter tourne plutôt autour d'un point choisi.
Parameters
- inputs: Bit.Inputs.OCCT.RotateDto<TopoDSShapePointer>
  La forme, la direction de l'axe et l'angle en degrés
Returns Promise<TopoDSShapePointer>
La forme tournée
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>
Tourne une forme autour d'un axe passant par un point choisi, d'un angle en degrés.

La forme est déplacée pour que le point se trouve à l'origine, tournée là selon la règle de la main droite autour de axis, et ramenée.
Parameters
- inputs: RotateAroundCenterDto<TopoDSShapePointer>
  La forme, l'angle en degrés, le point par lequel passe l'axe et la direction de l'axe
Returns Promise<TopoDSShapePointer>
La forme tournée
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>
Déplace une forme pour qu'un point et une direction sur elle atterrissent sur un autre point et une autre direction : le repère fromOrigin avec fromDirection est porté sur toOrigin avec toDirection.

C'est la façon de poser une forme sur une surface ou de l'orienter le long d'une ligne : la forme est à la fois déplacée et tournée, jamais mise à l'échelle.
Parameters
- inputs: AlignDto<TopoDSShapePointer>
  La forme, le point et la direction de départ, et le point et la direction d'arrivée
Returns Promise<TopoDSShapePointer>
La forme alignée
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>
Déplace une forme pour qu'un repère complet sur elle atterrisse sur un autre repère : un point, sa normale et un axe dans le plan de cette normale sont portés sur leurs cibles.

Là où align fixe une direction et laisse libre la rotation autour d'elle, ceci fixe aussi la rotation, ce qui compte pour les formes qui ne sont pas rondes autour de leur axe.
Parameters
- inputs: AlignNormAndAxisDto<TopoDSShapePointer>
  La forme, le point, la normale et l'axe de départ, et le point, la normale et l'axe d'arrivée
Returns Promise<TopoDSShapePointer>
La forme alignée
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>
Tourne une forme pour que son axe Y pointe le long de direction, puis la déplace à center.

Les formes plates et les primitives de ce paquet sont construites sur le sol avec Y vers le haut, c'est donc le seul appel qui place n'importe laquelle d'entre elles : la direction devient leur nouveau haut, et le centre l'endroit où elles se posent.
Parameters
- inputs: AlignAndTranslateDto<TopoDSShapePointer>
  La forme, la direction vers laquelle son axe Y doit pointer et le point où la déplacer
Returns Promise<TopoDSShapePointer>
La forme placée
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>
Déplace une forme d'un vecteur, en unités du modèle.
Parameters
- inputs: Bit.Inputs.OCCT.TranslateDto<TopoDSShapePointer>
  La forme et le vecteur de déplacement
Returns Promise<TopoDSShapePointer>
La forme déplacée
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>
Met une forme à l'échelle uniformément autour de l'origine d'un facteur.

Une forme éloignée de l'origine s'en éloigne ou s'en rapproche aussi ; scaleFromCenter met à l'échelle autour d'un point choisi et scale3d met chaque axe à l'échelle de son propre facteur.
Parameters
- inputs: Bit.Inputs.OCCT.ScaleDto<TopoDSShapePointer>
  La forme et le facteur
Returns Promise<TopoDSShapePointer>
La forme mise à l'échelle
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>
Met une forme à l'échelle d'un facteur distinct le long de X, Y et Z, autour d'un point central choisi.

Des facteurs inégaux étirent la forme, ce qui transforme les cercles en ellipses et peut rendre les opérations ultérieures, comme les congés, plus lentes ou les faire échouer ; gardez les facteurs égaux quand la forme n'a besoin que de grandir.
Parameters
- inputs: Bit.Inputs.OCCT.Scale3DDto<TopoDSShapePointer>
  La forme, les trois facteurs et le point autour duquel mettre à l'échelle
Returns Promise<TopoDSShapePointer>
La forme mise à l'échelle
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>
Met une forme en miroir par rapport à une ligne : l'axe passant par origin le long de direction.

Chaque point atterrit aussi loin derrière la ligne qu'il était devant, ce qui en 3D revient à un demi-tour autour de cet axe.
Parameters
- inputs: Bit.Inputs.OCCT.MirrorDto<TopoDSShapePointer>
  La forme, un point sur l'axe et la direction de l'axe
Returns Promise<TopoDSShapePointer>
La forme en miroir
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>
Met une forme en miroir par rapport à un plan donné par un point sur lui et sa normale.

C'est l'image miroir habituelle, celle dont une pièce symétrique a besoin ; le résultat est retourné au sens où une forme main gauche devient une forme main droite.
Parameters
- inputs: MirrorAlongNormalDto<TopoDSShapePointer>
  La forme, un point sur le plan de symétrie et la normale du plan
Returns Promise<TopoDSShapePointer>
La forme en miroir
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>
Met une forme à l'échelle uniformément autour d'un point choisi d'un facteur.

Le point reste où il est et tout le reste s'en éloigne ou s'en rapproche.
Parameters
- inputs: ScaleFromCenterDto<TopoDSShapePointer>
  La forme, le facteur et le point autour duquel mettre à l'échelle
Returns Promise<TopoDSShapePointer>
La forme mise à l'échelle
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>
Met une forme en miroir à travers un point : chaque point de la forme atterrit aussi loin au-delà du point qu'il était avant lui, du côté opposé.

Le résultat est retourné, comme un miroir plan transforme une main gauche en main droite.
Parameters
- inputs: MirrorAboutPointDto<TopoDSShapePointer>
  La forme et le point par rapport auquel faire le miroir
Returns Promise<TopoDSShapePointer>
La forme en miroir
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>
Tourne une forme autour de l'origine selon un quaternion donné sous forme [x, y, z, w].

Le quaternion est d'abord normalisé, sa longueur n'a donc pas d'importance. Les quaternions sont ce que les bibliothèques d'animation et de physique fournissent, cela évite donc de les convertir en axe et angle.
Parameters
- inputs: RotateByQuaternionDto<TopoDSShapePointer>
  La forme et le quaternion
Returns Promise<TopoDSShapePointer>
La forme tournée
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