Types¶
Functions Signatures
Converts a RGB color to string based on the color range defined in Cinema 4D preferences (See WPREF_COLOR_RGBRANGE).
|
|
Converts a HSV color to string based on the color range defined in Cinema 4D preferences (See WPREF_COLOR_RGBRANGE).
|
|
|
Converts a RGB float color component in range [0.0, 1.0] to 8-bit (range [0, 255]). |
|
Converts a RGB 8-bit color component (range [0, 255]) to float in range [0.0, 1.0]. |
Converts a RGB float color in range [0.0, 1.0] to 8-bit color (range [0, 255]). |
|
Converts a RGB 8-bit color (range [0, 255]) to float color in range [0.0, 1.0]. |
|
|
Converts a RGB float color component in range [0.0, 1.0] to 16-bit (range [0, 65535]). |
|
Converts a RGB 16-bit color component (range [0, 65535]) to float in range [0.0, 1.0]. |
Converts a RGB float color in range [0.0, 1.0] to 16-bit color (range [0, 65535]). |
|
|
Converts a RGB 16-bit color (range [0, 65535]) to float color in range [0.0, 1.0]. |
|
Converts color Kelvin temperature to RGB value. |
|
Generates a complementary color harmony palette from color. Contains the input color and its opposite color in a color wheel. |
|
Generates a split complementary color harmony palette from color. Contains the input color and the 2 analogous colors to its complementary color.
|
|
Generates a tetradric color harmony palette. The rectangle or Tetradic color scheme uses four colors arranged into 2 complementary pairs. |
|
Generates an Analogous Color Harmony palette. Analogous color schemes use colors that are next to each other on the color wheel, i.e. 30 deg far away. |
|
Generates an Equiangular Color Harmony palette. All colors are evenly arranged around the color wheel. |
|
Generates a palette composed by a defined amount of colors whose hue is separated by a defined angle in HSV color space. |
|
Generates a palette composed by a defined amount of colors interpolated between color1 and color2 in HSV color space. All 3 HSV values will be interpolated. |
Functions Documentation
-
c4d.modules.colorchooser.
ColorRGBToString
(color)¶ - Converts a RGB color to string based on the color range defined in Cinema 4D preferences (See WPREF_COLOR_RGBRANGE).Example: The string result for the color Vector(0.45, 0.32, 1.0) will be “115, 82, 255” if WPREF_COLOR_RGBRANGE is configured to COLORSYSTEM_RANGE_255.
- Parameters
color (c4d.Vector) – The RGB color to convert to string. Its components must be in range [0.0, 1.0].
- Return type
str
- Returns
The string representation of the color.
-
c4d.modules.colorchooser.
ColorHSVToString
(color)¶ - Converts a HSV color to string based on the color range defined in Cinema 4D preferences (See WPREF_COLOR_RGBRANGE).Example: The string result for the color Vector(0.45, 0.32, 1.0) will be “251.471 deg , 68 %, 100 %”.
- Parameters
color (c4d.Vector) – The HSV color to convert to string. Its components must be in range [0.0, 1.0]. See
RGBToHSV()
/HSVToRGB()
.- Return type
str
- Returns
The string representation of the color.
-
c4d.modules.colorchooser.
ColorComponentFloatTo8Bit
(colorComponentInput)¶ Converts a RGB float color component in range [0.0, 1.0] to 8-bit (range [0, 255]).
- Parameters
colorComponentInput (float) – The color component to be converted. Must be in range [0.0, 1.0].
- Return type
int
- Returns
The converted 8-bit color component in range [0, 255].
-
c4d.modules.colorchooser.
ColorComponent8BitToFloat
(colorComponentInput)¶ Converts a RGB 8-bit color component (range [0, 255]) to float in range [0.0, 1.0].
- Parameters
colorComponentInput (int) – The 8-bit color component to be converted. Must be in range [0, 255].
- Return type
float
- Returns
The converted color component in range [0.0, 1.0].
-
c4d.modules.colorchooser.
ColorFloatTo8Bit
(floatColor)¶ Converts a RGB float color in range [0.0, 1.0] to 8-bit color (range [0, 255]).
- Parameters
floatColor (c4d.Vector) – The color to be converted. Must be in range [0.0, 1.0].
- Return type
List[int, int, int]
- Returns
The converted 8-bit red, green and blue color components.
-
c4d.modules.colorchooser.
Color8BitToFloat
(red, green, blue)¶ Converts a RGB 8-bit color (range [0, 255]) to float color in range [0.0, 1.0].
- Parameters
red (int) – The 8-bit color component to be converted. Must be in range [0, 255].
green (int) – The 8-bit color component to be converted. Must be in range [0, 255].
blue (int) – The 8-bit color component to be converted. Must be in range [0, 255].
- Return type
- Returns
The converted float color in range [0.0, 1.0].
-
c4d.modules.colorchooser.
ColorComponentFloatTo16Bit
(colorComponentInput)¶ Converts a RGB float color component in range [0.0, 1.0] to 16-bit (range [0, 65535]).
- Parameters
colorComponentInput (float) – The color component to be converted. Must be in range [0.0, 1.0].
- Return type
int
- Returns
The converted 16-bit color component in range [0, 65535].
-
c4d.modules.colorchooser.
ColorComponent16BitToFloat
(colorComponentInput)¶ Converts a RGB 16-bit color component (range [0, 65535]) to float in range [0.0, 1.0].
- Parameters
colorComponentInput (int) – The 16-bit color component to be converted. Must be in range [0, 65535].
- Return type
float
- Returns
The converted color component in range [0.0, 1.0].
-
c4d.modules.colorchooser.
ColorFloatTo16Bit
(floatColor)¶ Converts a RGB float color in range [0.0, 1.0] to 16-bit color (range [0, 65535]).
- Parameters
floatColor (c4d.Vector) – The color to be converted. Must be in range [0.0, 1.0].
- Return type
List[int, int, int]
- Returns
The converted 16-bit red, green and blue color components.
-
c4d.modules.colorchooser.
Color16BitToFloat
(red, green, blue)¶ Converts a RGB 16-bit color (range [0, 65535]) to float color in range [0.0, 1.0].
- Parameters
red (int) – The 16-bit color component to be converted. Must be in range [0, 65535].
green (int) – The 16-bit color component to be converted. Must be in range [0, 65535].
blue (int) – The 16-bit color component to be converted. Must be in range [0, 65535].
- Return type
- Returns
The converted float color in range [0.0, 1.0].
-
c4d.modules.colorchooser.
ColorKelvinTemperatureToRGB
(kelvinDegree, tint=0.0)¶ Converts color Kelvin temperature to RGB value.
- Parameters
kelvinDegree (float) – The Kelvin temperature value in Kelvin degrees. Useful range: [1000.0, 10000.0] deg K
tint (float) – Offsets the color temperature from green (negative value) to magenta (positive value). Set to 0.0 to disable tinting. Value will be clamped to range [-1.0, 1.0].
- Return type
- Returns
The converted RGB color value.
-
c4d.modules.colorchooser.
ColorHarmonyGetComplementary
(color, ryb)¶ Generates a complementary color harmony palette from color. Contains the input color and its opposite color in a color wheel.
- Parameters
color (c4d.Vector) – The color to generate the palette. This color will be added to the resulting palette as well, and converted to RYB space if enabled.
ryb (bool) –
Set to True to use RYB (red-yellow-blue) HSV space, set to False to use RGB (red-green-blue) HSV space.RYB generates visually nicer palettes, but is less accurate because it is smaller than RGB space.This means different RGB values could be converted to the same RYB value.
- Return type
List[c4d.Vector]
- Returns
The complementary color harmony palette.
-
c4d.modules.colorchooser.
ColorHarmonyGetSplitComplementary
(color, ryb)¶ - Generates a split complementary color harmony palette from color. Contains the input color and the 2 analogous colors to its complementary color.The complementary color is calculated rotating 180 deg the hue of the original color in HSV space.
- Parameters
color (c4d.Vector) – The color to generate the palette. This color will be added to the resulting palette as well, and converted to RYB space if enabled.
ryb (bool) –
Set to True to use RYB (red-yellow-blue) HSV space, set to False to use RGB (red-green-blue) HSV space.RYB generates visually nicer palettes, but is less accurate because it is smaller than RGB space.This means different RGB values could be converted to the same RYB value.
- Return type
List[c4d.Vector]
- Returns
The split complementary color harmony palette.
-
c4d.modules.colorchooser.
ColorHarmonyGetTetradic
(color, ryb)¶ Generates a tetradric color harmony palette. The rectangle or Tetradic color scheme uses four colors arranged into 2 complementary pairs.
- Parameters
color (c4d.Vector) – The color to generate the palette. This color will be added to the resulting palette as well, and converted to RYB space if enabled.
ryb (bool) –
Set to True to use RYB (red-yellow-blue) HSV space, set to False to use RGB (red-green-blue) HSV space.RYB generates visually nicer palettes, but is less accurate because it is smaller than RGB space.This means different RGB values could be converted to the same RYB value.
- Return type
List[c4d.Vector]
- Returns
The tetradric color harmony palette.
-
c4d.modules.colorchooser.
ColorHarmonyGetAnalogous
(color, colorCount, ryb)¶ Generates an Analogous Color Harmony palette. Analogous color schemes use colors that are next to each other on the color wheel, i.e. 30 deg far away.
- Parameters
color (c4d.Vector) – The color to generate the palette. This color will be added to the resulting palette as well, and converted to RYB space if enabled.
colorCount (int) – Number of colors to generate. Because input color is added as well, the resulting palette will have colorCount + 1 colors.
ryb (bool) –
Set to True to use RYB (red-yellow-blue) HSV space, set to False to use RGB (red-green-blue) HSV space.RYB generates visually nicer palettes, but is less accurate and smaller than RGB space.This means different RGB values could be converted to the same RYB value.
- Return type
List[c4d.Vector]
- Returns
The analogous color harmony palette.
-
c4d.modules.colorchooser.
ColorHarmonyGetEquiangular
(color, colorCount, ryb)¶ Generates an Equiangular Color Harmony palette. All colors are evenly arranged around the color wheel.
- Parameters
color (c4d.Vector) – The color to generate the palette. This color will be added to the resulting palette as well, and converted to RYB space if enabled.
colorCount (int) – Number of colors to generate. Because input color is added as well, the resulting palette will have colorCount + 1 colors.
ryb (bool) –
Set to True to use RYB (red-yellow-blue) HSV space, set to False to use RGB (red-green-blue) HSV space.RYB generates visually nicer palettes, but is less accurate because it is smaller than RGB space.This means different RGB values could be converted to the same RYB value.
- Return type
List[c4d.Vector]
- Returns
The equiangular color harmony palette.
-
c4d.modules.colorchooser.
ColorHarmonyRotateColor
(color, colorCount, angle, ryb)¶ Generates a palette composed by a defined amount of colors whose hue is separated by a defined angle in HSV color space.
- Parameters
color (c4d.Vector) – The color to generate the palette. This color will be added to the resulting palette as well, and converted to RYB space if enabled.
colorCount (int) – Number of colors to generate. Because input color is added as well, the resulting palette will have colorCount + 1 colors.
angle (int) – Rotation angle in radians. See
c4d.utils.Deg()
ryb (bool) –
Set to True to use RYB (red-yellow-blue) HSV space, set to False to use RGB (red-green-blue) HSV space.RYB generates visually nicer palettes, but is less accurate because it is smaller than RGB space.This means different RGB values could be converted to the same RYB value.
- Return type
List[c4d.Vector]
- Returns
The palette.
-
c4d.modules.colorchooser.
ColorHarmonyInterpolateColors
(color1, color2, colorCount, ryb)¶ Generates a palette composed by a defined amount of colors interpolated between color1 and color2 in HSV color space. All 3 HSV values will be interpolated.
- Parameters
color1 (c4d.Vector) – The first generator color. This color will be added to the resulting palette as well, and converted to RYB space if enabled.
color2 (c4d.Vector) – The second generator color. This color will be added to the resulting palette as well, and converted to RYB space if enabled.
colorCount (int) – Number of colors to generate. Because the 2 input colors are added as well, the resulting palette will have colorCount + 2 colors.
ryb (bool) –
Set to True to use RYB (red-yellow-blue) HSV space, set to False to use RGB (red-green-blue) HSV space.RYB generates visually nicer palettes, but is less accurate because it is smaller than RGB space.This means different RGB values could be converted to the same RYB value.
- Return type
List[c4d.Vector]
- Returns
The palette.