System.Drawing.Imaging 네임스페이스

고급 GDI+ 이미징 기능을 제공합니다. 기본 그래픽 기능은 System.Drawing 네임스페이스가 제공합니다.

클래스

BitmapData	비트맵 이미지의 특성을 지정합니다. BitmapData 클래스는 LockBits 클래스의 UnlockBits(BitmapData) 및 Bitmap 메서드에서 사용됩니다. 상속할 수 없습니다.
CachedBitmap	지정된 Graphics 개체의 Bitmap 현재 디바이스(표시) 설정과 일치하는 디바이스 종속 복사본을 나타냅니다. 렌더링 시 다시 포맷 단계를 방지하여 성능을 크게 향상시킬 수 있습니다.
ColorMap	색을 변환하기 위한 맵을 정의합니다. ImageAttributes 클래스의 여러 메서드는 ColorMap 구조체의 배열인 색 매핑 변경 테이블을 사용하여 이미지 색을 조정합니다. 상속할 수 없습니다.
ColorMatrix	RGBAW 공간의 좌표를 포함하는 5x5 매트릭스를 정의합니다. ImageAttributes 클래스의 여러 메서드는 색 매트릭스를 사용하여 이미지 색을 조정합니다. 이 클래스는 상속될 수 없습니다.
ColorPalette	색상표를 구성하는 색 배열을 정의합니다. 해당 색들은 32비트 ARGB 색입니다. 상속할 수 없습니다.
Encoder	Encoder 개체는 이미지 인코더 매개 변수의 범주를 식별하는 GUID(Globally Unique Identifier)를 캡슐화합니다.
EncoderParameter	값 또는 값 배열을 이미지 인코더에 전달하는 데 사용됩니다.
EncoderParameters	EncoderParameter 개체의 배열을 캡슐화합니다.
FrameDimension	이미지의 프레임 크기를 가져오는 속성을 제공합니다. 상속할 수 없습니다.
ImageAttributes	렌더링하는 동안 비트맵과 메타파일 색을 조작하는 방법에 대한 정보가 들어 있습니다.
ImageCodecInfo	ImageCodecInfo 클래스는 설치된 이미지 인코더 및 디코더(코덱이라고 함)의 관련 정보를 모두 검색하는 데 필요한 스토리지 멤버 및 메서드를 제공합니다. 상속할 수 없습니다.
ImageFormat	이미지의 파일 형식을 지정합니다. 상속할 수 없습니다.
Metafile	그래픽 메타파일을 정의합니다. 메타파일에는 기록(생성) 및 재생(표시)할 수 있는 그래픽 작업 시퀀스를 설명하는 레코드가 들어 있습니다. 이 클래스는 상속될 수 없습니다.
MetafileHeader	관련된 Metafile의 특성을 포함합니다. 상속할 수 없습니다.
MetaHeader	Windows 메타파일(WMF)에 대한 정보를 포함합니다.
PropertyItem	메타데이터 속성을 캡슐화하여 이미지 파일에 포함시킵니다. 상속할 수 없습니다.
WmfPlaceableFileHeader	배치 가능한 메타파일을 정의합니다. 상속할 수 없습니다.

열거형

ColorAdjustType	색 조정 정보를 사용하는 GDI+ 개체를 지정합니다.
ColorChannelFlag	개별 채널을 CMYK(녹청, 자홍, 노랑, 검정) 색 공간에 지정합니다. 이 열거형은 SetOutputChannel 메서드에서 사용됩니다.
ColorMapType	색상 맵의 형식을 지정합니다.
ColorMatrixFlag	ImageAttributes의 색 및 회색조 조정 설정의 영향을 받을 색 및 이미지의 형식을 지정합니다.
ColorMode	색 구성 요소 값에 대해 두 가지 모드를 지정합니다.
EmfPlusRecordType	그래픽 명령을 읽고 쓰기 위해 메타파일에 사용할 수 있는 메서드를 지정합니다.
EmfType	확장 메타파일(EMF) 파일에 배치되는 레코드의 속성을 지정합니다. 이 열거형은 Metafile 클래스의 여러 생성자가 사용합니다.
EncoderParameterValueType	이미지의 Save 또는 SaveAdd 메서드와 함께 사용되는 EncoderParameter의 데이터 형식을 지정합니다.
EncoderValue	Save(String, ImageCodecInfo, EncoderParameters) 또는 SaveAdd(EncoderParameters) 메서드를 사용할 때 JPEG 또는 TIFF 이미지 인코더에 전달되는 매개 변수 값을 지정하는 데 사용됩니다.
ImageCodecFlags	이미지 코덱(인코더/디코더)의 특성을 제공합니다.
ImageFlags	Image 개체에 포함된 픽셀 데이터의 특성을 지정합니다. Flags 속성은 이 열거형의 멤버를 반환합니다.
ImageLockMode	LockBits 메서드의 플래그 매개 변수에 전달되는 플래그를 지정합니다. LockBits 메서드는 픽셀 데이터를 읽거나 쓸 수 있도록 이미지 부분을 잠급니다.
MetafileFrameUnit	메타파일의 크기 및 위치를 지정하는 데 사용되는 영역 단위를 지정합니다. 단위는 Metafile 개체를 만드는 동안에 지정됩니다.
MetafileType	메타파일의 형식을 지정합니다. Type 속성은 이 열거형의 멤버를 반환합니다.
PaletteFlags	시스템 색상표에 있는 색 데이터의 형식을 지정합니다. 알파 데이터, 회색조 데이터만 또는 하프톤 데이터를 사용할 수 있습니다.
PixelFormat	이미지의 각 픽셀에 대한 색 데이터의 형식을 지정합니다.

대리자

PlayRecordCallback

이 대리자는 사용되지 않습니다. 메타파일의 레코드를 열거하는 예제는 EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc)을 참조하십시오.

설명

주의

System.Drawing 네임스페이스에는 특정 운영 체제 및 애플리케이션 유형에 대한 몇 가지 제한 사항이 있습니다.

• Windows에서 는 System.Drawing OS의 일부로 제공되는 GDI+ 네이티브 라이브러리에 따라 달라집니다. Windows Server Core 또는 Windows Nano와 같은 일부 Windows SKU는 이 네이티브 라이브러리를 OS의 일부로 포함하지 않습니다. 이 네임스페이스를 사용하고 라이브러리를 로드할 수 없는 경우 런타임에 예외가 throw됩니다.

• 네임스페이스의 System.Drawing 일부 형식은 Windows 서비스 및 ASP.NET Core 및 ASP.NET 앱에서 지원되지 않는 GDI+를 사용합니다. 이러한 형식은 System.Drawing.Common NuGet 패키지에 있으며 및 를 System.Drawing.Font포함합니다System.Drawing.Bitmap. 그러나 네임스페이스의 기본 형식(예: System.Drawing.Color, System.Drawing.Size, System.Drawing.Point및 System.Drawing.Rectangle)은 모든 애플리케이션에서 사용할 수 있습니다.

• .NET 5 및 이전 버전에서 System.Drawing.Common NuGet 패키지는 Windows, Linux 및 macOS에서 작동합니다. 그러나 몇 가지 플랫폼 차이점이 있습니다. Linux 및 macOS에서 GDI+ 기능은 libgdiplus) 라이브러리에 의해 구현됩니다. 이 라이브러리는 대부분의 Linux 배포판에 기본적으로 설치되지 않으며 Windows 및 macOS에서 GDI+의 모든 기능을 지원하지 않습니다. libgdiplus를 전혀 사용할 수 없는 플랫폼도 있습니다. Linux 및 macOS의 System.Drawing.Common 패키지에서 형식을 사용하려면 libgdiplus를 별도로 설치해야 합니다. 자세한 내용은 Linux에 .NET 설치 또는 macOS에 .NET 설치를 참조하세요.

• .NET 6 이상 버전에서는 System.Drawing.Common NuGet 패키지가 Windows 운영 체제에서만 지원됩니다. 자세한 내용은 Windows에서만 지원되는 System.Drawing.Common을 참조하세요.

애플리케이션에서 사용할 System.Drawing 수 없는 경우 권장되는 대안으로 는 ImageSharp, SkiaSharp, Windows 이미징 구성 요소 및 Microsoft.Maui.Graphics가 있습니다.

Metafile 클래스는 기록 및 메타 파일을 저장 하기 위한 메서드를 제공 합니다. Encoder 클래스를 사용 하면 사용자가를 확장할 GDI + 모든 이미지 형식을 지원 합니다. PropertyItem 클래스를 저장 하 고 이미지 파일의 메타 데이터 검색 메서드를 제공 합니다.

주의

내에서 클래스를 System.Drawing.Imaging 네임 스페이스는 Windows 또는 ASP.NET 서비스 내에서 사용 하 여 지원 되지 않습니다. 이러한 애플리케이션 형식 중 하나에서 이러한 클래스를 사용 하는 동안 예기치 않은 문제가 발생할 수 있습니다, 그리고 감소와 같은 서비스 성능 및 런타임 예외입니다.

추가 정보

• Windows Forms의 그래픽 및 그리기
• 이미지, 비트맵 및 메타파일
• 이미지, 비트맵, 아이콘 및 메타파일 사용
• 관리형 GDI+에서 이미지 인코더 및 디코더 사용
• 이미지 다시 칠하기