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);
}

요구 사항

추가 정보

Bitmap

비트맵::GetPixel

색상

이미지

이미지, 비트맵 및 메타파일

이미지, 비트맵 및 메타파일 사용