Bitbybit Docs
    Preparing search index...

    Class OCCTIO

    Lire et écrire des fichiers CAO avec OCCT : tout ce que io offre sur le noyau, plus des chargeurs qui prennent un fichier STEP ou IGES comme objet File ou comme son texte et renvoient une forme. Les fichiers sont Z vers le haut par convention, donc adjustZtoY tourne la forme chargée vers le Y vers le haut de cette bibliothèque sauf s'il est mis à faux.

    Hierarchy (View Summary)

    Index

    Constructors

    Properties

    occWorkerManager: OCCTWorkerManager

    assembly

    • Convertit un fichier STEP en glTF binaire (GLB), en gardant l'arbre d'assemblage sous forme de nœuds glTF avec les noms de pièces, les couleurs, les matériaux et les placements.

      stepData est le fichier sous forme de texte, ArrayBuffer ou Uint8Array. Les réglages de maillage disent avec quelle finesse les surfaces courbes sont triangulées : meshPrecision est la déflexion, meshAngle la déflexion angulaire. Z vers le haut devient le Y vers le haut de glTF. Un échec lève une erreur.

      Parameters

      Returns Promise<Uint8Array<ArrayBufferLike>>

      Le fichier GLB sous forme d'octets

      const glb = await bitbybit.occt.io.convertStepToGltf({ stepData: stepText, meshPrecision: 0.005, meshAngle: 0.5, meshRelative: true, internalVerticesMode: false, controlSurfaceDeflection: false });
      
    • Convertit un fichier STEP en glTF binaire (GLB) comme convertStepToGltf, avec chaque option exposée.

      Les indicateurs de lecture choisissent quoi prendre dans le fichier (couleurs, noms, matériaux, calques, propriétés), les réglages de maillage la finesse de triangulation, les réglages d'export la façon dont le glTF est écrit (faces fusionnées, index 16 bits, nommage, échelle). Désactivez ce dont vous n'avez pas besoin.

      Parameters

      Returns Promise<Uint8Array<ArrayBufferLike>>

      Le fichier GLB sous forme d'octets

      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);
    • Convertit un fichier STEP en glTF binaire (GLB) comme convertStepToGltf et compresse la géométrie avec Draco, ce qui rend le fichier beaucoup plus petit au prix d'un chargeur compatible Draco.

      Les réglages Draco fixent le niveau de compression et combien de bits les positions, normales, coordonnées de texture et couleurs conservent ; moins de bits signifie un fichier plus petit et moins de précision.

      Parameters

      Returns Promise<Uint8Array<ArrayBufferLike>>

      Le fichier GLB sous forme d'octets

      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);
    • Convertit un fichier STEP en glTF binaire (GLB) avec chaque option de lecture, de maillage et d'écriture exposée, comme le fait convertStepToGltfAdvanced, et compresse la géométrie avec Draco.

      Les réglages Draco fixent le niveau de compression et combien de bits les positions, normales, coordonnées de texture et couleurs conservent ; moins de bits signifie un fichier plus petit et moins de précision.

      Parameters

      Returns Promise<Uint8Array<ArrayBufferLike>>

      Le fichier GLB sous forme d'octets

      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);
    • Lit la structure d'assemblage d'un fichier STEP sans construire de géométrie : chaque pièce et sous-assemblage sous forme de nœud avec son id, son nom, si c'est un assemblage, sa visibilité, sa couleur et sa matrice de placement.

      Les nœuds viennent en ordre profondeur d'abord, les enfants suivent donc leur parent. Un fichier qui ne peut pas être analysé rapporte son erreur dans le résultat.

      Parameters

      Returns Promise<AssemblyJsonResult>

      La liste des nœuds, la version du format et toute erreur

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

    dxf

    • Transforme les fils d'une forme en enregistrements de chemins DXF, la première étape d'un export DXF 2D.

      La forme doit être posée à plat sur le plan du sol XZ, puisque les dessins DXF sont en deux dimensions. Les réglages de déflexion disent avec quelle précision les arêtes courbes sont suivies. Donnez un calque aux chemins avec dxfPathsWithLayer et écrivez le fichier avec dxfCreate.

      Parameters

      Returns Promise<DxfPathDto[]>

      Les chemins DXF

      const paths = await bitbybit.occt.io.shapeToDxfPaths({
      shape: flatOutline,
      angularDeflection: 0.1,
      curvatureDeflection: 0.1,
      minimumOfPoints: 2,
      uTolerance: 1e-9,
      minimumLength: 1e-7,
      });
    • Place des chemins DXF sur un calque nommé avec une couleur, formant une partie d'un dessin DXF.

      Un dessin peut contenir plusieurs parties, chacune avec son propre calque et sa propre couleur ; dxfCreate les écrit dans un seul fichier.

      Parameters

      Returns Promise<DxfPathsPartDto>

      Les chemins sous forme d'une partie avec calque

      const part = await bitbybit.occt.io.dxfPathsWithLayer({ paths, layer: "cut", color: "#ff0000" });
      
    • Écrit des parties DXF dans un seul fichier DXF et renvoie son texte.

      colorFormat choisit les couleurs indexées d'AutoCAD ou la couleur vraie, acadVersion la version DXF : AC1009 est R12, la plus largement lisible, AC1015 est 2000. fileName et tryDownload ne comptent que là où un téléchargement du navigateur peut être lancé.

      Parameters

      • inputs: DxfPathsPartsListDto

        Les parties avec calques, le format de couleur, la version DXF et les options de téléchargement

      Returns Promise<string>

      Le fichier DXF sous forme de texte

      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

    • Écrit une forme en STEP, le format d'échange standard pour la géométrie CAO exacte, et lance un téléchargement du fichier dans le navigateur.

      Avec adjustYtoZ vrai, la forme est tournée pour que le Y vers le haut de cette bibliothèque devienne le Z vers le haut de STEP ; fromRightHanded saute le miroir que cet échange inclut sinon. fileName nomme le téléchargement et tryDownload faux le saute. saveShapeSTEPAndReturn donne plutôt le texte du fichier.

      Parameters

      Returns Promise<void>

      Rien ; le téléchargement démarre quand le fichier est prêt

      await bitbybit.occt.io.saveShapeSTEP({ shape: box, fileName: "box.step", adjustYtoZ: true, tryDownload: true });
      
    • Écrit une forme en STEP, le format d'échange standard pour la géométrie CAO exacte, et renvoie le texte du fichier.

      Avec adjustYtoZ vrai, la forme est tournée pour que le Y vers le haut de cette bibliothèque devienne le Z vers le haut de STEP ; fromRightHanded saute le miroir que cet échange inclut sinon. fileName et tryDownload ne comptent que là où un téléchargement du navigateur peut être lancé.

      Parameters

      Returns Promise<string>

      Le fichier STEP sous forme de texte

      const step = await bitbybit.occt.io.saveShapeSTEPAndReturn({ shape: box, fileName: "box.step", adjustYtoZ: true, tryDownload: false });
      
    • Triangule une forme, l'écrit en STL, le format de maillage que lisent les imprimantes 3D, et lance un téléchargement du fichier dans le navigateur.

      precision est la tolérance de maillage en unités du modèle ; des valeurs plus petites suivent les surfaces courbes de plus près et font un fichier plus gros. adjustYtoZ transforme Y vers le haut en Z vers le haut. fileName nomme le téléchargement, tryDownload faux le saute. saveShapeStlAndReturn donne plutôt le texte.

      Parameters

      • inputs: SaveStlDto<TopoDSShapePointer>

        La forme, le nom du fichier, la précision du maillage, l'ajustement des axes et les options de téléchargement

      Returns Promise<void>

      Rien ; le téléchargement démarre quand le fichier est prêt

      await bitbybit.occt.io.saveShapeStl({ shape: box, fileName: "box.stl", precision: 0.01, adjustYtoZ: true, tryDownload: true });
      
    • Triangule une forme et l'écrit en STL, le format de maillage que lisent les imprimantes 3D et les trancheurs, en renvoyant le texte du fichier.

      precision est la tolérance de maillage en unités du modèle ; des valeurs plus petites suivent les surfaces courbes de plus près et font un fichier plus gros. adjustYtoZ tourne la forme pour que Y vers le haut devienne Z vers le haut. fileName et tryDownload ne comptent que là où un téléchargement peut être lancé.

      Parameters

      • inputs: SaveStlDto<TopoDSShapePointer>

        La forme, le nom du fichier, la précision du maillage, l'ajustement des axes et les options de téléchargement

      Returns Promise<string>

      Le fichier STL sous forme de texte

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