# Funciones de color

Conjunto de [Funciones de fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) 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.

El dato devuelto deberá ser un valor comprendido entre 0 (sin transparencia) y 255.

`getAlpha(color)`

#### Parámetros

* **color**

  Valor numérico de un color RGBA o CMYKA. Dicho valor deberá ser expresado en formato decimal.&#x20;

  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 ](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas/funciones-cientificas#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.

El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente negro) y 255.

`getBlack(color)`

#### Parámetros

* **color**

  Valor numérico de un color CMYK o CMYKA. Dicho valor deberá ser expresado en formato decimal.&#x20;

  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 ](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas/funciones-cientificas#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. El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente azul) y 255.

`getBlue(color)`

#### Parámetros

* **color**

  Valor numérico de un color RGB o RGBA. Dicho valor deberá ser expresado en formato decimal.

  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 ](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas/funciones-cientificas#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. El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente cián) y 255.

`getCyan(color)`

#### Parámetros

* **color**

  Valor numérico de un color CMYK o CMYKA. Dicho valor deberá estar comprendido entre 0 y 1.

## getGray

Devuelve el gris equivalente al color pasado como parámetro. El dato devuelto deberá ser un valor comprendido entre 0 y 255.

`getGray(color)`

#### Parámetros

* **color**

  Valor numérico de un color RGB o CMYK. Dicho valor deberá ser expresado en formato decimal.

  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](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas/funciones-cientificas#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. El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente verde) y 255.

`getGreen(color)`

#### Parámetros

* **color**

  Valor numérico de un color RGB o RGBA. Dicho valor deberá ser expresado en formato decimal.

  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 ](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas/funciones-cientificas#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. El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente magenta) y 255.

`getMagenta(color)`

#### Parámetros

* **color**

  Valor numérico de un color CMYK o CMYKA. Dicho valor deberá ser expresado en formato decimal.

  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](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas/funciones-cientificas#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. El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente rojo) y 255.

`getRed(color)`

#### Parámetros

* **color**

  Valor numérico de un color RGB o RGBA. Dicho valor deberá ser expresado en formato decimal.

  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 ](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas/funciones-cientificas#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. El dato devuelto deberá ser un valor comprendido entre 0 (ausencia de componente amarillo) y 255.

`getYellow(color)`

#### Parámetros

* **color**

  Valor numérico de un color CMYK o CMYKA. Dicho valor deberá ser expresado en formato decimal.

  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 ](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas/funciones-cientificas#stringhextonumber)para convertir el código hexadecimal de un color en un número decimal.

## setCMYK

Compone un color siguiendo el modelo CMYK (acrónimo de Cyan, Magenta, Yellow y Key -Black-). Internamente el resultado será guardado como un valor comprendido entre 0 y 1.

`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.

## setCMYKA

Compone un color siguiendo el modelo CMYKA (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.

Internamente el resultado será guardado como un valor comprendido entre 0 y 1.

`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.

## setRGB

Compone un color siguiendo el modelo RGB (acrónimo de Red, Green, y Blue). Internamente el resultado será guardado como un valor comprendido entre 0 y 1.

`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.

## setRGBA

Compone un color siguiendo el modelo RGBA (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.

Internamente el resultado será guardado como un valor comprendido entre 0 y 1.

`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.
