GISarabia.org
PostGIS › الدليل الرسمي › 11. مرجع الرستر › 11.3. منشئات الرستر
PostGIS 3.6 · Official Manual · ترجمة عربية

ST_MakeEmptyRaster

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

الاسم

ST_MakeEmptyRaster — تُعيد رسترًا فارغًا (بلا نطاقات) بالأبعاد المحددة (العرض & الارتفاع)، وX وY للزاوية العلوية اليسرى، وحجم البكسل والدوران (scalex وscaley وskewx & skewy)، والنظام المرجعي (srid). إذا مُرّر رستر، تُعيد رسترًا جديدًا بالحجم والمحاذاة وSRID نفسها. وإذا أُغفل srid، يُضبط النظام المرجعي المكاني على غير معروف (0).

المختصر

raster ST_MakeEmptyRaster(raster rast);

raster ST_MakeEmptyRaster(integer width, integer height, float8 upperleftx, float8 upperlefty, float8 scalex, float8 scaley, float8 skewx, float8 skewy, integer srid=unknown);

raster ST_MakeEmptyRaster(integer width, integer height, float8 upperleftx, float8 upperlefty, float8 pixelsize);

الوصف

تُعيد رسترًا فارغًا (بلا نطاق) بالأبعاد المحددة (العرض & الارتفاع)، مُسندًا جغرافيًا بالإحداثيات المكانية (أو العالمية) مع X للزاوية العلوية اليسرى (upperleftx)، وY للزاوية العلوية اليسرى (upperlefty)، وحجم البكسل والدوران (scalex وscaley وskewx & skewy)، والنظام المرجعي (srid).

تستخدم الصيغة الأخيرة معاملًا واحدًا لتحديد حجم البكسل (pixelsize). يُضبط scalex على هذا الوسيط ويُضبط scaley على القيمة السالبة له. ويُضبط skewx وskewy على 0.

إذا مُرّر رستر موجود، تُعيد رسترًا جديدًا بإعدادات البيانات الوصفية نفسها (بدون النطاقات).

إذا لم يُحدَّد srid فقيمته الافتراضية 0. بعد إنشاء رستر فارغ، سترغب على الأرجح في إضافة نطاقات إليه وربما تعديله. راجع ST_AddBand لتعريف النطاقات وST_SetValue لضبط القيم الأولية للبكسلات.

أمثلة

INSERT INTO dummy_rast(rid,rast)
VALUES(3, ST_MakeEmptyRaster( 100, 100, 0.0005, 0.0005, 1, 1, 0, 0, 4326) );

--use an existing raster as template for new raster
INSERT INTO dummy_rast(rid,rast)
SELECT 4, ST_MakeEmptyRaster(rast)
FROM dummy_rast WHERE rid = 3;

-- output meta data of rasters we just added
SELECT rid, (md).*
FROM (SELECT rid, ST_MetaData(rast) As md
    FROM dummy_rast
    WHERE rid IN(3,4)) As foo;

-- output --
 rid | upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands
-----+------------+------------+-------+--------+------------+------------+-------+-------+------+----------
   3 |     0.0005 |     0.0005 |   100 |    100 |          1 |          1 |    0  |     0 | 4326 |        0
   4 |     0.0005 |     0.0005 |   100 |    100 |          1 |          1 |    0  |     0 | 4326 |        0