الاسم
ST_AsPNG — تُعيد النطاقات المحددة من بلاطة الرستر كصورة واحدة بصيغة Portable Network Graphics (PNG) (مصفوفة بايتات). إذا كان في الرستر 1 أو 3 أو 4 نطاقات ولم تُحدَّد نطاقات، فتُستخدم جميع النطاقات. وإذا كان هناك نطاقان أو أكثر من 4 نطاقات ولم تُحدَّد نطاقات، فيُستخدم النطاق 1 فقط. تُربط النطاقات بفضاء RGB أو RGBA.
المختصر
bytea ST_AsPNG(raster rast, text[] options=NULL);
bytea ST_AsPNG(raster rast, integer nband, integer compression);
bytea ST_AsPNG(raster rast, integer nband, text[] options=NULL);
bytea ST_AsPNG(raster rast, integer[] nbands, integer compression);
bytea ST_AsPNG(raster rast, integer[] nbands, text[] options=NULL);
الوصف
تُعيد النطاقات المحددة من الرستر كصورة واحدة بصيغة Portable Network Graphics (PNG). استخدم ST_AsGDALRaster إذا كنت تحتاج إلى التصدير بأنواع رستر أقل شيوعًا. إذا لم يُحدَّد نطاق، فتُصدَّر النطاقات الثلاثة الأولى. للدالة أشكال عديدة بخيارات كثيرة. إذا لم يُحدَّد srid فيُستخدم srid الرستر. وهي مفصّلة أدناه:
-
nbandلتصدير نطاق واحد. -
nbandsمصفوفة من النطاقات المراد تصديرها (لاحظ أن الحد الأقصى 4 لصيغة PNG) وترتيب النطاقات هو RGBA. مثلًا ARRAY[3,2,1] تعني ربط النطاق 3 بالأحمر والنطاق 2 بالأخضر والنطاق 1 بالأزرق -
compressionعدد من 1 إلى 9. كلما زاد العدد زاد الضغط. -
optionsمصفوفة نصية من خيارات GDAL كما هي معرّفة لصيغة PNG (انظر create_options لصيغة PNG في ST_GDALDrivers). الخيار الصالح الوحيد لصيغة PNG هو ZLEVEL (مقدار الوقت المخصص للضغط -- الافتراضي 6) مثلًا ARRAY['ZLEVEL=9']. لا يُسمح بـ WORLDFILE لأن الدالة ستضطر حينها إلى إنتاج مُخرَجين. راجع خيارات صيغ رستر GDAL لمزيد من التفاصيل.
متاحة منذ: 2.0.0 - تتطلب GDAL >= 1.6.0.
أمثلة
SELECT ST_AsPNG(rast) As rastpng
FROM dummy_rast WHERE rid=2;
-- export the first 3 bands and map band 3 to Red, band 1 to Green, band 2 to blue
SELECT ST_AsPNG(rast, ARRAY[3,1,2]) As rastpng
FROM dummy_rast WHERE rid=2;