Bitmap::GetPixel 메서드(gdiplusheaders.h)
Bitmap::GetPixel 메서드는 이 비트맵에서 지정된 픽셀의 색을 가져옵니다.
구문
Status GetPixel(
[in] INT x,
[in] INT y,
[out] Color *color
);
매개 변수
[in] x
형식: INT
픽셀의 x 좌표(열)를 지정하는 정수입니다.
[in] y
형식: INT
픽셀의 y 좌표(행)를 지정하는 정수입니다.
[out] color
형식: 색*
지정한 픽셀의 색을 받는 Color 개체에 대한 포인터입니다.
반환 값
형식: 상태
메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.
메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.
설명
비트맵의 형식에 따라 Bitmap::GetPixel은 Bitmap::SetPixel에서 설정한 것과 동일한 값을 반환하지 않을 수 있습니다. 예를 들어 픽셀 형식이 32bppPARGB인 Bitmap 개체에서 Bitmap::SetPixel을 호출하는 경우 픽셀의 RGB 구성 요소는 미리 곱합니다. Bitmap::GetPixel에 대한 후속 호출은 반올림으로 인해 다른 값을 반환할 수 있습니다. 또한 색상 깊이가 픽셀당 16비트인 Bitmap 개체에서 Bitmap::SetPixel을 호출하는 경우 32비트에서 16비트로 변환하는 동안 정보가 손실될 수 있으며 나중에 Bitmap::GetPixel을 호출하면 다른 값이 반환될 수 있습니다.
예제
다음 예제에서는 JPEG 파일을 기반으로 Bitmap 개체를 만듭니다. 코드는 Bitmap::GetPixel 메서드를 호출하여 비트맵에서 픽셀의 색을 가져온 다음 검색된 색으로 사각형을 채웁니다.
VOID Example_GetPixel(HDC hdc)
{
Graphics graphics(hdc);
// Create a Bitmap object from a JPEG file.
Bitmap myBitmap(L"Climber.jpg");
// Get the value of a pixel from myBitmap.
Color pixelColor;
myBitmap.GetPixel(25, 25, &pixelColor);
// Fill a rectangle with the pixel color.
SolidBrush brush(pixelColor);
graphics.FillRectangle(&brush, Rect(0, 0, 100, 100));
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP, Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | gdiplusheaders.h(Gdiplus.h 포함) |
| 라이브러리 | Gdiplus.lib |
| DLL | Gdiplus.dll |