Curves(ID)

base classes — bpy_struct, ID

class bpy.types.Curves(ID)

Hair data-block for hair curves

animation_data

Animation data for this data-block (readonly)

Type:

AnimData

attributes

Geometry attributes (default None, readonly)

Type:

AttributeGroupCurves[Attribute]

color_attributes

Geometry color attributes (default None, readonly)

Type:

AttributeGroupCurves[Attribute]

curve_offset_data

(default None, readonly)

Type:

bpy_prop_collection[IntAttributeValue]

curves

All curves in the data-block (default None, readonly)

Type:

bpy_prop_collection[CurveSlice]

materials

(default None, readonly)

Type:

IDMaterials[Material]

normals

The curve normal value at each of the curve’s control points (default None, readonly)

Type:

bpy_prop_collection[FloatVectorValueReadOnly]

points

Control points of all curves (default None, readonly)

Type:

bpy_prop_collection[CurvePoint]

position_data

(default None, readonly)

Type:

bpy_prop_collection[FloatVectorAttributeValue]

selection_domain

(default 'POINT')

Type:

Literal[Attribute Curves Domain Items]

surface

Mesh object that the curves can be attached to

Type:

Object

surface_collision_distance

Distance to keep the curves away from the surface (in [1.192e-07, inf], default 0.005)

Type:

float

surface_uv_map

The name of the attribute on the surface mesh used to define the attachment of each curve (default “”, never None)

Type:

str

use_mirror_x

Enable symmetry in the X axis (default False)

Type:

bool

use_mirror_y

Enable symmetry in the Y axis (default False)

Type:

bool

use_mirror_z

Enable symmetry in the Z axis (default False)

Type:

bool

use_sculpt_collision

Enable collision with the surface while sculpting (default False)

Type:

bool

add_curves(sizes)

add_curves

Parameters:

sizes (Sequence[int]) – Sizes, The number of points in each curve (array of 1 items, in [0, inf])

remove_curves(*, indices=(0,))

Remove all curves. If indices are provided, remove only the curves with the given indices.

Parameters:

indices (Sequence[int]) – Indices, The indices of the curves to remove (array of 1 items, in [0, inf], optional)

resize_curves(sizes, *, indices=(0,))

Resize all existing curves. If indices are provided, resize only the curves with the given indices. If the new size for a curve is smaller, the curve is trimmed. If the new size for a curve is larger, the new end values are default initialized.

Parameters:

  • sizes (Sequence[int]) – Sizes, The number of points in each curve (array of 1 items, in [1, inf])

  • indices (Sequence[int]) – Indices, The indices of the curves to resize (array of 1 items, in [0, inf], optional)

reorder_curves(new_indices)

Reorder the curves by the new indices.

Parameters:

new_indices (Sequence[int]) – New indices, The new index for each of the curves (array of 1 items, in [0, inf])

set_types(*, type='CATMULL_ROM', indices=(0,))

Set the curve type. If indices are provided, set only the types with the given curve indices.

Parameters:

  • type (Literal[Curves Type Items]) – Type, (optional)

  • indices (Sequence[int]) – Indices, The indices of the curves to resize (array of 1 items, in [0, inf], optional)

unit_test_compare(*, curves=None, threshold=7.1526e-06)

unit_test_compare

Parameters:

  • curves (Curves) – Curves to compare to (optional)

  • threshold (float) – Threshold, Comparison tolerance threshold (in [0, inf], optional)

Returns:

Return value, String description of result of comparison (never None)

Return type:

str

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