Bitbybit Docs
    Preparing search index...

    Class OCCTIO

    Чтение и запись CAD-файлов с помощью OCCT: все, что io предлагает в ядре, плюс загрузчики, которые принимают файл STEP или IGES как объект File или как его текст и возвращают форму. Файлы по соглашению ориентированы осью Z вверх, поэтому adjustZtoY поворачивает загруженную форму к ориентации этой библиотеки с осью Y вверх, если не установлен в false.

    Hierarchy (View Summary)

    Index

    Constructors

    Properties

    occWorkerManager: OCCTWorkerManager

    assembly

    • Преобразует файл STEP в двоичный glTF (GLB), сохраняя дерево сборки как узлы glTF вместе с именами деталей, цветами, материалами и размещениями.

      stepData - файл как текст, ArrayBuffer или Uint8Array. Настройки меша говорят, насколько мелко триангулируются изогнутые поверхности: meshPrecision - отклонение, meshAngle - угловое отклонение. Z-вверх становится Y-вверх glTF. Сбой выбрасывает исключение.

      Parameters

      • inputs: ConvertStepToGltfDto

        Содержимое файла STEP и настройки построения меша

      Returns Promise<Uint8Array<ArrayBufferLike>>

      Файл GLB как байты

      const glb = await bitbybit.occt.io.convertStepToGltf({ stepData: stepText, meshPrecision: 0.005, meshAngle: 0.5, meshRelative: true, internalVerticesMode: false, controlSurfaceDeflection: false });
      
    • Преобразует файл STEP в двоичный glTF (GLB), как convertStepToGltf, со всеми доступными параметрами.

      Флаги чтения выбирают, что брать из файла (цвета, имена, материалы, слои, свойства), настройки меша - насколько мелко триангулировать, настройки экспорта - как записывается glTF (объединенные грани, 16-битные индексы, именование, масштаб). Отключите то, что вам не нужно.

      Parameters

      • inputs: ConvertStepToGltfAdvancedDto

        Содержимое файла STEP и настройки чтения, построения меша и экспорта

      Returns Promise<Uint8Array<ArrayBufferLike>>

      Файл GLB как байты

      const options = new Bit.Inputs.OCCT.ConvertStepToGltfAdvancedDto();
      options.stepData = stepText;
      options.readColors = true;
      options.readNames = true;
      options.meshDeflection = 0.005;
      options.mergeFaces = true;
      options.adjustZtoY = true;
      const glb = await bitbybit.occt.io.convertStepToGltfAdvanced(options);
    • Преобразует файл STEP в двоичный glTF (GLB), как convertStepToGltf, и сжимает геометрию с помощью Draco, что делает файл намного меньше ценой необходимости загрузчика с поддержкой Draco.

      Настройки Draco задают уровень сжатия и сколько бит сохраняют позиции, нормали, текстурные координаты и цвета; меньше бит означает меньший файл и меньшую точность.

      Parameters

      • inputs: ConvertStepToGltfWithDracoDto

        Содержимое файла STEP, настройки построения меша и настройки Draco

      Returns Promise<Uint8Array<ArrayBufferLike>>

      Файл GLB как байты

      const options = new Bit.Inputs.OCCT.ConvertStepToGltfWithDracoDto();
      options.stepData = stepText;
      options.meshPrecision = 0.005;
      options.dracoCompressionLevel = 7;
      options.dracoQuantizePositionBits = 14;
      const glb = await bitbybit.occt.io.convertStepToGltfWithDraco(options);
    • Преобразует файл STEP в двоичный glTF (GLB) со всеми доступными параметрами чтения, построения меша и записи, как convertStepToGltfAdvanced, и сжимает геометрию с помощью Draco.

      Настройки Draco задают уровень сжатия и сколько бит сохраняют позиции, нормали, текстурные координаты и цвета; меньше бит означает меньший файл и меньшую точность.

      Parameters

      • inputs: ConvertStepToGltfAdvancedWithDracoDto

        Содержимое файла STEP, настройки чтения, построения меша и экспорта и настройки Draco

      Returns Promise<Uint8Array<ArrayBufferLike>>

      Файл GLB как байты

      const options = new Bit.Inputs.OCCT.ConvertStepToGltfAdvancedWithDracoDto();
      options.stepData = stepText;
      options.readColors = true;
      options.meshDeflection = 0.005;
      options.dracoCompressionLevel = 7;
      const glb = await bitbybit.occt.io.convertStepToGltfAdvancedWithDraco(options);
    • Читает структуру сборки файла STEP без построения геометрии: каждую деталь и подсборку как узел с ее id, именем, признаком сборки, видимостью, цветом и матрицей размещения.

      Узлы идут в порядке обхода в глубину, так что дочерние следуют за своим родителем. Файл, который нельзя разобрать, сообщает свою ошибку в результате.

      Parameters

      Returns Promise<AssemblyJsonResult>

      Список узлов, версия формата и ошибка, если она есть

      const tree = await bitbybit.occt.io.parseStepToJson({ stepData: stepText });
      console.log(tree.nodes.map(n => n.name));

    dxf

    • Превращает контуры формы в записи путей DXF, первый шаг 2D-экспорта в DXF.

      Форма должна лежать плоско на плоскости земли XZ, так как чертежи DXF двумерны. Настройки отклонения говорят, насколько близко следовать изогнутым ребрам. Дайте путям слой через dxfPathsWithLayer и запишите файл через dxfCreate.

      Parameters

      Returns Promise<DxfPathDto[]>

      Пути DXF

      const paths = await bitbybit.occt.io.shapeToDxfPaths({
      shape: flatOutline,
      angularDeflection: 0.1,
      curvatureDeflection: 0.1,
      minimumOfPoints: 2,
      uTolerance: 1e-9,
      minimumLength: 1e-7,
      });
    • Помещает пути DXF на именованный слой с цветом, делая одну часть чертежа DXF.

      Чертеж может содержать несколько частей, каждая со своим слоем и цветом; dxfCreate записывает их в один файл.

      Parameters

      Returns Promise<DxfPathsPartDto>

      Пути как одна часть со слоем

      const part = await bitbybit.occt.io.dxfPathsWithLayer({ paths, layer: "cut", color: "#ff0000" });
      
    • Записывает части DXF в один файл DXF и возвращает его текст.

      colorFormat выбирает индексированные цвета AutoCAD или истинный цвет, acadVersion - версию DXF: AC1009 - R12, наиболее широко читаемая, AC1015 - 2000. fileName и tryDownload имеют значение только там, где можно запустить скачивание браузером.

      Parameters

      • inputs: DxfPathsPartsListDto

        Части со слоями, формат цвета, версия DXF и параметры скачивания

      Returns Promise<string>

      Файл DXF как текст

      const dxf = await bitbybit.occt.io.dxfCreate({
      pathsParts: [part],
      colorFormat: Bit.Inputs.OCCT.dxfColorFormatEnum.aci,
      acadVersion: Bit.Inputs.OCCT.dxfAcadVersionEnum.AC1009,
      fileName: "drawing.dxf",
      tryDownload: false,
      });

    io

    • Записывает форму как STEP, стандартный формат обмена точной CAD-геометрией, и запускает скачивание файла браузером.

      При adjustYtoZ равном true форма поворачивается так, что Y-вверх этой библиотеки становится Z-вверх STEP; fromRightHanded пропускает отражение, которое эта смена иначе включает. fileName называет скачиваемый файл, а tryDownload равный false пропускает скачивание. saveShapeSTEPAndReturn вместо этого дает текст файла.

      Parameters

      • inputs: SaveStepDto<TopoDSShapePointer>

        Форма, имя файла, корректировка осей и параметры скачивания

      Returns Promise<void>

      Ничего; скачивание начинается, когда файл готов

      await bitbybit.occt.io.saveShapeSTEP({ shape: box, fileName: "box.step", adjustYtoZ: true, tryDownload: true });
      
    • Записывает форму как STEP, стандартный формат обмена точной CAD-геометрией, и возвращает текст файла.

      При adjustYtoZ равном true форма поворачивается так, что Y-вверх этой библиотеки становится Z-вверх STEP; fromRightHanded пропускает отражение, которое эта смена иначе включает. fileName и tryDownload имеют значение только там, где можно запустить скачивание браузером.

      Parameters

      • inputs: SaveStepDto<TopoDSShapePointer>

        Форма, имя файла, корректировка осей и параметры скачивания

      Returns Promise<string>

      Файл STEP как текст

      const step = await bitbybit.occt.io.saveShapeSTEPAndReturn({ shape: box, fileName: "box.step", adjustYtoZ: true, tryDownload: false });
      
    • Триангулирует форму, записывает ее как STL, формат мешей, который читают 3D-принтеры, и запускает скачивание файла браузером.

      precision - допуск построения меша в единицах модели; меньшие значения точнее следуют изогнутым поверхностям и дают больший файл. adjustYtoZ превращает Y-вверх в Z-вверх. fileName называет скачиваемый файл, tryDownload равный false пропускает скачивание. saveShapeStlAndReturn вместо этого дает текст.

      Parameters

      • inputs: SaveStlDto<TopoDSShapePointer>

        Форма, имя файла, точность построения меша, корректировка осей и параметры скачивания

      Returns Promise<void>

      Ничего; скачивание начинается, когда файл готов

      await bitbybit.occt.io.saveShapeStl({ shape: box, fileName: "box.stl", precision: 0.01, adjustYtoZ: true, tryDownload: true });
      
    • Триангулирует форму и записывает ее как STL, формат мешей, который читают 3D-принтеры и слайсеры, возвращая текст файла.

      precision - допуск построения меша в единицах модели; меньшие значения точнее следуют изогнутым поверхностям и дают больший файл. adjustYtoZ поворачивает форму так, что Y-вверх становится Z-вверх. fileName и tryDownload имеют значение только там, где можно запустить скачивание.

      Parameters

      • inputs: SaveStlDto<TopoDSShapePointer>

        Форма, имя файла, точность построения меша, корректировка осей и параметры скачивания

      Returns Promise<string>

      Файл STL как текст

      const stl = await bitbybit.occt.io.saveShapeStlAndReturn({ shape: box, fileName: "box.stl", precision: 0.01, adjustYtoZ: true, tryDownload: false });