Bitbybit Docs
    Preparing search index...

    Class BabylonMeshBuilder

    أوليات الشبكات الخاصة بـ BabylonJS، تُبنى مباشرة في المشهد كشبكات جاهزة للتصيير وليس عبر نواة CAD: الصناديق والكرات والأقراص والحلقات والمضلعات والأنابيب ومتعددات السطوح والكبسولات والأسطوانات والبثوق والأشرطة والمخارط والأرضيات. سريعة الإنشاء ورخيصة الرسم لكنها لا تحمل هندسة دقيقة، فاستخدم النوى عندما يجب قياس الشكل أو قطعه أو تصديره. يتوسط كل بانٍ شبكته على نقطة الأصل، ويضبط sideOrientation، ويسجلها للظلال ما لم يكن enableShadows هو false.

    Index

    Constructors

    create simple

    • يبني صندوقًا مركزه نقطة الأصل بعرض width على طول X وارتفاع height على طول Y وعمق depth على طول Z.

      Parameters

      • inputs: CreateBoxDto

        الأحجام الثلاثة واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة الصندوق

      const box = bitbybit.babylon.meshBuilder.createBox({ width: 10, height: 5, depth: 20, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.frontside, enableShadows: true });
      
    • يبني مكعبًا مركزه نقطة الأصل بطول size لكل حافة.

      Parameters

      • inputs: CreateCubeDto

        طول الحافة واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة المكعب

      const cube = bitbybit.babylon.meshBuilder.createCube({ size: 10, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.frontside, enableShadows: true });
      
    • يبني مربعًا مسطحًا بضلع size مركزه نقطة الأصل في المستوى XY، مواجهًا للمحور Z؛ المستوى أحادي الجانب غير مرئي من الخلف ما لم يكن sideOrientation مزدوج الجانب.

      Parameters

      Returns Mesh

      شبكة المستوى

      const plane = bitbybit.babylon.meshBuilder.createSquarePlane({ size: 10, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, enableShadows: true });
      
    • يبني كرة بالقطر diameter المعطى مركزها نقطة الأصل؛ segments يضبط مدى دقة تقسيمها، والأكثر يعني أكثر استدارة وأثقل.

      Parameters

      • inputs: CreateSphereDto

        القطر وعدد القطع واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة الكرة

      const ball = bitbybit.babylon.meshBuilder.createSphere({ diameter: 10, segments: 32, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.frontside, enableShadows: true });
      
    • يبني كرة من مثلثات متساوية الحجم، مقسّمة فرعيًا من عشروني الوجوه، وهي تُظلَّل بتساوٍ أكثر من createSphere.

      radiusX وradiusY وradiusZ تمدها لكل محور وتعود إلى radius عندما تكون 0؛ flat يعطي تظليلًا مسطحًا.

      Parameters

      • inputs: CreateIcoSphereDto

        أنصاف الأقطار وعلم التسطيح والتقسيمات الفرعية واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة الكرة العشرونية

      const ball = bitbybit.babylon.meshBuilder.createIcoSphere({ radius: 5, radiusX: 0, radiusY: 0, radiusZ: 0, flat: false, subdivisions: 4, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.frontside, enableShadows: true });
      
    • يبني قرصًا مسطحًا بنصف القطر radius المعطى مركزه نقطة الأصل في المستوى XY؛ arc أقل من 1 يترك شريحة فطيرة، فالقيمة 0.5 هي نصف قرص.

      Parameters

      • inputs: CreateDiscDto

        نصف القطر والتفصيص وكسر القوس واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة القرص

      const disc = bitbybit.babylon.meshBuilder.createDisc({ radius: 5, tessellation: 32, arc: 1, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, enableShadows: true });
      
    • يبني حلقة تقع في المستوى XZ حول نقطة الأصل: diameter هو القطر الكلي للحلقة وthickness قطر أنبوبها.

      Parameters

      • inputs: CreateTorusDto

        القطر وسمك الأنبوب والتفصيص واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة الحلقة

      const ring = bitbybit.babylon.meshBuilder.createTorus({ diameter: 10, thickness: 2, tessellation: 32, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.frontside, enableShadows: true });
      
    • يبني أنبوبًا ملفوفًا في عقدة حول نقطة الأصل: p وq هما عدد مرات لفه حول الحلقة وعبر ثقبها، فالقيمتان 2 و3 تعطيان العقدة ثلاثية الفصوص الكلاسيكية.

      Parameters

      • inputs: CreateTorusKnotDto

        نصف القطر ونصف قطر الأنبوب وأعداد القطع وأرقام اللف واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة العقدة الحلقية

      const knot = bitbybit.babylon.meshBuilder.createTorusKnot({ radius: 5, tube: 1, radialSegments: 128, tubularSegments: 32, p: 2, q: 3, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.frontside, enableShadows: true });
      
    • يبني مضلعًا مسطحًا مملوءًا من نقاط محيطه الخارجي، مع ثقوب اختيارية، يقع في المستوى XZ؛ depth أكبر من 0 يعطيه سمكًا إلى الأسفل.

      النقاط ثلاثية الأبعاد لكن X وZ فقط تُستخدمان، ويجب ألا يتقاطع المحيط الخارجي مع نفسه.

      Parameters

      • inputs: CreatePolygonDto

        المخطط الخارجي والثقوب والعمق والتنعيم واتجاه الجوانب وعلم الالتفاف وعلم الظل

      Returns Mesh

      شبكة المضلع

      const slab = bitbybit.babylon.meshBuilder.createPolygon({ shape: [[0, 0, 0], [10, 0, 0], [10, 0, 10], [0, 0, 10]], holes: [], depth: 0, smoothingThreshold: 0.01, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, wrap: false, enableShadows: true });
      
    • يبني مجسمًا صلبًا ببثق مضلع مسطح، معطى بنقاط محيطه الخارجي في المستوى XZ مع ثقوب اختيارية، إلى الأسفل بمقدار depth.

      Parameters

      • inputs: ExtrudePolygonDto

        المخطط الخارجي والثقوب والعمق واتجاه الجوانب وعلم الالتفاف وعلم الظل

      Returns Mesh

      الشبكة المبثوقة

      const block = bitbybit.babylon.meshBuilder.extrudePolygon({ shape: [[0, 0, 0], [10, 0, 0], [10, 0, 10], [0, 0, 10]], holes: [[[3, 0, 3], [7, 0, 3], [7, 0, 7], [3, 0, 7]]], depth: 5, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.frontside, wrap: false, enableShadows: true });
      
    • يبني أنبوبًا بنصف القطر radius المعطى على طول مسار من النقاط؛ cap يغلق أيًا من الطرفين أو أحدهما أو كليهما، وarc أقل من 1 يترك الأنبوب مفتوحًا على طوله.

      Parameters

      • inputs: CreateTubeDto

        المسار ونصف القطر والتفصيص ووضع الأغطية وكسر القوس واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة الأنبوب

      const pipe = bitbybit.babylon.meshBuilder.createTube({ path: [[0, 0, 0], [10, 0, 0], [10, 10, 0]], radius: 1, tessellation: 32, cap: 3, arc: 1, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, enableShadows: true });
      
    • يبني واحدًا من متعددات الوجوه الخمسة عشر المدمجة بحسب type، من رباعي الوجوه (0) إلى القبة الخماسية المطوّلة (14)، أو واحدًا خاصًا بك من بيانات custom.

      sizeX وsizeY وsizeZ تمده لكل محور وتعود إلى size عندما تكون 0؛ flat يعطي تظليلًا مسطحًا.

      Parameters

      • inputs: CreatePolyhedronDto

        الحجم والنوع والبيانات المخصصة وعلم التسطيح واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة متعدد السطوح

      const dodecahedron = bitbybit.babylon.meshBuilder.createPolyhedron({ size: 5, type: 2, sizeX: 0, sizeY: 0, sizeZ: 0, flat: true, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.frontside, enableShadows: true });
      
    • يبني كرة جيوديسية، وهي عشروني الوجوه تُقسَّم أوجهه فرعيًا إلى مثلثات كما يحدد m وn، بحيث يتكون السطح من مثلثات شبه متساوية.

      sizeX وsizeY وsizeZ تمدها لكل محور وتعود إلى size عندما تكون 0.

      Parameters

      • inputs: CreateGeodesicDto

        أرقام التقسيم الفرعي والأحجام وعلم التسطيح واتجاه الجوانب وعلم الظل

      Returns Mesh

      الشبكة الجيوديسية

      const dome = bitbybit.babylon.meshBuilder.createGeodesic({ m: 4, n: 4, size: 5, sizeX: 0, sizeY: 0, sizeZ: 0, flat: false, subdivisions: 4, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.frontside, enableShadows: true });
      
    • يبني متعدد وجوه غولدبرغ، وهو كرة مكوّنة من سداسيات واثني عشر خماسيًا مثل كرة القدم، مع m وn يحددان عدد السداسيات.

      sizeX وsizeY وsizeZ تمده لكل محور وتعود إلى size عندما تكون 0.

      Parameters

      • inputs: CreateGoldbergDto

        أرقام التقسيم الفرعي والأحجام واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة Goldberg

      const ball = bitbybit.babylon.meshBuilder.createGoldberg({ m: 4, n: 4, size: 5, sizeX: 0, sizeY: 0, sizeZ: 0, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, enableShadows: true });
      
    • يبني كبسولة، وهي أسطوانة بطرفين مستديرين، بالارتفاع height ونصف القطر radius المعطيين على طول orientation؛ radiusTop وradiusBottom يحجّمان الطرفين كلًا على حدة.

      Parameters

      • inputs: CreateCapsuleDto

        التوجيه والأحجام وأعداد التقسيم الفرعي واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة الكبسولة

      const pill = bitbybit.babylon.meshBuilder.createCapsule({ orientation: [0, 1, 0], subdivisions: 2, tessellation: 16, height: 10, radius: 2, capSubdivisions: 6, radiusTop: 2, radiusBottom: 2, topCapSubdivisions: 6, bottomCapSubdivisions: 6, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, enableShadows: true });
      
    • يبني أسطوانة قائمة على طول Y، مركزها نقطة الأصل؛ اختلاف قطري القمة والقاعدة يصنع مخروطًا أو استدقاقًا، والقيمة 0 تغلق طرفًا إلى نقطة.

      Parameters

      • inputs: CreateCylinderDto

        الارتفاع والقطران والتفصيص والتقسيمات الفرعية واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة الأسطوانة

      const cone = bitbybit.babylon.meshBuilder.createCylinder({ height: 10, diameterTop: 0, diameterBottom: 6, tessellation: 64, subdivisions: 1, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, enableShadows: true });
      
    • يكسح مقطعًا جانبيًا على طول مسار: shape هو المقطع الجانبي كنقاط في المستوى XY وpath النقاط التي يمر عبرها، مع تطبيق scale وrotation بالراديان خطوة بخطوة على طول الطريق.

      closeShape يصل طرفي المقطع الجانبي، وclosePath يصل طرفي المسار، وcap يغلق أيًا من الطرفين أو أحدهما أو كليهما.

      Parameters

      • inputs: CreateExtrudedShapeDto

        المقطع الجانبي والمسار والتحجيم والتدوير لكل خطوة وأعلام الإغلاق ووضع الأغطية واتجاه الجوانب وعلم الظل

      Returns Mesh

      الشبكة المكسوحة

      const rail = bitbybit.babylon.meshBuilder.createExtrudedSahpe({ shape: [[-1, 0, 0], [1, 0, 0], [1, 1, 0], [-1, 1, 0]], path: [[0, 0, 0], [10, 0, 0], [10, 0, 10]], scale: 1, rotation: 0, closeShape: true, closePath: false, cap: 3, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, enableShadows: true });
      
    • يبني سطحًا عبر عدة مسارات من النقاط، واصلًا المسارات المتجاورة بمثلثات، مثل قماش مشدود فوق مجموعة من الخطوط.

      closePath يصل طرفي كل مسار، وcloseArray يصل المسار الأخير عودة بالأول، وoffset يزيح كيفية اقتران النقاط عندما يُعطى مسار واحد فقط.

      Parameters

      • inputs: CreateRibbonDto

        المسارات وأعلام الإغلاق والإزاحة وعلم القابلية للتحديث واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة الشريط

      const sheet = bitbybit.babylon.meshBuilder.createRibbon({ pathArray: [[[0, 0, 0], [10, 0, 0], [20, 0, 0]], [[0, 5, 5], [10, 5, 5], [20, 5, 5]]], closeArray: false, closePath: false, offset: 0, updatable: false, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, enableShadows: true });
      
    • يدوّر مقطعًا جانبيًا حول المحور Y، كما تخرط المخرطة الخشب: shape هو المقطع الجانبي كنقاط في المستوى XY حيث X هي المسافة من المحور، وradius يدفعه إلى الخارج، وarc أقل من 1 يترك الدوران مفتوحًا.

      Parameters

      • inputs: CreateLatheDto

        المقطع الجانبي ونصف القطر والتفصيص وكسر القوس وعلم الإغلاق واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة المخرطة

      const vase = bitbybit.babylon.meshBuilder.createLathe({ shape: [[2, 0, 0], [3, 3, 0], [2, 6, 0], [2.5, 8, 0]], radius: 0, tessellation: 64, arc: 1, closed: true, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, enableShadows: true });
      
    • يبني مستوى أرض مسطحًا مركزه نقطة الأصل في المستوى XZ، بعرض width على طول X وارتفاع height على طول Z، مقسمًا إلى شبكة من subdivisionsX في subdivisionsY خلية.

      Parameters

      • inputs: CreateGroundDto

        العرض والارتفاع والتقسيمات الفرعية واتجاه الجوانب وعلم الظل

      Returns Mesh

      شبكة الأرضية

      const ground = bitbybit.babylon.meshBuilder.createGround({ width: 100, height: 100, subdivisionsX: 1, subdivisionsY: 1, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, enableShadows: true });
      
    • يبني مستطيلًا مسطحًا مركزه نقطة الأصل في المستوى XY، بعرض width على طول X وارتفاع height على طول Y، مواجهًا للمحور Z.

      Parameters

      Returns Mesh

      شبكة المستوى

      const plane = bitbybit.babylon.meshBuilder.createRectanglePlane({ width: 20, height: 10, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.doubleside, enableShadows: true });