# Funciones de color

Conjunto de [Funciones de fórmula](https://doc.velneo.com/32/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.

### 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 ](https://doc.velneo.com/32/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.

### 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 ](https://doc.velneo.com/32/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.

### 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 ](https://doc.velneo.com/32/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.

### 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](https://doc.velneo.com/32/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.

### 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 ](https://doc.velneo.com/32/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.

### 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](https://doc.velneo.com/32/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.

### 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 ](https://doc.velneo.com/32/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.

### 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 ](https://doc.velneo.com/32/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.

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.
