Tous les produits
Search
Centre de documentation

:ST_Affine

Dernière mise à jour :Sep 24, 2026

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}