GISarabia.org
PostGIS › الدليل الرسمي › 7. مرجع PostGIS › 7.5. دوال تحرير الأشكال الهندسية
PostGIS 3.6 · Official Manual · ترجمة عربية

ST_Force3DM

الصفحة الأصلية بالإنجليزية postgis.net ↗

الاسم

ST_Force3DM — فرض وضع XYM على الأشكال الهندسية.

المختصر

geometry ST_Force3DM(geometry geomA, float Mvalue = 0.0);

الوصف

تفرض على الأشكال الهندسية وضع XYM. إذا لم يكن للشكل مكوّن M، فيُضاف إليه إحداثي M بقيمة Mvalue. وإذا كان له مكوّن Z، فيُزال Z

تغيّرت في: 2.1.0. حتى الإصدار 2.0.x كانت تُسمّى ST_Force_3DM.

تغيّرت في: 3.1.0. أُضيف دعم تمرير قيمة M غير صفرية.

تدعم هذه الدالة الأقواس الدائرية (Circular Strings) والمنحنيات.

أمثلة

--Nothing happens to an already 3D geometry
SELECT ST_AsEWKT(ST_Force3DM(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
                                   st_asewkt
------------------------------------------------
 CIRCULARSTRINGM(1 1 0,2 3 0,4 5 0,6 7 0,5 6 0)


SELECT  ST_AsEWKT(ST_Force3DM('POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 1,1 3 1,1 1 1))'));

                                                  st_asewkt
---------------------------------------------------------------
 POLYGONM((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))