Funciones de color
Conjunto de Funciones de fórmula orientadas al manejo de colores.
getAlpha
Devuelve el valor del canal alfa de un color CMYKA o RGBA. El canal alfa es el que nos permite establecer el grado de transparencia de un color.
Sintaxis
getAlpha(color)
Parámetros
color
Valor numérico de un color RGBA o CMYKA. Dicho valor deberá ser expresado en formato decimal.
El dato devuelto deberá ser un valor comprendido entre 0 (sin transparencia) y 255.
Dado que el parámetro ha de ser expresado en formato decimal y dado que los colores suelen ser codificados en formato hexadecimal, podremos utilizar la función de fórmulas stringHexToNumber para convertir el código hexadecimal de un color en un número decimal.
getBlack
Devuelve el componente K (negro) de un color CMYK o CMYKA.
Sintaxis
getBlack(color)
Parámetros
color
Valor numérico de un color CMYK o CMYKA. Dicho valor deberá ser expresado en formato decimal.
El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente negro) y 255.
Dado que el parámetro ha de ser expresado en formato decimal y dado que los colores suelen ser codificados en formato hexadecimal, podremos utilizar la función de fórmulas stringHexToNumber para convertir el código hexadecimal de un color en un número decimal.
getBlue
Devuelve el componente B (azul) de un color RGB o RGBA.
Sintaxis
getBlue(color)
Parámetros
color
Valor numérico de un color RGB o RGBA. Dicho valor deberá ser expresado en formato decimal.
El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente azul) y 255.
Dado que el parámetro ha de ser expresado en formato decimal y dado que los colores suelen ser codificados en formato hexadecimal, podremos utilizar la función de fórmulas stringHexToNumber para convertir el código hexadecimal de un color en un número decimal.
getCyan
Devuelve el componente C (cián) de un color CMYK o CMYKA.
Sintaxis
getCyan(color)
Parámetros
color
Valor numérico de un color CMYK o CMYKA. Dicho valor deberá estar comprendido entre 0 y 1.
El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente cián) y 255.
getGray
Devuelve el gris equivalente al color pasado como parámetro.
Sintaxis
getGray(color)
Parámetros
color
Valor numérico de un color RGB o CMYK. Dicho valor deberá ser expresado en formato decimal.
El dato devuelto deberá ser un valor comprendido entre 0 y 255.
Dado que el parámetro ha de ser expresado en formato decimal y dado que los colores suelen ser codificados en formato hexadecimal, podremos utilizar la función de fórmulas stringHexToNumber para convertir el código hexadecimal de un color en un número decimal.
getGreen
Devuelve el componente G (verde) de un color RGB o RGBA.
Sintaxis
getGreen(color)
Parámetros
color
Valor numérico de un color RGB o RGBA. Dicho valor deberá ser expresado en formato decimal.
El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente verde) y 255.
Dado que el parámetro ha de ser expresado en formato decimal y dado que los colores suelen ser codificados en formato hexadecimal, podremos utilizar la función de fórmulas stringHexToNumber para convertir el código hexadecimal de un color en un número decimal.
getMagenta
Devuelve el componente M (magenta) de un color CMYK o CMYKA.
Sintaxis
getMagenta(color)
Parámetros
color
Valor numérico de un color CMYK o CMYKA. Dicho valor deberá ser expresado en formato decimal.
El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente magenta) y 255.
Dado que el parámetro ha de ser expresado en formato decimal y dado que los colores suelen ser codificados en formato hexadecimal, podremos utilizar la función de fórmulas stringHexToNumber para convertir el código hexadecimal de un color en un número decimal.
getRed
Devuelve el componente R (rojo) de un color RGB o RGBA.
Sintaxis
getRed(color)
Parámetros
color
Valor numérico de un color RGB o RGBA. Dicho valor deberá ser expresado en formato decimal.
El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente rojo) y 255.
Dado que el parámetro ha de ser expresado en formato decimal y dado que los colores suelen ser codificados en formato hexadecimal, podremos utilizar la función de fórmulas stringHexToNumber para convertir el código hexadecimal de un color en un número decimal.
getYellow
Devuelve el componente Y (amarillo) de un color CMYK o CMYKA.
Sintaxis
getYellow(color)
Parámetros
color
Valor numérico de un color CMYK o CMYKA. Dicho valor deberá ser expresado en formato decimal.
El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente amarillo) y 255.
Dado que el parámetro ha de ser expresado en formato decimal y dado que los colores suelen ser codificados en formato hexadecimal, podremos utilizar la función de fórmulas stringHexToNumber para convertir el código hexadecimal de un color en un número decimal.
setCMYK
Compone un color siguiendo el modelo CMYK.
CMYK es acrónimo de Cyan, Magenta, Yellow y Key (Black).
Sintaxis
setCMYK(cyan, magenta, yellow, black)
Parámetros
cyan
Expresión numérica con el valor del componente cián del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
magenta
Expresión numérica con el valor del componente magenta del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
yellow
Expresión numérica con el valor del componente amarillo del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
black
Expresión numérica con el valor del componente negro del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
Internamente el resultado será guardado como un valor comprendido entre 0 y 1.
setCMYKA
Compone un color siguiendo el modelo CMYKA.
CMYKA es el acrónimo de Cyan, Magenta, Yellow, Key (Black) y Alpha.
Alpha es el canal de un color CMYKA que permite establecer un grado de transparencia al mismo.
Sintaxis
setCMYKA(cyan, magenta, yellow, key, alpha)
Parámetros
cyan
Expresión numérica con el valor del componente cián del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
magenta
Expresión numérica con el valor del componente magenta del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
yellow
Expresión numérica con el valor del componente amarillo del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
black
Expresión numérica con el valor del componente negro del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
Alfa
Expresión numérica con el valor del canal alfa del color. El canal alfa nos permite definir el grado de transparencia de un color Será un número comprendido entre 0 y 255. El valor 0 indicará que el color será totalmente opaco.
Internamente el resultado será guardado como un valor comprendido entre 0 y 1.
setRGB
Compone un color siguiendo el modelo RGB.
RGB es el acrónimo de Red, Green, y Blue.
Sintaxis
setRGB(red, green, blue)
Parámetros
red
Expresión numérica con el valor del componente rojo del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
green
Expresión numérica con el valor del componente verde del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
blue
Expresión numérica con el valor del componente azul del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
Internamente el resultado será guardado como un valor comprendido entre 0 y 1.
setRGBA
Compone un color siguiendo el modelo RGBA.
RGBA es el acrónimo de Red, Green, Blue y Alpha.
Alpha es el canal de un color RGBA que permite establecer un grado de transparencia al mismo.
Sintaxis
setRGBA(red, green, blue, alpha)
Parámetros
red
Expresión numérica con el valor del componente rojo del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
green
Expresión numérica con el valor del componente verde del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
blue
Expresión numérica con el valor del componente azul del color. Será un número comprendido entre 0 y 255. El valor 0 indicará ausencia de este componente.
Alpha
Expresión numérica con el valor del canal alfa del color. El canal alfa nos permite definir el grado de transparencia de un color Será un número comprendido entre 0 y 255. El valor 0 indicará que el color será totalmente opaco.
Internamente el resultado será guardado como un valor comprendido entre 0 y 1.