변환 및 페이지 요소

이 가이드에서는 변환에 사용되는 기본 개념 (즉, 이동, 회전, 크기 조정 및 기울기 등 페이지 요소를 사용할 때 특히 관련 affine 변환 및 해당 작업에 대한 설명을 제공합니다.

아핀 변환을 사용하여 특정 결과를 얻는 방법에 대한 자세한 내용은 도형 크기 및 위치 지정 가이드를 참고하세요.

페이지 요소의 시각적 크기와 위치는 속성: size 및 transform 이상적인 크기 또는 기본 제공 크기를 설명하는 크기 페이지 요소의 하위 요소로 구성됩니다. 변환은 2차원 데이터 세트를 아핀 변환 행렬 기본 제공 크기의 객체가 변환되어 최종 시각적 디자인

아핀 변환을 통해 렌더링된 도형 다이어그램

Slides UI에서 페이지 요소를 선택하고 시각적 크기를 변경할 때 조정 핸들을 사용하면 실제로 이 변환 행렬을 업데이트하는 것입니다. 요소를 페이지에서 이동하거나 회전하면 변환 행렬입니다.

Slides UI를 사용하여 시작하기

페이지 요소를 변환하고 크기를 조절하는 데 사용하는 행렬 산술은 매우 강력하지만 처음에는 어려울 수 있습니다. 이 페이지의 대부분은 많은 시간을 할애합니다. 그러나 변환 및 변환의 사양을 단순화할 수 있습니다. 다음과 같은 방법을 사용하세요.

  1. Slides UI를 사용하여 페이지 요소를 만듭니다.
  2. Slides UI를 사용하여 이러한 페이지 요소의 크기를 원하는 대로 조정합니다.
  3. get 메서드를 사용하여 이러한 요소의 크기와 변환을 읽습니다.

이 정도면 시작하기에 충분할 수 있습니다. 이 가이드의 나머지 부분에서는 페이지 요소를 세부적으로 조작하는 데 사용할 수 있는 계산을 변형합니다.

아핀 변환 행렬

그래픽에 흔히 사용되는 2차원 아핀 변환 행렬 스케일, 회전, 기울기, 반사 및 좌표이동을 제어하는 요소 Slides API에서 페이지 요소의 변환은 3x3 행렬로 표현합니다.

$$A=\begin{bmatrix} scale\_x & shear\_x & translate\_x\\ shear\_y & scale\_y & translate\_y\\ 0 & 0 & 1 \end{bmatrix}$$

변환에 사용되는 매개변수는 다음과 같습니다.

translate_x 변환 매개변수는 이동 경로의 (X,Y) 위치를 페이지 요소의 왼쪽 상단 모서리를 기준으로 있습니다. 상대 위치를 단위 점 (pt) 또는 영어 미터법 (EMU) 중 하나입니다.
translate_y
scale_x scale 매개변수는 특정 시점에 페이지 요소의 크기를 있습니다. 이것들은 단위 없는 곱셈 계수입니다. 예: scale_x 값을 1.5로 설정하면 요소의 너비가 50% 확대됩니다.
scale_y
shear_x shear 매개변수도 단위가 없으며 페이지의 기울기를 제어합니다. 요소가 포함됩니다. scale 매개변수와 shear 매개변수를 함께 사용하여 페이지를 회전할 수 있음 요소가 포함됩니다.
shear_y

웹에서 2차원 변환 행렬이 그래픽 객체 렌더링에 영향을 줍니다.

변환 행렬은 요소가 포함됩니다. 예를 들어 직사각형이 포함된 그룹을 회전하면 그룹의 transform 필드 값은 회전을 반영하지만 직사각형의 transform는 필드 값이 포함되지 않습니다.

시각적 크기 계산 중

페이지 요소의 시각적 (렌더링된) 크기를 결정하려면 크기 및 변환 속성을 모두 함께 정의합니다. 이 데이터 세트에서 두 페이지 요소는 크기 속성을 비교하기만 하면 시각적으로 커집니다. 변환 행렬을 사용하여 요소의 경계를 매핑해야 하며 계산할 수 있습니다.

지점 매핑

변환 행렬을 사용하여 특정 지점을 매핑하려면 점 (x, y)를 변환합니다. 행렬 곱셈을 수행합니다. 다음과 같은 방법을 고려해 보세요. 점 p의 매핑입니다.

\[p' = Ap\]

다음과 같이 됩니다.

$$\begin{bmatrix} x'\\ y'\\ 1 \end{bmatrix} =\begin{bmatrix} scale\_x & shear\_x & translate\_x\\ shear\_y & scale\_y & translate\_y\\ 0 & 0 & 1 \end{bmatrix} \begin{bmatrix} x\\ y\\ 1 \end{bmatrix}$$

따라서 새 점 p'의 좌표는 다음과 같습니다.

$$x' = (scale\_x \times x) + (shear\_x \times y) + translate\_x\\ y' = (scale\_y \times y) + (shear\_y \times x) + translate\_y$$

경계 계산 중

변환 후 요소 경계 상자의 렌더링된 크기를 결정하기 위해 다음과 같은 형식을 사용합니다.

$$width' = (scale\_x \times width) + (shear\_x \times height)\\ height' = (scale\_y \times height) + (shear\_y \times width)$$

아핀 변환을 사용하여 특정 결과를 얻는 방법에 대한 자세한 내용은 도형 크기 및 위치 지정 가이드를 참고하세요.

제한사항

일부 크기 및 위치 지정 필드가 일부 페이지 유형과 호환되지 않습니다. 요소 아래 표에는 특정 페이지 요소와 크기 및 위치 지정 필드의 호환성이 요약되어 있습니다.

필드 도형 동영상 표
번역과 ✔ ✔ ✔
확장 ✔ ✔ 아니요**
전단 ✔ 아니요 아니요

** 표의 행 및 열 측정기준을 업데이트하려면 UpdateTableRowPropertiesRequest 및 UpdateTableColumnPropertiesRequest

페이지 요소에 자르기가 있으면 모든 크기 및 위치 지정 필드에서 예기치 않은 결과가 발생할 수 있습니다. 모든 제한사항은 변경될 수 있습니다. 최신 정보는 Google Slides API를 참고하세요.