ImageAttributes ImageAttributes ImageAttributes ImageAttributes Class

定義

レンダリング時のビットマップとメタファイルの色の操作方法に関する情報を格納します。Contains information about how bitmap and metafile colors are manipulated during rendering.

public ref class ImageAttributes sealed : ICloneable, IDisposable
public sealed class ImageAttributes : ICloneable, IDisposable
type ImageAttributes = class
    interface ICloneable
    interface IDisposable
Public NotInheritable Class ImageAttributes
Implements ICloneable, IDisposable
継承
ImageAttributesImageAttributesImageAttributesImageAttributes
実装

次の例はすべて 1 つの色 (0.2, 0.0、0.4, 1.0) であるイメージおよび double の赤のコンポーネントは、赤、緑、青のコンポーネントに 0.2 を追加します。The following example takes an image that is all one color (0.2, 0.0, 0.4, 1.0) and doubles the red component adds 0.2 to the red, green, and blue components

次の図は、右側の左側に、元のイメージと変換後のイメージを示します。The following illustration shows the original image on the left and the transformed image on the right.

色Colors

次の例のコードでは、次の手順を使用して、色の変更を実行します。The code in the following example uses the following steps to perform the recoloring:

  1. 初期化をColorMatrixオブジェクト。Initialize a ColorMatrix object.

  2. 作成、ImageAttributesオブジェクトを渡します、ColorMatrixオブジェクトをSetColorMatrixのメソッド、ImageAttributesオブジェクト。Create an ImageAttributes object and pass the ColorMatrix object to the SetColorMatrix method of the ImageAttributes object.

  3. 渡す、ImageAttributesオブジェクトをDrawImageのメソッドをGraphicsオブジェクト。Pass the ImageAttributes object to the DrawImage method of a Graphics object.

Image image = new Bitmap("InputColor.bmp");
ImageAttributes imageAttributes = new ImageAttributes();
int width = image.Width;
int height = image.Height;

float[][] colorMatrixElements = { 
   new float[] {2,  0,  0,  0, 0},        // red scaling factor of 2
   new float[] {0,  1,  0,  0, 0},        // green scaling factor of 1
   new float[] {0,  0,  1,  0, 0},        // blue scaling factor of 1
   new float[] {0,  0,  0,  1, 0},        // alpha scaling factor of 1
   new float[] {.2f, .2f, .2f, 0, 1}};    // three translations of 0.2

ColorMatrix colorMatrix = new ColorMatrix(colorMatrixElements);

imageAttributes.SetColorMatrix(
   colorMatrix,
   ColorMatrixFlag.Default,
   ColorAdjustType.Bitmap);

e.Graphics.DrawImage(image, 10, 10);

e.Graphics.DrawImage(
   image,
   new Rectangle(120, 10, width, height),  // destination rectangle 
   0, 0,        // upper-left corner of source rectangle 
   width,       // width of source rectangle
   height,      // height of source rectangle
   GraphicsUnit.Pixel,
   imageAttributes);
Dim image As New Bitmap("InputColor.bmp")
Dim imageAttributes As New ImageAttributes()
Dim width As Integer = image.Width
Dim height As Integer = image.Height

' The following matrix consists of the following transformations:
' red scaling factor of 2
' green scaling factor of 1
' blue scaling factor of 1
' alpha scaling factor of 1
' three translations of 0.2
Dim colorMatrixElements As Single()() = { _
   New Single() {2, 0, 0, 0, 0}, _
   New Single() {0, 1, 0, 0, 0}, _
   New Single() {0, 0, 1, 0, 0}, _
   New Single() {0, 0, 0, 1, 0}, _
   New Single() {0.2F, 0.2F, 0.2F, 0, 1}}

Dim colorMatrix As New ColorMatrix(colorMatrixElements)

imageAttributes.SetColorMatrix(colorMatrix, ColorMatrixFlag.Default, ColorAdjustType.Bitmap)

e.Graphics.DrawImage(image, 10, 10)

e.Graphics.DrawImage( _
   image, _
   New Rectangle(120, 10, width, height), _
   0, _
   0, _
   width, _
   height, _
   GraphicsUnit.Pixel, _
   imageAttributes)

注釈

ImageAttributesカラー調整行列、グレースケール調整行列、ガンマ補正値、カラー マップ テーブル、および色のしきい値の値を含む、いくつかのカラー調整設定を保持するオブジェクト。An ImageAttributes object maintains several color-adjustment settings, including color-adjustment matrices, grayscale-adjustment matrices, gamma-correction values, color-map tables, and color-threshold values. レンダリング中に色を修正、暗く、明るく、および削除できます。During rendering, colors can be corrected, darkened, lightened, and removed. このような操作を適用するには、初期化、ImageAttributesオブジェクトし、そのパスを渡すImageAttributesオブジェクト (のパスと共に、 Image) に、DrawImageメソッド。To apply such manipulations, initialize an ImageAttributes object and pass the path of that ImageAttributes object (along with the path of an Image) to the DrawImage method.

コンストラクター

ImageAttributes() ImageAttributes() ImageAttributes() ImageAttributes()

ImageAttributes クラスの新しいインスタンスを初期化します。Initializes a new instance of the ImageAttributes class.

メソッド

ClearBrushRemapTable() ClearBrushRemapTable() ClearBrushRemapTable() ClearBrushRemapTable()

ImageAttributes オブジェクトのブラシのカラー リマップ テーブルを消去します。Clears the brush color-remap table of this ImageAttributes object.

ClearColorKey() ClearColorKey() ClearColorKey() ClearColorKey()

既定のカテゴリのカラー キー (透明度の範囲) を消去します。Clears the color key (transparency range) for the default category.

ClearColorKey(ColorAdjustType) ClearColorKey(ColorAdjustType) ClearColorKey(ColorAdjustType) ClearColorKey(ColorAdjustType)

指定したカテゴリのカラー キー (透明度の範囲) を消去します。Clears the color key (transparency range) for a specified category.

ClearColorMatrix() ClearColorMatrix() ClearColorMatrix() ClearColorMatrix()

既定のカテゴリのカラー調整行列を消去します。Clears the color-adjustment matrix for the default category.

ClearColorMatrix(ColorAdjustType) ClearColorMatrix(ColorAdjustType) ClearColorMatrix(ColorAdjustType) ClearColorMatrix(ColorAdjustType)

指定したカテゴリのカラー調整行列を消去します。Clears the color-adjustment matrix for a specified category.

ClearGamma() ClearGamma() ClearGamma() ClearGamma()

既定のカテゴリのガンマ補正を無効にします。Disables gamma correction for the default category.

ClearGamma(ColorAdjustType) ClearGamma(ColorAdjustType) ClearGamma(ColorAdjustType) ClearGamma(ColorAdjustType)

指定したカテゴリのガンマ補正を無効にします。Disables gamma correction for a specified category.

ClearNoOp() ClearNoOp() ClearNoOp() ClearNoOp()

既定のカテゴリの NoOp 設定を消去します。Clears the NoOp setting for the default category.

ClearNoOp(ColorAdjustType) ClearNoOp(ColorAdjustType) ClearNoOp(ColorAdjustType) ClearNoOp(ColorAdjustType)

指定したカテゴリの NoOp 設定を消去します。Clears the NoOp setting for a specified category.

ClearOutputChannel() ClearOutputChannel() ClearOutputChannel() ClearOutputChannel()

既定のカテゴリの CMYK (水色、マゼンタ、黄、黒) 出力チャネル設定を消去します。Clears the CMYK (cyan-magenta-yellow-black) output channel setting for the default category.

ClearOutputChannel(ColorAdjustType) ClearOutputChannel(ColorAdjustType) ClearOutputChannel(ColorAdjustType) ClearOutputChannel(ColorAdjustType)

指定されたのカテゴリの CMYK (水色、マゼンタ、黄、黒) 出力チャネル設定を消去します。Clears the (cyan-magenta-yellow-black) output channel setting for a specified category.

ClearOutputChannelColorProfile() ClearOutputChannelColorProfile() ClearOutputChannelColorProfile() ClearOutputChannelColorProfile()

既定のカテゴリの出力チャネルのカラー プロファイル設定を消去します。Clears the output channel color profile setting for the default category.

ClearOutputChannelColorProfile(ColorAdjustType) ClearOutputChannelColorProfile(ColorAdjustType) ClearOutputChannelColorProfile(ColorAdjustType) ClearOutputChannelColorProfile(ColorAdjustType)

指定したカテゴリの出力チャネルのカラー プロファイル設定を消去します。Clears the output channel color profile setting for a specified category.

ClearRemapTable() ClearRemapTable() ClearRemapTable() ClearRemapTable()

既定のカテゴリのカラー リマップ テーブルを消去します。Clears the color-remap table for the default category.

ClearRemapTable(ColorAdjustType) ClearRemapTable(ColorAdjustType) ClearRemapTable(ColorAdjustType) ClearRemapTable(ColorAdjustType)

指定したカテゴリのカラー リマップ テーブルを消去します。Clears the color-remap table for a specified category.

ClearThreshold() ClearThreshold() ClearThreshold() ClearThreshold()

既定のカテゴリのしきい値を消去します。Clears the threshold value for the default category.

ClearThreshold(ColorAdjustType) ClearThreshold(ColorAdjustType) ClearThreshold(ColorAdjustType) ClearThreshold(ColorAdjustType)

指定したカテゴリのしきい値を消去します。Clears the threshold value for a specified category.

Clone() Clone() Clone() Clone()

この ImageAttributes オブジェクトの同一コピーを作成します。Creates an exact copy of this ImageAttributes object.

Dispose() Dispose() Dispose() Dispose()

この ImageAttributes オブジェクトによって使用されているすべてのリソースを解放します。Releases all resources used by this ImageAttributes object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

オブジェクトが、ガベージ コレクションによって収集される前に、リソースの解放とその他のクリーンアップ操作の実行を試みることができるようにします。Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetAdjustedPalette(ColorPalette, ColorAdjustType) GetAdjustedPalette(ColorPalette, ColorAdjustType) GetAdjustedPalette(ColorPalette, ColorAdjustType) GetAdjustedPalette(ColorPalette, ColorAdjustType)

指定したカテゴリの調整設定に従ってパレットの色を調整します。Adjusts the colors in a palette according to the adjustment settings of a specified category.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
SetBrushRemapTable(ColorMap[]) SetBrushRemapTable(ColorMap[]) SetBrushRemapTable(ColorMap[]) SetBrushRemapTable(ColorMap[])

ブラシ カテゴリのカラー リマップ テーブルを設定します。Sets the color-remap table for the brush category.

SetColorKey(Color, Color) SetColorKey(Color, Color) SetColorKey(Color, Color) SetColorKey(Color, Color)

既定のカテゴリのカラー キーを設定します。Sets the color key for the default category.

SetColorKey(Color, Color, ColorAdjustType) SetColorKey(Color, Color, ColorAdjustType) SetColorKey(Color, Color, ColorAdjustType) SetColorKey(Color, Color, ColorAdjustType)

指定したカテゴリのカラー キー (透明度の範囲) を設定します。Sets the color key (transparency range) for a specified category.

SetColorMatrices(ColorMatrix, ColorMatrix) SetColorMatrices(ColorMatrix, ColorMatrix) SetColorMatrices(ColorMatrix, ColorMatrix) SetColorMatrices(ColorMatrix, ColorMatrix)

既定のカテゴリのカラー調整行列とグレースケール調整行列を設定します。Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag)

既定のカテゴリのカラー調整行列とグレースケール調整行列を設定します。Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType)

指定したカテゴリのカラー調整行列とグレースケール調整行列を設定します。Sets the color-adjustment matrix and the grayscale-adjustment matrix for a specified category.

SetColorMatrix(ColorMatrix) SetColorMatrix(ColorMatrix) SetColorMatrix(ColorMatrix) SetColorMatrix(ColorMatrix)

既定のカテゴリのカラー調整行列を設定します。Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag) SetColorMatrix(ColorMatrix, ColorMatrixFlag) SetColorMatrix(ColorMatrix, ColorMatrixFlag) SetColorMatrix(ColorMatrix, ColorMatrixFlag)

既定のカテゴリのカラー調整行列を設定します。Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType)

指定したカテゴリのカラー調整行列を設定します。Sets the color-adjustment matrix for a specified category.

SetGamma(Single) SetGamma(Single) SetGamma(Single) SetGamma(Single)

既定のカテゴリのガンマ値を設定します。Sets the gamma value for the default category.

SetGamma(Single, ColorAdjustType) SetGamma(Single, ColorAdjustType) SetGamma(Single, ColorAdjustType) SetGamma(Single, ColorAdjustType)

指定したカテゴリのガンマ値を設定します。Sets the gamma value for a specified category.

SetNoOp() SetNoOp() SetNoOp() SetNoOp()

既定のカテゴリのカラー調整をオフにします。Turns off color adjustment for the default category. ClearNoOp メソッドを呼び出して、SetNoOp メソッドを呼び出す前のカラー調整設定に戻すことができます。You can call the ClearNoOp method to reinstate the color-adjustment settings that were in place before the call to the SetNoOp method.

SetNoOp(ColorAdjustType) SetNoOp(ColorAdjustType) SetNoOp(ColorAdjustType) SetNoOp(ColorAdjustType)

指定したカテゴリのカラー調整をオフにします。Turns off color adjustment for a specified category. ClearNoOp メソッドを呼び出して、SetNoOp メソッドを呼び出す前のカラー調整設定に戻すことができます。You can call the ClearNoOp method to reinstate the color-adjustment settings that were in place before the call to the SetNoOp method.

SetOutputChannel(ColorChannelFlag) SetOutputChannel(ColorChannelFlag) SetOutputChannel(ColorChannelFlag) SetOutputChannel(ColorChannelFlag)

既定のカテゴリの CMYK (水色、マゼンタ、黄、黒) 出力チャネルを設定します。Sets the CMYK (cyan-magenta-yellow-black) output channel for the default category.

SetOutputChannel(ColorChannelFlag, ColorAdjustType) SetOutputChannel(ColorChannelFlag, ColorAdjustType) SetOutputChannel(ColorChannelFlag, ColorAdjustType) SetOutputChannel(ColorChannelFlag, ColorAdjustType)

指定されたカテゴリの CMYK (水色、マゼンタ、黄、黒) 出力チャネルを設定します。Sets the CMYK (cyan-magenta-yellow-black) output channel for a specified category.

SetOutputChannelColorProfile(String) SetOutputChannelColorProfile(String) SetOutputChannelColorProfile(String) SetOutputChannelColorProfile(String)

既定のカテゴリの出力チャネルのカラー プロファイル ファイルを設定します。Sets the output channel color-profile file for the default category.

SetOutputChannelColorProfile(String, ColorAdjustType) SetOutputChannelColorProfile(String, ColorAdjustType) SetOutputChannelColorProfile(String, ColorAdjustType) SetOutputChannelColorProfile(String, ColorAdjustType)

指定したカテゴリの出力チャネルのカラー プロファイル ファイルを設定します。Sets the output channel color-profile file for a specified category.

SetRemapTable(ColorMap[]) SetRemapTable(ColorMap[]) SetRemapTable(ColorMap[]) SetRemapTable(ColorMap[])

既定のカテゴリのカラー リマップ テーブルを設定します。Sets the color-remap table for the default category.

SetRemapTable(ColorMap[], ColorAdjustType) SetRemapTable(ColorMap[], ColorAdjustType) SetRemapTable(ColorMap[], ColorAdjustType) SetRemapTable(ColorMap[], ColorAdjustType)

指定したカテゴリのカラー リマップ テーブルを設定します。Sets the color-remap table for a specified category.

SetThreshold(Single) SetThreshold(Single) SetThreshold(Single) SetThreshold(Single)

既定のカテゴリのしきい値 (透明度の範囲) を指定します。Sets the threshold (transparency range) for the default category.

SetThreshold(Single, ColorAdjustType) SetThreshold(Single, ColorAdjustType) SetThreshold(Single, ColorAdjustType) SetThreshold(Single, ColorAdjustType)

指定したカテゴリのしきい値 (透明度の範囲) を設定します。Sets the threshold (transparency range) for a specified category.

SetWrapMode(WrapMode) SetWrapMode(WrapMode) SetWrapMode(WrapMode) SetWrapMode(WrapMode)

形状全体、または形状の境界上にテクスチャを並べて表示する方法を決定するために使用されるラップ モードを設定します。Sets the wrap mode that is used to decide how to tile a texture across a shape, or at shape boundaries. テクスチャで塗りつぶす形状がそのテクスチャより小さい場合、テクスチャは形状の境界をはみだして表示されます。A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.

SetWrapMode(WrapMode, Color) SetWrapMode(WrapMode, Color) SetWrapMode(WrapMode, Color) SetWrapMode(WrapMode, Color)

形状全体、または形状の境界上にテクスチャを並べて表示する方法を決定するために使用される、ラップ モードおよび色を指定します。Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. テクスチャで塗りつぶす形状がそのテクスチャより小さい場合、テクスチャは形状の境界をはみだして表示されます。A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.

SetWrapMode(WrapMode, Color, Boolean) SetWrapMode(WrapMode, Color, Boolean) SetWrapMode(WrapMode, Color, Boolean) SetWrapMode(WrapMode, Color, Boolean)

形状全体、または形状の境界上にテクスチャを並べて表示する方法を決定するために使用される、ラップ モードおよび色を指定します。Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. テクスチャで塗りつぶす形状がそのテクスチャより小さい場合、テクスチャは形状の境界をはみだして表示されます。A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください