Appliquez une transformation affine 3D à un objet meshgeom ou sfmesh pour le translater, le faire pivoter ou changer son échelle en une seule étape.
Syntaxe
meshgeom ST_Affine(meshgeom geom, float a, float b, float c, float d, float e, float f, float g, float h, float i, float xoff, float yoff, float zoff)
meshgeom ST_Affine(meshgeom geom, float[] p)
sfmesh ST_Affine(sfmesh sfmesh, float a, float b, float c, float d, float e, float f, float g, float h, float i, float xoff, float yoff, float zoff)
sfmesh ST_Affine(sfmesh sfmesh, float[] p)
sfmesh ST_Affine(float8[] p, float8[] p2)
Paramètres
| Paramètre | Description |
|---|---|
geom |
Objet meshgeom à transformer. |
sfmesh |
Objet sfmesh à transformer. |
a–i |
Valeurs des paramètres. |
xoff |
Décalage de translation le long de l'axe x. |
yoff |
Décalage de translation le long de l'axe y. |
zoff |
Décalage de translation le long de l'axe z. |
p |
Tableau de nombres flottants de 16 éléments représentant la matrice de transformation affine 4x4 complète. |
p2 |
Second tableau de nombres flottants de 16 éléments. Utilisé avec la signature sfmesh ST_Affine(float8[] p, float8[] p2) pour combiner deux matrices de transformation. |
Description
La fonction ST_Affine construit une matrice de transformation affine 4x4 et l'applique à chaque sommet de la géométrie d'entrée. Utilisez-la pour translater, faire pivoter, mettre à l'échelle ou combiner ces opérations en un seul appel.
Forme avec paramètres nommés — la matrice est :
/ a b c xoff \
| d e f yoff |
| g h i zoff |
\ 0 0 0 1 /
Chaque coordonnée de sortie est calculée comme suit :
x' = a*x + b*y + c*z + xoff
y' = d*x + e*y + f*z + yoff
z' = g*x + h*y + i*z + zoff
Forme avec tableau — transmettez un tableau de 16 éléments p au lieu des coefficients individuels. La matrice correspond à :
/ p[1] p[2] p[3] p[4] \
| p[5] p[6] p[7] p[8] |
| p[9] p[10] p[11] p[12] |
\ p[13] p[14] p[15] p[16] /
La transformation des coordonnées suit la même formule, en substituant p[n] au paramètre nommé correspondant :
x' = p[1]*x + p[2]*y + p[3]*z + p[4]
y' = p[5]*x + p[6]*y + p[7]*z + p[8]
z' = p[9]*x + p[10]*y + p[11]*z + p[12]
Exemples
Exemple 1 : Faire pivoter un meshgeom de 180 degrés autour de l'axe z (paramètres nommés)
cos(pi()) = -1 et sin(pi()) = 0, donc la matrice se réduit à une rotation de 180 degrés. Les coordonnées x et y sont inversées ; z reste inchangé.
SELECT ST_AsText(
ST_Affine(
'MESHGEOM(PATCH(INDEXSURFACE(VERTEX(0 0,0 10,10 10,10 0), INDEX((0,1,2),(1,2,3)))))'::meshgeom,
cos(pi()), -sin(pi()), 0,
sin(pi()), cos(pi()), 0,
0, 0, 1,
0, 0, 0
)
);
Résultat :
MESHGEOM(PATCH(INDEXSURFACE(VERTEX(0 0,0 -10,-10 -10,-10 0),INDEX((0,1,2),(1,2,3)))))
Exemple 2 : Même rotation utilisant un tableau de nombres flottants
Transmettez la même rotation de 180 degrés autour de l'axe z sous forme d'un tableau float8[] de 16 éléments au lieu d'utiliser des paramètres nommés.
SELECT ST_AsText(
ST_Affine(
'MESHGEOM(PATCH(INDEXSURFACE(VERTEX(0 0,0 10,10 10,10 0), INDEX((0,1,2),(1,2,3)))))'::meshgeom,
ARRAY[
cos(pi()), -sin(pi()), 0, 0,
sin(pi()), cos(pi()), 0, 0,
0, 0, 1, 0,
0, 0, 0, 0
]::float8[]
)
);
Résultat :
MESHGEOM(PATCH(INDEXSURFACE(VERTEX(0 0,0 -10,-10 -10,-10 0),INDEX((0,1,2),(1,2,3)))))
Exemple 3 : Combiner deux matrices de transformation sfmesh
Transmettez deux matrices float8[] pour calculer leur transformation combinée.
SELECT st_affine(
'{-0.3583679495453059,-0.9335804264971996,0,72.60910593620417,0.9335804264971996,-0.3583679495453059,0,82.98262879309624,0,0,1,96.52,0,0,0,1}'::float8[],
'{-0.3583679495453059,-0.9335804264971996,0,63.25570597150741,0.9335804264971996,-0.3583679495453059,0,107.3490699956786,0,0,1,87.92,0,0,0,1}'::float8[]
);
Résultat :
{-0.743144825477386,0.669130606358867,0,-50.2787022604891,-0.669130606358867,-0.743144825477386,0,103.566451652411,0,0,1,184.44,0,0,0,1}