Bitmap::ConvertFormat 메서드(gdiplusheaders.h)

Bitmap::ConvertFormat 메서드는 비트맵을 지정된 픽셀 형식으로 변환합니다. 비트맵의 원래 픽셀 데이터는 새 픽셀 데이터로 대체됩니다.

구문

Status ConvertFormat(
  [in] PixelFormat  format,
  [in] DitherType   dithertype,
  [in] PaletteType  palettetype,
  [in] ColorPalette *palette,
  [in] REAL         alphaThresholdPercent
);

매개 변수

[in] format

형식: PixelFormat

새 픽셀 형식을 지정하는 픽셀 형식 상수입니다.

[in] dithertype

형식: DitherType

디더링 알고리즘을 지정하는 DitherType 열거형의 요소입니다. 변환이 픽셀 데이터의 비트 깊이를 줄이지 않는 경우 DitherTypeNone을 전달합니다.

[in] palettetype

형식: PaletteType

디더링에 사용할 표준 팔레트를 지정하는 PaletteType 열거형의 요소입니다. 인덱싱되지 않은 형식으로 변환하는 경우 이 매개 변수는 무시됩니다. 이 경우 PaletteType 열거형의 모든 요소(예: PaletteTypeCustom)를 전달합니다.

[in] palette

형식: ColorPalette*

인덱스가 변환된 비트맵의 픽셀 데이터에 저장되는 색상표를 지정하는 ColorPalette 구조체에 대한 포인터입니다. 이 색상표(실제 색상표라고 함)에는 palettetype 매개 변수로 지정된 형식이 있을 필요가 없습니다. palettetype 매개 변수는 순서가 지정된 또는 나선형 디더링 알고리즘에서 사용할 수 있는 표준 팔레트를 지정합니다. 실제 색상표에 palettetype 매개 변수로 지정된 형식이 아닌 다른 형식이 있는 경우 Bitmap::ConvertFormat 메서드는 표준 색상표에서 실제 색상표로 가장 가까운 색 변환을 수행합니다.

[in] alphaThresholdPercent

형식: REAL

원본 비트맵에서 변환된 비트맵의 투명한 색에 매핑할 픽셀을 지정하는 범위 0부터 100까지의 실제 숫자입니다. 값 0은 원본 픽셀이 투명 색에 매핑되지 않음을 지정합니다. 값 100은 완전히 불투명하지 않은 모든 픽셀이 투명 색에 매핑되도록 지정합니다. t 값은 전체 불투명의 t% 미만의 소스 픽셀이 투명 색에 매핑되도록 지정합니다. 알파 임계값이 적용되려면 색상표에 투명한 색이 있어야 합니다. 색상표에 투명한 색이 없는 경우 알파 값이 임계값 미만인 픽셀은 일반적으로 검은색과 가장 일치하는 색(0, 0, 0, 0)에 매핑됩니다.

반환 값

형식: 상태

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

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

요구 사항

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

참고 항목

Bitmap

비트맵::InitializePalette