# psychopy.colors - For working with colors.¶

Classes and functions for working with colors.

## Overview¶

 Color([color, space, contrast, conematrix]) A class to store colour details, knows what colour space it’s in and can supply colours in any space. isValidColor(color[, space]) Depreciated as of 2021.0 hex2rgb255(hexColor) Depreciated as of 2021.0

## Details¶

class psychopy.colors.Color(color=None, space=None, contrast=None, conematrix=None)[source]

A class to store colour details, knows what colour space it’s in and can supply colours in any space.

property alpha

How opaque (0) or transparent (0) this color is. Synonymous with opacity.

copy()[source]

Return a duplicate of this colour

property dkl

Color value expressed as a DKL triplet

property dklCart

Color value expressed as a cartesian DKL triplet

property dkla

Color value expressed as a DKL triplet, with alpha value (0 to 1)

property dklaCart

Color value expressed as a cartesian DKL triplet, with alpha value (0 to 1)

property hex

Color value expressed as a hex string - a # followed by 6 values from 0 to F, e.g. #F2545B

property hsv

Color value expressed as an HSV triplet

property hsva

Color value expressed as an HSV triplet, with alpha value (0 to 1)

property lms

Color value expressed as an LMS triplet

property lmsa

Color value expressed as an LMS triplet, with alpha value (0 to 1)

property named

The name of this color, if it has one.

property opacity

How opaque (0) or transparent (0) this color is. Synonymous with alpha.

render(space='rgb')[source]

Apply contrast to the base color value and return the adjusted color value

property rgb

Color value expressed as an RGB triplet from -1 to 1

property rgb1

Color value expressed as an RGB triplet from 0 to 1

property rgb255

Color value expressed as an RGB triplet from 0 to 255

property rgba

Color value expressed as an RGB triplet from -1 to 1, with alpha values (0 to 1)

property rgba1

Color value expressed as an RGB triplet from 0 to 1, with alpha value (0 to 1)

property rgba255

Color value expressed as an RGB triplet from 0 to 255, with alpha value (0 to 1)

set(color=None, space=None)[source]

Set the colour of this object - essentially the same as what happens on creation, but without having to initialise a new object.

property srgb

Color value expressed as an sRGB triplet

validate(color, space=None)[source]

Check that a color value is valid in the given space, or all spaces if space==None.

psychopy.colors.isValidColor(color, space='rgb')[source]

Depreciated as of 2021.0

psychopy.colors.hex2rgb255(hexColor)[source]

Depreciated as of 2021.0

Converts a hex color string (e.g. “#05ff66”) into an rgb triplet ranging from 0:255