Curve(ID)

base classes — bpy_struct, ID

subclasses — TextCurve, SurfaceCurve

class bpy.types.Curve(ID)

Curve datablock storing curves, splines and NURBS

animation_data

Animation data for this datablock

Type :AnimData, (readonly)

bevel_depth

Bevel depth when not using a bevel object

Type :float in [-inf, inf], default 0.0

bevel_factor_end

Factor that defines to where beveling of spline happens (0=to the very beginning, 1=to the very end)

Type :float in [0, 1], default 0.0

bevel_factor_start

Factor that defines from where beveling of spline happens (0=from the very beginning, 1=from the very end)

Type :float in [0, 1], default 0.0

bevel_object

Curve object name that defines the bevel shape

Type :Object

bevel_resolution

Bevel resolution when depth is non-zero and no specific bevel object has been defined

Type :int in [0, 32], default 0

dimensions

Select 2D or 3D curve type

• 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 :enum in [‘2D’, ‘3D’], default ‘2D’

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)

Type :float in [-inf, inf], default 0.0

extrude

Amount of curve extrusion when not using a bevel object

Type :float in [0, inf], default 0.0

fill_mode

Mode of filling curve

Type :enum in [‘FULL’, ‘BACK’, ‘FRONT’, ‘HALF’], default ‘FULL’

is_editmode

True when used in editmode

Type :boolean, default False, (readonly)

materials

Type :IDMaterials bpy_prop_collection of Material, (readonly)

offset

Offset the curve to adjust the width of a text

Type :float in [-inf, inf], default 0.0

path_duration

The number of frames that are needed to traverse the path, defining the maximum value for the ‘Evaluation Time’ setting

Type :int in [1, 300000], default 0

render_resolution_u

Surface resolution in U direction used while rendering (zero skips this property)

Type :int in [0, 1024], default 0

render_resolution_v

Surface resolution in V direction used while rendering (zero skips this property)

Type :int in [0, 1024], default 0

resolution_u

Surface resolution in U direction

Type :int in [1, 1024], default 0

resolution_v

Surface resolution in V direction

Type :int in [1, 1024], default 0

shape_keys

Type :Key, (readonly)

show_handles

Display Bezier handles in editmode

Type :boolean, default False

show_normal_face

Display 3D curve normals in editmode

Type :boolean, default False

splines

Collection of splines in this curve data object

Type :CurveSplines bpy_prop_collection of Spline, (readonly)

taper_object

Curve object name that defines the taper (width)

Type :Object

texspace_location

Texture space location

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

texspace_size

Texture space size

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

twist_mode

The type of tilt calculation for 3D Curves

• 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 :enum in [‘Z_UP’, ‘MINIMUM’, ‘TANGENT’], default ‘Z_UP’

twist_smooth

Smoothing iteration for tangents

Type :float in [-inf, inf], default 0.0

use_auto_texspace

Adjust active object’s texture space automatically when transforming object

Type :boolean, default False

use_deform_bounds

Option for curve-deform: Use the mesh bounds to clamp the deformation

Type :boolean, default False

use_fill_caps

Fill caps for beveled curves

Type :boolean, default False

use_fill_deform

Fill curve after applying shape keys and all modifiers

Type :boolean, default False

use_map_taper

Map effect of taper object on actually beveled curve

Type :boolean, default False

use_path

Enable the curve to become a translation path

Type :boolean, default False

use_path_follow

Make curve path children to rotate along the path

Type :boolean, default False

use_radius

Option for paths and curve-deform: apply the curve radius with path following it and deforming

Type :boolean, default False

use_stretch

Option for curve-deform: make deformed child to stretch along entire path

Type :boolean, default False

use_time_offset

Children will use TimeOffs value as path distance offset

Type :boolean, default False

use_uv_as_generated

Uses the UV values as Generated textured coordinates

Type :boolean, default False

transform(matrix)

Transform curve by a matrix

Parameters:matrix (float array of 16 items in [-inf, inf]) – Matrix

Inherited Properties

bpy_struct.id_data ID.name ID.users ID.use_fake_user ID.tag

ID.is_updated ID.is_updated_data ID.is_library_indirect ID.library

Inherited Functions

bpy_struct.as_pointer bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.is_property_hidden bpy_struct.is_property_set bpy_struct.items bpy_struct.keyframe_delete bpy_struct.keyframe_insert bpy_struct.keys

bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.property_unset bpy_struct.type_recast bpy_struct.values ID.copy ID.user_clear ID.animation_data_create ID.animation_data_clear ID.update_tag

References

bpy.context.curve BlendData.curves

BlendDataCurves.new BlendDataCurves.remove