15. Colors

Color classes are useful for the functions related to color in ccPointCloud class.

15.1. QColor (from Qt)

The QColor class is the binding of the Qcolor class from Qt.

class cloudComPy.QColor

Bases: pybind11_object

The Qt QColor class provides colors based on RGB, HSV or CMYK values. See Qt documentation.

__init__(*args, **kwargs)

Overloaded function.

  1. __init__(self: _cloudComPy.QColor) -> None

Default Constructor: invalid Color.

  1. __init__(self: _cloudComPy.QColor, arg0: int, arg1: int, arg2: int, arg3: int) -> None

Constructs a color with the RGB value r, g, b, and the alpha-channel (transparency) value a.

Parameters
  • r (int) – red value (0 to 255)

  • g (int) – green value (0 to 255)

  • b (int) – blue value (0 to 255)

  • a (int) – alpha value (0 to 255)

  1. __init__(self: _cloudComPy.QColor, arg0: int) -> None

Constructs a color with the value color. The alpha component is ignored and set to solid.

Parameters

rgb (int) – an unsigned int equivalent to an ARGB quadruplet on the format #AARRGGBB.

  1. __init__(self: _cloudComPy.QColor, arg0: _cloudComPy.QRgba64) -> None

Construct a Color with the value rgba64 (QRgba64).

Parameters

rgba64 (QRgba64) – an rgba64 value.

  1. __init__(self: _cloudComPy.QColor, arg0: QString) -> None

Constructs a named color in the same way as setNamedColor() using the given name.

The color is left invalid if the name cannot be parsed.

Parameters

colorName (string) – the color name following the syntax in setNamedColor().

alpha(self: _cloudComPy.QColor) int

Returns the alpha color component of this color. See Qt documentation.

Returns

alpha component int from [0..255]

Return type

int

alphaF(self: _cloudComPy.QColor) float

Returns the alpha color component of this color. See Qt documentation.

Returns

alpha component float from range [0., 1.]

Return type

float

black(self: _cloudComPy.QColor) int

Returns the black color component of this color. See Qt documentation.

Returns

black component int from [0..255]

Return type

int

blackF(self: _cloudComPy.QColor) float

Returns the black color component of this color. See Qt documentation.

Returns

black component float from range [0., 1.]

Return type

float

blue(self: _cloudComPy.QColor) int

Returns the blue color component of this color. See Qt documentation.

Returns

blue component int from [0..255]

Return type

int

blueF(self: _cloudComPy.QColor) float

Returns the blue color component of this color. See Qt documentation.

Returns

blue component float from range [0., 1.]

Return type

float

static colorNames() List[QString]

Returns a list of strings containing the color names Qt knows about. Static function. See Qt documentation.

Returns

list of Qt valid color names

Return type

list

convertTo(self: _cloudComPy.QColor, arg0: _cloudComPy.QColorSpec) _cloudComPy.QColor

Creates a copy of this color in the format specified by colorSpec.

See QColorSpec

Parameters

spec (int) – color spec

Returns

converted color

Return type

QColor

cyan(self: _cloudComPy.QColor) int

Returns the cyan color component of this color. See Qt documentation.

Returns

cyan component int from [0..255]

Return type

int

cyanF(self: _cloudComPy.QColor) float

Returns the cyan color component of this color. See Qt documentation.

Returns

cyan component float from range [0., 1.]

Return type

float

darker(self: _cloudComPy.QColor, factor: int = 200) _cloudComPy.QColor

Returns a darker (or lighter) color, but does not change this object.

If the factor is greater than 100, this functions returns a darker color. Setting factor to 300 returns a color that has one-third the brightness. If the factor is less than 100, the return color is lighter, but we recommend using the lighter() function for this purpose. If the factor is 0 or negative, the return value is unspecified.

The function converts the current RGB color to HSV, divides the value (V) component by factor and converts the color back to RGB. See Qt documentation.

Parameters

factor (int,optional) – default value 200

Returns

new color object

Return type

QColor

static fromCmyk(c: int, m: int, y: int, k: int, a: int = 255) _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the given CMYK color values: c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i.e. transparency). All the values must be in the range 0-255. See Qt documentation.

Parameters
  • c (int) – cyan

  • m (int) – magenta

  • y (int) – yellow

  • k (int) – black

  • a (int,optional) – alpha, default 255

Returns

a CMYK QColor

Return type

QColor

static fromCmykF(c: float, m: float, y: float, k: float, a: float = 1.0) _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the given CMYK color values: c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i.e. transparency). All the values must be in the range [0., 1.]. See Qt documentation.

Parameters
  • c (float) – cyan

  • m (float) – magenta

  • y (float) – yellow

  • k (float) – black

  • a (float,optional) – alpha, default 1.

Returns

a CMYK QColor

Return type

QColor

static fromHsl(h: int, s: int, l: int, a: int = 255) _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the HSL color values: h (hue), s (saturation), l (lightness), and a (alpha-channel, i.e. transparency). The value of s, l, and a must all be in the range 0-255; the value of h must be in the range 0-359. See Qt documentation.

Parameters
  • h (int) – hue

  • s (int) – saturation

  • l (int) – lightness

  • a (int,optional) – alpha, default 255

Returns

an HSL QColor

Return type

QColor

static fromHslF(h: float, s: float, l: float, a: float = 1.0) _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the HSL color values: h (hue), s (saturation), l (lightness), and a (alpha-channel, i.e. transparency). All the values must be in the range 0.0-1.0. See Qt documentation.

Parameters
  • h (float) – hue

  • s (float) – saturation

  • l (float) – lightness

  • a (float,optional) – alpha, default 1.

Returns

an HSL QColor

Return type

QColor

static fromHsv(h: int, s: int, v: int, a: int = 255) _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the HSV color values: h (hue), s (saturation), v (value), and a (alpha-channel, i.e. transparency). The value of s, v, and a must all be in the range 0-255; the value of h must be in the range 0-359. See Qt documentation.

Parameters
  • h (int) – hue

  • s (int) – saturation

  • v (int) – value

  • a (int,optional) – alpha, default 255

Returns

an HSV QColor

Return type

QColor

static fromHsvF(h: float, s: float, v: float, a: float = 1.0) _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the HSV color values: h (hue), s (saturation), v (value), and a (alpha-channel, i.e. transparency). All the values must be in the range 0.0-1.0. See Qt documentation.

Parameters
  • h (float) – hue

  • s (float) – saturation

  • v (float) – value

  • a (float,optional) – alpha, default 255

Returns

an HSV QColor

Return type

QColor

QColor.fromRgb(r: int, g: int, g: int, a: int = 255) -> _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the RGB color values, r (red), g (green), b (blue), and a (alpha-channel, i.e. transparency). All the values must be in the range 0-255. See Qt documentation.

Parameters
  • r (int) – red

  • g (int) – green

  • b (int) – blue

  • a (int,optional) – alpha, default 255

Returns

an RGB QColor

Return type

QColor

static fromRgbF(r: float, g: float, b: float, a: float = 1.0) _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the RGB color values, r (red), g (green), b (blue), and a (alpha-channel, i.e. transparency). All the values must be in the range 0.0-1.0. See Qt documentation.

Parameters
  • r (float) – red

  • g (float) – green

  • b (float) – blue

  • a (float,optional) – alpha, default 1.0

Returns

an RGB QColor

Return type

QColor

static fromRgbUInt(arg0: int) _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the given unsigned integer value rgb (ARGB quadruplet on the format #AARRGGBB). The alpha component of rgb is ignored (i.e. it is automatically set to 255), use the fromRgba() function to include the alpha-channel specified by the given QRgb value. See Qt documentation.

Parameters

rgb (int) – ARGB quadruplet on the format #AARRGGBB).

Returns

an RGB QColor

Return type

QColor

static fromRgba(arg0: int) _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the given unsigned integer value rgb (ARGB quadruplet on the format #AARRGGBB). Unlike the fromRgbUInt() function, the alpha-channel specified by the given QRgb value is included. See Qt documentation.

Parameters

rgb (int) – ARGB quadruplet on the format #AARRGGBB).

Returns

an RGB QColor

Return type

QColor

QColor.fromRgba64(r: int, g: int, g: int, a: int = 65535) -> _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the RGBA64 color values, r (red), g (green), b (blue), and a (alpha-channel, i.e. transparency). All values: unsigned short = 16bit range 0..65535 See Qt documentation.

Parameters
  • r (int) – red

  • g (int) – green

  • b (int) – blue

  • a (int,optional) – alpha, default 65535

Returns

an RGB QColor

Return type

QColor

static fromRgba64Q(arg0: _cloudComPy.QRgba64) _cloudComPy.QColor

Static convenience function that returns a QColor constructed from the given QRgba64 value rgba64. See Qt documentation.

Parameters

rgba64 (QRgba64) – an rgba64 value.

Returns

an RGB QColor

Return type

QColor

getCmyk(self: _cloudComPy.QColor) List[int]

Get the cyan, magenta, yellow, black, and alpha-channel (transparency) components of the color’s CMYK value. See Qt documentation.

Returns

a tuple (c, m, y, k, a), int values from [0..255]

Return type

tuple

getCmykF(self: _cloudComPy.QColor) List[float]

Get the cyan, magenta, yellow, black, and alpha-channel (transparency) components of the color’s CMYK value. See Qt documentation.

Returns

a tuple (c, m, y, k, a), float values from [0., 1.]

Return type

tuple

getHsl(self: _cloudComPy.QColor) List[int]

Get the hue, saturation, lightness and alpha-channel (transparency) components of the color’s HSL value. See Qt documentation.

Returns

a tuple (h, s, l, a), int values from [-1..359] for hue, [0..255] for saturation, lightness and alpha-channel

Return type

tuple

getHslF(self: _cloudComPy.QColor) List[float]

Get the hue, saturation, lightness and alpha-channel (transparency) components of the color’s HSL value. See Qt documentation.

Returns

a tuple (h, s, l, a), float values from [0., 1.]

Return type

tuple

getHsv(self: _cloudComPy.QColor) List[int]

Get the hue, saturation, value and alpha-channel (transparency) components of the color’s HSL value. See Qt documentation.

Returns

a tuple (h, s, v, a), int values from [-1..359] for hue, [0..255] for saturation, lightness and alpha-channel

Return type

tuple

getHsvF(self: _cloudComPy.QColor) List[float]

Get the hue, saturation, value and alpha-channel (transparency) components of the color’s HSL value. See Qt documentation.

Returns

a tuple (h, s, v, a), float values from [0., 1.]

Return type

tuple

getRgb(self: _cloudComPy.QColor) List[int]

Get the the red, green, blue, and alpha-channel (transparency) components of the color’s RGB value. See Qt documentation.

Returns

a tuple (r, g, b, a), int values from [0..255]

Return type

tuple

getRgbF(self: _cloudComPy.QColor) List[float]

Get the the red, green, blue, and alpha-channel (transparency) components of the color’s RGB value. See Qt documentation.

Returns

a tuple (r, g, b, a), float values from [0., 1.]

Return type

tuple

green(self: _cloudComPy.QColor) int

Returns the green color component of this color. See Qt documentation.

Returns

green component int from [0..255]

Return type

int

greenF(self: _cloudComPy.QColor) float

Returns the green color component of this color. See Qt documentation.

Returns

green component float from range [0., 1.]

Return type

float

hslHue(self: _cloudComPy.QColor) int

Returns the HSL hue color component of this color. (-1 means achromatic) See Qt documentation.

Returns

the HSL hue color component of this color, value from [-1..359]

Return type

int

hslHueF(self: _cloudComPy.QColor) float

Returns the HSL hue color component of this color. See Qt documentation.

Returns

the HSL hue color component of this color, value from [0., 1.]

Return type

float

hslSaturation(self: _cloudComPy.QColor) int

Returns the HSL saturation color component of this color. See Qt documentation.

Returns

the HSL saturation color component of this color, value from [0..255]

Return type

int

hslSaturationF(self: _cloudComPy.QColor) float

Returns the HSL saturation color component of this color. See Qt documentation.

Returns

the HSL saturation color component of this color, value from [0., 1.]

Return type

float

hsvHue(self: _cloudComPy.QColor) int

Returns the hsv hue color component of this color. (-1 means achromatic) See Qt documentation.

Returns

the hsv hue color component of this color, value from [-1..359]

Return type

int

hsvHueF(self: _cloudComPy.QColor) float

Returns the hsv hue color component of this color. See Qt documentation.

Returns

the hsv hue color component of this color, value from [0., 1.]

Return type

float

hsvSaturation(self: _cloudComPy.QColor) int

Returns the hsv saturation color component of this color. See Qt documentation.

Returns

the hsv saturation color component of this color, value from [0..255]

Return type

int

hsvSaturationF(self: _cloudComPy.QColor) float

Returns the hsv saturation color component of this color. See Qt documentation.

Returns

the hsv saturation color component of this color, value from [0., 1.]

Return type

float

hue(self: _cloudComPy.QColor) int

Returns the HSV hue color component of this color. (-1 means achromatic)

The color is implicitly converted to HSV. See Qt documentation.

Returns

the hsv hue color component of this color, value from [-1..359]

Return type

int

hueF(self: _cloudComPy.QColor) float

Returns the HSV hue color component of this color.

The color is implicitly converted to HSV. See Qt documentation.

Returns

the hsv hue color component of this color, value from [0., 1.]

Return type

float

isValid(self: _cloudComPy.QColor) bool

Returns True if the color is valid; otherwise returns False. See Qt documentation.

Returns

True if the color is valid.

Return type

bool

static isValidColor(arg0: QString) bool

Returns True if the name is a valid color name and can be used to construct a valid QColor object, otherwise returns false.

It uses the same algorithm used in setNamedColor(). See Qt documentation.

Returns

True if the color name is valid.

Return type

bool

lighter(self: _cloudComPy.QColor, factor: int = 150) _cloudComPy.QColor

Returns a lighter (or darker) color, but does not change this object.

If the factor is greater than 100, this functions returns a lighter color. Setting factor to 150 returns a color that is 50% brighter. If the factor is less than 100, the return color is darker, but we recommend using the darker() function for this purpose. If the factor is 0 or negative, the return value is unspecified.

The function converts the current RGB color to HSV, multiplies the value (V) component by factor and converts the color back to RGB. See Qt documentation.

Parameters

factor (int,optional) – default value 150

Returns

new color object

Return type

QColor

lightness(self: _cloudComPy.QColor) int

Returns the lightness color component of this color. See Qt documentation.

Returns

lightness in [0..255]

Return type

int

lightnessF(self: _cloudComPy.QColor) float

Returns the lightness color component of this color. See Qt documentation.

Returns

lightness in [0., 1.]

Return type

float

magenta(self: _cloudComPy.QColor) int

Returns the magenta color component of this color. See Qt documentation.

Returns

magenta component int from [0..255]

Return type

int

magentaF(self: _cloudComPy.QColor) float

Returns the magenta color component of this color. See Qt documentation.

Returns

magenta component float from range [0., 1.]

Return type

float

name(self: _cloudComPy.QColor) QString

Returns the name of the color in the format “#RRGGBB”; i.e. a “#” character followed by three two-digit hexadecimal numbers. See Qt documentation.

Returns

name of the color in the format “#RRGGBB”.

Return type

string

nameARGB(self: _cloudComPy.QColor) QString

Returns the name of the color in the format “#AARRGGBB”; i.e. a “#” character followed by four two-digit hexadecimal numbers. See Qt documentation.

Returns

name of the color in the format “#AARRGGBB”.

Return type

string

red(self: _cloudComPy.QColor) int

Returns the red color component of this color. See Qt documentation.

Returns

red component int from [0..255]

Return type

int

redF(self: _cloudComPy.QColor) float

Returns the red color component of this color. See Qt documentation.

Returns

red component float from range [0., 1.]

Return type

float

rgb(self: _cloudComPy.QColor) int

Returns the RGB value of the color. The alpha value is opaque. See Qt documentation.

Returns

rgb value (unsigned int equivalent to an ARGB quadruplet on the format #AARRGGBB)

Return type

int

rgba(self: _cloudComPy.QColor) int

Returns the RGB value of the color, including its alpha.

unsigned int equivalent to an ARGB quadruplet on the format #AARRGGBB rgb = blue + green*256 + red*256**2 + alpha*256**3 (blue, green, red, alpha: unsigned char) For an invalid color, the alpha value of the returned color is unspecified. See Qt documentation.

Returns

rgb value (unsigned int equivalent to an ARGB quadruplet on the format #AARRGGBB)

Return type

int

rgba64(self: _cloudComPy.QColor) _cloudComPy.QRgba64

Returns the RGB64 value of the color, including its alpha.

For an invalid color, the alpha value of the returned color is unspecified. See Qt documentation.

Returns

QRgba64 value

Return type

QRgba64

saturation(self: _cloudComPy.QColor) int

Returns the HSV saturation color component of this color.

The color is implicitly converted to HSV. See Qt documentation.

Returns

saturation in [0..255]

Return type

int

saturationF(self: _cloudComPy.QColor) float

Returns the HSV saturation color component of this color.

The color is implicitly converted to HSV. See Qt documentation.

Returns

saturation in [0., 1.]

Return type

float

setAlpha(self: _cloudComPy.QColor, arg0: int) None

Sets the alpha of this color to alpha. Integer alpha is specified in the range 0-255. See Qt documentation.

Parameters

alpha (int) – alpha is specified in the range 0-255.

setAlphaF(self: _cloudComPy.QColor, arg0: float) None

Sets the alpha of this color to alpha. float alpha is specified in the range [0., 1.] See Qt documentation.

Parameters

alpha (float) – alpha is specified in the range [0., 1.].

setBlue(self: _cloudComPy.QColor, arg0: int) None

Sets the Blue of this color to Blue. Integer Blue is specified in the range 0-255. See Qt documentation.

Parameters

Blue (int) – Blue is specified in the range 0-255.

setBlueF(self: _cloudComPy.QColor, arg0: float) None

Sets the Blue of this color to Blue. float Blue is specified in the range [0., 1.] See Qt documentation.

Parameters

Blue (float) – Blue is specified in the range [0., 1.].

setCmyk(self: _cloudComPy.QColor, c: int, m: int, y: int, k: int, a: int = 255) None

Sets the cyan, magenta, yellow, black, and alpha-channel (transparency) components of the color’s CMYK value.

These components can be retrieved individually using the cyan(), py:meth:magenta, py:meth:yellow, py:meth:black and py:meth:alpha functions. See Qt documentation.

Parameters
  • c (int) – cyan value (0 to 255)

  • m (int) – magenta value (0 to 255)

  • y (int) – yellow value (0 to 255)

  • k (int) – black value (0 to 255)

  • a (int,optional) – alpha value (0 to 255), default 255

setCmykF(self: _cloudComPy.QColor, c: float, m: float, y: float, k: float, a: float = 1.0) None

Sets the cyan, magenta, yellow, black, and alpha-channel (transparency) components of the color’s CMYK value.

These components can be retrieved individually using the cyan(), py:meth:magenta, py:meth:yellow, py:meth:black and py:meth:alpha functions. See Qt documentation.

Parameters
  • c (float) – cyan value from [0., 1.]

  • m (float) – magenta value from [0., 1.]

  • y (float) – yellow value from [0., 1.]

  • k (float) – black value from [0., 1.]

  • a (float,optional) – alpha value from [0., 1.] default 1.

setGreen(self: _cloudComPy.QColor, arg0: int) None

Sets the Green of this color to Green. Integer Green is specified in the range 0-255. See Qt documentation.

Parameters

Green (int) – Green is specified in the range 0-255.

setGreenF(self: _cloudComPy.QColor, arg0: float) None

Sets the Green of this color to Green. float Green is specified in the range [0., 1.] See Qt documentation.

Parameters

Green (float) – Green is specified in the range [0., 1.].

setHsl(self: _cloudComPy.QColor, h: int, s: int, l: int, a: int = 255) None

Sets a HSL color value; h is the hue, s is the saturation, l is the lightness and a is the alpha component of the HSL color.

The saturation, lightness and alpha-channel values must be in the range 0-255, and the hue value must be greater than -1. [0..359] See Qt documentation.

Parameters
  • h (int) – hue

  • s (int) – saturation

  • l (int) – lightness

  • a (int,optional) – alpha, default value 255

setHslF(self: _cloudComPy.QColor, h: float, s: float, l: float, a: float = 1.0) None

Sets a HSL color value; h is the hue, s is the saturation, l is the lightness and a is the alpha component of the HSL color.

All the values must be in the range 0.0-1.0. See Qt documentation.

Parameters
  • h (int) – hue

  • s (int) – saturation

  • l (int) – lightness

  • a (int,optional) – alpha, default value 1.0

setHsv(self: _cloudComPy.QColor, h: int, s: int, v: int, a: int = 255) None

Sets a HSV color value; h is the hue, s is the saturation, v is the value and a is the alpha component of the HSV color.

The saturation, value and alpha-channel values must be in the range 0-255, and the hue value must be greater than -1. [0..359] See Qt documentation.

Parameters
  • h (int) – hue

  • s (int) – saturation

  • v (int) – value

  • a (int,optional) – alpha, default value 255

setHsvF(self: _cloudComPy.QColor, h: float, s: float, v: float, a: float = 1.0) None

Sets a HSV color value; h is the hue, s is the saturation, v is the value and a is the alpha component of the HSV color.

All the values must be in the range 0.0-1.0. See Qt documentation.

Parameters
  • h (int) – hue

  • s (int) – saturation

  • v (int) – value

  • a (int,optional) – alpha, default value 1.0

setNamedColor(self: _cloudComPy.QColor, arg0: QString) None

Sets the RGB value of this QColor to name, which may be in one of these formats:

  • #RGB (each of R, G, and B is a single hex digit)

  • #RRGGBB

  • #AARRGGBB (Since 5.2)

  • #RRRGGGBBB

  • #RRRRGGGGBBBB

  • A name from the list of colors defined in the list of SVG color keyword names provided by the World Wide Web Consortium; for example, “steelblue” or “gainsboro”. These color names work on all platforms.

  • transparent - representing the absence of a color.

The color is invalid if name cannot be parsed. See Qt documentation.

Parameters

colorName (string) – color name. see colorNames() for a list of valid keyword names

setRed(self: _cloudComPy.QColor, arg0: int) None

Sets the Red of this color to Red. Integer Red is specified in the range 0-255. See Qt documentation.

Parameters

Red (int) – Red is specified in the range 0-255.

setRedF(self: _cloudComPy.QColor, arg0: float) None

Sets the Red of this color to Red. float Red is specified in the range [0., 1.] See Qt documentation.

Parameters

Red (float) – Green is specified in the range [0., 1.].

setRgb(self: _cloudComPy.QColor, r: int, g: int, b: int, a: int = 255) None

Sets the RGB value to r, g, b and the alpha value to a.

All the values must be in the range 0-255. See Qt documentation.

Parameters
  • r (int) – red

  • g (int) – green

  • b (int) – blue

  • a (int,optional) – alpha

QColor.setRgbF(self: _cloudComPy.QColor, r: float, g: float, g: float, a: float = 1.0) -> None

Sets the color channels of this color to r (red), g (green), b (blue) and a (alpha, transparency).

All values must be in the range 0.0-1.0. See Qt documentation.

Parameters
  • r (float) – red

  • g (float) – green

  • b (float) – blue

  • a (float,optional) – alpha

setRgbUInt(self: _cloudComPy.QColor, arg0: int) None

Sets the RGB value to rgb (unsigned integer color code). The alpha value is set to opaque. See Qt documentation.

Parameters

rgb (int) – unsigned integer color code (ARGB quadruplet on the format #AARRGGBB)

setRgba64(self: _cloudComPy.QColor, arg0: _cloudComPy.QRgba64) None

Sets the RGB64 value to rgba, including its alpha. See Qt documentation.

Parameters

rgba (QRgba64) – 64-bit RGB color structure

spec(self: _cloudComPy.QColor) _cloudComPy.QColorSpec

Returns how the color was specified.

See Qt documentation.

Returns

spec value

Return type

QColorSpec

toCmyk(self: _cloudComPy.QColor) _cloudComPy.QColor

Creates and returns a CMYK QColor based on this color. See Qt documentation.

Returns

a CMYK QColor based on this color.

Return type

QColor

toHsl(self: _cloudComPy.QColor) _cloudComPy.QColor

Creates and returns an HSL QColor based on this color. See Qt documentation.

Returns

an HSL QColor based on this color.

Return type

QColor

toHsv(self: _cloudComPy.QColor) _cloudComPy.QColor

Creates and returns an HSV QColor based on this color. See Qt documentation.

Returns

an HSV QColor based on this color.

Return type

QColor

toRgb(self: _cloudComPy.QColor) _cloudComPy.QColor

Creates and returns an RGB QColor based on this color. See Qt documentation.

Returns

an RGB QColor based on this color.

Return type

QColor

value(self: _cloudComPy.QColor) int

Returns the value color component of this color. See Qt documentation.

Returns

value color component [0..255]

Return type

int

valueF(self: _cloudComPy.QColor) float

Returns the value color component of this color. See Qt documentation.

Returns

value color component [0., 1.]

Return type

float

yellow(self: _cloudComPy.QColor) int

Returns the yellow color component of this color. See Qt documentation.

Returns

yellow color component [0..255]

Return type

int

yellowF(self: _cloudComPy.QColor) float

Returns the yellow color component of this color. See Qt documentation.

Returns

yellow color component [0., 1.]

Return type

float

15.2. Other Useful Color classes (from Qt)

The QRgba64 class from Qt provide a 64bit data structure to manipulate 16-bit color channels: Red, green, blue and alpha.

class cloudComPy.QRgba64

Bases: pybind11_object

The QRgba64 struct contains a 64-bit RGB color.

QRgba64 is a 64-bit data-structure containing four 16-bit color channels: Red, green, blue and alpha. QRgba64 can be used as a replacement for QRgb when higher precision is needed. In particular a premultiplied QRgba64 can operate on unpremultiplied QRgb without loss of precision except for alpha 0. See Qt documentation.

__init__(self: _cloudComPy.QRgba64) None

Default constructor

alpha(self: _cloudComPy.QRgba64) int

Returns the 16-bit alpha channel. See Qt documentation.

Returns

alpha 16 bits

Return type

int)

alpha8(self: _cloudComPy.QRgba64) int

Returns the alpha channel as an 8-bit. See Qt documentation.

Returns

alpha 8 bits

Return type

int

blue(self: _cloudComPy.QRgba64) int

Returns the 16-bit blue color component. See Qt documentation.

Returns

blue 16 bits

Return type

int

blue8(self: _cloudComPy.QRgba64) int

Returns the blue color component as an 8-bit. See Qt documentation.

Returns

blue 8 bits

Return type

int

static fromArgb32(arg0: int) _cloudComPy.QRgba64

Constructs a QRgba64 value from the 32bit ARGB value rgb. See Qt documentation.

Parameters

rgb (int) – 32bit ARGB value

Returns

color.

Return type

QRgba64

fromQuint64(self: _cloudComPy.QRgba64, arg0: int) _cloudComPy.QRgba64

Return the color from a 64bit unsigned integer RGBA. See Qt documentation.

Parameters

rgba (int) – a 64bit unsigned integer RGBA.

Returns

color.

Return type

QRgba64

static fromRgba(arg0: int, arg1: int, arg2: int, arg3: int) _cloudComPy.QRgba64

Constructs a QRgba64 value from the four 8-bit color channels red, green, blue and alpha. See Qt documentation.

Parameters
  • red (int) – 8bit red value.

  • green (int) – 8bit green value.

  • blue (int) – 8bit blue value.

  • alpha (int) – 8bit alpha value.

Returns

color.

Return type

QRgba64

static fromRgba64(arg0: int, arg1: int, arg2: int, arg3: int) _cloudComPy.QRgba64

Constructs a QRgba64 value from the four 16-bit color channels red, green, blue and alpha. See Qt documentation.

Parameters
  • red (int) – 16bit red value.

  • green (int) – 16bit green value.

  • blue (int) – 16bit blue value.

  • alpha (int) – 16bit alpha value.

Returns

color.

Return type

QRgba64

static fromRgba64Q(arg0: int) _cloudComPy.QRgba64

Constructs a QRgba64 value from a 64bit unsigned integer RGBA. See Qt documentation.

Parameters

rgba (int) – a 64bit unsigned integer RGBA.

Returns

color.

Return type

QRgba64

green(self: _cloudComPy.QRgba64) int

Returns the 16-bit green color component. See Qt documentation.

Returns

green 16 bits

Return type

int

green8(self: _cloudComPy.QRgba64) int

Returns the green color component as an 8-bit. See Qt documentation.

Returns

green 8 bits

Return type

int

isOpaque(self: _cloudComPy.QRgba64) bool

Returns whether the color is fully opaque. See Qt documentation.

Returns

True if the color is fully opaque.

Return type

bool

isTransparent(self: _cloudComPy.QRgba64) bool

Returns whether the color is transparent. See Qt documentation.

Returns

True if the color is transparent.

Return type

bool

premultiplied(self: _cloudComPy.QRgba64) _cloudComPy.QRgba64

Returns the color with the alpha premultiplied. See Qt documentation.

Returns

color premultiplied.

Return type

QRgba64

red(self: _cloudComPy.QRgba64) int

Returns the 16-bit red color component. See Qt documentation.

Returns

red 16 bits

Return type

int

red8(self: _cloudComPy.QRgba64) int

Returns the red color component as an 8-bit. See Qt documentation.

Returns

red 8 bits

Return type

int

setAlpha(self: _cloudComPy.QRgba64, arg0: int) None

Sets the alpha of this color to alpha. See Qt documentation.

Parameters

alpha (int) – alpha value.

setBlue(self: _cloudComPy.QRgba64, arg0: int) None

Sets the blue color component of this color to blue. See Qt documentation.

Parameters

blue (int) – blue value.

setGreen(self: _cloudComPy.QRgba64, arg0: int) None

Sets the green color component of this color to green. See Qt documentation.

Parameters

green (int) – green value.

setRed(self: _cloudComPy.QRgba64, arg0: int) None

Sets the red color component of this color to red. See Qt documentation.

Parameters

red (int) – red value.

toArgb32(self: _cloudComPy.QRgba64) int

Returns the color as a 32-bit ARGB value. See Qt documentation.

Returns

32 bits ARGB color

Return type

int

toQuint64(self: _cloudComPy.QRgba64) int

Returns the color as a 64bit unsigned integer RGBA. See Qt documentation.

Returns

64bit unsigned integer RGBA.

Return type

int

toRgb16(self: _cloudComPy.QRgba64) int

Returns the color as a 16-bit RGB value. See Qt documentation.

Returns

16 bits RGB color

Return type

int

unpremultiplied(self: _cloudComPy.QRgba64) _cloudComPy.QRgba64

Returns the color with the alpha unpremultiplied. See Qt documentation.

Returns

color unpremultiplied.

Return type

QRgba64

class cloudComPy.QColorSpec

The type of color specified, either RGB, HSV, CMYK or HSL. See Qt documentation.

Members:

Invalid

Rgb

Hsv

Cmyk

Hsl

Cmyk = <QColorSpec.Cmyk: 3>
Hsl = <QColorSpec.Hsl: 4>
Hsv = <QColorSpec.Hsv: 2>
Invalid = <QColorSpec.Invalid: 0>
Rgb = <QColorSpec.Rgb: 1>
__init__(self: _cloudComPy.QColorSpec, value: int) None
property name
property value