pyvista.Color#

Helper class to convert between different color representations used in the pyvista library.

Many pyvista methods accept ColorLike parameters. This helper class is used to convert such parameters to the necessary format, used by underlying (VTK) methods. Any color name (str), hex string (str) or RGB(A) sequence (tuple, list or numpy.ndarray of int or float) is considered a ColorLike parameter and can be converted by this class. See Color.name for a list of supported color names.

Parameters:

colorColorLike, optional

Either a string, RGB sequence, RGBA sequence, or hex color string. RGB(A) sequences should either be provided as floats between 0 and 1 or as ints between 0 and 255. Hex color strings can contain optional '#' or '0x' prefixes. If no opacity is provided, the default_opacity will be used. If color is None, the default_color is used instead. The following examples all denote the color ‘white’:

'white'
'w'
[1.0, 1.0, 1.0]
[255, 255, 255, 255]
'#FFFFFF'

opacityint | float | str, optional

Opacity of the represented color. Overrides any opacity associated with the provided color. Allowed opacities are floats between 0 and 1, ints between 0 and 255 or hexadecimal strings of length 2 (plus the length of the optional prefix). The following examples all denote a fully opaque color:

1.0
255
'#ff'

default_colorColorLike, optional

Default color to use when color is None. If this value is None, then defaults to the global theme color. Format is identical to color.

default_opacityint | float | str, optional

Default opacity of the represented color. Used when color does not specify an opacity and opacity is None. Format is identical to opacity.

Notes

The internally used representation is an integer RGBA sequence (values between 0 and 255). This might however change in future releases.

Refer to the table below for a list of supported colors.

Name	Hex value	Example
`"aliceblue"`	`#F0F8FF`
`"antiquewhite"`	`#FAEBD7`
`"aquamarine"`	`#7FFFD4`
`"azure"`	`#F0FFFF`
`"beige"`	`#F5F5DC`
`"bisque"`	`#FFE4C4`
`"black"` or `"k"`	`#000000`
`"blanchedalmond"`	`#FFEBCD`
`"blue"` or `"b"`	`#0000FF`
`"blueviolet"`	`#8A2BE2`
`"brown"`	`#654321`
`"burlywood"`	`#DEB887`
`"cadetblue"`	`#5F9EA0`
`"chartreuse"`	`#7FFF00`
`"chocolate"`	`#D2691E`
`"coral"`	`#FF7F50`
`"cornflowerblue"`	`#6495ED`
`"cornsilk"`	`#FFF8DC`
`"crimson"`	`#DC143C`
`"cyan"` or `"c"` or `"aqua"`	`#00FFFF`
`"darkblue"`	`#00008B`
`"darkcyan"`	`#008B8B`
`"darkgoldenrod"`	`#B8860B`
`"darkgray"` or `"darkgrey"`	`#A9A9A9`
`"darkgreen"`	`#006400`
`"darkkhaki"`	`#BDB76B`
`"darkmagenta"`	`#8B008B`
`"darkolivegreen"`	`#556B2F`
`"darkorange"`	`#FF8C00`
`"darkorchid"`	`#9932CC`
`"darkred"`	`#8B0000`
`"darksalmon"`	`#E9967A`
`"darkseagreen"`	`#8FBC8F`
`"darkslateblue"`	`#483D8B`
`"darkslategray"` or `"darkslategrey"`	`#2F4F4F`
`"darkturquoise"`	`#00CED1`
`"darkviolet"`	`#9400D3`
`"deeppink"`	`#FF1493`
`"deepskyblue"`	`#00BFFF`
`"dimgray"` or `"dimgrey"`	`#696969`
`"dodgerblue"`	`#1E90FF`
`"firebrick"`	`#B22222`
`"floralwhite"`	`#FFFAF0`
`"forestgreen"`	`#228B22`
`"gainsboro"`	`#DCDCDC`
`"ghostwhite"`	`#F8F8FF`
`"gold"`	`#FFD700`
`"goldenrod"`	`#DAA520`
`"gray"` or `"grey"`	`#808080`
`"green"` or `"g"`	`#008000`
`"greenyellow"`	`#ADFF2F`
`"honeydew"`	`#F0FFF0`
`"hotpink"`	`#FF69B4`
`"indianred"`	`#CD5C5C`
`"indigo"`	`#4B0082`
`"ivory"`	`#FFFFF0`
`"khaki"`	`#F0E68C`
`"lavender"`	`#E6E6FA`
`"lavenderblush"`	`#FFF0F5`
`"lawngreen"`	`#7CFC00`
`"lemonchiffon"`	`#FFFACD`
`"lightblue"`	`#ADD8E6`
`"lightcoral"`	`#F08080`
`"lightcyan"`	`#E0FFFF`
`"lightgoldenrodyellow"`	`#FAFAD2`
`"lightgray"` or `"lightgrey"`	`#D3D3D3`
`"lightgreen"`	`#90EE90`
`"lightpink"`	`#FFB6C1`
`"lightsalmon"`	`#FFA07A`
`"lightseagreen"`	`#20B2AA`
`"lightskyblue"`	`#87CEFA`
`"lightslategray"` or `"lightslategrey"`	`#778899`
`"lightsteelblue"`	`#B0C4DE`
`"lightyellow"`	`#FFFFE0`
`"lime"`	`#00FF00`
`"limegreen"`	`#32CD32`
`"linen"`	`#FAF0E6`
`"magenta"` or `"m"` or `"fuchsia"`	`#FF00FF`
`"maroon"`	`#800000`
`"mediumaquamarine"`	`#66CDAA`
`"mediumblue"`	`#0000CD`
`"mediumorchid"`	`#BA55D3`
`"mediumpurple"`	`#9370DB`
`"mediumseagreen"`	`#3CB371`
`"mediumslateblue"`	`#7B68EE`
`"mediumspringgreen"`	`#00FA9A`
`"mediumturquoise"`	`#48D1CC`
`"mediumvioletred"`	`#C71585`
`"midnightblue"`	`#191970`
`"mintcream"`	`#F5FFFA`
`"mistyrose"`	`#FFE4E1`
`"moccasin"`	`#FFE4B5`
`"navajowhite"`	`#FFDEAD`
`"navy"`	`#000080`
`"oldlace"`	`#FDF5E6`
`"olive"`	`#808000`
`"olivedrab"`	`#6B8E23`
`"orange"`	`#FFA500`
`"orangered"`	`#FF4500`
`"orchid"`	`#DA70D6`
`"palegoldenrod"`	`#EEE8AA`
`"palegreen"`	`#98FB98`
`"paleturquoise"`	`#AFEEEE`
`"palevioletred"`	`#DB7093`
`"papayawhip"`	`#FFEFD5`
`"paraview_background"` or `"pv"` or `"paraview"`	`#52576e`
`"peachpuff"`	`#FFDAB9`
`"peru"`	`#CD853F`
`"pink"`	`#FFC0CB`
`"plum"`	`#DDA0DD`
`"powderblue"`	`#B0E0E6`
`"purple"`	`#800080`
`"raw_sienna"`	`#965434`
`"rebeccapurple"`	`#663399`
`"red"` or `"r"`	`#FF0000`
`"rosybrown"`	`#BC8F8F`
`"royalblue"`	`#4169E1`
`"saddlebrown"`	`#8B4513`
`"salmon"`	`#FA8072`
`"sandybrown"`	`#F4A460`
`"seagreen"`	`#2E8B57`
`"seashell"`	`#FFF5EE`
`"sienna"`	`#A0522D`
`"silver"`	`#C0C0C0`
`"skyblue"`	`#87CEEB`
`"slateblue"`	`#6A5ACD`
`"slategray"` or `"slategrey"`	`#708090`
`"snow"`	`#FFFAFA`
`"springgreen"`	`#00FF7F`
`"steelblue"`	`#4682B4`
`"tan"`	`#D2B48C`
`"teal"`	`#008080`
`"thistle"`	`#D8BFD8`
`"tomato"`	`#FF6347`
`"turquoise"`	`#40E0D0`
`"violet"`	`#EE82EE`
`"wheat"`	`#F5DEB3`
`"white"` or `"w"`	`#FFFFFF`
`"whitesmoke"`	`#F5F5F5`
`"yellow"` or `"y"`	`#FFFF00`
`"yellowgreen"`	`#9ACD32`
`"tab:blue"`	`#1f77b4`
`"tab:orange"`	`#ff7f0e`
`"tab:green"`	`#2ca02c`
`"tab:red"`	`#d62728`
`"tab:purple"`	`#9467bd`
`"tab:brown"`	`#8c564b`
`"tab:pink"`	`#e377c2`
`"tab:gray"`	`#7f7f7f`
`"tab:olive"`	`#bcbd22`
`"tab:cyan"`	`#17becf`

Examples

Create a transparent green color using a color name, float RGBA sequence, integer RGBA sequence and RGBA hexadecimal string.

>>> import pyvista as pv
>>> pv.Color("green", opacity=0.5)
Color(name='green', hex='#00800080', opacity=128)
>>> pv.Color([0.0, 0.5, 0.0, 0.5])
Color(name='green', hex='#00800080', opacity=128)
>>> pv.Color([0, 128, 0, 128])
Color(name='green', hex='#00800080', opacity=128)
>>> pv.Color("#00800080")
Color(name='green', hex='#00800080', opacity=128)

Methods

`Color.convert_color_channel`(val)	Convert the given color channel value to the integer representation.
`Color.from_dict`(dict_)	Construct from dictionary for JSON deserialization.
`Color.linear_to_srgb`()	Convert from linear color values to sRGB color values.
`Color.srgb_to_linear`()	Convert from sRGB color values to linear color values.
`Color.strip_hex_prefix`(h)	Strip any `'#'` or `'0x'` prefix from a hexadecimal string.
`Color.to_dict`()	Convert to dictionary for JSON serialization.

Attributes

`Color.float_rgb`	Get the color value as an RGB float tuple.
`Color.float_rgba`	Get the color value as an RGBA float tuple.
`Color.hex_rgb`	Get the color value as an RGB hexadecimal value.
`Color.hex_rgba`	Get the color value as an RGBA hexadecimal value.
`Color.int_rgb`	Get the color value as an RGB integer tuple.
`Color.int_rgba`	Get the color value as an RGBA integer tuple.
`Color.name`	Get the color name.
`Color.opacity`	Return the opacity of this color in the range of `(0-255)`.
`Color.vtk_c3ub`	Get the color value as a VTK Color3ub instance.