Tous les produits
Search
Centre de documentation

PolarDB:ST_YupToZup

Dernière mise à jour :Oct 10, 2026

Inverse les axes Y et Z d'un objet sfmesh pour le convertir d'un système de coordonnées Y-up vers un système Z-up.

Syntaxe

sfmesh ST_YupToZup(sfmesh mesh);

Paramètres

Paramètre Description
mesh Objet sfmesh à convertir.

Valeur renvoyée

Renvoie l'objet sfmesh après inversion des axes Y et Z.

Description

La fonction ST_YupToZup permute les axes Y et Z de l'objet sfmesh en entrée. Utilisez cette fonction pour importer des modèles 3D utilisant une convention de coordonnées Y-up (tels que les assets provenant de certains outils de modélisation 3D) dans un pipeline qui attend une orientation Z-up (comme les workflows BIM ou GIS).

Cette transformation équivaut à appeler ST_Affine avec la matrice suivante. Cette matrice applique le mappage de coordonnées x' = x , y' = z , z' = -y . L'axe Y devient le nouvel axe Z, et l'axe Z d'origine (inversé) devient le nouvel axe Y.
1.0, 0,    0,   0,
0,   0,    1.0, 0,
0,   -1.0, 0,   0

Exemple

SELECT ST_AsText(ST_YupToZup(ST_MeshFromText('{"version" : 1, "root" : 0, "meshgeoms" : ["MESHGEOM(PATCH(INDEXSURFACE Z (VERTEX(0 0 2,0 10 3,10 10 1,10 0 1),INDEX((0,1,2),(1,2,3)))))"], "primitives" : [{"meshgeom" : 0}], "nodes" : [{"primitive" : 0}]}')));

Résultat :

{"version" : 1, "root" : 0, "meshgeoms" : ["MESHGEOM(PATCH(INDEXSURFACE Z (VERTEX(0 0 2,0 10 3,10 10 1,10 0 1),INDEX((0,1,2),(1,2,3)))))"], "primitives" : [{"meshgeom" : 0}], "nodes" : [{"primitive" : 0,"matrix" : [1,0,0,-1,0,0,0,0,1,0,0,0,0,0,0,1]}]}

Le nœud de sortie inclut un champ matrix qui encode la transformation d'inversion des axes. La géométrie du maillage reste inchangée ; la conversion est appliquée via la matrice du nœud du graphe de scène.