Tous les produits
Search
Centre de documentation

PolarDB:ST_AsImage

Dernière mise à jour :Aug 22, 2026

Convertit un objet raster en image bytea dans une étendue géographique ou pixel spécifiée. Si le paramètre bands n'est pas indiqué, la fonction utilise les trois premières bandes et définit par défaut le format de sortie sur PNG.

Syntaxe

bytea ST_AsImage(raster raster_obj,
        box extent,
        integer pyramidLevel default 0,
        cstring bands default '',
        cstring format default 'PNG',
        cstring option default '');

Paramètres

Paramètre Type Par défaut Description
raster_obj raster — L'objet raster à convertir.
extent box — L'étendue spatiale de l'image de sortie. Par défaut, utilise le système de coordonnées géographiques.
pyramidLevel integer 0 Le niveau de pyramide à lire. Les valeurs valides commencent à 0.
bands cstring '' Les bandes à inclure dans la sortie. Accepte des plages ('0-2') et des listes séparées par des virgules ('1,2,3'). Si ce champ est vide, la fonction utilise les trois premières bandes. Nombre de bandes pris en charge : PNG prend en charge 1, 2, 3 ou 4 bandes ; JPEG prend en charge 1 ou 3 bandes.
format cstring 'PNG' Le format de l'image de sortie. Valeurs valides : PNG, JPEG.
option cstring '' Une chaîne JSON contenant des options de rendu supplémentaires. Consultez la section Champs d'option.

Champs d'option

Champ Type Par défaut Description
nodata bool false Contrôle la gestion des valeurs NoData. true : traite les valeurs NoData. false : traite les valeurs NoData comme des valeurs normales.
nodataValue integer 0 La valeur NoData du raster. Obligatoire lorsque nodata est défini sur true.
rast_coord bool false Indique si la boîte extent utilise des coordonnées pixel au lieu de coordonnées géographiques. Lorsque la valeur est true, l'axe x correspond au numéro de colonne et l'axe y au numéro de ligne, tous deux commençant à 0.
strength string 'none' Mode d'amélioration de l'affichage. none : aucune amélioration. stats : applique un étirement basé sur les valeurs statistiques.
quality integer 75 La qualité de la compression. Valeurs valides : 1–100.

Remarques d'utilisation

  • La fonction ST_AsImage renvoie une valeur bytea.

  • Par défaut, jusqu'à 100 Mo de données découpées peuvent être mises en cache par requête. Pour ajuster cette limite, définissez le paramètre ganos.raster.clip_max_buffer_size.

  • Le paramètre bands contrôle les bandes incluses dans l'image de sortie. Les nombres de bandes suivants sont pris en charge :

    • 1 : bande unique — exportée sous forme d'image en niveaux de gris.

    • 2 : bande unique + bande Alpha — exportée sous forme d'image en niveaux de gris avec transparence.

    • 3 : bande R, bande G et bande B — exportée sous forme d'image RGB.

    • 4 : bande R, bande G, bande B et bande Alpha — exportée sous forme d'image RGBA.

Exemples

Tous les exemples lisent les données depuis une raster_table et filtrent selon id = 1. L'étendue géographique '(-180,-90), (0,0)'::box couvre le quadrant inférieur gauche du globe.

Exportation avec les paramètres par défaut

SELECT ST_AsImage(raster_obj,
                  '(-180,-90), (0,0)'::box)
FROM raster_table
WHERE id = 1;

Exportation depuis un niveau de pyramide spécifique

SELECT ST_AsImage(raster_obj,
                  '(-180,-90), (0,0)'::box,
                  1)
FROM raster_table
WHERE id = 1;

Exportation des bandes 0, 1 et 2

SELECT ST_AsImage(raster_obj,
                  '(-180,-90), (0,0)'::box,
                  1,
                  '0-2')
FROM raster_table
WHERE id = 1;

Exportation au format PNG avec format explicite

SELECT ST_AsImage(raster_obj,
                  '(-180,-90), (0,0)'::box,
                  1,
                  '0-2',
                  'PNG')
FROM raster_table
WHERE id = 1;

Exportation avec amélioration de l'affichage basée sur les statistiques

SELECT ST_AsImage(rast,
                  '(-180,-90), (0,0)'::box,
                  0,
                  '',
                  'PNG',
                  '{"nodata":"false","nodatavalue":"0","rast_coord":"false","strength":"stats","quality":"75"}')
FROM raster_table
WHERE id = 1;

Exportation d'une région en coordonnées pixel avec amélioration de l'affichage

Utilisez rast_coord: true pour spécifier l'étendue en coordonnées pixel plutôt qu'en coordonnées géographiques.

SELECT ST_AsImage(rast,
                  '(0,0), (200,100)'::box,
                  0,
                  '',
                  'PNG',
                  '{"nodata":"false","nodatavalue":"0","rast_coord":"true","strength":"stats","quality":"75"}')
FROM raster_table
WHERE id = 1;