LinearGradientBrush::ScaleTransform 메서드(gdiplusbrush.h)

아티클
08/23/2023

LinearGradientBrush::ScaleTransform 메서드는 이 브러시의 현재 변환 매트릭스를 자체의 제품 및 크기 조정 매트릭스로 업데이트합니다.

구문

Status ScaleTransform(
  [in] REAL        sx,
  [in] REAL        sy,
  [in] MatrixOrder order
);

매개 변수

[in] sx

형식: REAL

x 방향으로 크기를 조정할 크기를 지정하는 실수입니다.

[in] sy

형식: REAL

y 방향으로 스케일링할 크기를 지정하는 실수입니다.

[in] order

형식: MatrixOrder

선택 사항입니다. 곱하기 순서를 지정하는 MatrixOrder 열거형의 요소입니다. MatrixOrderPrepend는 크기 조정 행렬이 왼쪽에 있음을 지정하고 MatrixOrderAppend는 크기 조정 행렬이 오른쪽에 있음을 지정합니다. 기본값은 MatrixOrderPrepend입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

단일 3 ×3 행렬은 모든 일련의 아핀 변환을 저장할 수 있습니다. 각각 아핀 변환을 나타내는 3개의 ×3 행렬이 여러 개 있는 경우 이러한 행렬의 곱은 전체 변환 시퀀스를 나타내는 단일 3 ×3 행렬입니다. 해당 제품이 나타내는 변환을 복합 변환이라고 합니다. 예를 들어 행렬 T가 변환을 나타내고 행렬 S가 크기 조정을 나타낸다고 가정합니다. 행렬 M이 제품 TS인 경우 행렬 M은 복합 변환을 나타냅니다. 먼저 변환한 다음 배율을 조정합니다.

행렬 곱셈 순서가 중요합니다. 일반적으로 행렬 제품 RT는 행렬 제품 TR과 동일하지 않습니다. 이전 단락에 제공된 예제에서 RT로 표시되는 복합 변환(첫 번째 회전, 변환)은 TR(첫 번째 변환, 회전)으로 표시되는 복합 변환과 다릅니다.

예제

다음 예제에서는 선형 그라데이션 브러시를 만들고 이를 사용하여 사각형을 채웁니다. 다음으로, 코드는 브러시의 변환 매트릭스를 수정하고 복합 변환을 적용한 다음 변환된 브러시로 사각형을 채웁니다.

VOID Example_ScaleTrans(HDC hdc)
{
   Graphics myGraphics(hdc);

   LinearGradientBrush linGrBrush(
      Rect(0, 0, 80, 40),
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 0, 255),  // blue
      LinearGradientModeHorizontal);

   // Fill a large area with the linear gradient brush (no transformation).
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 150);

   // Apply a composite transformation: first translate, then scale.
   linGrBrush.TranslateTransform(60, 0);            // horizontal translation
   linGrBrush.ScaleTransform(2, MatrixOrderAppend); // horizontal doubling

   // Fill a large area with the transformed linear gradient brush.
   myGraphics.FillRectangle(&linGrBrush, 0, 200, 800, 150);  
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	gdiplusbrush.h(Gdiplus.h 포함)
라이브러리	Gdiplus.lib
DLL	Gdiplus.dll