فصل 8. مرجع دوال SFCGAL
قائمة المحتويات
SFCGAL مكتبة C++ مغلِّفة لمكتبة CGAL توفّر دوالًا مكانية متقدمة ثنائية وثلاثية الأبعاد. ولتحقيق المتانة، تُمثَّل إحداثيات الأشكال الهندسية تمثيلًا دقيقًا بأعداد كسرية (rational).
يمكن العثور على تعليمات تثبيت المكتبة في الصفحة الرئيسية لـ SFCGAL (http://www.sfcgal.org). لتفعيل الدوال استخدم create extension postgis_sfcgal.
8.1. دوال إدارة SFCGAL
خلاصة
يسرد هذا القسم دوالًا لتحديد إصدار SFCGAL واعتماديات المكتبة التي تعمل بها.
- postgis_sfcgal_version — تُعيد إصدار SFCGAL المستخدم
- postgis_sfcgal_full_version — تُعيد الإصدار الكامل لـ SFCGAL المستخدم بما في ذلك إصدارا CGAL وBoost
8.2. دوال الوصول والتعيين في SFCGAL
خلاصة
تصل هذه الدوال إلى خصائص الأشكال الهندسية أو تعيّنها. الأشكال المدعومة أساسًا في هذه الدوال هي TIN والأسطح متعددة الأوجه (Polyhedral Surfaces).
- CG_ForceLHR — تفرض الاتجاه LHR
- CG_IsPlanar — تتحقق مما إذا كان السطح مستويًا أم لا
- CG_IsSolid — تختبر ما إذا كان الشكل الهندسي مجسّمًا (solid). لا يُجرى أي فحص للصلاحية.
- CG_MakeSolid — تحوّل الشكل الهندسي إلى مجسّم (solid). لا يُجرى أي فحص. للحصول على مجسّم صالح، يجب أن يكون الشكل المُدخَل سطحًا متعدد الأوجه مغلقًا أو TIN مغلقًا.
- CG_Orientation — تحدد اتجاه السطح
- CG_Area — تحسب مساحة الشكل الهندسي
- CG_3DArea — تحسب مساحة الأشكال الهندسية السطحية الثلاثية الأبعاد. تُعيد 0 للمجسّمات.
- CG_Volume — تحسب حجم مجسّم ثلاثي الأبعاد. إذا طُبّقت على أشكال سطحية (حتى المغلقة منها) فستُعيد 0.
- ST_ForceLHR — تفرض الاتجاه LHR
- ST_IsPlanar — تتحقق مما إذا كان السطح مستويًا أم لا
- ST_IsSolid — تختبر ما إذا كان الشكل الهندسي مجسّمًا (solid). لا يُجرى أي فحص للصلاحية.
- ST_MakeSolid — تحوّل الشكل الهندسي إلى مجسّم (solid). لا يُجرى أي فحص. للحصول على مجسّم صالح، يجب أن يكون الشكل المُدخَل سطحًا متعدد الأوجه مغلقًا أو TIN مغلقًا.
- ST_Orientation — تحدد اتجاه السطح
- ST_3DArea — تحسب مساحة الأشكال الهندسية السطحية الثلاثية الأبعاد. تُعيد 0 للمجسّمات.
- ST_Volume — تحسب حجم مجسّم ثلاثي الأبعاد. إذا طُبّقت على أشكال سطحية (حتى المغلقة منها) فستُعيد 0.
8.3. دوال المعالجة والعلاقات في SFCGAL
- CG_Intersection — تحسب تقاطع شكلين هندسيين
- CG_Intersects — تختبر ما إذا كان شكلان هندسيان يتقاطعان (لهما نقطة مشتركة واحدة على الأقل)
- CG_3DIntersects — تختبر ما إذا كان شكلان هندسيان ثلاثيا الأبعاد يتقاطعان
- CG_Difference — تحسب الفرق الهندسي بين شكلين هندسيين
- ST_3DDifference — تُجري فرقًا ثلاثي الأبعاد
- CG_3DDifference — تُجري فرقًا ثلاثي الأبعاد
- CG_Distance — تحسب أقل مسافة بين شكلين هندسيين
- CG_3DDistance — تحسب أقل مسافة ثلاثية الأبعاد بين شكلين هندسيين
- ST_3DConvexHull — تحسب الغلاف المحدب الثلاثي الأبعاد لشكل هندسي.
- CG_3DConvexHull — تحسب الغلاف المحدب الثلاثي الأبعاد لشكل هندسي.
- ST_3DIntersection — تُجري تقاطعًا ثلاثي الأبعاد
- CG_3DIntersection — تُجري تقاطعًا ثلاثي الأبعاد
- CG_Union — تحسب اتحاد شكلين هندسيين
- ST_3DUnion — تُجري اتحادًا ثلاثي الأبعاد.
- CG_3DUnion — تُجري اتحادًا ثلاثي الأبعاد باستخدام postgis_sfcgal.
- ST_AlphaShape — تحسب شكل ألفا (Alpha-shape) المحيط بشكل هندسي
- CG_AlphaShape — تحسب شكل ألفا (Alpha-shape) المحيط بشكل هندسي
- CG_ApproxConvexPartition — تحسب تقسيمًا محدبًا تقريبيًا للشكل الهندسي المضلعي
- ST_ApproximateMedialAxis — تحسب المحور الوسطي التقريبي لشكل هندسي مساحي.
- CG_ApproximateMedialAxis — تحسب المحور الوسطي التقريبي لشكل هندسي مساحي.
- ST_ConstrainedDelaunayTriangles — تُعيد تثليث ديلوني مقيّدًا حول الشكل الهندسي المُدخَل.
- CG_ConstrainedDelaunayTriangles — تُعيد تثليث ديلوني مقيّدًا حول الشكل الهندسي المُدخَل.
- ST_Extrude — تبثق (extrude) سطحًا إلى حجم مرتبط به
- CG_Extrude — تبثق (extrude) سطحًا إلى حجم مرتبط به
- CG_ExtrudeStraightSkeleton — البثق بالهيكل المستقيم
- CG_GreeneApproxConvexPartition — تحسب تقسيمًا محدبًا تقريبيًا للشكل الهندسي المضلعي
- ST_MinkowskiSum — تُجري جمع مينكوفسكي
- CG_MinkowskiSum — تُجري جمع مينكوفسكي
- ST_OptimalAlphaShape — تحسب شكل ألفا المحيط بشكل هندسي باستخدام قيمة ألفا "مثلى".
- CG_OptimalAlphaShape — تحسب شكل ألفا المحيط بشكل هندسي باستخدام قيمة ألفا "مثلى".
- CG_OptimalConvexPartition — تحسب تقسيمًا محدبًا أمثل للشكل الهندسي المضلعي
- CG_StraightSkeleton — تحسب هيكلًا مستقيمًا (straight skeleton) من شكل هندسي
- ST_StraightSkeleton — تحسب هيكلًا مستقيمًا (straight skeleton) من شكل هندسي
- ST_Tesselate — تُجري تبليطًا (Tessellation) سطحيًا لمضلع أو سطح متعدد الأوجه وتُعيده على هيئة TIN أو مجموعة من TIN
- CG_Tesselate — تُجري تبليطًا (Tessellation) سطحيًا لمضلع أو سطح متعدد الأوجه وتُعيده على هيئة TIN أو مجموعة من TIN
- CG_Triangulate — تُثلّث شكلًا هندسيًا مضلعيًا
- CG_Visibility — تحسب مضلع الرؤية من نقطة أو قطعة مستقيمة داخل شكل هندسي مضلعي
- CG_YMonotonePartition — تحسب تقسيمًا رتيبًا بالنسبة إلى y (y-monotone) للشكل الهندسي المضلعي
- CG_StraightSkeletonPartition — تحسب تقسيم الهيكل المستقيم لمضلع.
- CG_3DBuffer — تحسب نطاقًا عازلًا ثلاثي الأبعاد حول شكل هندسي.
- CG_Rotate — تُدير شكلًا هندسيًا بزاوية معيّنة حول نقطة الأصل (0,0).
- CG_2DRotate — تُدير شكلًا هندسيًا بزاوية معيّنة حول نقطة محددة في الفضاء الثنائي الأبعاد.
- CG_3DRotate — تُدير شكلًا هندسيًا في الفضاء الثلاثي الأبعاد حول متجه محور.
- CG_RotateX — تُدير شكلًا هندسيًا حول المحور X بزاوية معيّنة.
- CG_RotateY — تُدير شكلًا هندسيًا حول المحور Y بزاوية معيّنة.
- CG_RotateZ — تُدير شكلًا هندسيًا حول المحور Z بزاوية معيّنة.
- CG_Scale — تغيّر مقياس شكل هندسي بانتظام في جميع الأبعاد بمعامل معيّن.
- CG_3DScale — تغيّر مقياس شكل هندسي بمعاملات منفصلة على طول المحاور X وY وZ.
- CG_3DScaleAroundCenter — تغيّر مقياس شكل هندسي في الفضاء الثلاثي الأبعاد حول نقطة مركز محددة.
- CG_Translate — تُزيح (تنقل) شكلًا هندسيًا بإزاحات معيّنة في الفضاء الثنائي الأبعاد.
- CG_3DTranslate — تُزيح (تنقل) شكلًا هندسيًا بإزاحات معيّنة في الفضاء الثلاثي الأبعاد.
- CG_Simplify — تقلّل تعقيد الشكل الهندسي مع الحفاظ على سماته الأساسية وقيم Z/M.
- CG_3DAlphaWrapping — تحسب تغليف ألفا ثلاثي الأبعاد (Alpha-wrapping) يحيط بالشكل الهندسي إحاطة تامة.