Color.HLSLightness property - Developer Area

API Documentation > CorelDRAW > 2022-v24.1 > Color > IVGColor

Color.HLSLightness property

Gets or sets the HLS Lightness value

Syntax:

Property Get HLSLightness() As Long
Property Let HLSLightness(ByVal Value As Long)

Remarks:

The HLSLightness property assigns the Lightness value for the HLS color model in CorelDRAW. Lightness determines the intensity of the color. Values range from 0 to 100.

A color is an effect applied to an object that alters the object's appearance by the way it reflects light. A color model is a system that defines the number and type of colors that make up an image and that is used to organize and define colors according to a set of basic properties that can be reproduced. Black-and-white, grayscale, RGB, CMYK, and paletted are examples of popular color modes.

The HLS model is a variation of the HSB model and contains three components: hue, lightness, and saturation. Hue determines color (yellow, orange, red, etc.), lightness determines perceived intensity (lighter or darker color), and saturation determines color depth (from dull to intense). The circular visual selector defines the H value (0 to 360) and the S value (0 to 100); the vertical visual selector defines the L value (0 to 100).

Examples:

The following VBA example creates an ellipse on the active layer in the current document.

Sub LayerActive()
  ActiveLayer.CreateEllipse 3, 3, 2, 1
  With ActiveDocument.Selection.Shapes(1).Fill.UniformColor
    .HLSAssign 200, 100, 100
    MsgBox .HLSLightness
  End With
End Sub

Version Information:

CorelDRAW:	X7.4, X7, X7.6, X8, 2017, 2018, 2019, 2019.2, 2020, 2021, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3, 2023-v24.5, 2024-v25
Corel DESIGNER:	X7, 2017.1, 20.1, 2019.2, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3, 2023-v24.5, 2024-v25