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

      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

      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

      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

      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 دون بناء هندسة: كل جزء وتجميع فرعي كعقدة بمعرّفها واسمها وما إذا كانت تجميعا ورؤيتها ولونها ومصفوفة وضعها.

      تأتي العقد بترتيب العمق أولا، فتتبع العناصر الفرعية أصلها. الملف الذي لا يمكن تحليله يبلغ عن خطئه في النتيجة.

      Parameters

      Returns Promise<AssemblyJsonResult>

      قائمة العقد وإصدار الصيغة وأي خطأ

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

    dxf

    • يحول أسلاك شكل إلى سجلات مسارات DXF، الخطوة الأولى في تصدير 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

      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

      Returns Promise<string>

      ملف STEP كنص

      const step = await bitbybit.occt.io.saveShapeSTEPAndReturn({ shape: box, fileName: "box.step", adjustYtoZ: true, tryDownload: false });
      
    • يثلّث شكلا، ويكتبه كـ STL، صيغة الشبكات التي تقرؤها الطابعات ثلاثية الأبعاد، ويبدأ تنزيل الملف في المتصفح.

      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، صيغة الشبكات التي تقرؤها الطابعات ثلاثية الأبعاد وبرامج التشريح، معيدا نص الملف.

      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 });