الاسم
ST_Force3D — فرض وضع XYZ على الأشكال الهندسية. وهي اسم بديل لـ ST_Force3DZ.
المختصر
geometry ST_Force3D(geometry geomA, float Zvalue = 0.0);
الوصف
تفرض على الأشكال الهندسية وضع XYZ. وهي اسم بديل لـ ST_Force3DZ. إذا لم يكن للشكل مكوّن Z، فيُضاف إليه إحداثي Z بقيمة Zvalue.
حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه.
تغيّرت في: 2.1.0. حتى الإصدار 2.0.x كانت تُسمّى ST_Force_3D.
تغيّرت في: 3.1.0. أُضيف دعم تمرير قيمة Z غير صفرية.
تدعم هذه الدالة الأسطح متعددة الوجوه (Polyhedral surfaces).
تدعم هذه الدالة الأقواس الدائرية (Circular Strings) والمنحنيات.
تدعم هذه الدالة الأبعاد الثلاثية ولا تُسقط قيمة Z.
أمثلة
--Nothing happens to an already 3D geometry
SELECT ST_AsEWKT(ST_Force3D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
st_asewkt
-----------------------------------------------
CIRCULARSTRING(1 1 2,2 3 2,4 5 2,6 7 2,5 6 2)
SELECT ST_AsEWKT(ST_Force3D('POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))'));
st_asewkt
--------------------------------------------------------------
POLYGON((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))