ImageAttributes Kelas

Definisi

Berisi informasi tentang bagaimana bitmap dan warna metafile dimanipulasi selama penyajian.

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
Warisan
ImageAttributes
Penerapan

Contoh

Contoh berikut mengambil gambar yang semuanya satu warna (0,2, 0,0, 0,4, 1,0) dan menggandakan komponen merah menambahkan 0,2 ke komponen merah, hijau, dan biru.

Ilustrasi berikut menunjukkan gambar asli di sebelah kiri dan gambar yang diubah di sebelah kanan.

Warna

Kode dalam contoh menggunakan langkah-langkah berikut untuk melakukan pewarnaan ulang:

  1. Menginisialisasi ColorMatrix objek.

  2. ImageAttributes Create objek dan teruskan ColorMatrix objek ke SetColorMatrix metode ImageAttributes objek .

  3. Teruskan ImageAttributes objek ke DrawImage metode Graphics objek.

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)

Keterangan

Objek ImageAttributes mempertahankan beberapa pengaturan penyesuaian warna, termasuk matriks penyesuaian warna, matriks penyesuaian skala abu-abu, nilai koreksi gamma, tabel peta warna, dan nilai ambang warna. Selama penyajian, warna dapat dikoreksi, digelapkan, dicerahkan, dan dihilangkan. Untuk menerapkan manipulasi tersebut, inisialisasi ImageAttributes objek dan lewati jalur ImageAttributes objek tersebut (bersama dengan jalur Image) ke DrawImage metode .

Catatan

Dalam .NET 6 dan versi yang lebih baru, paket System.Drawing.Common, yang mencakup jenis ini, hanya didukung pada sistem operasi Windows. Penggunaan jenis ini dalam aplikasi lintas platform menyebabkan peringatan waktu kompilasi dan pengecualian run-time. Untuk informasi selengkapnya, lihat System.Drawing.Common hanya didukung di Windows.

Konstruktor

ImageAttributes()

Menginisialisasi instans baru kelas ImageAttributes.

Metode

ClearBrushRemapTable()

Menghapus tabel kuas warna-remap objek ini ImageAttributes .

ClearColorKey()

Menghapus kunci warna (rentang transparansi) untuk kategori default.

ClearColorKey(ColorAdjustType)

Menghapus kunci warna (rentang transparansi) untuk kategori tertentu.

ClearColorMatrix()

Menghapus matriks penyesuaian warna untuk kategori default.

ClearColorMatrix(ColorAdjustType)

Menghapus matriks penyesuaian warna untuk kategori tertentu.

ClearGamma()

Menonaktifkan koreksi gamma untuk kategori default.

ClearGamma(ColorAdjustType)

Menonaktifkan koreksi gamma untuk kategori tertentu.

ClearNoOp()

NoOp Menghapus pengaturan untuk kategori default.

ClearNoOp(ColorAdjustType)

NoOp Menghapus pengaturan untuk kategori tertentu.

ClearOutputChannel()

Menghapus pengaturan saluran output CMYK (cyan-magenta-yellow-black) untuk kategori default.

ClearOutputChannel(ColorAdjustType)

Menghapus pengaturan saluran output (cyan-magenta-yellow-black) untuk kategori tertentu.

ClearOutputChannelColorProfile()

Menghapus pengaturan profil warna saluran output untuk kategori default.

ClearOutputChannelColorProfile(ColorAdjustType)

Menghapus pengaturan profil warna saluran output untuk kategori tertentu.

ClearRemapTable()

Menghapus tabel remap warna untuk kategori default.

ClearRemapTable(ColorAdjustType)

Menghapus tabel remap warna untuk kategori tertentu.

ClearThreshold()

Menghapus nilai ambang untuk kategori default.

ClearThreshold(ColorAdjustType)

Menghapus nilai ambang untuk kategori tertentu.

Clone()

Membuat salinan yang tepat dari objek ini ImageAttributes .

Dispose()

Melepaskan semua sumber daya yang digunakan oleh objek ini ImageAttributes .

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
Finalize()

Memungkinkan objek untuk mencoba membebaskan sumber daya dan melakukan operasi pembersihan lainnya sebelum direklamasi kembali oleh pengumpulan sampah.

GetAdjustedPalette(ColorPalette, ColorAdjustType)

Menyesuaikan warna dalam palet sesuai dengan pengaturan penyesuaian kategori tertentu.

GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan instans Type saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari yang saat ini Object.

(Diperoleh dari Object)
SetBrushRemapTable(ColorMap[])

Mengatur tabel remap warna untuk kategori kuas.

SetBrushRemapTable(ReadOnlySpan<ColorMap>)

Berisi informasi tentang bagaimana bitmap dan warna metafile dimanipulasi selama penyajian.

SetBrushRemapTable(ReadOnlySpan<ValueTuple<Color,Color>>)

Berisi informasi tentang bagaimana bitmap dan warna metafile dimanipulasi selama penyajian.

SetColorKey(Color, Color)

Mengatur kunci warna untuk kategori default.

SetColorKey(Color, Color, ColorAdjustType)

Mengatur kunci warna (rentang transparansi) untuk kategori tertentu.

SetColorMatrices(ColorMatrix, ColorMatrix)

Mengatur matriks penyesuaian warna dan matriks penyesuaian skala abu-abu untuk kategori default.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag)

Mengatur matriks penyesuaian warna dan matriks penyesuaian skala abu-abu untuk kategori default.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Mengatur matriks penyesuaian warna dan matriks penyesuaian skala abu-abu untuk kategori tertentu.

SetColorMatrix(ColorMatrix)

Mengatur matriks penyesuaian warna untuk kategori default.

SetColorMatrix(ColorMatrix, ColorMatrixFlag)

Mengatur matriks penyesuaian warna untuk kategori default.

SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Mengatur matriks penyesuaian warna untuk kategori tertentu.

SetGamma(Single)

Mengatur nilai gamma untuk kategori default.

SetGamma(Single, ColorAdjustType)

Mengatur nilai gamma untuk kategori tertentu.

SetNoOp()

Menonaktifkan penyesuaian warna untuk kategori default. Anda dapat memanggil ClearNoOp metode untuk memulihkan pengaturan penyesuaian warna yang ada sebelum panggilan ke SetNoOp metode .

SetNoOp(ColorAdjustType)

Menonaktifkan penyesuaian warna untuk kategori tertentu. Anda dapat memanggil ClearNoOp metode untuk memulihkan pengaturan penyesuaian warna yang ada sebelum panggilan ke SetNoOp metode .

SetOutputChannel(ColorChannelFlag)

Mengatur saluran output CMYK (cyan-magenta-yellow-black) untuk kategori default.

SetOutputChannel(ColorChannelFlag, ColorAdjustType)

Mengatur saluran output CMYK (cyan-magenta-yellow-black) untuk kategori tertentu.

SetOutputChannelColorProfile(String)

Mengatur file profil warna saluran output untuk kategori default.

SetOutputChannelColorProfile(String, ColorAdjustType)

Mengatur file profil warna saluran output untuk kategori tertentu.

SetRemapTable(ColorAdjustType, ReadOnlySpan<ColorMap>)

Berisi informasi tentang bagaimana bitmap dan warna metafile dimanipulasi selama penyajian.

SetRemapTable(ColorAdjustType, ReadOnlySpan<ValueTuple<Color,Color>>)

Berisi informasi tentang bagaimana bitmap dan warna metafile dimanipulasi selama penyajian.

SetRemapTable(ColorMap[])

Mengatur tabel remap warna untuk kategori default.

SetRemapTable(ColorMap[], ColorAdjustType)

Mengatur tabel remap warna untuk kategori tertentu.

SetRemapTable(ReadOnlySpan<ColorMap>)

Berisi informasi tentang bagaimana bitmap dan warna metafile dimanipulasi selama penyajian.

SetRemapTable(ReadOnlySpan<ValueTuple<Color,Color>>)

Berisi informasi tentang bagaimana bitmap dan warna metafile dimanipulasi selama penyajian.

SetThreshold(Single)

Mengatur ambang batas (rentang transparansi) untuk kategori default.

SetThreshold(Single, ColorAdjustType)

Mengatur ambang batas (rentang transparansi) untuk kategori tertentu.

SetWrapMode(WrapMode)

Mengatur mode bungkus yang digunakan untuk memutuskan cara memetakan tekstur di seluruh bentuk, atau pada batas bentuk. Tekstur diurutkan di seluruh bentuk untuk mengisinya ketika tekstur lebih kecil dari bentuk yang diisinya.

SetWrapMode(WrapMode, Color)

Mengatur mode bungkus dan warna yang digunakan untuk memutuskan cara memetakan tekstur di seluruh bentuk, atau pada batas bentuk. Tekstur diurutkan di seluruh bentuk untuk mengisinya ketika tekstur lebih kecil dari bentuk yang diisinya.

SetWrapMode(WrapMode, Color, Boolean)

Mengatur mode bungkus dan warna yang digunakan untuk memutuskan cara memetakan tekstur di seluruh bentuk, atau pada batas bentuk. Tekstur diurutkan di seluruh bentuk untuk mengisinya ketika tekstur lebih kecil dari bentuk yang diisinya.

ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Berlaku untuk

Lihat juga