hsb( function

hsb(

HUE

SATURATION

BRIGHTNESS

ALPHA

)

The hsb( function creates a color by combining hue, saturation, and brightness components. See Colors.

Parameters

This function has four parameters:

hue – specifies where this color falls in the spectrum. If you are familiar with the standard Apple color picker, the hue would specify the angle of the color from the center of the wheel. This must be a number from 0 to 65535.

saturation – specifies how intense this color is. Is it a very intense deep color, or is it a soft pastel color, or somewhere in between? Again using the standard Apple color picker, the saturation would specify the distance of the color from the center of the wheel. This must be a number from 0 (black) to 65535 (full intensity).

brightness – specifies how light or dark the color is. Is the color very bright, or is it almost black? This sounds similar to saturation, but it isn’t. Imagine a blue ball under a white light. As the light gets dimmer, the hue and saturation of the color don’t change, but the brightness does. On the Apple color picker the brightness is specified by the scroll bar on the right. This must be a number from 0 (black) to 65535 (full intensity).

alpha – is the opacity component of this color. This must be a number from 0 (transparent) to 65535 (fully opaque). This parameter is optional, if ommitted, the alpha component defaults to fully opaque.

Description

This function creates a color by combining hue, saturation, and brightness components. See Colors.

The example below changes the color of any object named Border to orange.

local Orange
Orange = hsb( 3563 , 62600 , 65535 )
selectobjects objectinfo("name") = "Border"
changeobjects "color",Orange

You will find an excellent explanatory article about the HSB color system at https://learnui.design/blog/the-hsb-color-system-practicioners-primer.html.

See Also

alpha( -- extracts the alpha (opacity) from a color.
black( -- returns black as a Panorama color value (see Colors).
blue( -- extracts the blue intensity from a color.
brightness( -- extracts the brightness from a color.
Colors -- Using colors in Panorama formulas and procedures.
colorwheel -- allows the user to pick a color using the operating systems standard color picker dialog
formcolor -- changes the background color of the current form.
getwebcolor( -- calculates an RGB color from a Netscape style web color.
gray( -- returns a shade of gray as a Panorama color value (see Colors).
green( -- extracts the green intensity from a color.
htmlcolor( -- converts a color name into a hex HTML color (RRGGBB format).
htmlcolorarray( -- generates a text array of HTML colors that gradually transition from one color to another.
htmlrgb( -- converts text formatted as an HTML color into a Panorama color value (see Colors).
htmlrgbstr( -- converts a color to text formatted as an HTML color.
hue( -- extracts the hue from a color.
info("colornames") -- returns a list of color names that can be used as a text object background and with the htmlcolor( function.
info("formcolor") -- returns the background color of the current form.
red( -- extracts the red intensity from a color.
rgb( -- creates a color by combining red, green, and blue primary colors. See Colors.
rgbstr( -- converts a color into text in the format *red,green,blue*.
saturation( -- extracts the saturation from a color.
white( -- returns white as a Panorama color value (see Colors).

History

Version	Status	Notes
10.0	Updated	Carried over from Panorama 6.0, but now includes an optional alpha (opacity) component.