ST_Affine

对目标Geometry对象执行三维仿射变换,可同时完成平移、旋转、缩放等操作。

语法

geometry ST_Affine(geometry geomA , float a , float b , float c , float d , float e , float f , float g , float h , float i , float xoff , float yoff , float zoff);
geometry ST_Affine(geometry geomA , float a , float b , float d , float e , float xoff , float yoff);

参数

参数名称

描述

geomA

目标Geometry对象。

a

仿射变换参数。

b

仿射变换参数。

c

仿射变换参数。

d

仿射变换参数。

e

仿射变换参数。

f

仿射变换参数。

g

仿射变换参数。

h

仿射变换参数。

i

仿射变换参数。

xoff

仿射变换参数。

yoff

仿射变换参数。

zoff

仿射变换参数。

描述

  • 对于ST_Affine(geom, a, b, c, d, e, f, g, h, i, xoff, yoff, zoff)形式,代表如下变换矩阵:

    / a  b  c  xoff \
    | d  e  f  yoff |
    | g  h  i  zoff |
    \ 0  0  0     1 /
  • 顶点坐标的变换如下(所有的转换和缩放函数都通过这样的仿射变换来表示):

    x' = a*x + b*y + c*z + xoff
    y' = d*x + e*y + f*z + yoff
    z' = g*x + h*y + i*z + zoff
  • 对于ST_Affine(geom, a, b, d, e, xoff, yoff)形式,代表如下变换矩阵:

    /  a  b  0  xoff  \       /  a  b  xoff  \
    |  d  e  0  yoff  | rsp.  |  d  e  yoff  |
    |  0  0  1     0  |       \  0  0     1  /
    \  0  0  0     1  /
  • 顶点坐标的变换如下:

    x' = a*x + b*y + xoff
    y' = d*x + e*y + yoff
    z' = z

    本形式是3D模式的子模式。

  • 该函数支持Circular Strings、Curves、Polyhedral surfaces、Triangles、Triangulated Irregular Network Surfaces(TIN)和3D对象。

示例

在X轴,Y轴,Z轴同时180度翻转一个点:

SELECT ST_AsEWKT(ST_Affine(ST_GeomFromEWKT('POINT(1 2 3)'),
                           cos(pi()), -sin(pi()), 0, sin(pi()), cos(pi()), -sin(pi()), 0, sin(pi()), cos(pi()), 0, 0, 0));
    st_asewkt
-----------------
 POINT(-1 -2 -3)
(1 row)