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éesx' = 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.