CurveMapping(bpy_struct)

base class — bpy_struct

class bpy.types.CurveMapping(bpy_struct)

Curve mapping to map color, vector and scalar values to other values using a user defined curve

black_level

For RGB curves, the color that black is mapped to (array of 3 items, in [-inf, inf], default (0.0, 0.0, 0.0))

Type:

mathutils.Color

clip_max_x

(in [-100, 100], default 0.0)

Type:

float

clip_max_y

(in [-100, 100], default 0.0)

Type:

float

clip_min_x

(in [-100, 100], default 0.0)

Type:

float

clip_min_y

(in [-100, 100], default 0.0)

Type:

float

curves

(default None, readonly)

Type:

bpy_prop_collection[CurveMap]

extend

Extrapolate the curve or extend it horizontally (default 'HORIZONTAL')

Type:

Literal[‘HORIZONTAL’, ‘EXTRAPOLATED’]

tone

Tone of the curve (default 'STANDARD')

  • STANDARD Standard – Combined curve is applied to each channel individually, which may result in a change of hue.

  • FILMLIKE Filmlike – Keeps the hue constant.

Type:

Literal[‘STANDARD’, ‘FILMLIKE’]

use_clip

Force the curve view to fit a defined boundary (default False)

Type:

bool

white_level

For RGB curves, the color that white is mapped to (array of 3 items, in [-inf, inf], default (0.0, 0.0, 0.0))

Type:

mathutils.Color

update()

Update curve mapping after making changes

reset_view()

Reset the curve mapping grid to its clipping size

initialize()

Initialize curve

evaluate(curve, position)

Evaluate curve at given location

Parameters:

  • curve (CurveMap) – curve, Curve to evaluate (never None)

  • position (float) – Position, Position to evaluate curve at (in [-inf, inf])

Returns:

Value, Value of curve at given location (in [-inf, inf])

Return type:

float

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References