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.

Каждая точка попадает настолько же за прямую, насколько была перед ней, что в 3D то же самое, что полуоборот вокруг этой оси.
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