Sdílet prostřednictvím


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í.

DitherType

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

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.

PaletteType

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

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é