TextureBrush::TextureBrush(Image,constRect&,constImageAttributes) 메서드(gdiplusbrush.h)

아티클
01/10/2024

이미지, 정의 사각형 및 이미지 속성 집합을 기반으로 TextureBrush 개체를 만듭니다.

구문

void TextureBrush(
  [in]      Image                 *image,
  [in, ref] const Rect &          dstRect,
  [in]      const ImageAttributes *imageAttributes
);

매개 변수

[in] image

형식: 이미지*

사용할 이미지의 비트맵을 포함하는 Image 개체에 대한 포인터입니다.

[in, ref] dstRect

형식: Rect

이 텍스처 브러시의 크기와 이 텍스처 브러시에서 사용할 이미지 부분을 정의하는 사각형에 대한 참조입니다. Image 개체가 메타파일에서 만들어진 경우 브러시는 브러시 크기에 맞게 크기가 조정되는 전체 이미지를 사용합니다.

[in] imageAttributes

형식: ImageAttributes*

선택 사항입니다. 이미지의 속성을 포함하는 ImageAttributes 개체에 대한 포인터입니다. 기본값은 NULL입니다.

반환 값

없음

설명

dstRect 사각형의 너비와 높이는 텍스처 브러시의 너비와 높이를 정의합니다. 텍스처 브러시는 항상 (0, 0)을 지향합니다. 사각형의 왼쪽 위 점, 너비 및 높이는 텍스처 브러시에서 사용할 이미지 부분의 시작점, 너비 및 높이를 지정합니다.

이 생성자가 비메타파일 이미지와 함께 dstRect 사각형을 사용하는 방법

dstRect 사각형의 크기가 브러시의 기반이 되는 이미지보다 작으면 브러시의 이미지가 잘립니다. 이는 이미지의 일부입니다. dstRect 사각형의 크기가 이미지의 차원과 같으면 브러시의 이미지가 이미지와 동일합니다. dstRect 사각형에는 이미지 차원 외부의 영역이 포함되어서는 안 됩니다. 이렇게 하면 예측할 수 없는 동작이 발생하거나 런타임 오류가 생성됩니다. 예를 들어 256×256픽셀의 이미지가 있고 이 이미지를 기반으로 TextureBrush 개체를 만들어 dstRect 매개 변수로 전달한다고 가정합니다. 브러시는 이미지의 왼쪽 아래 부분을 사용합니다. 이 부분의 왼쪽 아래 모서리도 이미지의 왼쪽 아래 모서리입니다. 이제 dstRect 매개 변수로 전달되는 동일한 이미지를 기반으로 다른 TextureBrush 개체를 만든다고 가정합니다. 이 사각형의 맨 위 좌표는 156이 아닌 157입니다. 이 사각형은 이미지 높이를 넘어 하나의 단위를 확장하며 액세스 위반이 발생할 가능성이 큽니다.

이 생성자가 메타파일 이미지와 함께 dstRect 사각형을 사용하는 방법

dstRect 사각형의 크기가 이미지와 다른 경우 브러시의 이미지는 사각형에 맞게 필요에 따라 더 작거나 크게 조정됩니다. 예를 들어 메타파일 이미지가 256×256픽셀이고 TextureBrush 개체를 만들어 dstRect 매개 변수로 전달한다고 가정합니다. 브러시의 이미지는 모든 메타파일 이미지를 포함하지만 브러시에 맞게 크기가 조정됩니다. 세로로 찌그러지고 가로로 늘어나게 됩니다. 사각형의 크기가 이미지와 같으면 브러시의 이미지가 이미지와 동일합니다.

요구 사항


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