ImageAttributes Класс

Определение

Содержит сведения о том, каким образом обрабатываются цвета точечных рисунков и метафайлов во время отрисовки.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
Наследование
ImageAttributes
Реализации

Примеры

В следующем примере создается изображение, которое имеет один цвет (0,2, 0,0, 0,4, 1,0) и удваивается красный компонент добавляет в красный, зеленый и синий компоненты 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.Initializes a new instance of the ImageAttributes class.

Методы

ClearBrushRemapTable()

Очищает таблицу преобразования цветов кисти этого объекта ImageAttributes.Clears the brush color-remap table of this ImageAttributes object.

ClearColorKey()

Очищает цветовой ключ (диапазон прозрачности) для категории по умолчанию.Clears the color key (transparency range) for the default category.

ClearColorKey(ColorAdjustType)

Очищает цветовой ключ (диапазон прозрачности) для указанной категории.Clears the color key (transparency range) for a specified category.

ClearColorMatrix()

Очищает матрицу настройки цвета для категории по умолчанию.Clears the color-adjustment matrix for the default category.

ClearColorMatrix(ColorAdjustType)

Очищает матрицу настройки цвета для определенной категории.Clears the color-adjustment matrix for a specified category.

ClearGamma()

Отключает гамма-коррекцию для категории по умолчанию.Disables gamma correction for the default category.

ClearGamma(ColorAdjustType)

Отключает гамма-коррекцию для определенной категории.Disables gamma correction for a specified category.

ClearNoOp()

Очищает параметр NoOp для категории по умолчанию.Clears the NoOp setting for the default category.

ClearNoOp(ColorAdjustType)

Очищает параметр NoOp для указанной категории.Clears the NoOp setting for a specified category.

ClearOutputChannel()

Очищает параметр CMYK (cyan-magenta-yellow-black или голубой-пурпурный-желтый-черный) выходного канала для категории по умолчанию.Clears the CMYK (cyan-magenta-yellow-black) output channel setting for the default category.

ClearOutputChannel(ColorAdjustType)

Очищает параметр CMYK (cyan-magenta-yellow-black или голубой-пурпурный-желтый-черный) выходного канала для указанной категории.Clears the (cyan-magenta-yellow-black) output channel setting for a specified category.

ClearOutputChannelColorProfile()

Очищает настройку цветового профиля выходного канала для категории по умолчанию.Clears the output channel color profile setting for the default category.

ClearOutputChannelColorProfile(ColorAdjustType)

Очищает настройку цветового профиля выходного канала для указанной категории.Clears the output channel color profile setting for a specified category.

ClearRemapTable()

Очищает таблицу преобразования цветов для категории по умолчанию.Clears the color-remap table for the default category.

ClearRemapTable(ColorAdjustType)

Очищает таблицу преобразования цветов для указанной категории.Clears the color-remap table for a specified category.

ClearThreshold()

Очищает пороговое значение для категории по умолчанию.Clears the threshold value for the default category.

ClearThreshold(ColorAdjustType)

Очищает пороговое значение для определенной категории.Clears the threshold value for a specified category.

Clone()

Создает точную копию объекта ImageAttributes.Creates an exact copy of this ImageAttributes object.

Dispose()

Освобождает все ресурсы, используемые этим объектом ImageAttributes.Releases all resources used by this ImageAttributes object.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Finalize()

Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как он будет уничтожен во время сборки мусора.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetAdjustedPalette(ColorPalette, ColorAdjustType)

Настраивает цвета в палитре согласно параметрам настройки указанной категории.Adjusts the colors in a palette according to the adjustment settings of a specified category.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
SetBrushRemapTable(ColorMap[])

Задает таблицу преобразования цветов для категории кистей.Sets the color-remap table for the brush category.

SetColorKey(Color, Color)

Задает цветовой ключ для категории по умолчанию.Sets the color key for the default category.

SetColorKey(Color, Color, ColorAdjustType)

Задает цветовой ключ (диапазон прозрачности) для определенной категории.Sets the color key (transparency range) for a specified category.

SetColorMatrices(ColorMatrix, ColorMatrix)

Задает матрицу настройки цвета и матрицу настройки оттенков серого для категории по умолчанию.Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag)

Задает матрицу настройки цвета и матрицу настройки оттенков серого для категории по умолчанию.Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Задает матрицу настройки цвета и матрицу настройки оттенков серого для указанной категории.Sets the color-adjustment matrix and the grayscale-adjustment matrix for a specified category.

SetColorMatrix(ColorMatrix)

Задает матрицу настройки цвета для категории по умолчанию.Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag)

Задает матрицу настройки цвета для категории по умолчанию.Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Задает матрицу настройки цвета для указанной категории.Sets the color-adjustment matrix for a specified category.

SetGamma(Single)

Задает гамма-значение для категории по умолчанию.Sets the gamma value for the default category.

SetGamma(Single, ColorAdjustType)

Задает гамма-значение для определенной категории.Sets the gamma value for a specified category.

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)

Отключает настройку цвета для определенной категории.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)

Устанавливает выходной канал CMYK (cyan-magenta-yellow-black или голубой-пурпурный-желтый-черный) для категории по умолчанию.Sets the CMYK (cyan-magenta-yellow-black) output channel for the default category.

SetOutputChannel(ColorChannelFlag, ColorAdjustType)

Устанавливает выходной канал CMYK (cyan-magenta-yellow-black или голубой-пурпурный-желтый-черный) для указанной категории.Sets the CMYK (cyan-magenta-yellow-black) output channel for a specified category.

SetOutputChannelColorProfile(String)

Задает файл цветового профиля выходного канала для категории по умолчанию.Sets the output channel color-profile file for the default category.

SetOutputChannelColorProfile(String, ColorAdjustType)

Задает файл цветового профиля выходного канала для указанной категории.Sets the output channel color-profile file for a specified category.

SetRemapTable(ColorMap[])

Задает таблицу преобразования цветов для категории по умолчанию.Sets the color-remap table for the default category.

SetRemapTable(ColorMap[], ColorAdjustType)

Задает таблицу преобразования цветов для определенной категории.Sets the color-remap table for a specified category.

SetThreshold(Single)

Задает пороговое значение (диапазон прозрачности) для категории по умолчанию.Sets the threshold (transparency range) for the default category.

SetThreshold(Single, ColorAdjustType)

Задает пороговое значение (диапазон прозрачности) для указанной категории.Sets the threshold (transparency range) for a specified category.

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)

Задает режим переноса и цвет, которые используются для определения метода мозаичного наложения текстуры: по всей фигуре или на краях фигуры.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)

Задает режим переноса и цвет, которые используются для определения метода мозаичного наложения текстуры: по всей фигуре или на краях фигуры.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()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно