Curve(ID)

base classes — bpy_struct, ID

subclasses — SurfaceCurve, TextCurve

class bpy.types.Curve(ID)

Curve data-block storing curves, splines and NURBS

animation_data

Animation data for this data-block (readonly)

Type:

AnimData

bevel_depth

Radius of the bevel geometry, not including extrusion (in [-inf, inf], default 0.0)

Type:

float

bevel_factor_end

Define where along the spline the curve geometry ends (0 for the beginning, 1 for the end) (in [0, 1], default 1.0)

Type:

float

bevel_factor_mapping_end

Determine how the geometry end factor is mapped to a spline (default 'RESOLUTION')

  • RESOLUTION Resolution – Map the geometry factor to the number of subdivisions of a spline (U resolution).

  • SEGMENTS Segments – Map the geometry factor to the length of a segment and to the number of subdivisions of a segment.

  • SPLINE Spline – Map the geometry factor to the length of a spline.

Type:

Literal[‘RESOLUTION’, ‘SEGMENTS’, ‘SPLINE’]

bevel_factor_mapping_start

Determine how the geometry start factor is mapped to a spline (default 'RESOLUTION')

  • RESOLUTION Resolution – Map the geometry factor to the number of subdivisions of a spline (U resolution).

  • SEGMENTS Segments – Map the geometry factor to the length of a segment and to the number of subdivisions of a segment.

  • SPLINE Spline – Map the geometry factor to the length of a spline.

Type:

Literal[‘RESOLUTION’, ‘SEGMENTS’, ‘SPLINE’]

bevel_factor_start

Define where along the spline the curve geometry starts (0 for the beginning, 1 for the end) (in [0, 1], default 0.0)

Type:

float

bevel_mode

Determine how to build the curve’s bevel geometry (default 'ROUND')

  • ROUND Round – Use circle for the section of the curve’s bevel geometry.

  • OBJECT Object – Use an object for the section of the curve’s bevel geometry segment.

  • PROFILE Profile – Use a custom profile for each quarter of curve’s bevel geometry.

Type:

Literal[‘ROUND’, ‘OBJECT’, ‘PROFILE’]

bevel_object

The name of the Curve object that defines the bevel shape

Type:

Object

bevel_profile

The path for the curve’s custom profile (readonly)

Type:

CurveProfile

bevel_resolution

The number of segments in each quarter-circle of the bevel (in [0, 32], default 4)

Type:

int

dimensions

Select 2D or 3D curve type (default '2D')

  • 2D 2D – Clamp the Z axis of the curve.

  • 3D 3D – Allow editing on the Z axis of this curve, also allows tilt and curve radius to be used.

Type:

Literal[‘2D’, ‘3D’]

eval_time

Parametric position along the length of the curve that Objects ‘following’ it should be at (position is evaluated by dividing by the ‘Path Length’ value) (in [-inf, inf], default 0.0)

Type:

float

extrude

Length of the depth added in the local Z direction along the curve, perpendicular to its normals (in [0, inf], default 0.0)

Type:

float

fill_mode

Mode of filling curve (default 'FULL')

Type:

Literal[‘FULL’, ‘BACK’, ‘FRONT’, ‘HALF’]

fill_rule

Fill rule for Delaunay fill solver (default 'EVEN_ODD')

  • EVEN_ODD Even-Odd – Alternate inside/outside based on crossing count.

  • NONZERO Non-Zero – Overlapping curves with the same winding direction are filled as a union.

Type:

Literal[‘EVEN_ODD’, ‘NONZERO’]

fill_solver

Triangulation solver for filling 2D curves (default 'SWEEP_LINE')

  • SWEEP_LINE Sweep Line – Fast without support for self-intersection.

  • CDT Delaunay – Constrained Delaunay Triangulation (CDT), robust with support for self-intersections.

Type:

Literal[‘SWEEP_LINE’, ‘CDT’]

is_editmode

True when used in editmode (default False, readonly)

Type:

bool

materials

(default None, readonly)

Type:

IDMaterials[Material]

offset

Distance to move the curve parallel to its normals (in [-inf, inf], default 0.0)

Type:

float

path_duration

The number of frames that are needed to traverse the path, defining the maximum value for the ‘Evaluation Time’ setting (in [1, 1048574], default 100)

Type:

int

render_resolution_u

Surface resolution in U direction used while rendering (zero uses preview resolution) (in [0, 1024], default 0)

Type:

int

render_resolution_v

Surface resolution in V direction used while rendering (zero uses preview resolution) (in [0, 1024], default 0)

Type:

int

resolution_u

Number of computed points in the U direction between every pair of control points (in [1, 1024], default 12)

Type:

int

resolution_v

The number of computed points in the V direction between every pair of control points (in [1, 1024], default 12)

Type:

int

shape_keys

(readonly)

Type:

Key

splines

Collection of splines in this curve data object (default None, readonly)

Type:

CurveSplines[Spline]

taper_object

Curve object name that defines the taper (width)

Type:

Object

taper_radius_mode

Determine how the effective radius of the spline point is computed when a taper object is specified (default 'OVERRIDE')

  • OVERRIDE Override – Override the radius of the spline point with the taper radius.

  • MULTIPLY Multiply – Multiply the radius of the spline point by the taper radius.

  • ADD Add – Add the radius of the bevel point to the taper radius.

Type:

Literal[‘OVERRIDE’, ‘MULTIPLY’, ‘ADD’]

texspace_location

(array of 3 items, in [-inf, inf], default (0.0, 0.0, 0.0))

Type:

mathutils.Vector

texspace_size

(array of 3 items, in [-inf, inf], default (1.0, 1.0, 1.0))

Type:

mathutils.Vector

twist_mode

The type of tilt calculation for 3D Curves (default 'MINIMUM')

  • Z_UP Z-Up – Use Z-Up axis to calculate the curve twist at each point.

  • MINIMUM Minimum – Use the least twist over the entire curve.

  • TANGENT Tangent – Use the tangent to calculate twist.

Type:

Literal[‘Z_UP’, ‘MINIMUM’, ‘TANGENT’]

twist_smooth

Smoothing iteration for tangents (in [-inf, inf], default 0.0)

Type:

float

use_auto_texspace

Adjust active object’s texture space automatically when transforming object (default True)

Type:

bool

use_deform_bounds

Option for curve-deform: Use the mesh bounds to clamp the deformation (default False)

Type:

bool

use_fill_caps

Fill caps for beveled curves (default False)

Type:

bool

use_map_taper

Map effect of the taper object to the beveled part of the curve (default False)

Type:

bool

use_path

Enable the curve to become a translation path (default False)

Type:

bool

use_path_clamp

Clamp the curve path children so they cannot travel past the start/end point of the curve (default False)

Type:

bool

use_path_follow

Make curve path children rotate along the path (default False)

Type:

bool

use_radius

Option for paths and curve-deform: apply the curve radius to objects following it and to deformed objects (default True)

Type:

bool

use_stretch

Option for curve-deform: make deformed child stretch along entire path (default False)

Type:

bool

transform(matrix, *, shape_keys=False)

Transform curve by a matrix

Parameters:

  • matrix (mathutils.Matrix) – Matrix (multi-dimensional array of 4 * 4 items, in [-inf, inf])

  • shape_keys (bool) – Transform Shape Keys (optional)

validate_material_indices()

Validate material indices of splines or letters, return True when the curve has had invalid indices corrected (to default 0)

Returns:

Result

Return type:

bool

update_gpu_tag()

update_gpu_tag

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