名前

ST_RotateZ — ジオメトリーを Z 軸について回転させます。

概要

geometry ST_RotateZ(geometry geomA, float rotRadians);

説明

ジオメトリー geomA を Z 軸について rotRadians ぶん回転させます。

[注記]

この関数は ST_Rotate と同じです。

[注記]

ST_RotateZ(geomA, rotRadians)SELECT ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)の短縮版です。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN 対応が導入されました。

Availability: 1.1.2 1.2.2で RotateZ から ST_RotateZ に名称変更しました。

[注記]

1.3.4より前では、曲線を含むジオメトリーで使用すると、この関数はクラッシュします。これは 1.3.4以上で訂正されています。

この関数は3次元に対応し、Z値を削除しません。

このメソッドは曲線ストリングと曲線に対応しています。

この関数は多面体サーフェスに対応しています。

この関数は三角形と不規則三角網 (TIN) に対応しています。

この例ではラインを Z 軸周りに 90°回転させます。

コード
SELECT ST_RotateZ('LINESTRING(1 2 3,1 1 1)', pi()/2);
出力
LINESTRING(-2 1 3,-1 1 1)
Geometry figure for visual-st-rotatez-01

この例では曲線円を Z 軸周りに回転させます。

コード
SELECT ST_RotateZ(geom, pi()/2)
FROM (SELECT ST_LineToCurve(ST_Buffer('POINT(234 567)'::geometry, 3)) As geom) As foo;
出力
CURVEPOLYGON(CIRCULARSTRING(-567 237.00000000000003,-567 231.00000000000003,-567 237.00000000000003))
Geometry figure for visual-st-rotatez-02