Método ImageAttributes::SetColorMatrices (gdiplusimageattributes.h)

Artículo
08/24/2023

El método ImageAttributes::SetColorMatrices establece la matriz de ajuste de color y la matriz de ajuste de escala de grises para una categoría especificada.

Sintaxis

Status SetColorMatrices(
  [in]           const ColorMatrix *colorMatrix,
  [in]           const ColorMatrix *grayMatrix,
  [in, optional] ColorMatrixFlags  mode,
  [in, optional] ColorAdjustType   type
);

Parámetros

[in] colorMatrix

Tipo: const ColorMatrix*

Puntero a una matriz de ajuste de color de 5×5.

[in] grayMatrix

Tipo: const ColorMatrix*

Puntero a una matriz de ajuste de escala de grises de 5×5.

[in, optional] mode

Tipo: ColorMatrixFlags

Elemento de la enumeración ColorMatrixFlags que especifica el tipo de imagen y color que se verá afectado por las matrices de ajuste de color y ajuste de escala de grises. El valor predeterminado es ColorMatrixFlagsDefault.

[in, optional] type

Tipo: ColorAdjustType

Elemento de la enumeración ColorAdjustType que especifica la categoría para la que se establecen las matrices de ajuste de color y ajuste de escala de grises. El valor predeterminado es ColorAdjustTypeDefault.

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Un objeto ImageAttributes mantiene la configuración de color y escala de grises para cinco categorías de ajuste: predeterminado, mapa de bits, pincel, lápiz y texto. Por ejemplo, puede especificar matrices de ajuste para la categoría predeterminada, diferentes matrices de ajuste para la categoría de mapa de bits y otras matrices de ajuste para la categoría de lápiz.

La configuración predeterminada de ajuste de escala de grises y color se aplica a todas las categorías que no tienen ajustes de ajuste propios. Por ejemplo, si nunca especifica ninguna configuración de ajuste para la categoría de lápiz, la configuración predeterminada se aplica a la categoría de lápiz.

En cuanto especifique un ajuste de ajuste de escala de grises o de color para una determinada categoría, la configuración de ajuste predeterminada ya no se aplica a esa categoría. Por ejemplo, supongamos que especifica una colección de opciones de ajuste para la categoría predeterminada. Si establece las matrices de ajuste de color y ajuste de escala de grises para la categoría de lápiz pasando ColorAdjustTypePen al método ImageAttributes::SetColorMatrices , no se aplicará ninguno de los ajustes de ajuste predeterminados a los lápices.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusimageattributes.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll