IBM Visualization Data Explorer User's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

Convert

Category

Transformation

Function

Converts between RGB and HSV color spaces.

Syntax

Output = Convert(data, incolorspace, outcolorspace, addpoints);

Inputs
Name Type Default Description
data vector list or field none input colors or color map
incolorspace string "hsv" color space of input
outcolorspace string "rgb" color space of output
addpoints integer input dependent add positions to ensure valid color transformations

Outputs
Name Type Description
output vector list or field output colors or color map

Functional Details

data

specifies the value(s) to be converted. If the parameter value is a vector or list of vectors, the output is a vector or list of vectors. These must be of 3-vectors, representing hue, saturation, and value (HSV) or red, green, and blue (RGB).

If the parameter value is a field, the module converts the "data" component of that field (which must consist of 3-vectors) from one color space to the other.

The range of hues is 0 (red) to 1 (red); 0.3333 = green and 0.6666 = blue. Values outside this range simply "wrap." That is, a hue of 0 = a hue of 1 = a hue of 2, and so on.

The range of saturation is 0 (white) to 1 (pure color).

The range of value is 0 (black) to 1 (full intensity).

incolorspace

is the color space of the input (data) and must be "rgb" or "hsv."

outcolorspace

is the color space of the output and must be "rgb" or "hsv."

addpoints

specifies whether points are to be added to the resulting output:

If data is a color map (i.e., if it has 1-D positions and 3-D data), the default value (1) specifies that points will be added to the "positions" component of the map so that the conversion between color spaces (which is nonlinear) remains valid. A parameter value of 0 (zero) specifies that no points are to be added.

A parameter value of 1 (one) is valid only if the input is a color map. If the input object is not a color map (i.e., if it has positions of dimensionality greater than 1), the default value is 0 (zero) and the "data" component is converted as specified by incolorspace and outcolorspace in one-to-one fashion.

Components

Modifies the "data" component and may modify the "positions" component. All other input components are propagated to the output.

Example Visual Programs

AlternateVisualizations.net
UsingCompute.net

See Also

 Color


[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]


[IBM Home Page | Order | Search | Contact IBM | Legal ]