System.Drawing.Imaging 名前空間
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
高度な GDI+ イメージング機能を提供します。 基本的なグラフィックス機能は、 System.Drawing 名前空間によって提供されます。
クラス
| 名前 | 説明 |
|---|---|
| BitmapData |
ビットマップ イメージの属性を指定します。 BitmapData クラスは、Bitmap クラスのLockBitsメソッドとUnlockBits(BitmapData) メソッドによって使用されます。 継承できません。 |
| ColorMap |
色を変換するためのマップを定義します。 ImageAttributes クラスのいくつかのメソッドは、ColorMap構造体の配列であるカラー 再マップ テーブルを使用してイメージの色を調整します。 継承できません。 |
| ColorMatrix |
RGBAW 空間の座標を含む 5 x 5 行列を定義します。 ImageAttributes クラスのいくつかのメソッドは、カラー マトリックスを使用してイメージの色を調整します。 このクラスは継承できません。 |
| ColorPalette |
カラー パレットを構成する色の配列を定義します。 色は 32 ビットの ARGB 色です。 継承できません。 |
| Encoder |
Encoder オブジェクトは、イメージ エンコーダー パラメーターのカテゴリを識別するグローバル一意識別子 (GUID) をカプセル化します。 |
| EncoderParameter |
イメージ エンコーダーに値または値の配列を渡すために使用されます。 |
| EncoderParameters |
EncoderParameter オブジェクトの配列をカプセル化します。 |
| FrameDimension |
イメージのフレーム ディメンションを取得するプロパティを提供します。 継承できません。 |
| ImageAttributes |
レンダリング中にビットマップとメタファイルの色を操作する方法に関する情報が含まれています。 |
| ImageCodecInfo |
ImageCodecInfo クラスは、インストールされているイメージ エンコーダーとデコーダー (コーデックと呼ばれます) に関するすべての関連情報を取得するために必要なストレージ メンバーとメソッドを提供します。 継承できません。 |
| ImageFormat |
イメージのファイル形式を指定します。 継承できません。 |
| Metafile |
グラフィック メタファイルを定義します。 メタファイルには、記録 (構築) および再生 (表示) できる一連のグラフィックス操作を記述するレコードが含まれます。 このクラスは継承できません。 |
| MetafileHeader |
関連付けられた Metafileの属性が含まれます。 継承できません。 |
| MetaHeader |
Windows 形式 (WMF) メタファイルに関する情報が含まれています。 |
| PropertyItem |
イメージ ファイルに含めるメタデータ プロパティをカプセル化します。 継承できません。 |
| WmfPlaceableFileHeader |
配置可能なメタファイルを定義します。 継承できません。 |
列挙型
| 名前 | 説明 |
|---|---|
| ColorAdjustType |
色調整情報を使用する GDI+ オブジェクトを指定します。 |
| ColorChannelFlag |
CMYK (シアン、マゼンタ、イエロー、ブラック) の色空間内の個々のチャネルを指定します。 この列挙型は、SetOutputChannel メソッドによって使用されます。 |
| ColorMapType |
カラー マップの種類を指定します。 |
| ColorMatrixFlag |
ImageAttributesの色とグレースケールの調整設定の影響を受けるイメージと色の種類を指定します。 |
| ColorMode |
カラー コンポーネント値の 2 つのモードを指定します。 |
| EmfPlusRecordType |
グラフィック コマンドの読み取りと書き込みにメタファイルで使用できるメソッドを指定します。 |
| EmfType |
拡張メタファイル (EMF) ファイルに配置されるレコードの性質を指定します。 この列挙型は、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 |
イメージ内の各ピクセルのカラー データの形式を指定します。 |
代理人
| 名前 | 説明 |
|---|---|
| PlayRecordCallback |
このデリゲートは使用されません。 メタファイルのレコードを列挙する例については、 EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc)を参照してください。 |
注釈
Caution
System.Drawing名前空間には、特定のオペレーティング システムとアプリケーションの種類に関するいくつかの制限があります。
Windowsでは、
System.Drawingは、OS の一部として出荷される GDI+ ネイティブ ライブラリに依存します。 Windows Server Core や Windows Nano など、一部のWindows SKU には、OS の一部としてこのネイティブ ライブラリが含まれていません。 この名前空間を使用し、ライブラリを読み込めなかった場合は、実行時に例外がスローされます。System.Drawing名前空間の一部の型は、GDI+ に依存します。これは、Windows サービスおよび ASP.NET Coreおよび ASP.NET アプリではサポートされていません。 これらの型は System.Drawing.Common NuGet パッケージにあり、 System.Drawing.Bitmap と System.Drawing.Fontが含まれます。 ただし、名前空間内のプリミティブ型 ( System.Drawing.Color、 System.Drawing.Size、 System.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 を個別にインストールする必要があります。 詳細については、「Install .NET on Linux または Install .NET on macOS を参照してください。
.NET 6 以降のバージョンでは、System.Drawing.Common NuGet パッケージは、Windows オペレーティング システムでのみサポートされます。 詳細については、「System.Drawing.Common が Windows でしかサポートされない」を参照してください。
アプリケーションで System.Drawing を使用できない場合は、 推奨される代替手段としては、ImageSharp、SkiaSharp、Windowsイメージング コンポーネント、および Microsoft があります。Maui.Graphics.
Metafile クラスには、メタファイルを記録および保存するためのメソッドが用意されています。 Encoder クラスを使用すると、ユーザーは GDI+ を拡張して任意のイメージ形式をサポートできます。 PropertyItem クラスは、イメージ ファイルにメタデータを格納および取得するためのメソッドを提供します。
Caution
System.Drawing.Imaging 名前空間内のクラスは、Windowsまたは ASP.NET サービス内での使用はサポートされていません。 これらのアプリケーションの種類の 1 つからこれらのクラスを使用しようとすると、サービスパフォーマンスの低下や実行時の例外など、予期しない問題が発生する可能性があります。