Class OCCTFace

ينشئ المقطع العرضي المسطح لعارضة على شكل I: شفتان أفقيتان متصلتان بجسر عمودي.

width هو عرض الشفة، و height الارتفاع الإجمالي، و webThickness و flangeThickness سمكا الجدران؛ و alignment يحدد أي نقطة من صندوق المقطع تقع على center، و rotation يدوّره في مستواه، بالدرجات. يقع على الأرض، جاهزاً للبثق على طول Y.

ينشئ المقطع العرضي المسطح لعارضة على شكل H: شفتان عموديتان متصلتان بجسر أفقي، أي عارضة I على جانبها.

width هو العرض الإجمالي، و height ارتفاع الشفة، و webThickness و flangeThickness سمكا الجدران؛ و alignment يحدد أي نقطة من صندوق المقطع تقع على center، و rotation يدوّره في مستواه، بالدرجات. يقع على الأرض.

ينشئ المقطع العرضي المسطح لعارضة على شكل T: شفة أفقية بجسر عمودي متدلٍّ من منتصفها.

width هو عرض الشفة، و height الارتفاع الإجمالي، و webThickness و flangeThickness سمكا الجدران؛ و alignment يحدد أي نقطة من صندوق المقطع تقع على center، و rotation يدوّره في مستواه، بالدرجات. يقع مسطحاً على الأرض.

ينشئ المقطع العرضي المسطح لعارضة على شكل U، أي قناة: جسر بشفتين بعرض flangeWidth قائمتين من طرفيه.

width و height هما الحجم الإجمالي، و webThickness و flangeThickness سمكا الجدران؛ و alignment يحدد أي نقطة من صندوق المقطع تقع على center، و rotation يدوّره في مستواه، بالدرجات. يقع مسطحاً على الأرض.

يجمع حقائق تشخيصية عن وجه: نوع سطحه، ودرجتا U و V، وعدد نقاط التحكم والعقد، وما إذا كان U أو V مغلقاً أو دورياً أو كسرياً، وحدود UV، والمساحة، والاستواء، والتوجيه وعدد الأسلاك والحواف.

الوجه الفارغ أو null يعطي تقريراً معلّماً كغير صالح.

يضع شبكة من النقاط على وجه بالتقدم بانتظام عبر مدييه U و V.

nrDivisionsU في nrDivisionsV نقطة تغطي الوجه من حافة إلى حافة، مسرودة صفاً بصف: كل قيم V لأول U، ثم U التالية. أعلام الإزالة تحذف الصف الأول أو الأخير؛ وأعلام الإزاحة تدفع كل نقطة نصف خطوة.

يرسم أسلاكاً متباعدة بانتظام عبر وجه على طول اتجاه معلمة واحد، مثل خطوط ورقة مسطرة.

nrDivisions خطوة تعطي سلكاً واحداً أكثر من ذلك، بما في ذلك خطوط الحدود؛ و removeStart و removeEnd يحذفانها، و shiftHalfStep ينقل كل سلك نصف خطوة. مع isU بقيمة true يقع كل سلك عند U ثابتة ويمتد عبر V؛ و false تبدّل الأدوار.

يضع شبكة من النقاط على وجه مثل subdivideToPoints، لكنه يزيح ويزيل النقاط في كل صف أو عمود رقم n، للأنماط الشبيهة بالطوب والمتعرجة.

كل قاعدة زوج: shiftHalfStepNthU يحدد كل كم صف V ينتقل نصف خطوة في U، و shiftHalfStepUOffsetN من أين يبدأ العدّ؛ وقواعد الإزالة تحذف كل نقطة رقم n من صف حافة.

يحسب ناظم السطح عند كل نقطة من الشبكة التي كان subdivideToPoints سيضعها على وجه، بالخيارات نفسها والترتيب نفسه.

النواظم متجهات وحدة وتتبع توجيه الوجه، لذا يعطيها الوجه المعكوس مقلوبة. اقرن القائمة بـ subdivideToPoints لوضع أشياء قائمة على السطح.

يسرد أزواج معلمات UV للشبكة التي كان subdivideToPoints سيضعها على وجه، بالخيارات نفسها والترتيب نفسه.

الأزواج بقيم UV الحقيقية للوجه، لا كسوراً.

يجد النقطة على وجه عند كسور UV المعطاة.

paramU و paramV يمتدان من 0 إلى 1 على مدى U و V للوجه، لذا فإن 0.5, 0.5 هو منتصف المدى، الذي لا يكون دائماً داخل الوجه في الوجه المقلّم.

يجد ناظم السطح لوجه عند كسور UV المعطاة.

paramU و paramV يمتدان من 0 إلى 1 على مدى U و V للوجه. الناظم متجه وحدة ويتبع توجيه الوجه، لذا يعطيه الوجه المعكوس مقلوباً.

يجد النقاط على وجه عند عدة أزواج من كسور UV دفعة واحدة.

يحمل كل زوج U ثم V، كلاهما من 0 إلى 1 على مدى الوجه.

يجد نواظم السطح لوجه عند عدة أزواج من كسور UV دفعة واحدة.

يحمل كل زوج U ثم V، كلاهما من 0 إلى 1 على مدى الوجه. النواظم متجهات وحدة للسطح الأساسي؛ وبخلاف normalOnUV، لا تُقلب للوجه المعكوس.

يضع نقاطاً متباعدة بانتظام على طول خط مستقيم واحد عبر مدى UV لوجه.

مع isU بقيمة true يقع الخط عند param (كسر من 0 إلى 1 من مدى U) وتنتشر nrPoints نقطة على مدى V كاملاً؛ ومع false تتبدل الأدوار. removeStartPoint و removeEndPoint يحذفان الطرفين، و shiftHalfStep ينقل كل نقطة نصف خطوة.

يرسم سلكاً واحداً عبر وجه على طول خط معلمة، متبعاً السطح.

مع isU بقيمة true يقع السلك عند param (كسر من 0 إلى 1 من مدى U) ويمتد على مدى V كاملاً؛ ومع false تتبدل الأدوار.

يرسم عدة أسلاك عبر وجه، واحداً لكل قيمة معلمة، متبعة السطح.

مع isU بقيمة true يقع كل سلك عند كسره من مدى U ويمتد على مدى V كاملاً؛ ومع false تتبدل الأدوار.

يصنف النقاط على أنها داخل وجه أو على حده أو خارجه، ويحتفظ بالمجموعات المختارة.

keepIn و keepOn و keepOut و keepUnknown تختار المجموعات؛ و tolerance يقرر مدى القرب من الحد الذي يُعد واقعاً عليه. مع useBndBox، النقطة الواقعة خارج الصندوق المحيط الموسع بـ gapTolerance تُعد خارجه.

يشغّل filterFacePoints ضد عدة أوجه بالنقاط والخيارات نفسها.

افتراضياً يحمل الناتج قائمة واحدة لكل وجه؛ ومع flatPointsArray بقيمة true تُضم القوائم في واحدة، بحيث تظهر النقطة الواقعة على وجهين مرتين.

ينشئ وجهاً واحداً لكل سلك، كل منها مقتطع من سطح وجه موجّه بحيث يأخذ انحناء ذلك السطح.

يجب أن تقع الأسلاك على السطح. مع inside بقيمة true يُدار كل سلك بحيث يكون وجهه المنطقة التي يحيط بها؛ ومع false يقرر اتجاه السلك نفسه، والسلك الممتد في الاتجاه الآخر يعطي المنطقة الخارجية.

ينشئ وجهاً من سلك يقع على سطح وجه موجّه، بحيث يأخذ الوجه الجديد انحناء ذلك السطح.

مع inside بقيمة true يُدار السلك بحيث يكون الوجه المنطقة التي يحيط بها؛ ومع false يقرر اتجاه السلك نفسه، والسلك الممتد في الاتجاه الآخر يعطي المنطقة الواقعة خارجه.

ينشئ وجهاً محدوداً بسلك مغلق.

مع planar بقيمة true يجب أن يقع السلك في مستوى واحد ويكون الوجه مسطحاً؛ ومع false يُقرَّب سطح ناعم عبر حواف السلك، وهو ما يملأ سلكاً غير مسطح. الشكل الذي ليس سلكاً يرمي خطأ.

ينشئ وجهاً واحداً من عدة أسلاك: السلك الأول هو الحد الخارجي وكل سلك إضافي يقطع ثقباً فيه.

مع planar بقيمة true يجب أن تقع الأسلاك في مستوى واحد. يجب أن تقع أسلاك الثقوب داخل السلك الخارجي دون أن تتقاطع معه أو مع بعضها.

ينشئ وجهاً واحداً من عدة أسلاك على سطح وجه موجّه: السلك الأول هو الحد الخارجي وكل سلك إضافي يقطع ثقباً.

يأخذ الوجه انحناء السطح الموجّه. inside ينطبق على السلك الأول: القيمة true تديره بحيث يكون الوجه المنطقة التي يحيط بها؛ و false تدع اتجاهه الخاص يقرر.

ينشئ وجهاً واحداً لكل سلك مغلق، كل منها كما يفعل createFaceFromWire.

مع planar بقيمة true يجب أن يقع كل سلك في مستوى؛ ومع false يُقرَّب سطح ناعم عبر كل منها.

يصل الدوائر بأحزمة مماسة: لكل زوج يرسم خطي المماس الخارجيين والقوسين الخارجيين بينهما ويملأ ذلك المخطط بوجه مسطح.

combination يختار الأزواج: allWithAll كل دائرة مع كل الأخرى، و inOrder الجيران في القائمة، و inOrderClosed الأخيرة مع الأولى أيضاً. unify يدمج الأوجه؛ وإلا تشكل مركباً.

يصل الدوائر من قوائم متتالية بأحزمة مماسة، بالطريقة التي يصل بها createFaceFromMultipleCircleTanWires الدوائر المفردة.

allWithAll يصل كل دائرة في قائمة بكل دائرة في التالية؛ و inOrder يصل الدوائر الواقعة في الموضع نفسه في القوائم المتجاورة، التي تحتاج أطوالاً متساوية؛ و inOrderClosed يغلق أيضاً كل قائمة في حلقة. unify يدمج الأوجه؛ وإلا تشكل مركباً.

ينشئ وجهاً يغطي سطحاً كاملاً، حتى الحدود الطبيعية للسطح.

tolerance يُستخدم لاكتشاف الحواف المنحلة، مثل قطب الكرة. تأتي الأسطح من geom.surfaces.

ينشئ وجهاً بقطع سطح بسلك يقع عليه.

مع inside بقيمة true يُدار السلك بحيث يكون الوجه المنطقة التي يحيط بها؛ ومع false يقرر اتجاه السلك نفسه، والسلك الممتد في الاتجاه الآخر يعطي المنطقة الواقعة خارجه. تأتي الأسطح من geom.surfaces.

ينشئ وجهاً مثلثياً مسطحاً من ثلاث نقاط.

ينشئ وجهاً مثلثياً مسطحاً واحداً لكل مثلث في شبكة.

المثلث الذي لا يمكن أن يشكل وجهاً، مثلاً ذو النقاط المكررة، يُتخطى مع تحذير في وحدة التحكم.

يختار وجهاً واحداً من شكل حسب موضعه، بالعدّ من 0، بالترتيب الذي تجتاز به النواة الشكل.

يجب أن يكون الشكل وجهاً أو شيئاً مبنياً من أوجه؛ والفهرس الذي يتجاوز الوجه الأخير يرمي خطأ.

يسرد كل وجه في شكل بالترتيب الذي تجتازه به النواة.

يقلب وجهاً بحيث يشير ناظمه إلى الاتجاه الآخر.

تبقى الهندسة كما هي؛ ولا يتغير سوى التوجيه، وهو ما يقرر الجانب الخارجي للقشرة والاتجاه الذي يبلّغ عنه normalOnUV.

يقرأ أصغر قيمة لمعلمة U لوجه، بوحدات السطح الخاصة.

مع getUMaxBound و getVMinBound و getVMaxBound يعطي المدى الذي تُسقط عليه كسور UV المستخدمة في مواضع أخرى من هذا الصنف.

يقرأ أكبر قيمة لمعلمة U لوجه، بوحدات السطح الخاصة.

يقرأ أصغر قيمة لمعلمة V لوجه، بوحدات السطح الخاصة.

يقرأ أكبر قيمة لمعلمة V لوجه، بوحدات السطح الخاصة.

يقيس مساحة سطح وجه، بوحدات النموذج المربعة.

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

يجد مركز كتلة وجه، وهو النقطة التي تتوازن عليها مساحته.

في الوجه المنحني أو الحلقي الشكل قد تقع هذه النقطة خارج السطح.

يجد مركز كتلة كل وجه في قائمة.

يضع أسلاكاً مستطيلة على وجه، واحداً لكل خلية من تقسيم nrRectanglesU في nrRectanglesV لمدى UV الخاص به، متبعة السطح.

إزاحات الحدود تقلّم المدى عند كل طرف. يقع كل مستطيل متمركزاً في خليته، بحجم تحدده أنماط التحجيم ككسر منها؛ ونمط التقويس يدوّر الزوايا، ونمط التضمين يتخطى الخلايا.

يقطع شبكة من الثقوب المستطيلة في وجه ويعيد الوجه المثقّب.

تتبع الثقوب الخلايا والأنماط نفسها التي يتبعها subdivideToRectangleWires؛ وعندما لا يُعطى نمط تحجيم يغطي كل ثقب نصف خليته. مع holesToFaces بقيمة true يحمل الناتج أيضاً وجهاً واحداً لكل ثقب، بعد الوجه المثقّب، وهو مفيد للأغطية أو الحشوات.

يضع خلية نحل من أسلاك سداسية على وجه، nrHexagonsU في nrHexagonsV منها موزعة في مدى UV الخاص به، كل منها يتبع السطح.

إزاحات الحدود تقلّم كسراً من المدى عند كل طرف؛ و flatU يوجه جانباً مسطحاً نحو U، وأعلام التمديد تمدد الصفوف الخارجية إلى ما بعد الحواف. أنماط التحجيم والتقويس والتضمين تتكرر لكل سداسي.

يقطع خلية نحل من الثقوب السداسية في وجه ويعيد الوجه المثقّب.

تتبع الثقوب التخطيط والأنماط نفسها التي يتبعها subdivideToHexagonWires؛ وعندما لا يُعطى نمط تحجيم يكون كل ثقب بنصف حجم سداسيه. مع holesToFaces بقيمة true يحمل الناتج أيضاً وجهاً واحداً لكل ثقب، بعد الوجه المثقّب.

ينشئ وجهاً مسطحاً من قائمة من نقاط الزوايا، مغلقاً المخطط من النقطة الأخيرة عائداً إلى الأولى.

يجب أن تقع النقاط في مستوى واحد.

ينشئ وجهاً دائرياً مسطحاً، أي قرصاً.

direction هو ناظم مستواه: القيمة الافتراضية [0, 1, 0] تضعه مسطحاً على الأرض.

يملأ مستطيلاً على المستوى الأرضي بشبكة من أوجه سداسية مسطحة، متمركزة على نقطة الأصل.

تُحجّم السداسيات بحيث يتسع nrHexagonsInWidth منها عبر width و nrHexagonsInHeight عبر height. تُقرأ أنماط التحجيم والتقويس والتضمين سداسياً بسداسي وتتكرر؛ وأعلام التمديد تمدد الصفوف الخارجية إلى ما بعد الحواف لتغطية المستطيل.

ينشئ وجهاً مسطحاً على شكل قطع ناقص.

direction هو ناظم مستواه: القيمة الافتراضية [0, 1, 0] تضعه مسطحاً على الأرض. يجب أن يكون radiusMajor على الأقل بقدر radiusMinor.

ينشئ وجهاً مربعاً مسطحاً متمركزاً على center.

direction هو ناظم مستواه: القيمة الافتراضية [0, 1, 0] تضعه مسطحاً على الأرض.

ينشئ وجهاً مستطيلاً مسطحاً متمركزاً على center.

على المستوى الأرضي يمتد width على طول X و length على طول Z؛ و direction هو ناظم المستوى، والقيمة الافتراضية [0, 1, 0] تبقي الوجه مسطحاً على الأرض.

ينشئ وجهاً مسطحاً على شكل حرف L: ساقان مستطيلتان متصلتان عند زاوية.

للساق الأولى widthFirst و lengthFirst، وللثانية widthSecond و lengthSecond؛ و align يضع الزاوية على الجانب الخارجي أو الداخلي أو منتصف الساقين، و rotation يدوّر الشكل في مستواه، بالدرجات. يقع مسطحاً على الأرض ما لم يحدد direction خلاف ذلك.

ينشئ وجهاً مسطحاً على شكل نجمة بعدد numRays من الرؤوس.

تصل الرؤوس إلى outerRadius والفجوات بينها إلى innerRadius؛ و half يبقي فقط النصف الأول من الأشعة. offsetOuterEdges يرفع أطراف الأشعة خارج المستوى وهو مخصص للسلك؛ والوجه المسطح يحتاجه بقيمة 0. يقع مسطحاً على الأرض ما لم يحدد direction خلاف ذلك.

ينشئ وجهاً مسطحاً على شكل شجرة عيد ميلاد منمّقة: nrSkirts طبقة من الأغصان، تضيق من outerDist إلى innerDist عن خط الجذع، على جذع بارتفاع trunkHeight وعرض trunkWidth.

بخلاف الأشكال المسطحة الأخرى هنا يقف منتصباً في المستوى XY، بقمته على طول Y؛ و direction هو الاتجاه من الجذع إلى القمة، و rotation يدوّره حول ذلك المحور، بالدرجات.

ينشئ وجه متوازي أضلاع مسطحاً: مستطيل بعرض width وارتفاع height تميل أضلاعه بمقدار angle درجة.

مع aroundCenter بقيمة true يتمركز الشكل على center؛ وإلا يبدأ هناك ويمتد في الاتجاهات الموجبة. direction هو ناظم المستوى؛ والقيمة الافتراضية [0, 1, 0] تضعه مسطحاً على الأرض.

ينشئ وجهاً مسطحاً على شكل قلب يتسع تقريباً في مربع بحجم sizeApprox.

rotation يدوّره في مستواه، بالدرجات. direction هو ناظم المستوى؛ والقيمة الافتراضية [0, 1, 0] تضعه مسطحاً على الأرض.

ينشئ وجه مضلع منتظم مسطحاً بعدد nrCorners من الزوايا، كلها على دائرة نصف قطرها radius.

direction هو ناظم المستوى؛ والقيمة الافتراضية [0, 1, 0] تضعه مسطحاً على الأرض.

يعيد بناء سطح وجه كسطح B-spline بدرجتي U و V المعطاتين.

خفض الدرجة ينعّم السطح إلى تقريب أبسط ضمن tolerance؛ ورفعها دقيق. keepTrim يبقي أسلاك الحدود الأصلية، وهو موثوق عند الرفع؛ وإلا يغطي الوجه السطح الجديد كاملاً. إعادة البناء التي تفشل تعطي وجهاً null.

يغيّر كيفية امتداد معلمات UV على وجه: تبديل U و V، أو عكس U، أو عكس V، أو أي تركيبة منها.

تبقى الهندسة كما هي؛ ولا تتغير سوى اتجاهات المعلمات، وهو ما يهم كل دالة هنا تعمل في UV، مثل subdivideToPoints أو wireAlongParam. يُعاد بناء الوجه على الحدود الطبيعية للسطح.

يعيد تعليم وجه بحيث تعطي الخطوات المتساوية في U أو V مسافات متساوية تقريباً على السطح.

تحشد كثير من الأسطح معلماتها في مواضع معينة، فتبدو شبكة UV عليها غير منتظمة؛ وهذا يعيد أخذ عينات السطح عند samples نقطة لكل اتجاه ويعيد تقريبه، وهو ما ينظّم subdivideToPoints وأشقاءه. يُعاد بناء الوجه على الحدود الجديدة.