Bitmap::SetPixel 메서드(gdiplusheaders.h)
Bitmap::SetPixel 메서드는 이 비트맵에서 지정된 픽셀의 색을 설정합니다.
구문
Status SetPixel(
[in] INT x,
[in] INT y,
[in, ref] const Color & color
);
매개 변수
[in] x
형식: INT
픽셀의 x 좌표(열)를 지정하는 int입니다.
[in] y
형식: INT
픽셀의 y 좌표(행)를 지정하는 int입니다.
[in, ref] color
형식: const 색
설정할 색을 지정하는 Color 개체에 대한 참조입니다.
반환 값
형식: 상태
메서드가 성공하면 Status 열거형의 요소인 확인을 반환합니다.
메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.
설명
비트맵의 형식에 따라 Bitmap::GetPixel은 Bitmap::SetPixel에서 설정한 것과 동일한 값을 반환하지 않을 수 있습니다. 예를 들어 픽셀 형식이 32bppPARGB인 Bitmap 개체에서 Bitmap::SetPixel을 호출하는 경우 RGB 구성 요소는 미리 곱합니다. 비트맵::GetPixel에 대한 후속 호출은 반올림으로 인해 다른 값을 반환할 수 있습니다. 또한 색상 깊이가 픽셀당 16비트인 비트맵에서 Bitmap::SetPixel을 호출하는 경우 32비트에서 16비트로 변환할 때 정보가 손실될 수 있으며 Bitmap::GetPixel에 대한 후속 호출은 다른 값을 반환할 수 있습니다.
예제
다음 예제에서는 JPEG 파일을 기반으로 Bitmap 개체를 만듭니다. 코드는 변경되지 않은 비트맵을 그립니다. 그런 다음 코드는 Bitmap::SetPixel 메서드를 호출하여 비트맵에 검은색 픽셀의 체크 무늬를 만들고 변경된 비트맵을 그립니다.
VOID Example_SetPixel(HDC hdc)
{
Graphics graphics(hdc);
// Create a Bitmap object from a JPEG file.
Bitmap myBitmap(L"Climber.jpg");
// Draw the bitmap.
graphics.DrawImage(&myBitmap, 0, 0);
// Create a checkered pattern with black pixels.
for (UINT row = 0; row < myBitmap.GetWidth(); row += 2)
{
for (UINT col = 0; col < myBitmap.GetHeight(); col += 2)
{
myBitmap.SetPixel(row, col, Color(255, 0, 0, 0));
}
}
// Draw the altered bitmap.
graphics.DrawImage(&myBitmap, 200, 0);
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP, Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | gdiplusheaders.h(Gdiplus.h 포함) |
| 라이브러리 | Gdiplus.lib |
| DLL | Gdiplus.dll |