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

bpy_struct.id_data ID.name ID.name_full ID.id_type ID.session_uid ID.is_evaluated ID.original ID.users ID.use_fake_user ID.use_extra_user ID.is_embedded_data

ID.is_linked_packed ID.is_missing ID.is_runtime_data ID.is_editable ID.tag ID.is_library_indirect ID.library ID.library_weak_reference ID.asset_data ID.override_library ID.preview

Inherited Functions

bpy_struct.as_pointer bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.id_properties_clear bpy_struct.id_properties_ensure bpy_struct.id_properties_ui bpy_struct.is_property_hidden bpy_struct.is_property_overridable_library bpy_struct.is_property_readonly 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_from_module bpy_struct.path_resolve bpy_struct.pop bpy_struct.property_overridable_library_set bpy_struct.property_unset bpy_struct.rna_ancestors

bpy_struct.type_recast bpy_struct.values ID.bl_system_properties_get ID.rename ID.evaluated_get ID.copy ID.asset_mark ID.asset_clear ID.asset_generate_preview ID.override_create ID.override_hierarchy_create ID.user_clear ID.user_remap ID.make_local ID.user_of_id ID.animation_data_create ID.animation_data_clear ID.update_tag ID.preview_ensure ID.bl_rna_get_subclass ID.bl_rna_get_subclass_py

References

bpy.context.curves BlendData.hair_curves BlendDataHairCurves.new

BlendDataHairCurves.remove Curves.unit_test_compare