System.Drawing.Imaging Obor názvů

Poskytuje pokročilé funkce GDI+ pro vytváření obrázků. Základní grafické funkce jsou poskytovány oborem System.Drawing názvů.

Třídy

BitmapData	Určuje atributy rastrového obrázku. Třída BitmapData je používána metodami LockBitsBitmap a UnlockBits(BitmapData) třídy . Nedědí se.
CachedBitmap	Představuje kopii Bitmap závislé na zařízení odpovídající aktuálnímu nastavení zařízení (zobrazení) zadaného Graphics objektu. Při vykreslování se vyhýbá přeformátování kroku, což může výrazně zlepšit výkon.
ColorMap	Definuje mapu pro převod barev. Několik metod ImageAttributes třídy upravuje barvy obrázků pomocí tabulky přemapování barev, což je pole ColorMap struktur. Nedědí se.
ColorMatrix	Definuje matici 5 x 5, která obsahuje souřadnice pro prostor RGBAW. Několik metod ImageAttributes třídy upravuje barvy obrázku pomocí matice barev. Tato třída se nemůže dědit.
ColorPalette	Definuje pole barev, které tvoří paletu barev. Barvy jsou 32bitové barvy ARGB. Nedědí se.
Encoder	Objekt Encoder zapouzdřuje globálně jedinečný identifikátor (GUID), který identifikuje kategorii parametru kodéru obrázků.
EncoderParameter	Používá se k předání hodnoty nebo pole hodnot do kodéru obrázku.
EncoderParameters	Zapouzdří pole EncoderParameter objektů.
FrameDimension	Poskytuje vlastnosti, které získají rozměry rámečku obrázku. Nedědí se.
ImageAttributes	Obsahuje informace o tom, jak se při vykreslování manipuluje s barvami rastrového obrázku a metasouboru.
ImageCodecInfo	Třída ImageCodecInfo poskytuje nezbytné členy úložiště a metody pro načtení všech relevantních informací o nainstalovaných kodérech obrázků a dekodérech (označovaných jako kodeky). Nedědí se.
ImageFormat	Určuje formát souboru obrázku. Nedědí se.
Metafile	Definuje grafický metasoubor. Metasoubor obsahuje záznamy, které popisují posloupnost grafických operací, které lze zaznamenat (vytvořit) a přehrát (zobrazit). Tuto třídu nelze dědit.
MetafileHeader	Obsahuje atributy přidruženého Metafileobjektu . Nedědí se.
MetaHeader	Obsahuje informace o metasouboru formátu windows (WMF).
PropertyItem	Zapouzdřuje vlastnost metadat, která má být zahrnuta do souboru obrázku. Nedědí se.
WmfPlaceableFileHeader	Definuje umístitelný metasoubor. Nedědí se.

Výčty

ColorAdjustType	Určuje, které objekty GDI+ používají informace o úpravě barev.
ColorChannelFlag	Určuje jednotlivé kanály v barevném prostoru CMYK (azurová, purpurová, žlutá, černá). Tento výčet je používán metodami SetOutputChannel .
ColorMapType	Určuje typy barevných map.
ColorMatrixFlag	Určuje typy obrázků a barev, které budou ovlivněny nastavením úprav barev a stupňů šedé objektu ImageAttributes.
ColorMode	Určuje dva režimy pro hodnoty barevných součástí.
EmfPlusRecordType	Určuje metody dostupné pro použití s metasouborem ke čtení a zápisu grafických příkazů.
EmfType	Určuje povahu záznamů, které jsou umístěny v souboru EMF (Enhanced Metafile). Tento výčet používá několik konstruktorů ve Metafile třídě .
EncoderParameterValueType	Určuje datový typ použitého EncoderParameter s Save metodou nebo SaveAdd obrázku.
EncoderValue	Slouží k určení hodnoty parametru předané kodéru obrázků JPEG nebo TIFF při použití Save(String, ImageCodecInfo, EncoderParameters) metod nebo SaveAdd(EncoderParameters) .
ImageCodecFlags	Poskytuje atributy kodéru nebo dekodéru obrázku (kodek).
ImageFlags	Určuje atributy obrazových dat obsažených v objektu Image . Vlastnost Flags vrátí člen tohoto výčtu.
ImageLockMode	Určuje příznaky, které se předávají parametru LockBits flags metody. Metoda LockBits uzamkne část obrázku, abyste mohli číst nebo zapisovat data pixelů.
MetafileFrameUnit	Určuje měrnou jednotku obdélníku použitého k určení velikosti a umístění metasouboru. To se zadává při vytváření objektu Metafile .
MetafileType	Určuje typy metasouborů. Vlastnost Type vrátí člen tohoto výčtu.
PaletteFlags	Určuje typ barevných dat v systémové paletě. Data můžou být barevná s použitím alfa, pouze dat ve stupních šedé nebo polotónových dat.
PixelFormat	Určuje formát dat barev pro každý pixel v obrázku.

Delegáti

PlayRecordCallback

Tento delegát se nepoužívá. Příklad vytvoření výčtu záznamů metasouboru najdete v tématu EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc).

Poznámky

Upozornění

Obor System.Drawing názvů má určitá omezení pro určité operační systémy a typy aplikací.

• Ve Windows System.Drawing závisí na nativní knihovně GDI+, která se dodává jako součást operačního systému. Některé skladové položky Windows, například Windows Server Core nebo Windows Nano, nezahrnují tuto nativní knihovnu jako součást operačního systému. Pokud použijete tento obor názvů a knihovnu nelze načíst, vyvolá se za běhu výjimky.

• Některé typy v System.Drawing oboru názvů spoléhají na rozhraní GDI+, které není podporováno ve službách windows a ASP.NET Core a ASP.NET aplikacích. Tyto typy jsou v balíčku NuGet System.Drawing.Common a zahrnují System.Drawing.Bitmap a System.Drawing.Font. Primitivní typy v oboru názvů, jako System.Drawing.Colorjsou , System.Drawing.Size, System.Drawing.Pointa System.Drawing.Rectangle, však lze použít v libovolné aplikaci.

• V .NET 5 a předchozích verzích funguje balíček NuGet System.Drawing.Common ve Windows, Linuxu a macOS. Existují však určité rozdíly mezi platformami. V Systémech Linux a macOS je funkce GDI+ implementována knihovnou libgdiplus ). Tato knihovna není ve výchozím nastavení nainstalovaná ve většině distribucí Linuxu a nepodporuje všechny funkce GDI+ ve Windows a macOS. Existují také platformy, kde libgdiplus není k dispozici vůbec. Pokud chcete používat typy z balíčku System.Drawing.Common v Linuxu a macOS, musíte knihovnu libgdiplus nainstalovat samostatně. Další informace najdete v tématech Instalace .NET v Linuxu nebo Instalace .NET v macOS.

• V .NET 6 a novějších verzích je balíček NuGet System.Drawing.Common podporován pouze v operačních systémech Windows. Další informace najdete v tématu System.Drawing.Common podporované pouze ve Windows.

Pokud s aplikací nemůžete použít System.Drawing , mezi doporučené alternativy patří ImageSharp, SkiaSharp, Windows Imaging Components a Microsoft.Maui.Graphics.

Třída Metafile poskytuje metody pro záznam a ukládání metasouborů. Třída Encoder umožňuje uživatelům rozšířit GDI+ o podporu libovolného formátu obrázku. Třída PropertyItem poskytuje metody pro ukládání a načítání metadat v souborech obrázků.

Upozornění

Třídy v rámci System.Drawing.Imaging oboru názvů nejsou podporovány pro použití v rámci služby systému Windows nebo ASP.NET. Pokus o použití těchto tříd z jednoho z těchto typů aplikací může způsobit neočekávané problémy, jako je snížení výkonu služby a výjimky za běhu.

Viz také

• Grafika a kreslení v rozhraní Windows Forms
• Obrázky, rastrové obrázky a metasoubory
• Práce s obrázky, rastrovými obrázky, ikonami a metasoubory
• Použití kodérů a dekodérů ve spravovaném GDI+
• Přebarvení obrázků