Curve(ID)¶
base classes — bpy_struct
, ID
subclasses —
SurfaceCurve
, TextCurve
-
class
bpy.types.
Curve
(ID)¶ Curve data-block storing curves, splines and NURBS
-
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 1.0
-
bevel_factor_mapping_end
¶ Determines how the end bevel factor is mapped to a spline
RESOLUTION
Resolution, Map the bevel factor to the number of subdivisions of a spline (U resolution).SEGMENTS
Segments, Map the bevel factor to the length of a segment and to the number of subdivisions of a segment.SPLINE
Spline, Map the bevel factor to the length of a spline.
- Type
enum in [‘RESOLUTION’, ‘SEGMENTS’, ‘SPLINE’], default ‘RESOLUTION’
-
bevel_factor_mapping_start
¶ Determines how the start bevel factor is mapped to a spline
RESOLUTION
Resolution, Map the bevel factor to the number of subdivisions of a spline (U resolution).SEGMENTS
Segments, Map the bevel factor to the length of a segment and to the number of subdivisions of a segment.SPLINE
Spline, Map the bevel factor to the length of a spline.
- Type
enum in [‘RESOLUTION’, ‘SEGMENTS’, ‘SPLINE’], default ‘RESOLUTION’
-
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_resolution
¶ Bevel resolution when depth is non-zero and no specific bevel object has been defined
- Type
int in [0, 32], default 4
-
cycles
¶ Cycles mesh settings
- Type
CyclesMeshSettings
, (readonly)
-
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
ofMaterial
, (readonly)
-
offset
¶ Offset the curve to adjust the width of a text
- Type
float in [-inf, inf], default 1.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, 1048574], default 100
-
render_resolution_u
¶ Surface resolution in U direction used while rendering (zero uses preview resolution)
- Type
int in [0, 1024], default 0
-
render_resolution_v
¶ Surface resolution in V direction used while rendering (zero uses preview resolution)
- Type
int in [0, 1024], default 0
-
resolution_u
¶ Surface resolution in U direction
- Type
int in [1, 1024], default 12
-
resolution_v
¶ Surface resolution in V direction
- Type
int in [1, 1024], default 12
-
splines
¶ Collection of splines in this curve data object
- Type
CurveSplines
bpy_prop_collection
ofSpline
, (readonly)
-
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 ‘MINIMUM’
-
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 True
-
use_deform_bounds
¶ Option for curve-deform: Use the mesh bounds to clamp the deformation
- Type
boolean, default True
-
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 the taper object to the beveled part of the 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 True
-
use_stretch
¶ Option for curve-deform: make deformed child to stretch along entire path
- Type
boolean, default False
-
transform
(matrix, shape_keys=False)¶ Transform curve by a matrix
- Parameters
matrix (float multi-dimensional array of 4 * 4 items in [-inf, inf]) – Matrix
shape_keys (boolean, (optional)) – Transform Shape Keys
-
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
boolean
-
update_gpu_tag
()¶ update_gpu_tag
-
classmethod
bl_rna_get_subclass
(id, default=None)¶ - Parameters
id (string) – The RNA type identifier.
- Returns
The RNA type or default when not found.
- Return type
bpy.types.Struct
subclass
-
classmethod
bl_rna_get_subclass_py
(id, default=None)¶ - Parameters
id (string) – The RNA type identifier.
- Returns
The class or default when not found.
- Return type
type
-
Inherited Properties
Inherited Functions
References