SVG_Filter_ColorMatrix

El comando SVG_Filter_ColorMatrix aplica una transformación de matriz de color a cada píxel de la imagen fuente pasada en el parámetro objetoSVG para producir un resultado con un nuevo conjunto de valores de color.

En el parámetro in, puede pasar una cadena que coincide con un valor "result" anterior o una de las seis siguientes palabras claves:

• SourceGraphic: el elemento objetivo (imagen, forma , grupo, etc.) que referencia el filtro. Esta palabra clave representa los elementos gráficos que eran la entrada original en el elemento "filtro".
• SourceAlpha: el canvas bajo el SourceGraphic. Esta palabra clave representa los elementos gráficos que eran la entrada original en el elemento "filtro".
• BackgroundImage: el canvas bajo el SourceGraphic. Esta palabra clave representa una instantánea de imagen del canvas bajo la región del filtro en el momento en que se invocó el elemento "filtro".
• BackgroundAlpha: el canal alfa del canvas bajo el SourceGraphic. Igual que BackgroundImage excepto que únicamente se utiliza el canal alfa.
• FillPaint: un pseudo-gráfico igual al tamaño de la región de filtro llenado con la propiedad de relleno del elemento objetivo. Esta palabra clave representa el valor de la propiedad 'relleno' en el elemento objetivo para el efecto  filtro.
• StrokePaint: una pseudo-gráfico igual al tamaño de la región de filtro de llenado con la propiedad de trazo del elemento objetivo. Esta palabra clave representa el valor de la propiedad 'trazo' en el elemento objetivo para el efecto de filtro.

Si no se pasa ningún valor y este es el primer filtro primitiva, entonces el SourceGraphic se utiliza como su entrada. Si no se ofrece ningún valor y esto es un filtro posterior primitivo, a continuación, este filtro primitivo, utilizará el resultado del filtro anterior primitivo como su entrada.

En el parámetro result, pase una referencia para el resultado de la salida de un filtro que puede ser referenciado por el parámetro in en un uso posterior de este comando en el mismo elemento "filtro". Si no se ofrece ningún valor, la salida se encuentra disponible para su reutilización como la entrada implícita para la siguiente primitiva de filtro si ese filtro primitivo ofrece ningún valor para su parámetro in.

En el parámetro tipo, puede especificar el tipo de operación matriz al pasar una de las siguientes palabras:

• saturate: ajusta la saturación de todos los canales de color RGB utilizando un valor de número real de 0 a 1 que se pasa en el parámetro valores.
• hueRotate: rota el pixel hue de todos los canales de color RGB el ángulo especificado (en grados) en el parámetro valores,
• luminanceToAlpha: convierte los canales rojo, verde y azul en un valor de luminancia. Los canales RGB están definidos en negro (0,0,0).)
• matrix: define el color utilizando la lista de valores pasados en el parámetro valores. Permite el valor de cada canal en la salida a especificar de una combinación de su color existente y canales alfa.

Si no pasa un parámetro tipo, por defecto el efecto es como si un valor de matriz se hubiera especificado.

En el parámetro valores, pase valores numéricos basados en la palabra clave pasada en el parámetro tipo:

• Con la palabra clave "matrix":  pase una lista de 20 valores de matriz, separados por espacios en blanco y/o una coma.
• Con la palabra clave "saturate": pase un valor de número real individual (0 a 1). El valor permitido de acuerdo con la especificación es de 0-1, pero muchos navegadores aceptan valores superiores> 1 para permitir el exceso de saturación.
• Con la palabra clave "hueRotate": pase un valor número real (para indicar los grados de rotación).
• Con la palabra clave "luminanceToAlpha": no pase un valor numérico. El atributo "valores" no se utiliza con este tipo, lo que descarta el canal alfa y lo reemplaza con valores iguales a la luminancia de la entrada.

Si no pasa un parámetro valores, el comportamiento por defecto depende de la palabra clave pasada en el parámetro tipo:

• Con la palabra clave "matrix": por defecto se utilizan los valores de la matriz de identidad
• Con la palabra clave "saturate": por defecto, el valor es 1 (sin cambios).
• Con la palabra clave "hueRotate": por defecto el valor es 0 (sin cambios).
• Con la palabra clave "luminanceToAlpha": por defecto, este parámetro no se utiliza.

Nota: bajo Windows, este comando requiere la desactivación previa de Direct2D (ver la constante Direct2D disabled en la descripción del comando SET DATABASE PARAMETER).