Class OCCTTransforms

Mover, rodar, escalar e espelhar formas OpenCascade, e construir as matrizes 4x4 que descrevem esses movimentos. Cada método devolve uma nova forma e deixa a entrada como estava. Os ângulos estão em graus, as distâncias em unidades do modelo, e um eixo de rotação passa pela origem a menos que um método receba um centro. As matrizes são 16 números por ordem de colunas (a translação fica nos índices 12 a 14); uma lista de matrizes é aplicada da primeira à última como um único movimento combinado, que é como transformByMatrix e os construtores ...ToMatrix se encaixam.

Constructors

constructor

new OCCTTransforms(): OCCTTransforms
Returns OCCTTransforms

by matrix

transformByMatrix

transformByMatrix(
inputs: TransformByMatrixDto<TopoDSShapePointer>,
): Promise<TopoDSShapePointer>
Aplica uma matriz 4x4, ou uma lista de matrizes aplicadas da primeira à última, a uma forma.

A matriz está ordenada por colunas, por isso a translação fica nos índices 12 a 14. Uma matriz que estica ou cisalha é permitida; construa matrizes com os métodos ...ToMatrix e combine-as com multiplyTransforms. Uma matriz que o kernel não consiga aplicar lança um erro.
Parameters
- inputs: TransformByMatrixDto<TopoDSShapePointer>
  A forma e a matriz ou lista de matrizes
Returns Promise<TopoDSShapePointer>
A forma transformada
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[]>
Aplica a mesma matriz 4x4, ou lista de matrizes aplicadas da primeira à última, a várias formas, tal como transformByMatrix faz para uma.
Parameters
- inputs: TransformShapesByMatrixDto<TopoDSShapePointer>
  As formas e a matriz ou lista de matrizes
Returns Promise<TopoDSShapePointer[]>
As formas transformadas, pela mesma ordem
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>
Lê a colocação que uma forma transporta, a transformação guardada nela em vez de incorporada na sua geometria, como uma matriz mais a sua translação, quaternião de rotação e escala uniforme.

Uma forma colocada com align ou através de uma montagem transporta tal colocação; a maioria dos outros métodos aqui incorpora o movimento na geometria, e uma forma dessas reporta a identidade.
Parameters
- inputs: ShapeTransformQueryDto<TopoDSShapePointer>
  A forma a ler
Returns Promise<ShapeTransformInfo>
A matriz, a translação, o quaternião como [x, y, z, w] e a escala
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>
Constrói a matriz identidade, a transformação que não muda nada, como ponto de partida para compor outras.

Returns Promise<TransformMatrix>
A matriz identidade, por colunas
Example
```
const identity = await bitbybit.occt.transforms.identityTransform();
```
- Defined in bitbybit-docs.d.ts:47317

composeTransform

composeTransform(inputs: ComposeTransformDto): Promise<TransformMatrix>
Constrói uma só matriz a partir de uma translação, três ângulos de rotação em graus em torno de X, Y e Z, e uma escala uniforme.

A escala é aplicada primeiro, depois as rotações (Z primeiro, depois Y, depois X), depois a translação, que é a ordem que as colocações de montagem usam. Qualquer parte omitida é tomada como nenhuma alteração.
Parameters
- inputs: ComposeTransformDto
  A translação, os três ângulos de rotação em graus e o fator de escala
Returns Promise<TransformMatrix>
A matriz combinada, por colunas
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>
Combina uma lista de matrizes numa só, aplicadas da primeira à última, de modo que uma cadeia de movimentos se torna uma única matriz.

Uma matriz única é devolvida sem alteração e uma lista vazia dá a identidade.
Parameters
- inputs: MultiplyTransformsDto
  A matriz ou lista de matrizes
Returns Promise<TransformMatrix>
A matriz combinada, por colunas
Example
```
const combined = await bitbybit.occt.transforms.multiplyTransforms({ transformation: [turn, move] });
```
- Defined in bitbybit-docs.d.ts:47351

invertTransform

invertTransform(inputs: InvertTransformDto): Promise<TransformMatrix>
Inverte uma matriz, dando a transformação que a desfaz: aplicar uma matriz e depois a sua inversa põe uma forma de volta onde estava.
Parameters
- inputs: InvertTransformDto
  A matriz a inverter
Returns Promise<TransformMatrix>
A matriz inversa, por colunas
Example
```
const back = await bitbybit.occt.transforms.invertTransform({ transformation: placement });
```
- Defined in bitbybit-docs.d.ts:47365

translationToMatrix

translationToMatrix(inputs: TranslationToMatrixDto): Promise<TransformMatrix>
Constrói a matriz de um movimento por um vetor, em unidades do modelo.
Parameters
- inputs: TranslationToMatrixDto
  O vetor de translação
Returns Promise<TransformMatrix>
A matriz de translação, por colunas
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>
Constrói a matriz de uma rotação por um ângulo em graus em torno de um eixo, pela origem ou por um ponto central opcional.

A rotação segue a regra da mão direita em torno de axis.
Parameters
- inputs: RotationAxisAngleToMatrixDto
  A direção do eixo, o ângulo em graus e o ponto opcional por onde o eixo passa
Returns Promise<TransformMatrix>
A matriz de rotação, por colunas
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>
Constrói a matriz de uma escala uniforme por um fator em torno da origem ou de um ponto central opcional.
Parameters
- inputs: ScaleUniformToMatrixDto
  O fator e o ponto opcional em torno do qual escalar
Returns Promise<TransformMatrix>
A matriz de escala, por colunas
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>
Constrói a matriz de um espelhamento através de um ponto, a transformação que mirrorAboutPoint aplica.
Parameters
- inputs: MirrorPointToMatrixDto
  O ponto através do qual espelhar
Returns Promise<TransformMatrix>
A matriz de espelho, por colunas
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>
Constrói a matriz de um espelhamento em relação a uma linha, a transformação que mirror aplica: o eixo que passa por origin ao longo de direction.
Parameters
- inputs: MirrorAxisToMatrixDto
  Um ponto no eixo e a direção do eixo
Returns Promise<TransformMatrix>
A matriz de espelho, por colunas
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>
Constrói a matriz de um espelhamento em relação a um plano, a transformação que mirrorAlongNormal aplica: o plano que passa por origin com a normal dada.
Parameters
- inputs: MirrorPlaneToMatrixDto
  Um ponto no plano e a normal do plano
Returns Promise<TransformMatrix>
A matriz de espelho, por colunas
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>
Constrói a matriz de rotação de um quaternião dado como [x, y, z, w].

O quaternião é primeiro normalizado, por isso o seu comprimento não importa.
Parameters
- inputs: QuaternionToMatrixDto
  O quaternião
Returns Promise<TransformMatrix>
A matriz de rotação, por colunas
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[]>
Aplica transform a várias formas, cada uma com a sua própria translação, eixo de rotação, ângulo e fator de escala.

Todas as listas têm de ter o mesmo comprimento, ou é lançado um erro.
Parameters
- inputs: TransformShapesDto<TopoDSShapePointer>
  As formas e uma translação, um eixo de rotação, um ângulo em graus e um fator de escala por forma
Returns Promise<TopoDSShapePointer[]>
As formas transformadas, pela mesma ordem
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[]>
Aplica rotate a várias formas, cada uma em torno do seu próprio eixo pela origem e pelo seu próprio ângulo em graus.

Todas as listas têm de ter o mesmo comprimento, ou é lançado um erro.
Parameters
- inputs: RotateShapesDto<TopoDSShapePointer>
  As formas e um eixo e um ângulo por forma
Returns Promise<TopoDSShapePointer[]>
As formas rodadas, pela mesma ordem
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[]>
Aplica rotateAroundCenter a várias formas, cada uma com o seu próprio ângulo em graus, centro e eixo.

Todas as listas têm de ter o mesmo comprimento, ou é lançado um erro.
Parameters
- inputs: RotateAroundCenterShapesDto<TopoDSShapePointer>
  As formas e um ângulo, um centro e um eixo por forma
Returns Promise<TopoDSShapePointer[]>
As formas rodadas, pela mesma ordem
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[]>
Aplica align a várias formas, cada uma com os seus próprios referenciais de origem e de destino.

Todas as listas têm de ter o mesmo comprimento, ou é lançado um erro.
Parameters
- inputs: AlignShapesDto<TopoDSShapePointer>
  As formas e uma origem de partida, uma direção de partida, uma origem de chegada e uma direção de chegada por forma
Returns Promise<TopoDSShapePointer[]>
As formas alinhadas, pela mesma ordem
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[]>
Aplica alignAndTranslate a várias formas, cada uma com a sua própria direção e centro.

Todas as listas têm de ter o mesmo comprimento, ou é lançado um erro.
Parameters
- inputs: AlignAndTranslateShapesDto<TopoDSShapePointer>
  As formas e uma direção e um centro por forma
Returns Promise<TopoDSShapePointer[]>
As formas colocadas, pela mesma ordem
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[]>
Aplica translate a várias formas, cada uma pelo seu próprio vetor.

As duas listas têm de ter o mesmo comprimento, ou é lançado um erro.
Parameters
- inputs: TranslateShapesDto<TopoDSShapePointer>
  As formas e um vetor de translação por forma
Returns Promise<TopoDSShapePointer[]>
As formas deslocadas, pela mesma ordem
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[]>
Aplica scale a várias formas, cada uma uniformemente em torno da origem pelo seu próprio fator.

As duas listas têm de ter o mesmo comprimento, ou é lançado um erro.
Parameters
- inputs: ScaleShapesDto<TopoDSShapePointer>
  As formas e um fator por forma
Returns Promise<TopoDSShapePointer[]>
As formas escaladas, pela mesma ordem
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[]>
Aplica scale3d a várias formas, cada uma com os seus próprios três fatores e centro.

Todas as listas têm de ter o mesmo comprimento, ou é lançado um erro.
Parameters
- inputs: Scale3DShapesDto<TopoDSShapePointer>
  As formas e um vetor de escala e um centro por forma
Returns Promise<TopoDSShapePointer[]>
As formas escaladas, pela mesma ordem
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[]>
Aplica mirror a várias formas, cada uma em relação ao seu próprio eixo.

Todas as listas têm de ter o mesmo comprimento, ou é lançado um erro.
Parameters
- inputs: MirrorShapesDto<TopoDSShapePointer>
  As formas e uma origem e direção de eixo por forma
Returns Promise<TopoDSShapePointer[]>
As formas espelhadas, pela mesma ordem
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[]>
Aplica mirrorAlongNormal a várias formas, cada uma em relação ao seu próprio plano.

Todas as listas têm de ter o mesmo comprimento, ou é lançado um erro.
Parameters
- inputs: MirrorAlongNormalShapesDto<TopoDSShapePointer>
  As formas e uma origem e normal de plano por forma
Returns Promise<TopoDSShapePointer[]>
As formas espelhadas, pela mesma ordem
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>
Escala, roda e move uma forma de uma só vez: primeiro a escala em torno da origem, depois a rotação em torno de um eixo que passa pela origem, depois a translação.

Como a escala e a rotação acontecem em torno da origem, uma forma que não esteja lá também gira à volta dela; mova-a primeiro, ou use rotateAroundCenter e scale3d para um centro escolhido.
Parameters
- inputs: Bit.Inputs.OCCT.TransformDto<TopoDSShapePointer>
  A forma, a translação, o eixo e o ângulo de rotação em graus, e o fator de escala
Returns Promise<TopoDSShapePointer>
A forma transformada
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>
Roda uma forma em torno de um eixo que passa pela origem, por um ângulo em graus.

A rotação segue a regra da mão direita: com o polegar ao longo de axis, os dedos mostram a direção positiva. Uma forma afastada da origem gira à volta dela; rotateAroundCenter roda em vez disso em torno de um ponto escolhido.
Parameters
- inputs: Bit.Inputs.OCCT.RotateDto<TopoDSShapePointer>
  A forma, a direção do eixo e o ângulo em graus
Returns Promise<TopoDSShapePointer>
A forma rodada
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>
Roda uma forma em torno de um eixo que passa por um ponto escolhido, por um ângulo em graus.

A forma é movida para que o ponto fique na origem, rodada aí com a regra da mão direita em torno de axis, e movida de volta.
Parameters
- inputs: RotateAroundCenterDto<TopoDSShapePointer>
  A forma, o ângulo em graus, o ponto por onde o eixo passa e a direção do eixo
Returns Promise<TopoDSShapePointer>
A forma rodada
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>
Move uma forma de modo que um ponto e uma direção nela aterrem noutro ponto e direção: o referencial fromOrigin com fromDirection é levado para toOrigin com toDirection.

Esta é a maneira de assentar uma forma numa superfície ou apontá-la ao longo de uma linha: a forma é movida e rodada, nunca escalada.
Parameters
- inputs: AlignDto<TopoDSShapePointer>
  A forma, o ponto e a direção de partida, e o ponto e a direção de chegada
Returns Promise<TopoDSShapePointer>
A forma alinhada
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>
Move uma forma de modo que um referencial completo nela aterre noutro referencial: um ponto, a sua normal e um eixo no plano dessa normal são levados para os seus destinos.

Onde align fixa uma direção e deixa a rotação em torno dela livre, isto fixa também a rotação, o que importa para formas que não são redondas em torno do seu eixo.
Parameters
- inputs: AlignNormAndAxisDto<TopoDSShapePointer>
  A forma, o ponto, a normal e o eixo de partida, e o ponto, a normal e o eixo de chegada
Returns Promise<TopoDSShapePointer>
A forma alinhada
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>
Roda uma forma de modo que o seu eixo Y aponte ao longo de direction, e depois move-a para center.

As formas planas e as primitivas deste pacote são construídas no chão com Y para cima, por isso esta é a única chamada que coloca qualquer uma delas: a direção torna-se o seu novo para cima, e o centro onde ficam.
Parameters
- inputs: AlignAndTranslateDto<TopoDSShapePointer>
  A forma, a direção para a qual o seu eixo Y deve apontar e o ponto para onde a deslocar
Returns Promise<TopoDSShapePointer>
A forma colocada
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>
Move uma forma por um vetor, em unidades do modelo.
Parameters
- inputs: Bit.Inputs.OCCT.TranslateDto<TopoDSShapePointer>
  A forma e o vetor pelo qual a deslocar
Returns Promise<TopoDSShapePointer>
A forma deslocada
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>
Escala uma forma uniformemente em torno da origem por um fator.

Uma forma afastada da origem também se afasta ou se aproxima dela; scaleFromCenter escala em torno de um ponto escolhido e scale3d escala cada eixo pelo seu próprio fator.
Parameters
- inputs: Bit.Inputs.OCCT.ScaleDto<TopoDSShapePointer>
  A forma e o fator
Returns Promise<TopoDSShapePointer>
A forma escalada
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>
Escala uma forma por um fator separado ao longo de X, Y e Z, em torno de um ponto central escolhido.

Fatores desiguais esticam a forma, o que transforma círculos em elipses e pode tornar operações posteriores, como arredondamentos, mais lentas ou fazê-las falhar; mantenha os fatores iguais quando a forma só precisa de crescer.
Parameters
- inputs: Bit.Inputs.OCCT.Scale3DDto<TopoDSShapePointer>
  A forma, os três fatores e o ponto em torno do qual escalar
Returns Promise<TopoDSShapePointer>
A forma escalada
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>
Espelha uma forma em relação a uma linha: o eixo que passa por origin ao longo de direction.

Cada ponto aterra tão atrás da linha quanto estava à frente, o que em 3D é o mesmo que uma meia volta em torno desse eixo.
Parameters
- inputs: Bit.Inputs.OCCT.MirrorDto<TopoDSShapePointer>
  A forma, um ponto no eixo e a direção do eixo
Returns Promise<TopoDSShapePointer>
A forma espelhada
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>
Espelha uma forma em relação a um plano dado por um ponto nele e pela sua normal.

Esta é a imagem espelhada habitual, a que uma peça simétrica precisa; o resultado fica virado do avesso no sentido em que uma forma de mão esquerda se torna uma de mão direita.
Parameters
- inputs: MirrorAlongNormalDto<TopoDSShapePointer>
  A forma, um ponto no plano de espelho e a normal do plano
Returns Promise<TopoDSShapePointer>
A forma espelhada
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>
Escala uma forma uniformemente em torno de um ponto escolhido por um fator.

O ponto fica onde está e tudo o resto se afasta dele ou se aproxima dele.
Parameters
- inputs: ScaleFromCenterDto<TopoDSShapePointer>
  A forma, o fator e o ponto em torno do qual escalar
Returns Promise<TopoDSShapePointer>
A forma escalada
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>
Espelha uma forma através de um ponto: cada ponto da forma aterra tão para lá do ponto quanto estava antes dele, do lado oposto.

O resultado fica virado do avesso, da maneira como um espelho plano transforma uma mão esquerda numa mão direita.
Parameters
- inputs: MirrorAboutPointDto<TopoDSShapePointer>
  A forma e o ponto através do qual espelhar
Returns Promise<TopoDSShapePointer>
A forma espelhada
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>
Roda uma forma em torno da origem por um quaternião dado como [x, y, z, w].

O quaternião é primeiro normalizado, por isso o seu comprimento não importa. Os quaterniões são o que as bibliotecas de animação e de física entregam, por isso isto poupa convertê-los num eixo e num ângulo.
Parameters
- inputs: RotateByQuaternionDto<TopoDSShapePointer>
  A forma e o quaternião
Returns Promise<TopoDSShapePointer>
A forma rodada
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