System.Drawing.Imaging Obor názvů

Poskytuje pokročilé funkce zobrazení GDI+. Základní grafické funkce poskytuje System.Drawing obor názvů.

Třídy

Name Description
BitmapData

Určuje atributy rastrového obrázku. Třída BitmapData je používána LockBits metodami UnlockBits(BitmapData)Bitmap třídy. Neděditelné.

CachedBitmap

Představuje kopii závislé na Bitmap zařízení odpovídající aktuálnímu nastavení zařízení (zobrazení) zadaného Graphics objektu. Vyhněte se kroku přeformátování při vykreslování, 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ěditelné.

ColorMatrix

Definuje matici 5 x 5, která obsahuje souřadnice prostoru RGBAW. Několik metod ImageAttributes třídy upravuje barvy obrázků pomocí barevné matice. Tato třída se nemůže dědit.

ColorPalette

Definuje pole barev, které tvoří paletu barev. Barvy jsou 32bitové barvy ARGB. Neděditelné.

Encoder

Objekt Encoder zapouzdřuje globálně jedinečný identifikátor (GUID), který identifikuje kategorii parametru kodéru obrázku.

EncoderParameter

Slouží k předání hodnoty nebo pole hodnot kodéru obrázku.

EncoderParameters

Zapouzdřuje pole EncoderParameter objektů.

FrameDimension

Poskytuje vlastnosti, které získají rozměry rámečku obrázku. Neděditelné.

ImageAttributes

Obsahuje informace o tom, jak se při vykreslování manipulují s rastrovými obrázky a barvami metasouboru.

ImageCodecInfo

Třída ImageCodecInfo poskytuje nezbytné členy a metody úložiště k načtení všech relevantních informací o nainstalovaných kodérech a dekodérech obrázků (označovaných jako kodeky). Neděditelné.

ImageFormat

Určuje formát souboru obrázku. Neděditelné.

Metafile

Definuje grafický metasoubor. Metasoubor obsahuje záznamy popisující posloupnost grafických operací, které lze zaznamenat (vytvořit) a přehrát (zobrazit). Tato třída není zděděná.

MetafileHeader

Obsahuje atributy přidruženého Metafileobjektu . Neděditelné.

MetaHeader

Obsahuje informace o metasouboru formátu windows (WMF).

PropertyItem

Zapouzdřuje vlastnost metadat, která se má zahrnout do souboru obrázku. Neděditelné.

WmfPlaceableFileHeader

Definuje umístitelný metasoubor. Neděditelné.

Výčty

Name Description
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 používá SetOutputChannel metody.

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é ImageAttributes.

ColorMode

Určuje dva režimy pro hodnoty barevných komponent.

DitherType

Určuje, jak se obrázky budou oddálit pomocí barevné palety s omezenou barvou.

EmfPlusRecordType

Určuje metody, které lze použít s metasouborem ke čtení a zápisu grafických příkazů.

EmfType

Určuje povahu záznamů, které jsou umístěny v souboru rozšířeného metasouboru (EMF). Tento výčet je používán několika konstruktory v Metafile třídy.

EncoderParameterValueType

Určuje datový typ EncoderParameter používané s Save nebo SaveAdd metodou 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) nebo SaveAdd(EncoderParameters) metod.

ImageCodecFlags

Poskytuje atributy kodéru nebo dekodéru obrázků (kodek).

ImageFlags

Určuje atributy pixelových dat obsažených v objektu Image. Vlastnost Flags vrátí člena tohoto výčtu.

ImageLockMode

Určuje příznaky, které se předávají parametru flags metody LockBits. Metoda LockBits uzamkne část obrázku, abyste mohli číst nebo zapisovat pixelová data.

MetafileFrameUnit

Určuje měrnou jednotku obdélníku použitého k nastavení velikosti a umístění metasouboru. Toto je určeno při vytváření objektu Metafile.

MetafileType

Určuje typy metasouborů. Vlastnost Type vrátí člena tohoto výčtu.

PaletteFlags

Určuje typ barevných dat v systémové paletě. Data můžou být barevná data pouze s alfa, daty ve stupních šedé nebo polotónovými daty.

PaletteType

Určuje typy palet barev.

PixelFormat

Určuje formát barevných dat pro každý pixel na obrázku.

Delegáti

Name Description
PlayRecordCallback

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

Poznámky

Caution

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

  • Na Windows závisí System.Drawing na nativní knihovně GDI+, která se dodává jako součást operačního systému. Některé Windows skladové položky, jako je 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, výjimky budou vyvolány za běhu.

  • Některé typy v oboru názvů System.Drawing spoléhají na GDI+, které nejsou podporované v aplikacích Windows a ASP.NET Core a ASP.NET. Tyto typy jsou v balíčku System.Drawing.Common NuGet a zahrnují System.Drawing.Bitmap a System.Drawing.Font. Primitivní typy v oboru názvů, například System.Drawing.Color, System.Drawing.Size, System.Drawing.Pointa System.Drawing.Rectangle, lze použít v libovolné aplikaci.

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

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

Pokud ve své aplikaci 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 rozhraní GDI+ na 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ů.

Caution

Třídy v oboru názvů System.Drawing.Imaging nejsou podporovány pro použití v rámci služby 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 jsou snížení výkonu služby a výjimky za běhu.

Viz také