# Funciones de color

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

### Comentarios

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/21/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.

### Comentarios

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/21/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.

### Comentarios

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/21/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.

### Comentarios

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/21/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.

### Comentarios

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/21/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.

### Comentarios

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/21/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.

### Comentarios

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/21/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.

### Comentarios

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/21/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.
