System.Drawing.Imaging Пространство имен

Предоставляет расширенные графические функции GDI+. Базовые графические средства реализованы в пространстве имен System.Drawing.

Классы

BitmapData	Задает атрибуты точечного рисунка. Класс BitmapData используется методами LockBits и UnlockBits(BitmapData) класса Bitmap. Не наследуется.
CachedBitmap	Представляет зависимую от устройства копию объекта , Bitmap соответствующую текущим параметрам устройства (дисплея) указанного Graphics объекта. Избегает переформатирования шага при отрисовке, что может значительно повысить производительность.
ColorMap	Определяет карту для преобразования цветов. Несколько методов класса ImageAttributes позволяют настроить цвета изображения с помощью таблицы преобразования цветов, которая представляет собой массив структур ColorMap. Не наследуется.
ColorMatrix	Определяет матрицу 5 x 5, которая содержит координаты для пространства RGBAW. Несколько методов класса ImageAttributes настраивают цвета изображения с помощью цветовой матрицы. Этот класс не наследуется.
ColorPalette	Определяет массив цветов, образующий цветовую палитру. Цвета — это 32-разрядные цвета ARGB. Не наследуется.
Encoder	Объект Encoder инкапсулирует глобальный уникальный идентификатор GUID, который определяет категорию параметра кодировщика изображения.
EncoderParameter	Используется для передачи значения или массива значений кодировщику изображений.
EncoderParameters	Инкапсулирует массив объектов EncoderParameter.
FrameDimension	Предоставляет свойства, получающие размеры кадра изображения. Не наследуется.
ImageAttributes	Содержит сведения о том, каким образом обрабатываются цвета точечных рисунков и метафайлов во время отрисовки.
ImageCodecInfo	Класс ImageCodecInfo обеспечивает необходимые члены и методы хранения для извлечения всей информации, имеющей отношение к установленным кодировщикам и декодерам изображений (называются кодеками). Не наследуется.
ImageFormat	Указывает формат файла изображения. Не наследуется.
Metafile	Определяет графический метафайл. Метафайл содержит записи, описывающие последовательность графических операций, которые могут быть записаны (созданы) и воспроизведены (выведены на экран). Этот класс не наследуется.
MetafileHeader	Содержит атрибуты связанного объекта Metafile. Не наследуется.
MetaHeader	Содержит информацию о метафайле WMF.
PropertyItem	Инкапсулирует свойство метаданных, включаемое в файл изображения. Не наследуется.
WmfPlaceableFileHeader	Определяет размещаемый метафайл. Не наследуется.

Перечисления

ColorAdjustType	Указывает, какие объекты GDI+ используют сведения о настройке цвета.
ColorChannelFlag	Определяет отдельные каналы в цветовом пространстве CMYK (голубой, пурпурный, желтый, черный). Это перечисление используется методами SetOutputChannel.
ColorMapType	Определяет типы карт цветов.
ColorMatrixFlag	Определяет типы изображений и цвета, на которые влияют параметры настройки цветной или черно-белой палитры объекта ImageAttributes.
ColorMode	Определяет два режима для значений составляющих цвета.
EmfPlusRecordType	Определяет методы, доступные для использования с метафайлом для чтения и записи графических команд.
EmfType	Определяет характер записей, размещенных в файле EMF (расширенный метафайл). Перечисление, используемое несколькими конструкторами в классе Metafile.
EncoderParameterValueType	Указывает тип данных EncoderParameter (используется с методом Save или SaveAdd изображения).
EncoderValue	Используется для определения значения параметра, передаваемого кодировщику изображений JPEG или TIFF при использовании методов Save(String, ImageCodecInfo, EncoderParameters) или SaveAdd(EncoderParameters).
ImageCodecFlags	Предоставляет атрибуты кодировщика или декодера изображения (кодека).
ImageFlags	Указывает атрибуты данных о пикселях, содержащихся в объекте Image. Свойство Flags возвращает члена данного перечисления.
ImageLockMode	Указывает флаги, передаваемые параметру флагов метода LockBits. Метод LockBits блокирует часть изображения, так что можно считывать или записывать данные о пикселях.
MetafileFrameUnit	Указывает единицу измерения прямоугольника, используемого для определения размеров и положения метафайлов. Эти данные указываются во время создания объекта Metafile.
MetafileType	Указывает типы метафайлов. Свойство Type возвращает члена данного перечисления.
PaletteFlags	Указывает тип данных о цвете в системной палитре. Это могут быть данные о цвете с альфа-составляющей, только черно-белые данные или полутоновые данные.
PixelFormat	Указывает формат данных о цвете для каждого пикселя изображения.

Делегаты

PlayRecordCallback

Данный делегат не используется. Пример перечисления записей метафайла см. в EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc).

Комментарии

Внимание!

Пространство System.Drawing имен имеет некоторые ограничения для определенных операционных систем и типов приложений.

• В Windows System.Drawing зависит от собственной библиотеки GDI+, которая поставляется в составе ОС. Некоторые номера SKU Windows, такие как Windows Server Core или Windows Nano, не включают эту собственную библиотеку в составе операционной системы. Если вы используете это пространство имен и библиотеку не удается загрузить, во время выполнения будут возникать исключения.

• Некоторые типы в System.Drawing пространстве имен используют GDI+, который не поддерживается в службах Windows, а также ASP.NET Core и ASP.NET приложениях. Эти типы находятся в пакете NuGet System.Drawing.Common и включают System.Drawing.Bitmap и System.Drawing.Font. Однако примитивные типы в пространстве имен, такие как System.Drawing.Color, System.Drawing.Size, System.Drawing.Pointи System.Drawing.Rectangle, можно использовать в любом приложении.

• В .NET 5 и предыдущих версиях пакет NuGet System.Drawing.Common работает в Windows, Linux и macOS. Однако существуют некоторые различия между платформами. В Linux и macOS функциональность GDI+ реализуется библиотекой libgdiplus). Эта библиотека не устанавливается по умолчанию в большинстве дистрибутивов Linux и не поддерживает все функции GDI+ в Windows и macOS. Существуют также платформы, где libgdiplus недоступен вообще. Чтобы использовать типы из пакета System.Drawing.Common в Linux и macOS, необходимо установить libgdiplus отдельно. Дополнительные сведения см. в разделах Установка .NET в Linux или Установка .NET в macOS.

• В .NET 6 и более поздних версиях пакет NuGet System.Drawing.Common поддерживается только в операционных системах Windows. Дополнительные сведения см . в статье System.Drawing.Common, поддерживаемая только в Windows.

Если вы не можете использовать System.Drawing с приложением, рекомендуемые варианты: ImageSharp, SkiaSharp, Компоненты образов Windows и Microsoft.Maui.Graphics.

Класс Metafile предоставляет методы для записи и сохранения метафайлов. Класс Encoder позволяет пользователям расширить GDI+ для поддержки любого формата изображений. Класс PropertyItem предоставляет методы для хранения и извлечения метаданных в файлах изображений.

Внимание!

Классы в System.Drawing.Imaging пространстве имен не поддерживаются для использования в службе Windows или ASP.NET. Попытка использовать эти классы в одном из этих типов приложений может привести к непредвиденным проблемам, таким как снижение производительности службы и исключения во время выполнения.

См. также раздел

• Объекты Graphics и Drawing в Windows Forms
• Работа с растровыми и векторными изображениями с использованием классов Image, Bitmap и Metafile
• Работа с растровыми и векторными изображениями
• Применение кодировщиков и декодеров изображений в управляемом GDI+
• Перекрашивание изображений