System.Drawing.Imaging 네임스페이스
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
고급 GDI+ 이미징 기능을 제공합니다. 기본 그래픽 기능은 네임스페이 System.Drawing 스에서 제공됩니다.
클래스
| Name | Description |
|---|---|
| BitmapData |
비트맵 이미지의 특성을 지정합니다. 클래스는 BitmapData 클래스의 LockBits 메서드 및 UnlockBits(BitmapData) 메서드에서 Bitmap 사용됩니다. 상속할 수 없습니다. |
| ColorMap |
색을 변환하기 위한 맵을 정의합니다. 클래스의 ImageAttributes 여러 메서드는 구조의 배열 ColorMap 인 색 다시 매핑 테이블을 사용하여 이미지 색을 조정합니다. 상속할 수 없습니다. |
| ColorMatrix |
RGBAW 공간에 대한 좌표를 포함하는 5 x 5 행렬을 정의합니다. 클래스의 여러 메서드는 ImageAttributes 색 행렬을 사용하여 이미지 색을 조정합니다. 이 클래스는 상속할 수 없습니다. |
| ColorPalette |
색상표를 구성하는 색 배열을 정의합니다. 색은 32비트 ARGB 색입니다. 상속할 수 없습니다. |
| Encoder |
개체는 Encoder 이미지 인코더 매개 변수의 범주를 식별하는 GUID(Globally Unique Identifier)를 캡슐화합니다. |
| EncoderParameter |
값 또는 값 배열을 이미지 인코더에 전달하는 데 사용됩니다. |
| EncoderParameters |
개체 배열 EncoderParameter 을 캡슐화합니다. |
| FrameDimension |
이미지의 프레임 크기를 가져오는 속성을 제공합니다. 상속할 수 없습니다. |
| ImageAttributes |
렌더링하는 동안 비트맵 및 메타파일 색을 조작하는 방법에 대한 정보를 포함합니다. |
| ImageCodecInfo |
이 클래스는 ImageCodecInfo 설치된 이미지 인코더 및 디코더(코덱이라고 함)에 대한 모든 관련 정보를 검색하는 데 필요한 스토리지 멤버 및 메서드를 제공합니다. 상속할 수 없습니다. |
| ImageFormat |
이미지의 파일 형식을 지정합니다. 상속할 수 없습니다. |
| Metafile |
그래픽 메타파일을 정의합니다. 메타파일은 기록(생성) 및 재생(표시)할 수 있는 그래픽 작업 시퀀스를 설명하는 레코드를 포함합니다. 이 클래스는 상속할 수 없습니다. |
| MetafileHeader |
연결된 Metafile. 상속할 수 없습니다. |
| MetaHeader |
WMF(windows-format) 메타파일에 대한 정보를 포함합니다. |
| PropertyItem |
이미지 파일에 포함할 메타데이터 속성을 캡슐화합니다. 상속할 수 없습니다. |
| WmfPlaceableFileHeader |
배치 가능한 메타파일을 정의합니다. 상속할 수 없습니다. |
열거형
| Name | Description |
|---|---|
| ColorAdjustType |
색 조정 정보를 사용하는 GDI+ 개체를 지정합니다. |
| ColorChannelFlag |
CMYK(cyan, magenta, yellow, black) 색 공간의 개별 채널을 지정합니다. 이 열거형은 SetOutputChannel 메서드에서 사용됩니다. |
| ColorMapType |
색 맵의 유형을 지정합니다. |
| ColorMatrixFlag |
ImageAttributes색 및 회색조 조정 설정의 영향을 받는 이미지 및 색 유형을 지정합니다. |
| ColorMode |
색 구성 요소 값에 대한 두 가지 모드를 지정합니다. |
| EmfPlusRecordType |
메타파일에서 그래픽 명령을 읽고 쓰는 데 사용할 수 있는 메서드를 지정합니다. |
| EmfType |
EMF(Enhanced Metafile) 파일에 배치되는 레코드의 특성을 지정합니다. 이 열거형은 Metafile 클래스의 여러 생성자에서 사용됩니다. |
| EncoderParameterValueType |
이미지의 EncoderParameter 또는 Save 메서드와 함께 사용되는 SaveAdd 데이터 형식을 지정합니다. |
| EncoderValue |
Save(String, ImageCodecInfo, EncoderParameters) 또는 SaveAdd(EncoderParameters) 메서드를 사용할 때 JPEG 또는 TIFF 이미지 인코더에 전달되는 매개 변수 값을 지정하는 데 사용됩니다. |
| ImageCodecFlags |
이미지 인코더/디코더(코덱)의 특성을 제공합니다. |
| ImageFlags |
Image 개체에 포함된 픽셀 데이터의 특성을 지정합니다. Flags 속성은 이 열거형의 멤버를 반환합니다. |
| ImageLockMode |
LockBits 메서드의 flags 매개 변수에 전달되는 플래그를 지정합니다. LockBits 메서드는 픽셀 데이터를 읽거나 쓸 수 있도록 이미지의 일부를 잠깁니다. |
| MetafileFrameUnit |
메타파일의 크기를 조정하고 배치하는 데 사용되는 사각형의 측정 단위를 지정합니다. Metafile 개체를 만드는 동안 지정됩니다. |
| MetafileType |
메타파일의 형식을 지정합니다. Type 속성은 이 열거형의 멤버를 반환합니다. |
| PaletteFlags |
시스템 색상표의 색 데이터 형식을 지정합니다. 데이터는 알파, 회색조 데이터만 있는 색 데이터 또는 하프톤 데이터일 수 있습니다. |
| PixelFormat |
이미지의 각 픽셀에 대한 색 데이터의 형식을 지정합니다. |
대리자
| Name | Description |
|---|---|
| PlayRecordCallback |
이 대리자는 사용되지 않습니다. 메타파일의 레코드를 열거하는 예제는 다음을 참조하세요 EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc). |
설명
Caution
네임스페이 System.Drawing 스에는 특정 운영 체제 및 애플리케이션 유형에 대한 몇 가지 제한 사항이 있습니다.
Windows
System.DrawingOS의 일부로 제공되는 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.Bitmap 및 System.Drawing.Font. 그러나 네임스페이스의 기본 형식(예: System.Drawing.Color, System.Drawing.SizeSystem.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 이미지 파일에 메타데이터를 저장하고 검색하는 메서드를 제공합니다.
Caution
System.Drawing.Imaging 네임스페이스 내의 클래스는 Windows 또는 ASP.NET 서비스 내에서 사용할 수 없습니다. 이러한 애플리케이션 유형 중 하나에서 이러한 클래스를 사용하려고 시도하면 서비스 성능 저하 및 런타임 예외와 같은 예기치 않은 문제가 발생할 수 있습니다.
추가 정보
- Windows Forms의 그래픽 및 그리기
- 이미지, 비트맵 및 메타파일
- 이미지, 비트맵, 아이콘 및 메타파일 사용
- 관리형 GDI+에서 이미지 인코더 및 디코더 사용
- 이미지 다시 칠하기