GISarabia.org
PostGIS › الدليل الرسمي › 11. مرجع الرستر › 11.11. مُخرجات الرستر
PostGIS 3.6 · Official Manual · ترجمة عربية

ST_AsJPEG

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

الاسم

ST_AsJPEG — تُعيد النطاقات المحددة من بلاطة الرستر كصورة واحدة بصيغة Joint Photographic Exports Group (JPEG) (مصفوفة بايتات). إذا لم يُحدَّد نطاق وكان هناك نطاق واحد أو أكثر من 3 نطاقات، فيُستخدم النطاق الأول فقط. وإذا كانت هناك 3 نطاقات فقط فتُستخدم النطاقات الثلاثة جميعًا وتُربط بـ RGB.

المختصر

bytea ST_AsJPEG(raster rast, text[] options=NULL);

bytea ST_AsJPEG(raster rast, integer nband, integer quality);

bytea ST_AsJPEG(raster rast, integer nband, text[] options=NULL);

bytea ST_AsJPEG(raster rast, integer[] nbands, text[] options=NULL);

bytea ST_AsJPEG(raster rast, integer[] nbands, integer quality);

الوصف

تُعيد النطاقات المحددة من الرستر كصورة واحدة بصيغة Joint Photographic Exports Group (JPEG). استخدم ST_AsGDALRaster إذا كنت تحتاج إلى التصدير بأنواع رستر أقل شيوعًا. إذا لم يُحدَّد نطاق وكان هناك نطاق واحد أو أكثر من 3 نطاقات، فيُستخدم النطاق الأول فقط. وإذا كانت هناك 3 نطاقات فتُستخدم النطاقات الثلاثة جميعًا. للدالة أشكال عديدة بخيارات كثيرة، وهي مفصّلة أدناه:

  • nband لتصدير نطاق واحد.

  • nbands مصفوفة من النطاقات المراد تصديرها (لاحظ أن الحد الأقصى 3 لصيغة JPEG) وترتيب النطاقات هو RGB. مثلًا ARRAY[3,2,1] تعني ربط النطاق 3 بالأحمر والنطاق 2 بالأخضر والنطاق 1 بالأزرق

  • quality عدد من 0 إلى 100. كلما زاد العدد كانت الصورة أوضح.

  • options مصفوفة نصية من خيارات GDAL كما هي معرّفة لصيغة JPEG (انظر create_options لصيغة JPEG في ST_GDALDrivers). الخيارات الصالحة لصيغة JPEG هي PROGRESSIVE بقيمة ON أو OFF، وQUALITY بمدى من 0 إلى 100 وقيمة افتراضية 75. راجع خيارات صيغ رستر GDAL لمزيد من التفاصيل.

متاحة منذ: 2.0.0 - تتطلب GDAL >= 1.6.0.

أمثلة: الإخراج

-- output first 3 bands 75% quality
SELECT ST_AsJPEG(rast) As rastjpg
    FROM dummy_rast WHERE rid=2;

-- output only first band as 90% quality
SELECT ST_AsJPEG(rast,1,90) As rastjpg
    FROM dummy_rast WHERE rid=2;

-- output first 3 bands (but make band 2 Red, band 1 green, and band 3 blue, progressive and 90% quality
SELECT ST_AsJPEG(rast,ARRAY[2,1,3],ARRAY['QUALITY=90','PROGRESSIVE=ON']) As rastjpg
    FROM dummy_rast WHERE rid=2;