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_AsImagerenvoie une valeurbytea.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
bandscontrô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;