mathutils_Color.cc File Reference

#include <algorithm>
#include <Python.h>
#include "mathutils.hh"
#include "BLI_utildefines.h"
#include "../generic/py_capi_utils.hh"
#include "../generic/python_utildefines.hh"
#include "IMB_colormanagement.hh"
#include "BLI_dynstr.h"

Go to the source code of this file.

Macros
#define	COLOR_SIZE   3

Functions
Utilities
static PyObject *	Color_to_tuple_ex (ColorObject *self, int ndigits)
Color Type: <tt>__new__</tt> / <tt>mathutils.Color()</tt>
static PyObject *	Color_vectorcall (PyObject *type, PyObject *const *args, const size_t nargsf, PyObject *kwnames)
static PyObject *	Color_new (PyTypeObject *type, PyObject *args, PyObject *kwds)
Color Methods: Color Space Conversion
	PyDoc_STRVAR (Color_from_scene_linear_to_srgb_doc, ".. function:: from_scene_linear_to_srgb()\n" "\n" " Convert from scene linear to sRGB color space.\n" "\n" " :return: A color in sRGB color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_scene_linear_to_srgb (ColorObject *self)
	PyDoc_STRVAR (Color_from_srgb_to_scene_linear_doc, ".. function:: from_srgb_to_scene_linear()\n" "\n" " Convert from sRGB to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_srgb_to_scene_linear (ColorObject *self)
	PyDoc_STRVAR (Color_from_scene_linear_to_xyz_d65_doc, ".. function:: from_scene_linear_to_xyz_d65()\n" "\n" " Convert from scene linear to CIE XYZ (Illuminant D65) color space.\n" "\n" " :return: A color in XYZ color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_scene_linear_to_xyz_d65 (ColorObject *self)
	PyDoc_STRVAR (Color_from_xyz_d65_to_scene_linear_doc, ".. function:: from_xyz_d65_to_scene_linear()\n" "\n" " Convert from CIE XYZ (Illuminant D65) to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_xyz_d65_to_scene_linear (ColorObject *self)
	PyDoc_STRVAR (Color_from_scene_linear_to_aces_doc, ".. function:: from_scene_linear_to_aces()\n" "\n" " Convert from scene linear to ACES2065-1 linear color space.\n" "\n" " :return: A color in ACES2065-1 linear color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_scene_linear_to_aces (ColorObject *self)
	PyDoc_STRVAR (Color_from_aces_to_scene_linear_doc, ".. function:: from_aces_to_scene_linear()\n" "\n" " Convert from ACES2065-1 linear to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_aces_to_scene_linear (ColorObject *self)
	PyDoc_STRVAR (Color_from_scene_linear_to_acescg_doc, ".. function:: from_scene_linear_to_acescg()\n" "\n" " Convert from scene linear to ACEScg linear color space.\n" "\n" " :return: A color in ACEScg linear color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_scene_linear_to_acescg (ColorObject *self)
	PyDoc_STRVAR (Color_from_acescg_to_scene_linear_doc, ".. function:: from_acescg_to_scene_linear()\n" "\n" " Convert from ACEScg linear to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_acescg_to_scene_linear (ColorObject *self)
	PyDoc_STRVAR (Color_from_scene_linear_to_rec709_linear_doc, ".. function:: from_scene_linear_to_rec709_linear()\n" "\n" " Convert from scene linear to Rec.709 linear color space.\n" "\n" " :return: A color in Rec.709 linear color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_scene_linear_to_rec709_linear (ColorObject *self)
	PyDoc_STRVAR (Color_from_rec709_linear_to_scene_linear_doc, ".. function:: from_rec709_linear_to_scene_linear()\n" "\n" " Convert from Rec.709 linear color space to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_rec709_linear_to_scene_linear (ColorObject *self)
	PyDoc_STRVAR (Color_from_scene_linear_to_rec2020_linear_doc, ".. function:: from_scene_linear_to_rec2020_linear()\n" "\n" " Convert from scene linear to Rec.2020 linear color space.\n" "\n" " :return: A color in Rec.2020 linear color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_scene_linear_to_rec2020_linear (ColorObject *self)
	PyDoc_STRVAR (Color_from_rec2020_linear_to_scene_linear_doc, ".. function:: from_rec2020_linear_to_scene_linear()\n" "\n" " Convert from Rec.2020 linear color space to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n")
static PyObject *	Color_from_rec2020_linear_to_scene_linear (ColorObject *self)
Color Methods: Color Copy/Deep-Copy
	PyDoc_STRVAR (Color_copy_doc, ".. function:: copy()\n" "\n" " Returns a copy of this color.\n" "\n" " :return: A copy of the color.\n" " :rtype: :class:`Color`\n" "\n" " .. note:: use this to get a copy of a wrapped color with\n" " no reference to the original data.\n")
static PyObject *	Color_copy (ColorObject *self)
static PyObject *	Color_deepcopy (ColorObject *self, PyObject *args)
Color Type: <tt>__repr__</tt> & <tt>__str__</tt>
static PyObject *	Color_repr (ColorObject *self)
static PyObject *	Color_str (ColorObject *self)
Color Type: Rich Compare
static PyObject *	Color_richcmpr (PyObject *a, PyObject *b, int op)
Color Type: Hash (<tt>__hash__</tt>)
static Py_hash_t	Color_hash (ColorObject *self)
Color Type: Sequence & Mapping Protocols Implementation
static Py_ssize_t	Color_len (ColorObject *)
static PyObject *	Color_item (ColorObject *self, Py_ssize_t i)
static int	Color_ass_item (ColorObject *self, Py_ssize_t i, PyObject *value)
static PyObject *	Color_slice (ColorObject *self, int begin, int end)
static int	Color_ass_slice (ColorObject *self, int begin, int end, PyObject *seq)
static PyObject *	Color_subscript (ColorObject *self, PyObject *item)
static int	Color_ass_subscript (ColorObject *self, PyObject *item, PyObject *value)
Color Type: Numeric Protocol Implementation
static PyObject *	Color_add (PyObject *v1, PyObject *v2)
static PyObject *	Color_iadd (PyObject *v1, PyObject *v2)
static PyObject *	Color_sub (PyObject *v1, PyObject *v2)
static PyObject *	Color_isub (PyObject *v1, PyObject *v2)
static PyObject *	color_mul_float (ColorObject *color, const float scalar)
static PyObject *	Color_mul (PyObject *v1, PyObject *v2)
static PyObject *	Color_div (PyObject *v1, PyObject *v2)
static PyObject *	Color_imul (PyObject *v1, PyObject *v2)
static PyObject *	Color_idiv (PyObject *v1, PyObject *v2)
static PyObject *	Color_neg (ColorObject *self)
Color Type: Get/Set Item Implementation
	PyDoc_STRVAR (Color_channel_r_doc, "Red color channel.\n" "\n" ":type: float\n")
	PyDoc_STRVAR (Color_channel_g_doc, "Green color channel.\n" "\n" ":type: float\n")
	PyDoc_STRVAR (Color_channel_b_doc, "Blue color channel.\n" "\n" ":type: float\n")
static PyObject *	Color_channel_get (ColorObject *self, void *type)
static int	Color_channel_set (ColorObject *self, PyObject *value, void *type)
	PyDoc_STRVAR (Color_channel_hsv_h_doc, "HSV Hue component in [0, 1].\n" "\n" ":type: float\n")
	PyDoc_STRVAR (Color_channel_hsv_s_doc, "HSV Saturation component in [0, 1].\n" "\n" ":type: float\n")
	PyDoc_STRVAR (Color_channel_hsv_v_doc, "HSV Value component in [0, 1].\n" "\n" ":type: float\n")
static PyObject *	Color_channel_hsv_get (ColorObject *self, void *type)
static int	Color_channel_hsv_set (ColorObject *self, PyObject *value, void *type)
	PyDoc_STRVAR (Color_hsv_doc, "HSV Values in [0, 1].\n" "\n" ":type: tuple[float, float, float]\n")
static PyObject *	Color_hsv_get (ColorObject *self, void *)
static int	Color_hsv_set (ColorObject *self, PyObject *value, void *)
Color Type: C/API Constructors
PyObject *	Color_CreatePyObject (const float col[3], PyTypeObject *base_type)
PyObject *	Color_CreatePyObject_wrap (float col[3], PyTypeObject *base_type)
PyObject *	Color_CreatePyObject_cb (PyObject *cb_user, uchar cb_type, uchar cb_subtype)

Variables
Color Type: Protocol Declarations
static PySequenceMethods	Color_SeqMethods
static PyMappingMethods	Color_AsMapping
static PyNumberMethods	Color_NumMethods
Color Type: Get/Set Item Definitions
static PyGetSetDef	Color_getseters []
Color Type: Method Definitions
static PyMethodDef	Color_methods []

Color Type: Buffer Protocol
static PyBufferProcs	Color_as_buffer
static int	Color_getbuffer (PyObject *obj, Py_buffer *view, int flags)
static void	Color_releasebuffer (PyObject *, Py_buffer *view)

Color Type: Python Object Definition
PyTypeObject	color_Type
	PyDoc_STRVAR (color_doc, ".. class:: Color(rgb=(0.0, 0.0, 0.0), /)\n" "\n" " This object gives access to Colors in Blender.\n" "\n" " Most colors returned by Blender APIs are in scene linear color space, as defined by " " the OpenColorIO configuration. The notable exception is user interface theming colors, " " which are in sRGB color space.\n" "\n" " :arg rgb: (red, green, blue) color values where (0, 0, 0) is black & (1, 1, 1) is white.\n" " :type rgb: Sequence[float]\n")

Macro Definition Documentation

COLOR_SIZE

#define COLOR_SIZE   3

Definition at line 28 of file mathutils_Color.cc.

Referenced by Color_add(), Color_ass_item(), Color_ass_slice(), Color_ass_subscript(), Color_CreatePyObject(), Color_getbuffer(), Color_hash(), Color_iadd(), Color_idiv(), Color_imul(), Color_isub(), Color_item(), Color_len(), color_mul_float(), Color_neg(), Color_richcmpr(), Color_slice(), Color_sub(), Color_subscript(), Color_to_tuple_ex(), and Color_vectorcall().

Function Documentation

Color_add()

PyObject * Color_add ( PyObject * v1, PyObject * v2 )

static

Addition: object + object.

Definition at line 719 of file mathutils_Color.cc.

References add_vn_vnvn(), BaseMath_ReadCallback, col, Color_CreatePyObject(), COLOR_SIZE, ColorObject_Check, and v2.

Color_ass_item()

int Color_ass_item ( ColorObject * self, Py_ssize_t i, PyObject * value )

static

Sequence accessor (set): object[i] = x.

Definition at line 543 of file mathutils_Color.cc.

References BaseMath_Prepare_ForWrite, BaseMath_WriteIndexCallback, COLOR_SIZE, i, and self.

Referenced by Color_ass_subscript(), and Color_channel_set().

Color_ass_slice()

int Color_ass_slice ( ColorObject * self, int begin, int end, PyObject * seq )

static

Sequence slice accessor (set): object[i:j] = x.

Definition at line 605 of file mathutils_Color.cc.

References BaseMath_ReadCallback_ForWrite, BaseMath_WriteCallback, begin(), CLAMP, col, COLOR_SIZE, i, mathutils_array_parse(), self, and size().

Referenced by Color_ass_subscript().

Color_ass_subscript()

int Color_ass_subscript ( ColorObject * self, PyObject * item, PyObject * value )

static

Sequence generic subscript (set): object[...] = x.

Definition at line 680 of file mathutils_Color.cc.

References Color_ass_item(), Color_ass_slice(), COLOR_SIZE, i, self, and step.

Color_channel_get()

PyObject * Color_channel_get ( ColorObject * self, void * type )

static

Definition at line 1075 of file mathutils_Color.cc.

References Color_item(), POINTER_AS_INT, and self.

Color_channel_hsv_get()

PyObject * Color_channel_hsv_get ( ColorObject * self, void * type )

static

Definition at line 1106 of file mathutils_Color.cc.

References BaseMath_ReadCallback, i, POINTER_AS_INT, rgb_to_hsv(), and self.

Color_channel_hsv_set()

int Color_channel_hsv_set ( ColorObject * self, PyObject * value, void * type )

static

Definition at line 1120 of file mathutils_Color.cc.

References BaseMath_ReadCallback_ForWrite, BaseMath_WriteCallback, CLAMP, hsv_to_rgb_v(), i, POINTER_AS_INT, rgb_to_hsv_v(), and self.

Color_channel_set()

int Color_channel_set ( ColorObject * self, PyObject * value, void * type )

static

Definition at line 1080 of file mathutils_Color.cc.

References Color_ass_item(), POINTER_AS_INT, and self.

Color_copy()

PyObject * Color_copy ( ColorObject * self )

static

Definition at line 334 of file mathutils_Color.cc.

References BaseMath_ReadCallback, Color_CreatePyObject(), and self.

Referenced by Color_deepcopy().

Color_CreatePyObject()

PyObject * Color_CreatePyObject ( const float col[3], PyTypeObject * base_type )

nodiscard

Definition at line 1432 of file mathutils_Color.cc.

References BASE_MATH_FLAG_DEFAULT, BASE_MATH_NEW, col, COLOR_SIZE, color_Type, copy_v3_v3(), self, UNLIKELY, and zero_v3().

Referenced by Color_add(), Color_copy(), Color_CreatePyObject_cb(), Color_from_aces_to_scene_linear(), Color_from_acescg_to_scene_linear(), Color_from_rec2020_linear_to_scene_linear(), Color_from_rec709_linear_to_scene_linear(), Color_from_scene_linear_to_aces(), Color_from_scene_linear_to_acescg(), Color_from_scene_linear_to_rec2020_linear(), Color_from_scene_linear_to_rec709_linear(), Color_from_scene_linear_to_srgb(), Color_from_scene_linear_to_xyz_d65(), Color_from_srgb_to_scene_linear(), Color_from_xyz_d65_to_scene_linear(), color_mul_float(), Color_neg(), Color_sub(), Color_vectorcall(), and pyrna_math_object_from_array().

Color_CreatePyObject_cb()

PyObject * Color_CreatePyObject_cb ( PyObject * cb_user, uchar cb_type, uchar cb_subtype )

nodiscard

Definition at line 1488 of file mathutils_Color.cc.

References BLI_assert, Color_CreatePyObject(), and self.

Referenced by pyrna_math_object_from_array(), and StrokeAttribute_color_get().

Color_CreatePyObject_wrap()

PyObject * Color_CreatePyObject_wrap ( float col[3], PyTypeObject * base_type )

nodiscard

Definition at line 1470 of file mathutils_Color.cc.

References BASE_MATH_FLAG_DEFAULT, BASE_MATH_FLAG_IS_WRAP, BASE_MATH_NEW, col, color_Type, and self.

Color_deepcopy()

PyObject * Color_deepcopy ( ColorObject * self, PyObject * args )

static

Definition at line 342 of file mathutils_Color.cc.

References Color_copy(), PyC_CheckArgs_DeepCopy(), and self.

Color_div()

PyObject * Color_div ( PyObject * v1, PyObject * v2 )

static

Division: object / object.

Definition at line 877 of file mathutils_Color.cc.

References BaseMath_ReadCallback, color_mul_float(), ColorObject_Check, and v2.

Color_from_aces_to_scene_linear()

PyObject * Color_from_aces_to_scene_linear ( ColorObject * self )

static

Definition at line 211 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_aces_to_scene_linear(), and self.

Color_from_acescg_to_scene_linear()

PyObject * Color_from_acescg_to_scene_linear ( ColorObject * self )

static

Definition at line 243 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_acescg_to_scene_linear(), and self.

Color_from_rec2020_linear_to_scene_linear()

PyObject * Color_from_rec2020_linear_to_scene_linear ( ColorObject * self )

static

Definition at line 307 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_rec2020_to_scene_linear(), and self.

Color_from_rec709_linear_to_scene_linear()

PyObject * Color_from_rec709_linear_to_scene_linear ( ColorObject * self )

static

Definition at line 275 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_rec709_to_scene_linear(), and self.

Color_from_scene_linear_to_aces()

PyObject * Color_from_scene_linear_to_aces ( ColorObject * self )

static

Definition at line 195 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_scene_linear_to_aces(), and self.

Color_from_scene_linear_to_acescg()

PyObject * Color_from_scene_linear_to_acescg ( ColorObject * self )

static

Definition at line 227 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_scene_linear_to_acescg(), and self.

Color_from_scene_linear_to_rec2020_linear()

PyObject * Color_from_scene_linear_to_rec2020_linear ( ColorObject * self )

static

Definition at line 291 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_scene_linear_to_rec2020(), and self.

Color_from_scene_linear_to_rec709_linear()

PyObject * Color_from_scene_linear_to_rec709_linear ( ColorObject * self )

static

Definition at line 259 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_scene_linear_to_rec709(), and self.

Color_from_scene_linear_to_srgb()

PyObject * Color_from_scene_linear_to_srgb ( ColorObject * self )

static

Definition at line 131 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_scene_linear_to_srgb_v3(), and self.

Color_from_scene_linear_to_xyz_d65()

PyObject * Color_from_scene_linear_to_xyz_d65 ( ColorObject * self )

static

Definition at line 163 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_scene_linear_to_xyz(), and self.

Color_from_srgb_to_scene_linear()

PyObject * Color_from_srgb_to_scene_linear ( ColorObject * self )

static

Definition at line 147 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_srgb_to_scene_linear_v3(), and self.

Color_from_xyz_d65_to_scene_linear()

PyObject * Color_from_xyz_d65_to_scene_linear ( ColorObject * self )

static

Definition at line 179 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), IMB_colormanagement_xyz_to_scene_linear(), and self.

Color_getbuffer()

int Color_getbuffer ( PyObject * obj, Py_buffer * view, int flags )

static

Definition at line 396 of file mathutils_Color.cc.

References BASE_MATH_FLAG_HAS_BUFFER_VIEW, BaseMath_Prepare_ForBufferAccess, BaseMath_ReadCallback, COLOR_SIZE, float, self, UNLIKELY, and view.

Color_hash()

Py_hash_t Color_hash ( ColorObject * self )

static

Definition at line 496 of file mathutils_Color.cc.

References BaseMath_ReadCallback, BaseMathObject_Prepare_ForHash, COLOR_SIZE, mathutils_array_hash(), and self.

Color_hsv_get()

PyObject * Color_hsv_get ( ColorObject * self, void *  )

static

Color channel HSV (get): x = color.hsv.

Definition at line 1156 of file mathutils_Color.cc.

References BaseMath_ReadCallback, PyTuple_SET_ITEMS, ret, rgb_to_hsv(), and self.

Color_hsv_set()

int Color_hsv_set ( ColorObject * self, PyObject * value, void *  )

static

Color channel HSV (set): color.hsv = x.

Definition at line 1174 of file mathutils_Color.cc.

References BaseMath_Prepare_ForWrite, BaseMath_WriteCallback, clamp_v3(), hsv_to_rgb_v(), mathutils_array_parse(), and self.

Color_iadd()

PyObject * Color_iadd ( PyObject * v1, PyObject * v2 )

static

Addition in-place: object += object.

Definition at line 745 of file mathutils_Color.cc.

References add_vn_vn(), BaseMath_ReadCallback, BaseMath_ReadCallback_ForWrite, BaseMath_WriteCallback, COLOR_SIZE, ColorObject_Check, and v2.

Color_idiv()

PyObject * Color_idiv ( PyObject * v1, PyObject * v2 )

static

Division in-place: object *= object.

Definition at line 939 of file mathutils_Color.cc.

References BaseMath_ReadCallback_ForWrite, BaseMath_WriteCallback, COLOR_SIZE, mul_vn_fl(), and v2.

Color_imul()

PyObject * Color_imul ( PyObject * v1, PyObject * v2 )

static

Multiplication in-place: object *= object.

Definition at line 911 of file mathutils_Color.cc.

References BaseMath_ReadCallback_ForWrite, BaseMath_WriteCallback, COLOR_SIZE, mul_vn_fl(), and v2.

Color_isub()

PyObject * Color_isub ( PyObject * v1, PyObject * v2 )

static

Subtraction in-place: object -= object.

Definition at line 798 of file mathutils_Color.cc.

References BaseMath_ReadCallback, BaseMath_ReadCallback_ForWrite, BaseMath_WriteCallback, COLOR_SIZE, ColorObject_Check, sub_vn_vn(), and v2.

Color_item()

PyObject * Color_item ( ColorObject * self, Py_ssize_t i )

static

Sequence accessor (get): x = object[i].

Definition at line 522 of file mathutils_Color.cc.

References BaseMath_ReadIndexCallback, COLOR_SIZE, i, and self.

Referenced by Color_channel_get(), and Color_subscript().

Color_len()

Py_ssize_t Color_len ( ColorObject * )

static

Sequence length: len(object).

Definition at line 516 of file mathutils_Color.cc.

References COLOR_SIZE.

Color_mul()

PyObject * Color_mul ( PyObject * v1, PyObject * v2 )

static

Multiplication: object * object.

Definition at line 832 of file mathutils_Color.cc.

References BaseMath_ReadCallback, BLI_assert_msg, color_mul_float(), ColorObject_Check, and v2.

color_mul_float()

PyObject * color_mul_float ( ColorObject * color, const float scalar )

static

Definition at line 824 of file mathutils_Color.cc.

References Color_CreatePyObject(), COLOR_SIZE, and mul_vn_vn_fl().

Referenced by Color_div(), and Color_mul().

Color_neg()

PyObject * Color_neg ( ColorObject * self )

static

Negative (returns the negative of this object): -object.

Definition at line 972 of file mathutils_Color.cc.

References BaseMath_ReadCallback, Color_CreatePyObject(), COLOR_SIZE, negate_vn_vn(), and self.

Color_new()

PyObject * Color_new ( PyTypeObject * type, PyObject * args, PyObject * kwds )

static

Definition at line 100 of file mathutils_Color.cc.

References Color_vectorcall(), and UNLIKELY.

Color_releasebuffer()

void Color_releasebuffer ( PyObject * , Py_buffer * view )

static

Definition at line 426 of file mathutils_Color.cc.

References BASE_MATH_FLAG_HAS_BUFFER_VIEW, BaseMath_WriteCallback, self, UNLIKELY, and view.

Color_repr()

PyObject * Color_repr ( ColorObject * self )

static

Definition at line 356 of file mathutils_Color.cc.

References BaseMath_ReadCallback, Color_to_tuple_ex(), Py_DECREF(), ret, and self.

Color_richcmpr()

PyObject * Color_richcmpr ( PyObject * a, PyObject * b, int op )

static

Definition at line 449 of file mathutils_Color.cc.

References ATTR_FALLTHROUGH, b, BaseMath_ReadCallback, COLOR_SIZE, ColorObject_Check, and EXPP_VectorsAreEqual().

Color_slice()

PyObject * Color_slice ( ColorObject * self, int begin, int end )

static

Sequence slice accessor (get): x = object[i:j].

Definition at line 580 of file mathutils_Color.cc.

References BaseMath_ReadCallback, begin(), CLAMP, COLOR_SIZE, count, and self.

Referenced by Color_subscript().

Color_str()

PyObject * Color_str ( ColorObject * self )

static

Definition at line 373 of file mathutils_Color.cc.

References BaseMath_ReadCallback, BLI_dynstr_appendf(), BLI_dynstr_new(), mathutils_dynstr_to_py(), and self.

Color_sub()

PyObject * Color_sub ( PyObject * v1, PyObject * v2 )

static

Subtraction: object - object.

Definition at line 772 of file mathutils_Color.cc.

References BaseMath_ReadCallback, col, Color_CreatePyObject(), COLOR_SIZE, ColorObject_Check, sub_vn_vnvn(), and v2.

Color_subscript()

PyObject * Color_subscript ( ColorObject * self, PyObject * item )

static

Sequence generic subscript (get): x = object[...].

Definition at line 643 of file mathutils_Color.cc.

References Color_item(), COLOR_SIZE, Color_slice(), i, self, and step.

Color_to_tuple_ex()

PyObject * Color_to_tuple_ex ( ColorObject * self, int ndigits )

static

Note

BaseMath_ReadCallback must be called beforehand.

Definition at line 37 of file mathutils_Color.cc.

References COLOR_SIZE, double_round(), i, ret, and self.

Referenced by Color_repr().

Color_vectorcall()

PyObject * Color_vectorcall ( PyObject * type, PyObject *const * args, const size_t nargsf, PyObject * kwnames )

static

Definition at line 64 of file mathutils_Color.cc.

References col, Color_CreatePyObject(), COLOR_SIZE, mathutils_array_parse(), and UNLIKELY.

Referenced by Color_new().

PyDoc_STRVAR() [1/21]

PyDoc_STRVAR	(	Color_channel_b_doc	,
		"Blue color channel.\n" "\n" ":type: float\n"	)

PyDoc_STRVAR() [2/21]

PyDoc_STRVAR	(	Color_channel_g_doc	,
		"Green color channel.\n" "\n" ":type: float\n"	)

PyDoc_STRVAR() [3/21]

PyDoc_STRVAR	(	Color_channel_hsv_h_doc	,
		"HSV Hue component in .\n" "\n" ":type: float\n"	[0, 1] )

PyDoc_STRVAR() [4/21]

PyDoc_STRVAR	(	Color_channel_hsv_s_doc	,
		"HSV Saturation component in .\n" "\n" ":type: float\n"	[0, 1] )

PyDoc_STRVAR() [5/21]

PyDoc_STRVAR	(	Color_channel_hsv_v_doc	,
		"HSV Value component in .\n" "\n" ":type: float\n"	[0, 1] )

PyDoc_STRVAR() [6/21]

PyDoc_STRVAR	(	Color_channel_r_doc	,
		"Red color channel.\n" "\n" ":type: float\n"	)

PyDoc_STRVAR() [7/21]

PyDoc_STRVAR	(	Color_copy_doc	,
		".. function:: copy()\n" "\n" " Returns a copy of this color.\n" "\n" " :return: A copy of the color.\n" " :rtype: :class:`Color`\n" "\n" " .. note:: use this to get a copy of a wrapped color with\n" " no reference to the original data.\n"	)

PyDoc_STRVAR() [8/21]

PyDoc_STRVAR	(	color_doc	,
		".. class:: Color(rgb=(0.0, 0.0, 0.0), /)\n" "\n" " This object gives access to Colors in Blender.\n" "\n" " Most colors returned by Blender APIs are in scene linear color	space,
		as defined by " " the OpenColorIO configuration. The notable exception is user interface theming	colors,
		" " which are in sRGB color space.\n" "\n" " :arg rgb:(red, green, blue) color values where(0, 0, 0) is black &(1, 1, 1) is white.\n" " :type rgb:Sequence\n"	[float] )

PyDoc_STRVAR() [9/21]

PyDoc_STRVAR	(	Color_from_aces_to_scene_linear_doc	,
		".. function:: from_aces_to_scene_linear()\n" "\n" " Convert from ACES2065-1 linear to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [10/21]

PyDoc_STRVAR	(	Color_from_acescg_to_scene_linear_doc	,
		".. function:: from_acescg_to_scene_linear()\n" "\n" " Convert from ACEScg linear to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [11/21]

PyDoc_STRVAR	(	Color_from_rec2020_linear_to_scene_linear_doc	,
		".. function:: from_rec2020_linear_to_scene_linear()\n" "\n" " Convert from Rec.2020 linear color space to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [12/21]

PyDoc_STRVAR	(	Color_from_rec709_linear_to_scene_linear_doc	,
		".. function:: from_rec709_linear_to_scene_linear()\n" "\n" " Convert from Rec.709 linear color space to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [13/21]

PyDoc_STRVAR	(	Color_from_scene_linear_to_aces_doc	,
		".. function:: from_scene_linear_to_aces()\n" "\n" " Convert from scene linear to ACES2065-1 linear color space.\n" "\n" " :return: A color in ACES2065-1 linear color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [14/21]

PyDoc_STRVAR	(	Color_from_scene_linear_to_acescg_doc	,
		".. function:: from_scene_linear_to_acescg()\n" "\n" " Convert from scene linear to ACEScg linear color space.\n" "\n" " :return: A color in ACEScg linear color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [15/21]

PyDoc_STRVAR	(	Color_from_scene_linear_to_rec2020_linear_doc	,
		".. function:: from_scene_linear_to_rec2020_linear()\n" "\n" " Convert from scene linear to Rec.2020 linear color space.\n" "\n" " :return: A color in Rec.2020 linear color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [16/21]

PyDoc_STRVAR	(	Color_from_scene_linear_to_rec709_linear_doc	,
		".. function:: from_scene_linear_to_rec709_linear()\n" "\n" " Convert from scene linear to Rec.709 linear color space.\n" "\n" " :return: A color in Rec.709 linear color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [17/21]

PyDoc_STRVAR	(	Color_from_scene_linear_to_srgb_doc	,
		".. function:: from_scene_linear_to_srgb()\n" "\n" " Convert from scene linear to sRGB color space.\n" "\n" " :return: A color in sRGB color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [18/21]

PyDoc_STRVAR	(	Color_from_scene_linear_to_xyz_d65_doc	,
		".. function:: from_scene_linear_to_xyz_d65()\n" "\n" " Convert from scene linear to CIE XYZ (Illuminant D65) color space.\n" "\n" " :return: A color in XYZ color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [19/21]

PyDoc_STRVAR	(	Color_from_srgb_to_scene_linear_doc	,
		".. function:: from_srgb_to_scene_linear()\n" "\n" " Convert from sRGB to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [20/21]

PyDoc_STRVAR	(	Color_from_xyz_d65_to_scene_linear_doc	,
		".. function:: from_xyz_d65_to_scene_linear()\n" "\n" " Convert from CIE XYZ (Illuminant D65) to scene linear color space.\n" "\n" " :return: A color in scene linear color space.\n" " :rtype: :class:`Color`\n"	)

PyDoc_STRVAR() [21/21]

PyDoc_STRVAR	(	Color_hsv_doc	,
		"HSV Values in .\n" "\n" ":type: tuple\n"	[0, 1][float, float, float] )

Variable Documentation

Color_as_buffer

PyBufferProcs Color_as_buffer

static

Initial value:

                                     = {
    (getbufferproc)Color_getbuffer,
    (releasebufferproc)Color_releasebuffer,
}

Definition at line 438 of file mathutils_Color.cc.

Color_AsMapping

PyMappingMethods Color_AsMapping

static

Initial value:

                                        = {
     (lenfunc)Color_len,
     (binaryfunc)Color_subscript,
     (objobjargproc)Color_ass_subscript,
}

Definition at line 1003 of file mathutils_Color.cc.

Color_getseters

PyGetSetDef Color_getseters[]

static

Definition at line 1202 of file mathutils_Color.cc.

Color_methods

PyMethodDef Color_methods[]

static

Definition at line 1276 of file mathutils_Color.cc.

Color_NumMethods

PyNumberMethods Color_NumMethods

static

Definition at line 1009 of file mathutils_Color.cc.

Color_SeqMethods

PySequenceMethods Color_SeqMethods

static

Initial value:

                                          = {
     (lenfunc)Color_len,
     nullptr,
     nullptr,
     (ssizeargfunc)Color_item,
     nullptr, 
     (ssizeobjargproc)Color_ass_item,
     nullptr, 
     nullptr,
     nullptr,
     nullptr,
}

Definition at line 990 of file mathutils_Color.cc.

color_Type

PyTypeObject color_Type

Definition at line 1370 of file mathutils_Color.cc.

Referenced by Color_CreatePyObject(), Color_CreatePyObject_wrap(), and PyInit_mathutils().