描述

对几何图形应用 3D 仿射变换，以便一步完成平移、旋转和缩放等操作。

版本 1：调用

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

以下所有平移/缩放函数都是通过这种仿射变换来表达的。

版本 2：对几何图形应用 2D 仿射变换。 调用

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 方法的子情况。

增强功能：引入了对多面体表面、三角形和 TIN 的 2.0.0 支持。

可用性：1.1.2。 在 1.2.2 中将名称从 Affine 更改为 ST_Affine

此函数支持多面体表面。

此函数支持三角形和三角不规则网络表面 (TIN)。

此函数支持 3d，不会删除 z 索引。

此方法支持圆形字符串和曲线。

示例

--Rotate a 3d line 180 degrees about the z axis.  Note this is long-hand for doing ST_Rotate();
 SELECT ST_AsEWKT(ST_Affine(geom,  cos(pi()), -sin(pi()), 0,  sin(pi()), cos(pi()), 0,  0, 0, 1,  0, 0, 0)) As using_affine,
	 ST_AsEWKT(ST_Rotate(geom, pi())) As using_rotate
	FROM (SELECT ST_GeomFromEWKT('LINESTRING(1 2 3, 1 4 3)') As geom) As foo;
        using_affine         |        using_rotate
-----------------------------+-----------------------------
 LINESTRING(-1 -2 3,-1 -4 3) | LINESTRING(-1 -2 3,-1 -4 3)
(1 row)

--Rotate a 3d line 180 degrees in both the x and z axis
SELECT ST_AsEWKT(ST_Affine(geom, cos(pi()), -sin(pi()), 0, sin(pi()), cos(pi()), -sin(pi()), 0, sin(pi()), cos(pi()), 0, 0, 0))
	FROM (SELECT ST_GeomFromEWKT('LINESTRING(1 2 3, 1 4 3)') As geom) As foo;
           st_asewkt
-------------------------------
 LINESTRING(-1 -2 -3,-1 -4 -3)
(1 row)
		

另请参阅

ST_Rotate, ST_Scale, ST_Translate, ST_TransScale