Namespaces
namespace	nurbs
namespace	poly
namespace	bezier
namespace	catmull_rom

Classes
struct	CurvePoint
struct	CurveSegment
class	CurvesVertexGroupsAttributeProvider
class	IndexRangeCyclic

Functions
const AttributeAccessorFunctions &	get_attribute_accessor_functions ()
static void	tag_component_topology_changed (void *owner)
static void	tag_component_curve_types_changed (void *owner)
static void	tag_component_positions_changed (void *owner)
static void	tag_component_radii_changed (void *owner)
static void	tag_component_normals_changed (void *owner)
static void	tag_component_material_index_changed (void *owner)
static GeometryAttributeProviders	create_attribute_providers_for_curve ()
static AttributeAccessorFunctions	get_curves_accessor_functions ()
static void	if_has_data_call_callback (const Span< int > offset_data, const int begin, const int end, UnselectedCallback callback)
template<typename Fn>
static void	foreach_selected_point_ranges_per_curve_ (const IndexMask &mask, const OffsetIndices< int > points_by_curve, SelectedCallback selected_fn, Fn unselected_fn)
Inline Curve Methods
int	segments_num (const int points_num, const bool cyclic)
float2	encode_surface_bary_coord (const float3 &v)
float3	decode_surface_bary_coord (const float2 &v)
IndexRange	per_curve_point_offsets_range (const IndexRange points, const int curve_index)

Utility Functions
using	SelectedCallback
using	UnselectedCallback = FunctionRef<void(IndexRange curves, IndexRange unselected_points)>
IndexMask	curve_to_point_selection (OffsetIndices< int > points_by_curve, const IndexMask &curve_selection, IndexMaskMemory &memory)
void	fill_points (OffsetIndices< int > points_by_curve, const IndexMask &curve_selection, GPointer value, GMutableSpan dst)
template<typename T>
void	fill_points (const OffsetIndices< int > points_by_curve, const IndexMask &curve_selection, const T &value, MutableSpan< T > dst)
bke::CurvesGeometry	copy_only_curve_domain (const bke::CurvesGeometry &src_curves)
IndexMask	indices_for_type (const VArray< int8_t > &types, const std::array< int, CURVE_TYPES_NUM > &type_counts, const CurveType type, const IndexMask &selection, IndexMaskMemory &memory)
void	foreach_curve_by_type (const VArray< int8_t > &types, const std::array< int, CURVE_TYPES_NUM > &type_counts, const IndexMask &selection, FunctionRef< void(IndexMask)> catmull_rom_fn, FunctionRef< void(IndexMask)> poly_fn, FunctionRef< void(IndexMask)> bezier_fn, FunctionRef< void(IndexMask)> nurbs_fn)
void	foreach_selected_point_ranges_per_curve (const IndexMask &mask, const OffsetIndices< int > points_by_curve, SelectedCallback selected_fn)
void	foreach_selected_point_ranges_per_curve (const IndexMask &mask, const OffsetIndices< int > points_by_curve, SelectedCallback selected_fn, UnselectedCallback unselected_fn)

Typedef Documentation

◆ SelectedCallback

using blender::bke::curves::SelectedCallback

Initial value:

FunctionRef<void(

int curve_i, IndexRange curve_points, Span<IndexRange> selected_point_ranges)>

blender::FunctionRef

Definition BLI_function_ref.hh:72

blender::IndexRange

Definition BLI_index_range.hh:50

blender::Span

Definition BLI_span.hh:74

Definition at line 511 of file BKE_curves_utils.hh.

◆ UnselectedCallback

using blender::bke::curves::UnselectedCallback = FunctionRef<void(IndexRange curves, IndexRange unselected_points)>

Definition at line 513 of file BKE_curves_utils.hh.

Function Documentation

◆ copy_only_curve_domain()

CurvesGeometry blender::bke::curves::copy_only_curve_domain ( const bke::CurvesGeometry & src_curves )

Create new curves with the same number of curves as the input, but no points. Copy all curve domain attributes to the new curves, except the offsets encoding the size of each curve.

Used for operations that change the number of points but not the number of curves, allowing creation of the new offsets directly inside the new array.

Warning: The returned curves have invalid offsets!

Definition at line 40 of file curves_utils.cc.

References CD_MASK_ALL, copy_only_curve_domain(), CurvesGeometry::curve_data, blender::bke::CurvesGeometry::curves_num(), CustomData_init_from(), and CurvesGeometry::runtime.

◆ create_attribute_providers_for_curve()

GeometryAttributeProviders blender::bke::curves::create_attribute_providers_for_curve ( )

static

In this function all the attribute providers for a curves component are created. Most data in this function is statically allocated, because it does not change over time.

Definition at line 158 of file curves_attributes.cc.

References BEZIER_HANDLE_ALIGN, BEZIER_HANDLE_FREE, CD_PROP_BOOL, CD_PROP_FLOAT, CD_PROP_FLOAT3, CD_PROP_INT32, CD_PROP_INT8, create_attribute_providers_for_curve(), blender::bke::Curve, CURVE_TYPE_CATMULL_ROM, CURVE_TYPES_NUM, blender::bke::BuiltinAttributeProvider::Deletable, blender::bke::GeometryAttributeProviders::GeometryAttributeProviders(), blender::bke::BuiltinAttributeProvider::NonDeletable, NORMAL_MODE_FREE, NORMAL_MODE_MINIMUM_TWIST, NURBS_KNOT_MODE_ENDPOINT_BEZIER, NURBS_KNOT_MODE_NORMAL, blender::bke::Point, tag_component_curve_types_changed(), tag_component_material_index_changed(), tag_component_normals_changed(), tag_component_positions_changed(), tag_component_radii_changed(), and tag_component_topology_changed().

Referenced by create_attribute_providers_for_curve(), and get_curves_accessor_functions().

◆ curve_to_point_selection()

IndexMask blender::bke::curves::curve_to_point_selection	(	OffsetIndices< int >	points_by_curve,
		const IndexMask &	curve_selection,
		IndexMaskMemory &	memory )

Definition at line 16 of file curves_utils.cc.

References curve_to_point_selection(), blender::index_mask::IndexMask::foreach_index(), blender::IndexMask::from_initializers(), blender::GrainSize::GrainSize(), and blender::index_mask::IndexMask::size().

Referenced by blender::bke::copy_point_selection_custom_knots(), blender::ed::transform::curves::createTransCurvesVerts(), and curve_to_point_selection().

◆ decode_surface_bary_coord()

float3 blender::bke::curves::decode_surface_bary_coord ( const float2 & v )

inline

Definition at line 572 of file BKE_curves.hh.

References decode_surface_bary_coord(), and v.

Referenced by decode_surface_bary_coord().

◆ encode_surface_bary_coord()

float2 blender::bke::curves::encode_surface_bary_coord ( const float3 & v )

inline

Definition at line 566 of file BKE_curves.hh.

References BLI_assert, encode_surface_bary_coord(), and v.

Referenced by encode_surface_bary_coord().

◆ fill_points() [1/2]

template<typename T>

void blender::bke::curves::fill_points	(	const OffsetIndices< int >	points_by_curve,
		const IndexMask &	curve_selection,
		const T &	value,
		MutableSpan< T >	dst )

Definition at line 478 of file BKE_curves_utils.hh.

References fill_points(), and T.

◆ fill_points() [2/2]

void blender::bke::curves::fill_points	(	OffsetIndices< int >	points_by_curve,
		const IndexMask &	curve_selection,
		GPointer	value,
		GMutableSpan	dst )

Definition at line 27 of file curves_utils.cc.

References BLI_assert, blender::GMutableSpan::data(), blender::CPPType::fill_assign_n(), fill_points(), blender::index_mask::IndexMask::foreach_index(), blender::GPointer::get(), blender::GrainSize::GrainSize(), i, blender::IndexRange::size(), blender::GMutableSpan::slice(), blender::GMutableSpan::type(), and blender::GPointer::type().

Referenced by blender::geometry::convert_curves_to_bezier(), blender::geometry::convert_curves_to_nurbs(), blender::geometry::copy_or_defaults_for_unselected_curves(), blender::bke::CurvesGeometry::evaluated_positions(), blender::geometry::fill_nurbs_data(), fill_points(), fill_points(), blender::ed::greasepencil::grease_pencil_set_uniform_opacity_exec(), blender::ed::greasepencil::grease_pencil_set_uniform_thickness_exec(), and blender::geometry::simplify_curve_attribute().

◆ foreach_curve_by_type()

void blender::bke::curves::foreach_curve_by_type	(	const VArray< int8_t > &	types,
		const std::array< int, CURVE_TYPES_NUM > &	type_counts,
		const IndexMask &	selection,
		FunctionRef< void(IndexMask)>	catmull_rom_fn,
		FunctionRef< void(IndexMask)>	poly_fn,
		FunctionRef< void(IndexMask)>	bezier_fn,
		FunctionRef< void(IndexMask)>	nurbs_fn )

Definition at line 67 of file curves_utils.cc.

References CURVE_TYPE_BEZIER, CURVE_TYPE_CATMULL_ROM, CURVE_TYPE_NURBS, CURVE_TYPE_POLY, foreach_curve_by_type(), indices_for_type(), and mask().

Referenced by blender::geometry::convert_curves_to_bezier(), blender::geometry::convert_curves_to_catmull_rom_or_poly(), blender::geometry::convert_curves_to_nurbs(), blender::bke::curve_legacy_to_curves(), blender::bke::CurvesGeometry::evaluated_positions(), foreach_curve_by_type(), blender::geometry::subdivide_curves(), and blender::geometry::trim_curves().

◆ foreach_selected_point_ranges_per_curve() [1/2]

void blender::bke::curves::foreach_selected_point_ranges_per_curve	(	const IndexMask &	mask,
		const OffsetIndices< int >	points_by_curve,
		SelectedCallback	selected_fn )

Calls callback function for each curve having selected points.

Parameters

mask	selected points.
points_by_curve	The offsets of every curve into arrays on the points domain.
selected_fn	callback function called for each curve with at least one point selected.

Definition at line 147 of file curves_utils.cc.

References foreach_selected_point_ranges_per_curve(), foreach_selected_point_ranges_per_curve_(), and mask().

Referenced by blender::ed::curves::calc_curves_extrusion(), blender::bke::copy_point_selection_custom_knots(), blender::ed::curves::duplicate_points(), foreach_selected_point_ranges_per_curve(), foreach_selected_point_ranges_per_curve(), blender::ed::curves::separate_points(), and blender::ed::curves::split_points().

◆ foreach_selected_point_ranges_per_curve() [2/2]

void blender::bke::curves::foreach_selected_point_ranges_per_curve	(	const IndexMask &	mask,
		const OffsetIndices< int >	points_by_curve,
		SelectedCallback	selected_fn,
		UnselectedCallback	unselected_fn )

Calls callback function for each curve having selected points. Calls second callback for groups of curves with no points selected.

Parameters

mask	selected points.
points_by_curve	The offsets of every curve into arrays on the points domain.
selected_fn	callback function called for each curve with at least one point selected.
unselected_fn	callback function called for groups of curves with no selected points.

Definition at line 154 of file curves_utils.cc.

References foreach_selected_point_ranges_per_curve(), foreach_selected_point_ranges_per_curve_(), and mask().

◆ foreach_selected_point_ranges_per_curve_()

template<typename Fn>

void blender::bke::curves::foreach_selected_point_ranges_per_curve_	(	const IndexMask &	mask,
		const OffsetIndices< int >	points_by_curve,
		SelectedCallback	selected_fn,
		Fn	unselected_fn )

static

Definition at line 101 of file curves_utils.cc.

References blender::Vector< T, InlineBufferCapacity, Allocator >::append(), blender::Vector< T, InlineBufferCapacity, Allocator >::clear(), blender::offset_indices::OffsetIndices< T >::data(), foreach_selected_point_ranges_per_curve_(), blender::IndexRange::from_begin_end_inclusive(), if_has_data_call_callback(), mask(), and blender::offset_indices::OffsetIndices< T >::size().

Referenced by foreach_selected_point_ranges_per_curve(), foreach_selected_point_ranges_per_curve(), and foreach_selected_point_ranges_per_curve_().

◆ get_attribute_accessor_functions()

const AttributeAccessorFunctions & blender::bke::curves::get_attribute_accessor_functions ( )

Definition at line 421 of file curves_attributes.cc.

References get_attribute_accessor_functions(), and get_curves_accessor_functions().

Referenced by blender::bke::CurveComponent::attributes(), blender::bke::CurvesGeometry::attributes(), blender::bke::CurveComponent::attributes_for_write(), blender::bke::CurvesGeometry::attributes_for_write(), and get_attribute_accessor_functions().

◆ get_curves_accessor_functions()

AttributeAccessorFunctions blender::bke::curves::get_curves_accessor_functions ( )

static

Definition at line 386 of file curves_attributes.cc.

References blender::bke::attribute_accessor_functions::accessor_functions_for_providers(), create_attribute_providers_for_curve(), blender::bke::Curve, ELEM, get_curves_accessor_functions(), and blender::bke::Point.

Referenced by get_attribute_accessor_functions(), and get_curves_accessor_functions().

◆ if_has_data_call_callback()

void blender::bke::curves::if_has_data_call_callback	(	const Span< int >	offset_data,
		const int	begin,
		const int	end,
		UnselectedCallback	callback )

static

Definition at line 88 of file curves_utils.cc.

References begin(), blender::IndexRange::from_begin_end(), and if_has_data_call_callback().

Referenced by foreach_selected_point_ranges_per_curve_(), and if_has_data_call_callback().

◆ indices_for_type()

IndexMask blender::bke::curves::indices_for_type	(	const VArray< int8_t > &	types,
		const std::array< int, CURVE_TYPES_NUM > &	type_counts,
		const CurveType	type,
		const IndexMask &	selection,
		IndexMaskMemory &	memory )

Definition at line 49 of file curves_utils.cc.

References blender::IndexMask::from_predicate(), blender::VArrayCommon< T >::get_internal_single(), blender::VArrayCommon< T >::get_internal_span(), blender::GrainSize::GrainSize(), blender::IndexMask::IndexMask(), indices_for_type(), blender::VArrayCommon< T >::is_single(), and blender::VArrayCommon< T >::size().

Referenced by blender::ed::transform::curves::createTransCurvesVerts(), blender::ed::transform::greasepencil::createTransGreasePencilVerts(), blender::draw::DRW_curves_batch_cache_create_requested(), foreach_curve_by_type(), blender::bke::CurvesGeometry::indices_for_curve_type(), and indices_for_type().

◆ per_curve_point_offsets_range()

IndexRange blender::bke::curves::per_curve_point_offsets_range	(	const IndexRange	points,
		const int	curve_index )

inline

Return a range used to retrieve values from an array of values stored per point, but with an extra element at the end of each curve. This is useful for offsets within curves, where it is convenient to store the first 0 and have the last offset be the total result curve size, using the same rules as OffsetIndices.

Definition at line 583 of file BKE_curves.hh.

References per_curve_point_offsets_range(), blender::IndexRange::size(), and blender::IndexRange::start().

Referenced by blender::bke::CurvesGeometry::bezier_evaluated_offsets_for_curve(), blender::bke::calculate_evaluated_offsets(), blender::geometry::calculate_result_offsets(), blender::geometry::calculate_result_offsets(), blender::geometry::duplicate_fillet_point_data(), blender::bke::evaluate_generic_data_for_curve(), blender::bke::CurvesGeometry::evaluated_positions(), blender::geometry::fillet_curves(), per_curve_point_offsets_range(), blender::geometry::subdivide_attribute_catmull_rom(), blender::geometry::subdivide_attribute_linear(), and blender::geometry::subdivide_curves().

◆ segments_num()

int blender::bke::curves::segments_num	(	const int	points_num,
		const bool	cyclic )

inline

The number of segments between control points, accounting for the last segment of cyclic curves. The logic is simple, but this function should be used to make intentions clearer.

Definition at line 560 of file BKE_curves.hh.

References BLI_assert, and segments_num().

Referenced by blender::bke::curves::nurbs::calculate_basis_cache(), blender::bke::curves::catmull_rom::calculate_evaluated_num(), blender::bke::curves::nurbs::calculate_evaluated_num(), blender::draw::curve_eval_render_wire_verts_edges_len_get(), blender::bke::fill_mesh_topology(), blender::bke::curves::bezier::has_vector_handles(), segments_num(), and blender::bke::segments_num_no_duplicate_edge().