#include <BKE_curves.hh>

Inherits CurvesGeometry.

Classes
struct	BlendWriteData

Public Member Functions
template<typename T >
VArray< T >	adapt_domain (const VArray< T > &varray, AttrDomain from, AttrDomain to) const

Constructors/Destructor
	CurvesGeometry ()

	CurvesGeometry (int point_num, int curve_num)

	CurvesGeometry (const CurvesGeometry &other)

	CurvesGeometry (CurvesGeometry &&other)

CurvesGeometry &	operator= (const CurvesGeometry &other)

CurvesGeometry &	operator= (CurvesGeometry &&other)

	~CurvesGeometry ()

Accessors
Span< int >	offsets () const

MutableSpan< int >	offsets_for_write ()

VArray< int8_t >	curve_types () const

MutableSpan< int8_t >	curve_types_for_write ()

void	fill_curve_types (CurveType type)

void	fill_curve_types (const IndexMask &selection, CurveType type)

void	update_curve_types ()

Span< float3 >	positions () const

MutableSpan< float3 >	positions_for_write ()

VArray< float >	radius () const

MutableSpan< float >	radius_for_write ()

VArray< bool >	cyclic () const

MutableSpan< bool >	cyclic_for_write ()

VArray< int >	resolution () const

MutableSpan< int >	resolution_for_write ()

VArray< float >	tilt () const

MutableSpan< float >	tilt_for_write ()

VArray< int8_t >	normal_mode () const

MutableSpan< int8_t >	normal_mode_for_write ()

VArray< int8_t >	handle_types_left () const

MutableSpan< int8_t >	handle_types_left_for_write ()

VArray< int8_t >	handle_types_right () const

MutableSpan< int8_t >	handle_types_right_for_write ()

Span< float3 >	handle_positions_left () const

MutableSpan< float3 >	handle_positions_left_for_write ()

Span< float3 >	handle_positions_right () const

MutableSpan< float3 >	handle_positions_right_for_write ()

VArray< int8_t >	nurbs_orders () const

MutableSpan< int8_t >	nurbs_orders_for_write ()

VArray< int8_t >	nurbs_knots_modes () const

MutableSpan< int8_t >	nurbs_knots_modes_for_write ()

Span< float >	nurbs_weights () const

MutableSpan< float >	nurbs_weights_for_write ()

Span< float2 >	surface_uv_coords () const

MutableSpan< float2 >	surface_uv_coords_for_write ()

Span< float >	nurbs_custom_knots () const

MutableSpan< float >	nurbs_custom_knots_for_write ()

OffsetIndices< int >	nurbs_custom_knots_by_curve () const

IndexMask	nurbs_custom_knot_curves (IndexMaskMemory &memory) const

void	nurbs_custom_knots_update_size ()

void	nurbs_custom_knots_resize (int knots_num)

Span< MDeformVert >	deform_verts () const

MutableSpan< MDeformVert >	deform_verts_for_write ()

Operations
std::optional< Bounds< float3 > >	bounds_min_max (bool use_radius=true) const

void	count_memory (MemoryCounter &memory) const

std::optional< int >	material_index_max () const

void	resize (int points_num, int curves_num)

void	tag_positions_changed ()

void	tag_topology_changed ()

void	tag_normals_changed ()

void	tag_radii_changed ()

void	tag_material_index_changed ()

void	translate (const float3 &translation)

void	transform (const float4x4 &matrix)

void	calculate_bezier_auto_handles ()

void	remove_points (const IndexMask &points_to_delete, const AttributeFilter &attribute_filter)

void	remove_curves (const IndexMask &curves_to_delete, const AttributeFilter &attribute_filter)

void	reverse_curves (const IndexMask &curves_to_reverse)

void	remove_attributes_based_on_types ()

Domain Interpolation
AttributeAccessor	attributes () const

MutableAttributeAccessor	attributes_for_write ()

GVArray	adapt_domain (const GVArray &varray, AttrDomain from, AttrDomain to) const

File reading/writing.
void	blend_read (BlendDataReader &reader)

void	blend_write_prepare (BlendWriteData &write_data)

void	blend_write (BlendWriter &writer, ID &id, const BlendWriteData &write_data)

#CurvesGeometry Inline Methods
int	points_num () const

int	curves_num () const

bool	is_empty () const

IndexRange	points_range () const

IndexRange	curves_range () const

OffsetIndices< int >	points_by_curve () const

bool	has_curve_with_type (CurveType type) const

bool	has_curve_with_type (Span< CurveType > types) const

bool	is_single_type (CurveType type) const

const std::array< int, CURVE_TYPES_NUM > &	curve_type_counts () const

bool	nurbs_has_custom_knots () const

int	evaluated_points_num () const

Span< int >	bezier_evaluated_offsets_for_curve (int curve_index) const

Span< float >	evaluated_lengths_for_curve (int curve_index, bool cyclic) const

float	evaluated_length_total_for_curve (int curve_index, bool cyclic) const

Evaluation
IndexMask	indices_for_curve_type (CurveType type, IndexMaskMemory &memory) const

IndexMask	indices_for_curve_type (CurveType type, const IndexMask &selection, IndexMaskMemory &memory) const

Array< int >	point_to_curve_map () const

OffsetIndices< int >	evaluated_points_by_curve () const

Span< float3 >	evaluated_positions () const

Span< float3 >	evaluated_tangents () const

Span< float3 >	evaluated_normals () const

void	ensure_evaluated_lengths () const

void	ensure_can_interpolate_to_evaluated () const

void	interpolate_to_evaluated (int curve_index, GSpan src, GMutableSpan dst) const

void	interpolate_to_evaluated (GSpan src, GMutableSpan dst) const

Additional Inherited Members
Public Attributes inherited from CurvesGeometry
int *	curve_offsets

struct AttributeStorage	attribute_storage

CustomData	point_data

CustomData	curve_data

int	point_num

int	curve_num

ListBase	vertex_group_names

int	vertex_group_active_index

int	attributes_active_index

CurvesGeometryRuntimeHandle *	runtime

float *	custom_knots

int	custom_knot_num

char	_pad [4]

Detailed Description

A C++ class that wraps the DNA struct for better encapsulation and ease of use. It inherits directly from the struct rather than storing a pointer to avoid more complicated ownership handling.

Definition at line 152 of file BKE_curves.hh.

Constructor & Destructor Documentation

◆ CurvesGeometry() [1/4]

CurvesGeometry::CurvesGeometry ( )

Definition at line 62 of file curves_geometry.cc.

Referenced by operator=(), and operator=().

◆ CurvesGeometry() [2/4]

CurvesGeometry::CurvesGeometry	(	int	point_num,
		int	curve_num )

Create curves with the given size. Only the position attribute is created, along with the offsets.

Definition at line 64 of file curves_geometry.cc.

References blender::bke::MutableAttributeAccessor::add(), CurvesGeometry::attribute_storage, attributes_for_write(), BLI_listbase_clear(), CurvesGeometry::curve_data, CurvesGeometry::curve_num, CurvesGeometry::curve_offsets, CURVE_TYPE_CATMULL_ROM, CurvesGeometry::custom_knot_num, CurvesGeometry::custom_knots, CustomData_reset(), blender::MutableSpan< T >::fill(), blender::implicit_sharing::info_for_mem_free(), MEM_malloc_arrayN(), offsets_for_write(), blender::bke::Point, CurvesGeometry::point_data, CurvesGeometry::point_num, CurvesGeometry::runtime, and CurvesGeometry::vertex_group_names.

◆ CurvesGeometry() [3/4]

CurvesGeometry::CurvesGeometry ( const CurvesGeometry & other )

Definition at line 100 of file curves_geometry.cc.

References CurvesGeometry::attribute_storage, CurvesGeometry::attributes_active_index, BKE_defgroup_copy_list(), CD_MASK_ALL, CurvesGeometry::curve_data, CurvesGeometry::curve_num, CurvesGeometry::curve_offsets, CurvesGeometry::custom_knot_num, CurvesGeometry::custom_knots, CustomData_init_from(), CurvesGeometry::point_data, CurvesGeometry::point_num, CurvesGeometry::runtime, this, CurvesGeometry::vertex_group_active_index, and CurvesGeometry::vertex_group_names.

◆ CurvesGeometry() [4/4]

CurvesGeometry::CurvesGeometry ( CurvesGeometry && other )

Definition at line 160 of file curves_geometry.cc.

References CurvesGeometry::attribute_storage, CurvesGeometry::attributes_active_index, BLI_listbase_clear(), CurvesGeometry::curve_data, CurvesGeometry::curve_num, CurvesGeometry::curve_offsets, CurvesGeometry::custom_knot_num, CurvesGeometry::custom_knots, CustomData_reset(), CurvesGeometry::point_data, CurvesGeometry::point_num, CurvesGeometry::runtime, CurvesGeometry::vertex_group_active_index, and CurvesGeometry::vertex_group_names.

◆ ~CurvesGeometry()

CurvesGeometry::~CurvesGeometry ( )

Definition at line 209 of file curves_geometry.cc.

References CurvesGeometry::attribute_storage, BLI_freelistN(), CurvesGeometry::curve_data, CurvesGeometry::curve_offsets, CurvesGeometry::custom_knots, CustomData_free(), blender::implicit_sharing::free_shared_data(), CurvesGeometry::point_data, CurvesGeometry::runtime, and CurvesGeometry::vertex_group_names.

Referenced by blender::bke::greasepencil::Drawing::~Drawing().

Member Function Documentation

◆ adapt_domain() [1/2]

GVArray CurvesGeometry::adapt_domain	(	const GVArray &	varray,
		AttrDomain	from,
		AttrDomain	to ) const

◆ adapt_domain() [2/2]

template<typename T >

VArray< T > blender::bke::CurvesGeometry::adapt_domain	(	const VArray< T > &	varray,
		AttrDomain	from,
		AttrDomain	to ) const

inline

Definition at line 486 of file BKE_curves.hh.

References adapt_domain(), from, and blender::GVArray::typed().

◆ attributes()

AttributeAccessor CurvesGeometry::attributes ( ) const

Definition at line 1845 of file curves_geometry.cc.

◆ attributes_for_write()

MutableAttributeAccessor CurvesGeometry::attributes_for_write ( )

Definition at line 1850 of file curves_geometry.cc.

◆ bezier_evaluated_offsets_for_curve()

Span< int > CurvesGeometry::bezier_evaluated_offsets_for_curve ( int curve_index ) const

inline

Retrieve offsets into a Bezier curve's evaluated points for each control point. Stored in the same format as #OffsetIndices. Call evaluated_points_by_curve() first to ensure that the evaluated offsets cache is current.

Definition at line 1033 of file BKE_curves.hh.

References blender::Span< T >::data(), offsets(), blender::bke::curves::per_curve_point_offsets_range(), points_by_curve(), range, CurvesGeometry::runtime, and blender::Span< T >::slice().

Referenced by blender::geometry::lookup_point_bezier().

◆ blend_read()

void CurvesGeometry::blend_read ( BlendDataReader & reader )

Definition at line 1861 of file curves_geometry.cc.

References BLO_read_float_array(), BLO_read_int32_array(), BLO_read_shared(), BLO_read_struct_list, blender::bke::CurvesGeometryRuntime::curve_offsets_sharing_info, blender::bke::curves_convert_storage_to_customdata(), blender::bke::CurvesGeometryRuntime::custom_knots_sharing_info, CustomData_blend_read(), and blender::implicit_sharing::info_for_mem_free().

◆ blend_write()

void CurvesGeometry::blend_write	(	BlendWriter &	writer,
		ID &	id,
		const BlendWriteData &	write_data )

Definition at line 1928 of file curves_geometry.cc.

References CurvesGeometry::attribute_storage, BKE_defbase_blend_write(), BLO_write_shared(), CD_MASK_ALL, CurvesGeometry::curve_data, CurvesGeometry::curve_num, CurvesGeometry::curve_offsets, blender::bke::CurvesGeometryRuntime::curve_offsets_sharing_info, CurvesGeometry::custom_knot_num, blender::bke::CurvesGeometryRuntime::custom_knots_sharing_info, CustomData_blend_write(), CurvesGeometry::point_data, this, and CurvesGeometry::vertex_group_names.

Referenced by write_drawing_array().

◆ blend_write_prepare()

void CurvesGeometry::blend_write_prepare ( BlendWriteData & write_data )

This function needs to be called before blend_write and before the CurvesGeometry struct is written because it can mutate the CustomData and AttributeStorage structs.

Definition at line 1902 of file curves_geometry.cc.

References CurvesGeometry::attribute_storage, and blender::bke::attribute_storage_blend_write_prepare().

Referenced by write_drawing_array().

◆ bounds_min_max()

std::optional< Bounds< float3 > > CurvesGeometry::bounds_min_max ( bool use_radius = true ) const

The largest and smallest position values of evaluated points.

Definition at line 1316 of file curves_geometry.cc.

References blender::Array< T, InlineBufferCapacity, Allocator >::as_mutable_span(), blender::Array< T, InlineBufferCapacity, Allocator >::as_span(), blender::bke::CurvesGeometryRuntime::bounds_cache, blender::bke::CurvesGeometryRuntime::bounds_with_radius_cache, CURVE_TYPE_POLY, blender::VArrayCommon< T >::get_if_single(), blender::VArrayCommon< T >::get_internal_span(), blender::bounds::min_max(), blender::bounds::min_max_with_radii(), and blender::Bounds< T >::pad().

Referenced by blender::create_array_copies(), blender::io::usd::USDCurvesWriter::do_write(), blender::ed::object::object_origin_set_exec(), blender::io::grease_pencil::shift_to_bounds_center(), blender::bke::tests::TEST(), and blender::bke::tests::TEST().

◆ calculate_bezier_auto_handles()

void CurvesGeometry::calculate_bezier_auto_handles ( )

Definition at line 1243 of file curves_geometry.cc.

References CURVE_TYPE_BEZIER, blender::threading::parallel_for(), range, blender::MutableSpan< T >::slice(), blender::Span< T >::slice(), and types.

Referenced by blender::geometry::convert_curves_to_bezier(), ED_transverts_update_obedit(), blender::ed::curves::cyclic_toggle::exec(), blender::ed::greasepencil::grease_pencil_set_handle_type_exec(), blender::ed::greasepencil::grease_pencil_snap_to_cursor_exec(), blender::ed::object::object_origin_set_exec(), blender::ed::transform::curves::recalcData_curves(), blender::ed::transform::greasepencil::recalcData_grease_pencil(), blender::nodes::node_geo_set_position_cc::set_curves_position(), blender::nodes::node_geo_curve_set_handle_type_cc::set_handle_type(), and blender::ed::curves::split::split_exec().

◆ count_memory()

void CurvesGeometry::count_memory ( MemoryCounter & memory ) const

Definition at line 1363 of file curves_geometry.cc.

References blender::memory_counter::MemoryCounter::add_shared(), blender::bke::CurvesGeometryRuntime::curve_offsets_sharing_info, blender::bke::CurvesGeometryRuntime::custom_knots_sharing_info, CustomData_count_memory(), and this.

◆ curve_type_counts()

const std::array< int, CURVE_TYPES_NUM > & CurvesGeometry::curve_type_counts ( ) const

inline

Return the number of curves with each type.

Definition at line 1007 of file BKE_curves.hh.

References BLI_assert, blender::bke::calculate_type_counts(), curve_types(), and CurvesGeometry::runtime.

Referenced by blender::geometry::convert_curves_to_bezier(), blender::geometry::convert_curves_to_catmull_rom_or_poly(), blender::geometry::convert_curves_to_nurbs(), blender::ed::transform::curves::createTransCurvesVerts(), blender::ed::transform::greasepencil::createTransGreasePencilVerts(), blender::bke::curve_legacy_to_curves(), blender::io::alembic::ABCCurveWriter::do_write(), blender::io::usd::USDCurvesWriter::do_write(), blender::draw::DRW_curves_batch_cache_create_requested(), blender::geometry::gather_point_attributes_to_interpolate(), blender::geometry::gather_point_attributes_to_interpolate(), has_curve_with_type(), is_single_type(), blender::geometry::subdivide_curves(), blender::bke::tests::TEST(), and blender::geometry::trim_curves().

◆ curve_types()

VArray< int8_t > CurvesGeometry::curve_types ( ) const

The type (CurveType) of each curve, or potentially a single if all are the same type.

Definition at line 303 of file curves_geometry.cc.

References blender::bke::ATTR_CURVE_TYPE, blender::bke::Curve, CURVE_TYPE_CATMULL_ROM, and blender::bke::get_varray_attribute().

◆ curve_types_for_write()

MutableSpan< int8_t > CurvesGeometry::curve_types_for_write ( )

Mutable access to curve types. Call tag_topology_changed and update_curve_types after changing any type. Consider using the other methods to change types below.

Definition at line 309 of file curves_geometry.cc.

References blender::bke::ATTR_CURVE_TYPE, blender::bke::Curve, and blender::bke::get_mutable_attribute().

Referenced by blender::ed::greasepencil::boundary_to_curves(), blender::bke::curve_legacy_to_curves(), fill_curve_types(), fill_curve_types(), blender::geometry::fit_poly_to_bezier_curves(), blender::ed::greasepencil::grease_pencil_primitive_init_curves(), blender::bke::greasepencil::convert::legacy_gpencil_frame_to_grease_pencil_drawing(), blender::ed::sculpt_paint::greasepencil::PaintOperationExecutor::process_start_sample(), blender::io::grease_pencil::shape_attributes_to_curves(), and blender::bke::tests::TEST().

◆ curves_num()

int CurvesGeometry::curves_num ( ) const

inline

The number of curves in the data-block.

Definition at line 968 of file BKE_curves.hh.

References CurvesGeometry::curve_num.

◆ curves_range()

IndexRange CurvesGeometry::curves_range ( ) const

inline

Definition at line 986 of file BKE_curves.hh.

References curves_num().

◆ cyclic()

VArray< bool > CurvesGeometry::cyclic ( ) const

Whether the curve loops around to connect to itself, on the curve domain.

Definition at line 419 of file curves_geometry.cc.

References blender::bke::ATTR_CYCLIC, and get_varray_attribute().

◆ cyclic_for_write()

MutableSpan< bool > CurvesGeometry::cyclic_for_write ( )

Mutable access to curve cyclic values. Call tag_topology_changed after changes.

Definition at line 423 of file curves_geometry.cc.

References blender::bke::ATTR_CYCLIC, and get_mutable_attribute().

Referenced by blender::ed::curves::copy_data_to_geometry(), blender::nodes::node_geo_curve_primitive_arc_cc::create_arc_curve_from_points(), blender::nodes::node_geo_curve_primitive_arc_cc::create_arc_curve_from_radius(), blender::geometry::create_curve_from_vert_indices(), blender::ed::curves::tests::create_curves(), blender::geometry::create_curves_for_faces(), blender::nodes::node_geo_curve_primitive_circle_cc::create_point_circle_curve(), blender::nodes::node_geo_curve_primitive_circle_cc::create_radius_circle_curve(), blender::nodes::node_geo_curve_primitive_star_cc::create_star_curve(), blender::bke::tests::GreasePencilInterpolate::create_test_curves(), blender::geometry::tests::create_test_curves(), blender::bke::curve_legacy_to_curves(), blender::ed::curves::curves_draw_exec(), blender::geometry::curves_merge_endpoints(), blender::ed::curves::duplicate_points(), blender::ed::greasepencil::extrude_grease_pencil_curves(), blender::ed::greasepencil::grease_pencil_cyclical_set_exec(), blender::ed::object::mesh_data_to_grease_pencil(), blender::ed::space_node::node_draw_zones_and_frames(), blender::nodes::node_geo_curve_primitive_quadrilateral_cc::node_geo_exec(), blender::io::usd::USDBasisCurvesReader::read_curve_sample(), blender::io::alembic::AbcCurveReader::read_curves_sample(), blender::geometry::remove_points_and_split(), blender::io::grease_pencil::shape_attributes_to_curves(), blender::bke::tests::TEST(), blender::bke::tests::TEST(), and blender::bke::tests::TEST().

◆ deform_verts()

Span< MDeformVert > CurvesGeometry::deform_verts ( ) const

Vertex group data, encoded as an array of indices and weights for every vertex.

Warning: : May be empty.

Definition at line 605 of file curves_geometry.cc.

References CD_MDEFORMVERT, and CustomData_get_layer().

Referenced by blender::bke::curves::CurvesVertexGroupsAttributeProvider::foreach_attribute(), blender::modify_curves(), blender::modify_drawing(), blender::bke::curves::CurvesVertexGroupsAttributeProvider::try_delete(), blender::bke::curves::CurvesVertexGroupsAttributeProvider::try_get_for_read(), and blender::ed::object::vgroup_grease_pencil_select_verts().

◆ deform_verts_for_write()

MutableSpan< MDeformVert > CurvesGeometry::deform_verts_for_write ( )

Definition at line 615 of file curves_geometry.cc.

References CD_MDEFORMVERT, CD_SET_DEFAULT, CustomData_add_layer(), and CustomData_get_layer_for_write().

Referenced by blender::bke::greasepencil::assign_to_vertex_group(), blender::bke::greasepencil::assign_to_vertex_group_from_mask(), blender::bke::greasepencil::clear_vertex_groups(), blender::ed::greasepencil::grease_pencil_weight_invert_exec(), blender::bke::greasepencil::convert::legacy_gpencil_frame_to_grease_pencil_drawing(), MOD_lineart_gpencil_generate_v3(), blender::bke::greasepencil::remove_from_vertex_group(), blender::bke::curves::CurvesVertexGroupsAttributeProvider::try_delete(), blender::bke::curves::CurvesVertexGroupsAttributeProvider::try_get_for_write(), blender::bke::greasepencil::validate_drawing_vertex_groups(), and blender::ed::object::vgroup_parray_alloc().

◆ ensure_can_interpolate_to_evaluated()

void CurvesGeometry::ensure_can_interpolate_to_evaluated ( ) const

Definition at line 1159 of file curves_geometry.cc.

Referenced by blender::nodes::node_geo_curve_sample_cc::SampleCurveFunction::call(), blender::geometry::compute_curve_trim_parameters(), blender::draw::curve_create_attribute(), blender::bke::curve_to_mesh_sweep(), blender::draw::grease_pencil_edit_batch_ensure(), blender::draw::grease_pencil_geom_batch_ensure(), and blender::geometry::resample_to_evaluated().

◆ ensure_evaluated_lengths()

void CurvesGeometry::ensure_evaluated_lengths ( ) const

Calculates the data described by evaluated_lengths_for_curve if necessary.

Definition at line 1132 of file curves_geometry.cc.

References blender::length_parameterize::accumulate_lengths(), blender::bke::CurvesGeometryRuntime::evaluated_length_cache, blender::threading::parallel_for(), blender::Vector< T, InlineBufferCapacity, Allocator >::resize(), blender::MutableSpan< T >::slice(), and blender::Span< T >::slice().

Referenced by blender::nodes::node_geo_curve_spline_parameter_cc::accumulated_lengths_curve_domain(), blender::nodes::node_geo_curve_spline_parameter_cc::calculate_point_lengths(), blender::bke::construct_curve_length_gvarray(), blender::ed::greasepencil::curves_merge_by_distance(), blender::nodes::node_geo_curve_length_cc::curves_total_length(), blender::deform_drawing(), blender::geometry::extend_curves(), blender::draw::grease_pencil_geom_batch_ensure(), blender::geometry::interpolate_curves(), blender::nodes::node_geo_curve_sample_cc::node_geo_exec(), blender::point_counts_to_keep_concurrent(), blender::geometry::resample_to_length(), blender::geometry::resample_to_uniform(), blender::ed::greasepencil::subdivide_last_segement(), blender::geometry::trim_curves(), and blender::write_stroke_transforms().

◆ evaluated_length_total_for_curve()

float CurvesGeometry::evaluated_length_total_for_curve	(	int	curve_index,
		bool	cyclic ) const

inline

Definition at line 1058 of file BKE_curves.hh.

References cyclic(), evaluated_lengths_for_curve(), blender::Span< T >::is_empty(), and blender::Span< T >::last().

Referenced by blender::nodes::node_geo_curve_spline_parameter_cc::accumulated_lengths_curve_domain(), blender::nodes::node_geo_curve_spline_parameter_cc::calculate_curve_parameters(), blender::nodes::node_geo_curve_sample_cc::curve_accumulated_lengths(), blender::nodes::node_geo_curve_length_cc::curves_total_length(), blender::geometry::extend_curves(), blender::point_counts_to_keep_concurrent(), blender::geometry::resample_to_length(), and blender::ed::greasepencil::subdivide_last_segement().

◆ evaluated_lengths_for_curve()

Span< float > CurvesGeometry::evaluated_lengths_for_curve	(	int	curve_index,
		bool	cyclic ) const

inline

Return a cache of accumulated lengths along the curve. Each item is the length of the subsequent segment (the first value is the length of the first segment rather than 0). This calculation is rather trivial, and only depends on the evaluated positions, but the results are used often, and it is necessarily single threaded per curve, so it is cached.

Parameters

cyclic This argument is redundant with the data stored for the curve, but is passed for performance reasons to avoid looking up the attribute.

Definition at line 1051 of file BKE_curves.hh.

References cyclic(), range, and CurvesGeometry::runtime.

Referenced by blender::geometry::compute_curve_trim_parameters(), evaluated_length_total_for_curve(), blender::draw::grease_pencil_geom_batch_ensure(), blender::geometry::resample_to_uniform(), blender::geometry::sample_curve_uniform(), and blender::write_stroke_transforms().

◆ evaluated_normals()

Span< float3 > CurvesGeometry::evaluated_normals ( ) const

Definition at line 991 of file curves_geometry.cc.

References blender::Vector< T, InlineBufferCapacity, Allocator >::as_mutable_span(), blender::Vector< T, InlineBufferCapacity, Allocator >::as_span(), CURVE_TYPE_POLY, blender::bke::evaluate_generic_data_for_curve(), blender::bke::CurvesGeometryRuntime::evaluated_normal_cache, blender::bke::CurvesGeometryRuntime::evaluated_offsets_cache, blender::VArrayCommon< T >::get_internal_single(), blender::Span< T >::is_empty(), blender::VArrayCommon< T >::is_single(), blender::bke::AttributeAccessor::lookup(), NORMAL_MODE_FREE, NORMAL_MODE_MINIMUM_TWIST, NORMAL_MODE_Z_UP, blender::bke::normalize_span(), blender::bke::CurvesGeometryRuntime::nurbs_basis_cache, blender::threading::parallel_for(), blender::Vector< T, InlineBufferCapacity, Allocator >::reinitialize(), blender::Vector< T, InlineBufferCapacity, Allocator >::resize(), blender::bke::rotate_directions_around_axes(), blender::IndexRange::size(), blender::MutableSpan< T >::slice(), blender::Span< T >::slice(), and types.

Referenced by blender::bke::build_mesh_positions(), blender::nodes::node_geo_curve_sample_cc::SampleCurveFunction::call(), blender::bke::curve_normal_point_domain(), blender::bke::curve_normals_varray(), and blender::geometry::gather_point_attributes_to_interpolate().

◆ evaluated_points_by_curve()

OffsetIndices< int > CurvesGeometry::evaluated_points_by_curve ( ) const

The offsets of every curve's evaluated points.

Definition at line 691 of file curves_geometry.cc.

References blender::bke::CurvesGeometryRuntime::EvaluatedOffsets::all_bezier_offsets, blender::Vector< T, InlineBufferCapacity, Allocator >::clear_and_shrink(), CURVE_TYPE_BEZIER, CURVE_TYPE_POLY, blender::bke::CurvesGeometryRuntime::EvaluatedOffsets::evaluated_offsets, blender::bke::CurvesGeometryRuntime::evaluated_offsets_cache, and blender::Vector< T, InlineBufferCapacity, Allocator >::resize().

Referenced by blender::ed::greasepencil::build_curves_2d_bvh_from_visible(), blender::nodes::node_geo_curve_sample_cc::SampleCurveFunction::call(), blender::geometry::compute_curve_trim_parameters(), blender::draw::curve_create_curves_lines(), blender::draw::curve_eval_render_wire_verts_edges_len_get(), blender::bke::curve_normal_point_domain(), blender::nodes::node_geo_input_tangent_cc::curve_tangent_point_domain(), blender::nodes::node_geo_curve_fill_cc::do_cdt(), blender::nodes::node_geo_curve_fill_cc::do_cdt_with_mask(), blender::draw::overlay::GreasePencil::draw_grease_pencil(), blender::draw::DRW_curves_batch_cache_create_requested(), evaluated_points_num(), blender::draw::grease_pencil_edit_batch_ensure(), blender::draw::grease_pencil_geom_batch_ensure(), blender::draw::grease_pencil_wire_batch_ensure(), blender::draw::index_buf_add_line_points(), blender::geometry::resample_to_evaluated(), blender::geometry::resample_to_uniform(), blender::geometry::sample_curve_attribute(), blender::bke::greasepencil::Drawing::tag_positions_changed(), blender::bke::greasepencil::Drawing::tag_topology_changed(), blender::bke::greasepencil::Drawing::triangles(), and blender::geometry::trim_evaluated_curves().

◆ evaluated_points_num()

int CurvesGeometry::evaluated_points_num ( ) const

inline

The total number of points in the evaluated poly curve. This can depend on the resolution attribute if it exists.

Definition at line 1027 of file BKE_curves.hh.

References evaluated_points_by_curve().

Referenced by blender::draw::attribute_interpolate(), blender::bke::evaluate_attribute(), blender::draw::grease_pencil_edit_batch_ensure(), blender::draw::grease_pencil_geom_batch_ensure(), blender::draw::index_buf_add_line_points(), and blender::bke::tests::TEST().

◆ evaluated_positions()

Span< float3 > CurvesGeometry::evaluated_positions ( ) const

Definition at line 793 of file curves_geometry.cc.

References blender::Vector< T, InlineBufferCapacity, Allocator >::clear_and_shrink(), blender::array_utils::copy_group_to_group(), CURVE_TYPE_POLY, blender::bke::CurvesGeometryRuntime::evaluated_offsets_cache, blender::bke::CurvesGeometryRuntime::evaluated_position_cache, blender::Span< T >::is_empty(), blender::bke::CurvesGeometryRuntime::nurbs_basis_cache, blender::Vector< T, InlineBufferCapacity, Allocator >::resize(), blender::MutableSpan< T >::slice(), blender::Span< T >::slice(), and blender::Span< T >::slice_safe().

Referenced by BKE_object_foreach_display_point(), blender::ed::greasepencil::build_curves_2d_bvh_from_visible(), blender::bke::build_mesh_positions(), blender::nodes::node_geo_curve_sample_cc::SampleCurveFunction::call(), blender::draw::create_edit_points_position_vbo(), blender::draw::curve_create_curves_pos(), blender::nodes::node_geo_curve_fill_cc::do_cdt(), blender::nodes::node_geo_curve_fill_cc::do_cdt_with_mask(), blender::draw::grease_pencil_edit_batch_ensure(), blender::draw::grease_pencil_geom_batch_ensure(), blender::geometry::interpolate_curves_with_samples(), blender::geometry::resample_to_evaluated(), blender::geometry::resample_to_uniform(), blender::bke::greasepencil::Drawing::tag_positions_changed(), blender::bke::greasepencil::Drawing::tag_topology_changed(), blender::bke::tests::TEST(), blender::bke::tests::TEST(), blender::bke::tests::TEST(), blender::bke::tests::TEST(), blender::bke::greasepencil::Drawing::triangles(), blender::geometry::trim_curves(), and blender::geometry::trim_evaluated_curves().

◆ evaluated_tangents()

Span< float3 > CurvesGeometry::evaluated_tangents ( ) const

Definition at line 872 of file curves_geometry.cc.

References blender::math::almost_equal_relative(), CURVE_TYPE_BEZIER, blender::bke::CurvesGeometryRuntime::evaluated_tangent_cache, blender::IndexRange::first(), blender::index_mask::IndexMask::foreach_index(), if(), blender::index_mask::IndexMask::is_empty(), blender::IndexRange::last(), blender::threading::parallel_for(), blender::Vector< T, InlineBufferCapacity, Allocator >::resize(), blender::MutableSpan< T >::slice(), and blender::Span< T >::slice().

Referenced by blender::bke::build_mesh_positions(), blender::nodes::node_geo_curve_sample_cc::SampleCurveFunction::call(), blender::nodes::node_geo_input_tangent_cc::construct_curve_tangent_gvarray(), blender::nodes::node_geo_input_tangent_cc::curve_tangent_point_domain(), blender::deform_drawing(), blender::geometry::gather_point_attributes_to_interpolate(), and blender::generate_curves().

◆ fill_curve_types() [1/2]

void CurvesGeometry::fill_curve_types	(	const IndexMask &	selection,
		CurveType	type )

Set the types for the curves in the selection and call update_curve_types.

Definition at line 329 of file curves_geometry.cc.

References curve_types(), curve_types_for_write(), fill_curve_types(), blender::index_mask::masked_fill(), blender::index_mask::IndexMask::size(), tag_topology_changed(), this, and update_curve_types().

◆ fill_curve_types() [2/2]

void CurvesGeometry::fill_curve_types ( CurveType type )

Set all curve types to the value and call update_curve_types.

Definition at line 314 of file curves_geometry.cc.

References attributes_for_write(), CURVE_TYPE_CATMULL_ROM, curve_types_for_write(), curves_num(), blender::bke::MutableAttributeAccessor::remove(), CurvesGeometry::runtime, and tag_topology_changed().

◆ handle_positions_left()

Span< float3 > CurvesGeometry::handle_positions_left ( ) const

The positions of Bezier curve handles. Though these are really control points for the Bezier segments, they are stored in separate arrays to better reflect user expectations. Note that values may be generated automatically based on the handle types. Call tag_positions_changed after changes.

Definition at line 473 of file curves_geometry.cc.

References blender::bke::ATTR_HANDLE_POSITION_LEFT, and get_span_attribute().

Referenced by BKE_grease_pencil_point_coords_get(), blender::geometry::convert_curves_to_bezier(), blender::geometry::convert_curves_to_catmull_rom_or_poly(), blender::geometry::convert_curves_to_nurbs(), blender::draw::create_edit_points_position(), blender::ed::transform::curves::curve_populate_trans_data_structs(), blender::io::alembic::ABCCurveWriter::do_write(), blender::geometry::fillet_curves(), blender::ed::curves::get_curves_positions(), blender::ed::curves::get_selection_attribute_positions(), blender::draw::grease_pencil_edit_batch_ensure(), blender::ed::curves::init_selectable_foreach(), blender::io::usd::populate_curve_props_for_bezier(), blender::bke::curves::bezier::retrieve_all_positions(), blender::ed::greasepencil::retrieve_visible_bezier_handle_points(), blender::geometry::subdivide_curves(), and blender::geometry::trim_bezier_curves().

◆ handle_positions_left_for_write()

MutableSpan< float3 > CurvesGeometry::handle_positions_left_for_write ( )

Definition at line 477 of file curves_geometry.cc.

References blender::bke::ATTR_HANDLE_POSITION_LEFT, and get_mutable_attribute().

Referenced by BKE_grease_pencil_point_coords_apply(), BKE_grease_pencil_point_coords_apply_with_mat4(), blender::ed::transform::curves::calculate_aligned_handles(), blender::geometry::convert_curves_to_bezier(), blender::ed::curves::create_Bezier(), blender::nodes::node_geo_curve_primitive_bezier_segment_cc::create_bezier_segment_curve(), blender::bke::curve_legacy_to_curves(), blender::geometry::fill_bezier_data(), blender::geometry::fillet_curves(), blender::ed::curves::get_curves_positions_for_write(), blender::ed::greasepencil::grease_pencil_reproject_exec(), blender::ed::greasepencil::grease_pencil_snap_to_grid_exec(), blender::bke::greasepencil::convert::legacy_gpencil_frame_to_grease_pencil_drawing(), blender::io::usd::USDBasisCurvesReader::read_curve_sample(), blender::io::alembic::AbcCurveReader::read_curves_sample(), blender::nodes::node_geo_set_curve_handles_cc::set_position_in_component(), blender::io::grease_pencil::shape_attributes_to_curves(), blender::geometry::subdivide_curves(), blender::bke::tests::TEST(), blender::bke::tests::TEST(), blender::geometry::trim_bezier_curves(), and blender::bke::curves::bezier::write_all_positions().

◆ handle_positions_right()

Span< float3 > CurvesGeometry::handle_positions_right ( ) const

Definition at line 482 of file curves_geometry.cc.

References blender::bke::ATTR_HANDLE_POSITION_RIGHT, and get_span_attribute().

Referenced by BKE_grease_pencil_point_coords_get(), blender::geometry::convert_curves_to_bezier(), blender::geometry::convert_curves_to_catmull_rom_or_poly(), blender::geometry::convert_curves_to_nurbs(), blender::draw::create_edit_points_position(), blender::ed::transform::curves::curve_populate_trans_data_structs(), blender::io::alembic::ABCCurveWriter::do_write(), blender::geometry::fillet_curves(), blender::ed::curves::get_curves_positions(), blender::ed::curves::get_selection_attribute_positions(), blender::draw::grease_pencil_edit_batch_ensure(), blender::ed::curves::init_selectable_foreach(), blender::io::usd::populate_curve_props_for_bezier(), blender::bke::curves::bezier::retrieve_all_positions(), blender::ed::greasepencil::retrieve_visible_bezier_handle_points(), blender::geometry::subdivide_curves(), and blender::geometry::trim_bezier_curves().

◆ handle_positions_right_for_write()

MutableSpan< float3 > CurvesGeometry::handle_positions_right_for_write ( )

Definition at line 486 of file curves_geometry.cc.

References blender::bke::ATTR_HANDLE_POSITION_RIGHT, and get_mutable_attribute().

Referenced by BKE_grease_pencil_point_coords_apply(), BKE_grease_pencil_point_coords_apply_with_mat4(), blender::ed::transform::curves::calculate_aligned_handles(), blender::geometry::convert_curves_to_bezier(), blender::ed::curves::create_Bezier(), blender::nodes::node_geo_curve_primitive_bezier_segment_cc::create_bezier_segment_curve(), blender::bke::curve_legacy_to_curves(), blender::geometry::fill_bezier_data(), blender::geometry::fillet_curves(), blender::ed::curves::get_curves_positions_for_write(), blender::ed::greasepencil::grease_pencil_reproject_exec(), blender::ed::greasepencil::grease_pencil_snap_to_grid_exec(), blender::bke::greasepencil::convert::legacy_gpencil_frame_to_grease_pencil_drawing(), blender::io::usd::USDBasisCurvesReader::read_curve_sample(), blender::io::alembic::AbcCurveReader::read_curves_sample(), blender::nodes::node_geo_set_curve_handles_cc::set_position_in_component(), blender::io::grease_pencil::shape_attributes_to_curves(), blender::geometry::subdivide_curves(), blender::bke::tests::TEST(), blender::bke::tests::TEST(), blender::geometry::trim_bezier_curves(), and blender::bke::curves::bezier::write_all_positions().

◆ handle_types_left()

VArray< int8_t > CurvesGeometry::handle_types_left ( ) const

Handle types for Bezier control points. Call tag_topology_changed after changes.

Definition at line 455 of file curves_geometry.cc.

References blender::bke::ATTR_HANDLE_TYPE_LEFT, and get_varray_attribute().

Referenced by blender::bke::calculate_evaluated_offsets(), blender::geometry::convert_curves_to_bezier(), blender::ed::transform::curves::create_aligned_handles_masks(), blender::draw::create_edit_points_data(), blender::geometry::fillet_curves(), blender::nodes::node_geo_curve_handle_type_selection_cc::select_by_handle_type(), blender::geometry::subdivide_curves(), blender::geometry::trim_bezier_curves(), and blender::bke::write_sharp_bezier_edges().

◆ handle_types_left_for_write()

MutableSpan< int8_t > CurvesGeometry::handle_types_left_for_write ( )

Definition at line 459 of file curves_geometry.cc.

References blender::bke::ATTR_HANDLE_TYPE_LEFT, and get_mutable_attribute().

Referenced by blender::geometry::convert_curves_to_bezier(), blender::ed::curves::create_Bezier(), blender::nodes::node_geo_curve_primitive_bezier_segment_cc::create_bezier_segment_curve(), blender::ed::transform::curves::createTransCurvesVerts(), blender::ed::transform::greasepencil::createTransGreasePencilVerts(), blender::bke::curve_legacy_to_curves(), blender::ed::curves::set_handle_type::exec(), blender::geometry::fill_bezier_data(), blender::geometry::fillet_curves(), blender::ed::greasepencil::grease_pencil_set_handle_type_exec(), blender::io::usd::USDBasisCurvesReader::read_curve_sample(), blender::io::alembic::AbcCurveReader::read_curves_sample(), blender::nodes::node_geo_curve_set_handle_type_cc::set_handle_type(), blender::nodes::node_geo_set_curve_handles_cc::set_position_in_component(), blender::io::grease_pencil::shape_attributes_to_curves(), blender::geometry::subdivide_curves(), and blender::geometry::trim_bezier_curves().

◆ handle_types_right()

VArray< int8_t > CurvesGeometry::handle_types_right ( ) const

Definition at line 464 of file curves_geometry.cc.

References blender::bke::ATTR_HANDLE_TYPE_RIGHT, and get_varray_attribute().

Referenced by blender::bke::calculate_evaluated_offsets(), blender::geometry::convert_curves_to_bezier(), blender::ed::transform::curves::create_aligned_handles_masks(), blender::draw::create_edit_points_data(), blender::geometry::fillet_curves(), blender::nodes::node_geo_curve_handle_type_selection_cc::select_by_handle_type(), blender::geometry::subdivide_curves(), blender::geometry::trim_bezier_curves(), and blender::bke::write_sharp_bezier_edges().

◆ handle_types_right_for_write()

MutableSpan< int8_t > CurvesGeometry::handle_types_right_for_write ( )

Definition at line 468 of file curves_geometry.cc.

References blender::bke::ATTR_HANDLE_TYPE_RIGHT, and get_mutable_attribute().

Referenced by blender::geometry::convert_curves_to_bezier(), blender::ed::curves::create_Bezier(), blender::nodes::node_geo_curve_primitive_bezier_segment_cc::create_bezier_segment_curve(), blender::ed::transform::curves::createTransCurvesVerts(), blender::ed::transform::greasepencil::createTransGreasePencilVerts(), blender::bke::curve_legacy_to_curves(), blender::ed::curves::set_handle_type::exec(), blender::geometry::fill_bezier_data(), blender::geometry::fillet_curves(), blender::ed::greasepencil::grease_pencil_set_handle_type_exec(), blender::io::usd::USDBasisCurvesReader::read_curve_sample(), blender::io::alembic::AbcCurveReader::read_curves_sample(), blender::nodes::node_geo_curve_set_handle_type_cc::set_handle_type(), blender::nodes::node_geo_set_curve_handles_cc::set_position_in_component(), blender::io::grease_pencil::shape_attributes_to_curves(), blender::geometry::subdivide_curves(), and blender::geometry::trim_bezier_curves().

◆ has_curve_with_type() [1/2]

bool CurvesGeometry::has_curve_with_type ( CurveType type ) const

inline

Definition at line 996 of file BKE_curves.hh.

References curve_type_counts().

Referenced by BKE_grease_pencil_has_curve_with_type(), BKE_grease_pencil_point_coords_apply(), BKE_grease_pencil_point_coords_apply_with_mat4(), BKE_grease_pencil_point_coords_get(), blender::bke::calculate_evaluated_offsets(), blender::geometry::convert_curves_to_bezier(), blender::geometry::convert_curves_to_catmull_rom_or_poly(), blender::ed::object::data_xform_by_mat4(), blender::ed::object::data_xform_create_ex(), blender::ed::object::data_xform_restore(), blender::io::grease_pencil::SVGExporter::export_grease_pencil_objects(), blender::geometry::fill_bezier_data(), blender::geometry::fill_nurbs_data(), blender::geometry::fillet_curves(), blender::ed::curves::get_curves_positions(), blender::ed::curves::get_curves_positions_for_write(), blender::ed::curves::get_curves_selection_attribute_names(), blender::draw::grease_pencil_get_visible_non_nurbs_curves(), blender::draw::grease_pencil_get_visible_nurbs_curves(), blender::draw::grease_pencil_get_visible_nurbs_points(), blender::ed::greasepencil::grease_pencil_set_handle_type_exec(), blender::modify_curves(), blender::bke::curves::bezier::retrieve_all_positions(), blender::ed::greasepencil::retrieve_visible_bezier_handle_points(), blender::geometry::smooth_curve_positions(), blender::geometry::trim_curves(), blender::bke::curves::bezier::write_all_positions(), and blender::bke::write_sharp_bezier_edges().

◆ has_curve_with_type() [2/2]

bool CurvesGeometry::has_curve_with_type ( Span< CurveType > types ) const

inline

Definition at line 1001 of file BKE_curves.hh.

References types.

◆ indices_for_curve_type() [1/2]

IndexMask CurvesGeometry::indices_for_curve_type	(	CurveType	type,
		const IndexMask &	selection,
		IndexMaskMemory &	memory ) const

Definition at line 726 of file curves_geometry.cc.

◆ indices_for_curve_type() [2/2]

IndexMask CurvesGeometry::indices_for_curve_type	(	CurveType	type,
		IndexMaskMemory &	memory ) const

All of the curve indices for curves with a specific type.

Definition at line 720 of file curves_geometry.cc.

Referenced by blender::ed::greasepencil::convert_to_bezier(), blender::ed::greasepencil::convert_to_catmull_rom(), blender::ed::greasepencil::convert_to_nurbs(), blender::ed::greasepencil::convert_to_poly(), blender::modifier::greasepencil::ensure_no_bezier_curves(), blender::io::grease_pencil::SVGExporter::export_grease_pencil_objects(), blender::ed::greasepencil::grease_pencil_set_handle_type_exec(), blender::ed::curves::init_selectable_foreach(), and blender::geometry::smooth_curve_positions().

◆ interpolate_to_evaluated() [1/2]

void CurvesGeometry::interpolate_to_evaluated	(	GSpan	src,
		GMutableSpan	dst ) const

Evaluate generic data for curve control points to the standard evaluated points of the curves.

Definition at line 1106 of file curves_geometry.cc.

References blender::bke::evaluate_generic_data_for_curve(), blender::bke::CurvesGeometryRuntime::evaluated_offsets_cache, blender::bke::CurvesGeometryRuntime::nurbs_basis_cache, blender::threading::parallel_for(), blender::GMutableSpan::slice(), and blender::GSpan::slice().

◆ interpolate_to_evaluated() [2/2]

void CurvesGeometry::interpolate_to_evaluated	(	int	curve_index,
		GSpan	src,
		GMutableSpan	dst ) const

Evaluate a generic data to the standard evaluated points of a specific curve, defined by the resolution attribute or other factors, depending on the curve type.

Warning: This function expects offsets to the evaluated points for each curve to be calculated. That can be ensured with ensure_can_interpolate_to_evaluated.

Definition at line 1086 of file curves_geometry.cc.

References BLI_assert, blender::bke::evaluate_generic_data_for_curve(), blender::bke::CurvesGeometryRuntime::evaluated_offsets_cache, blender::bke::CurvesGeometryRuntime::nurbs_basis_cache, blender::GMutableSpan::size(), blender::GSpan::size(), and this.

Referenced by blender::draw::attribute_interpolate(), blender::draw::curve_create_attribute(), blender::bke::evaluate_attribute(), blender::draw::grease_pencil_edit_batch_ensure(), blender::geometry::resample_to_evaluated(), blender::geometry::resample_to_uniform(), blender::geometry::sample_curve_attribute(), and blender::bke::tests::TEST().

◆ is_empty()

bool CurvesGeometry::is_empty ( ) const

inline

Return true if there are no curves in the geometry.

Definition at line 976 of file BKE_curves.hh.

References BLI_assert, CurvesGeometry::curve_num, and CurvesGeometry::point_num.

◆ is_single_type()

bool CurvesGeometry::is_single_type ( CurveType type ) const

inline

Return true if all of the curves have the provided type.

Definition at line 991 of file BKE_curves.hh.

References curve_type_counts(), and curves_num().

Referenced by blender::draw::attribute_interpolate(), blender::nodes::node_geo_input_tangent_cc::construct_curve_tangent_gvarray(), blender::ed::greasepencil::convert_to_bezier(), blender::ed::greasepencil::convert_to_catmull_rom(), blender::ed::greasepencil::convert_to_nurbs(), blender::ed::greasepencil::convert_to_poly(), blender::bke::curve_normals_varray(), blender::bke::evaluate_attribute(), blender::draw::grease_pencil_edit_batch_ensure(), blender::ed::greasepencil::grease_pencil_set_curve_resolution_exec(), and blender::nodes::node_geo_curve_spline_type_cc::node_geo_exec().

◆ material_index_max()

std::optional< int > CurvesGeometry::material_index_max ( ) const

Get the largest material index used by the geometry or nullopt if there are none. The returned value is clamped between 0 and MAXMAT even if the stored material indices may be out of that range.

Definition at line 1349 of file curves_geometry.cc.

References blender::bke::Curve, blender::SharedCache< T >::data(), blender::SharedCache< T >::ensure(), blender::bounds::max(), blender::bke::CurvesGeometryRuntime::max_material_index_cache, and MAXMAT.

◆ normal_mode()

VArray< int8_t > CurvesGeometry::normal_mode ( ) const

Which method to use for calculating the normals of evaluated points (NormalMode). Call tag_normals_changed after changes.

Definition at line 437 of file curves_geometry.cc.

References blender::bke::ATTR_NORMAL_MODE, and get_varray_attribute().

Referenced by blender::bke::curve_normal_point_domain().

◆ normal_mode_for_write()

MutableSpan< int8_t > CurvesGeometry::normal_mode_for_write ( )

Definition at line 441 of file curves_geometry.cc.

References blender::bke::ATTR_NORMAL_MODE, and get_mutable_attribute().

Referenced by blender::bke::curve_legacy_to_curves(), and blender::nodes::node_geo_set_curve_normal_cc::set_curve_normal().

◆ nurbs_custom_knot_curves()

IndexMask CurvesGeometry::nurbs_custom_knot_curves ( IndexMaskMemory & memory ) const

Builds mask of NURBS curves with knot mode NURBS_KNOT_MODE_CUSTOM.

Definition at line 546 of file curves_geometry.cc.

References curve, CURVE_TYPE_NURBS, blender::index_mask::IndexMask::from_predicate(), and NURBS_KNOT_MODE_CUSTOM.

Referenced by blender::bke::copy_curve_selection_custom_knots(), blender::bke::curves::nurbs::copy_custom_knots(), blender::bke::copy_point_selection_custom_knots(), and blender::ed::curves::extrude_knots().

◆ nurbs_custom_knots()

Span< float > CurvesGeometry::nurbs_custom_knots ( ) const

Custom knots for NURBS curves with knots mode NURBS_KNOT_MODE_CUSTOM.

Definition at line 528 of file curves_geometry.cc.

Referenced by blender::ed::curves::append_point_knots(), blender::bke::copy_curve_selection_custom_knots(), blender::bke::copy_point_selection_custom_knots(), blender::ed::curves::extrude_knots(), blender::bke::curves::nurbs::gather_custom_knots(), and blender::io::usd::populate_curve_props_for_nurbs().

◆ nurbs_custom_knots_by_curve()

OffsetIndices< int > CurvesGeometry::nurbs_custom_knots_by_curve ( ) const

The offsets of every curve into arrays on #CurvesGeometry::nurbs_custom_knots. Curves with knot mode other than NURBS_KNOT_MODE_CUSTOM will have zero sized #IndexRange.

Definition at line 557 of file curves_geometry.cc.

References curve, blender::bke::CurvesGeometryRuntime::custom_knot_offsets_cache, NURBS_KNOT_MODE_CUSTOM, blender::Vector< T, InlineBufferCapacity, Allocator >::resize(), and blender::offset_indices::OffsetIndices< T >::size().

Referenced by blender::ed::curves::append_point_knots(), blender::bke::copy_curve_selection_custom_knots(), blender::bke::copy_point_selection_custom_knots(), blender::bke::curve_legacy_to_curves(), blender::geometry::execute_realize_curve_task(), blender::ed::curves::extrude_knots(), blender::bke::curves::nurbs::gather_custom_knots(), and blender::io::usd::populate_curve_props_for_nurbs().

◆ nurbs_custom_knots_for_write()

MutableSpan< float > CurvesGeometry::nurbs_custom_knots_for_write ( )

Definition at line 536 of file curves_geometry.cc.

References blender::implicit_sharing::make_trivial_data_mutable(), and this.

Referenced by blender::ed::curves::append_point_knots(), blender::bke::copy_curve_selection_custom_knots(), blender::bke::copy_point_selection_custom_knots(), blender::bke::curve_legacy_to_curves(), blender::ed::curves::extrude_knots(), and blender::bke::curves::nurbs::gather_custom_knots().

◆ nurbs_custom_knots_resize()

void CurvesGeometry::nurbs_custom_knots_resize ( int knots_num )

Resizes custom knots array. Used when knots number is known in advance and knot values are set together with topological data.

Definition at line 595 of file curves_geometry.cc.

References blender::implicit_sharing::resize_trivial_array(), and this.

Referenced by blender::geometry::execute_realize_curve_tasks().

◆ nurbs_custom_knots_update_size()

void CurvesGeometry::nurbs_custom_knots_update_size ( )

Resizes custom knots array depending on topological data. Depends on curve offsets, knot modes, orders and cyclic data. Used to resize internal knots array before writing knots.

Definition at line 581 of file curves_geometry.cc.

References blender::implicit_sharing::resize_trivial_array(), this, and blender::offset_indices::OffsetIndices< T >::total_size().

Referenced by blender::ed::curves::append_curve_knots(), blender::ed::curves::append_point_knots(), blender::geometry::copy_and_reorder_curves(), blender::bke::copy_curve_selection_custom_knots(), blender::bke::copy_point_selection_custom_knots(), blender::bke::curve_legacy_to_curves(), blender::ed::curves::extrude_knots(), and blender::bke::curves::nurbs::update_custom_knot_modes().

◆ nurbs_has_custom_knots()

bool CurvesGeometry::nurbs_has_custom_knots ( ) const

inline

Definition at line 972 of file BKE_curves.hh.

References CurvesGeometry::custom_knot_num.

Referenced by blender::geometry::copy_and_reorder_curves(), blender::bke::curves::nurbs::copy_custom_knots(), blender::ed::curves::copy_data_to_geometry(), blender::bke::curve_legacy_to_curves(), blender::bke::curves_copy_curve_selection(), blender::geometry::curves_merge_endpoints(), blender::ed::curves::duplicate_curves(), blender::ed::curves::duplicate_points(), blender::ed::greasepencil::extrude_grease_pencil_curves(), blender::geometry::fillet_curves(), blender::geometry::remove_points_and_split(), blender::ed::curves::resize_curves(), and blender::geometry::trim_curves().

◆ nurbs_knots_modes()

VArray< int8_t > CurvesGeometry::nurbs_knots_modes ( ) const

The automatic generation mode for each NURBS curve's knots vector, on the curve domain. Call tag_topology_changed after changes.

Definition at line 509 of file curves_geometry.cc.

References blender::bke::ATTR_NURBS_KNOTS_MODE, and get_varray_attribute().

Referenced by blender::ed::curves::append_point_knots(), blender::bke::calculate_evaluated_offsets(), blender::geometry::convert_curves_to_bezier(), blender::ed::greasepencil::extrude_grease_pencil_curves(), and blender::io::usd::populate_curve_props_for_nurbs().

◆ nurbs_knots_modes_for_write()

MutableSpan< int8_t > CurvesGeometry::nurbs_knots_modes_for_write ( )

Definition at line 513 of file curves_geometry.cc.

References blender::bke::ATTR_NURBS_KNOTS_MODE, and get_mutable_attribute().

Referenced by blender::geometry::convert_curves_to_nurbs(), blender::bke::curve_legacy_to_curves(), blender::ed::curves::curves_draw_exec(), blender::io::alembic::AbcCurveReader::read_curves_sample(), and blender::bke::curves::nurbs::update_custom_knot_modes().

◆ nurbs_orders()

VArray< int8_t > CurvesGeometry::nurbs_orders ( ) const

The order (degree plus one) of each NURBS curve, on the curve domain. Call tag_topology_changed after changes.

Definition at line 491 of file curves_geometry.cc.

References blender::bke::ATTR_NURBS_ORDER, and get_varray_attribute().

Referenced by blender::ed::curves::append_point_knots(), blender::bke::calculate_evaluated_offsets(), blender::bke::copy_point_selection_custom_knots(), blender::io::alembic::ABCCurveWriter::do_write(), blender::ed::curves::extrude_knots(), and blender::io::usd::populate_curve_props_for_nurbs().

◆ nurbs_orders_for_write()

MutableSpan< int8_t > CurvesGeometry::nurbs_orders_for_write ( )

Definition at line 495 of file curves_geometry.cc.

References blender::bke::ATTR_NURBS_ORDER, and get_mutable_attribute().

Referenced by blender::geometry::convert_curves_to_nurbs(), blender::ed::curves::tests::create_curves(), blender::bke::curve_legacy_to_curves(), blender::ed::curves::curves_draw_exec(), blender::io::usd::USDBasisCurvesReader::read_curve_sample(), and blender::io::alembic::AbcCurveReader::read_curves_sample().

◆ nurbs_weights()

Span< float > CurvesGeometry::nurbs_weights ( ) const

The weight for each control point for NURBS curves. Call tag_positions_changed after changes.

Definition at line 500 of file curves_geometry.cc.

References blender::bke::ATTR_NURBS_WEIGHT, and get_span_attribute().

Referenced by blender::geometry::convert_curves_to_nurbs(), and blender::io::alembic::ABCCurveWriter::do_write().

◆ nurbs_weights_for_write()

MutableSpan< float > CurvesGeometry::nurbs_weights_for_write ( )

Definition at line 504 of file curves_geometry.cc.

References blender::bke::ATTR_NURBS_WEIGHT, and get_mutable_attribute().

Referenced by blender::geometry::convert_curves_to_nurbs(), blender::ed::curves::create_NURBS(), blender::bke::curve_legacy_to_curves(), blender::geometry::fill_nurbs_data(), blender::io::alembic::AbcCurveReader::read_curves_sample(), and blender::bke::tests::TEST().

◆ offsets()

Span< int > CurvesGeometry::offsets ( ) const

The index of the first point in every curve. The size of this span is one larger than the number of curves, but the spans will be empty if there are no curves/points.

Consider using points_by_curve rather than these offsets directly.

Definition at line 402 of file curves_geometry.cc.

◆ offsets_for_write()

MutableSpan< int > CurvesGeometry::offsets_for_write ( )

Definition at line 409 of file curves_geometry.cc.

References blender::implicit_sharing::make_trivial_data_mutable(), and this.

◆ operator=() [1/2]

CurvesGeometry & CurvesGeometry::operator= ( const CurvesGeometry & other )

Definition at line 150 of file curves_geometry.cc.

References CurvesGeometry().

◆ operator=() [2/2]

CurvesGeometry & CurvesGeometry::operator= ( CurvesGeometry && other )

Definition at line 199 of file curves_geometry.cc.

References CurvesGeometry().

◆ point_to_curve_map()

Array< int > CurvesGeometry::point_to_curve_map ( ) const

Definition at line 734 of file curves_geometry.cc.

References blender::offset_indices::build_reverse_map().

Referenced by blender::ed::transform::curves::curve_populate_trans_data_structs(), blender::bke::curves_copy_point_selection(), blender::nodes::node_geo_duplicate_elements_cc::duplicate_points_CurvesGeometry(), blender::geometry::extract_curves_points(), blender::geometry::extract_greasepencil_layer_points(), blender::nodes::node_geo_offset_point_in_curve_cc::ControlPointNeighborFieldInput::get_varray_for_context(), blender::nodes::node_geo_offset_point_in_curve_cc::OffsetValidFieldInput::get_varray_for_context(), blender::draw::grease_pencil_get_visible_nurbs_points(), blender::ed::greasepencil::grease_pencil_stroke_simplify_exec(), blender::ed::greasepencil::retrieve_visible_bezier_handle_points(), blender::simplify_drawing(), blender::ed::greasepencil::simplify_fixed(), blender::ed::sculpt_paint::simplify_fixed(), and blender::simplify_fixed().

◆ points_by_curve()

OffsetIndices< int > CurvesGeometry::points_by_curve ( ) const

inline

The offsets of every curve into arrays on the points domain.

Definition at line 1021 of file BKE_curves.hh.

References CurvesGeometry::curve_num, and CurvesGeometry::curve_offsets.

◆ points_num()

int CurvesGeometry::points_num ( ) const

inline

The total number of control points in all curves.

Definition at line 964 of file BKE_curves.hh.

References CurvesGeometry::point_num.

◆ points_range()

IndexRange CurvesGeometry::points_range ( ) const

inline

Definition at line 982 of file BKE_curves.hh.

References points_num().

◆ positions()

Span< float3 > CurvesGeometry::positions ( ) const

Definition at line 384 of file curves_geometry.cc.

References ATTR_POSITION, and get_span_attribute().

◆ positions_for_write()

MutableSpan< float3 > CurvesGeometry::positions_for_write ( )

Definition at line 388 of file curves_geometry.cc.

References ATTR_POSITION, and get_mutable_attribute().

◆ radius()

VArray< float > CurvesGeometry::radius ( ) const

Definition at line 393 of file curves_geometry.cc.

References blender::bke::ATTR_RADIUS, and get_varray_attribute().

Referenced by blender::ed::object::data_xform_create_ex(), blender::io::alembic::ABCCurveWriter::do_write(), and blender::io::usd::populate_curve_widths().

◆ radius_for_write()

MutableSpan< float > CurvesGeometry::radius_for_write ( )

Definition at line 397 of file curves_geometry.cc.

References blender::bke::ATTR_RADIUS, and get_mutable_attribute().

Referenced by blender::geometry::calc_radius_without_interpolation(), blender::ed::object::data_xform_by_mat4(), blender::ed::object::data_xform_restore(), blender::ed::greasepencil::grease_pencil_reproject_exec(), blender::io::usd::USDBasisCurvesReader::read_curve_sample(), and blender::io::alembic::AbcCurveReader::read_curves_sample().

◆ remove_attributes_based_on_types()

void CurvesGeometry::remove_attributes_based_on_types ( )

Remove any attributes that are unused based on the types in the curves.

Definition at line 1687 of file curves_geometry.cc.

References blender::bke::ATTR_HANDLE_POSITION_LEFT, blender::bke::ATTR_HANDLE_POSITION_RIGHT, blender::bke::ATTR_HANDLE_TYPE_LEFT, blender::bke::ATTR_HANDLE_TYPE_RIGHT, blender::bke::ATTR_NURBS_KNOTS_MODE, blender::bke::ATTR_NURBS_ORDER, blender::bke::ATTR_NURBS_WEIGHT, blender::bke::ATTR_RESOLUTION, CURVE_TYPE_BEZIER, CURVE_TYPE_CATMULL_ROM, CURVE_TYPE_NURBS, and blender::bke::MutableAttributeAccessor::remove().

Referenced by blender::geometry::convert_curves_trivial(), blender::bke::curves_copy_curve_selection(), blender::geometry::remove_points_and_split(), and blender::geometry::trim_curves().

◆ remove_curves()

void CurvesGeometry::remove_curves	(	const IndexMask &	curves_to_delete,
		const AttributeFilter &	attribute_filter )

Definition at line 1566 of file curves_geometry.cc.

References blender::index_mask::IndexMask::complement(), blender::bke::curves_copy_curve_selection(), blender::index_mask::IndexMask::is_empty(), blender::index_mask::IndexMask::size(), and this.

Referenced by blender::nodes::node_geo_curves_to_grease_pencil_cc::curves_to_grease_pencil_with_one_layer(), blender::deform_drawing(), blender::ed::greasepencil::grease_pencil_clean_loose_exec(), blender::ed::greasepencil::grease_pencil_delete_exec(), blender::ed::greasepencil::grease_pencil_move_to_layer_exec(), blender::ed::greasepencil::grease_pencil_primitive_undo_curves(), blender::ed::greasepencil::grease_pencil_separate_layer(), blender::ed::greasepencil::grease_pencil_separate_material(), blender::ed::sculpt_paint::greasepencil::outline_stroke(), blender::ed::greasepencil::remove_fill_guides(), blender::ed::curves::remove_selection(), and blender::ed::sculpt_paint::greasepencil::trim_stroke_ends().

◆ remove_points()

void CurvesGeometry::remove_points	(	const IndexMask &	points_to_delete,
		const AttributeFilter &	attribute_filter )

Definition at line 1486 of file curves_geometry.cc.

References blender::index_mask::IndexMask::complement(), blender::bke::curves_copy_point_selection(), blender::index_mask::IndexMask::is_empty(), blender::index_mask::IndexMask::size(), and this.

Referenced by blender::ed::greasepencil::convert_to_catmull_rom(), blender::ed::greasepencil::grease_pencil_dissolve_exec(), blender::ed::curves::remove_selection(), blender::simplify_drawing(), blender::ed::sculpt_paint::greasepencil::simplify_opacities(), and blender::ed::sculpt_paint::greasepencil::simplify_stroke().

◆ resize()

void CurvesGeometry::resize	(	int	points_num,
		int	curves_num )

Change the number of curves and/or points.

Warning: To avoid redundant writes, newly created attribute values are not initialized. They must be initialized by the caller afterwards.

Definition at line 1171 of file curves_geometry.cc.

References BLI_assert, blender::bke::CurvesGeometryRuntime::curve_offsets_sharing_info, CustomData_realloc(), blender::implicit_sharing::resize_trivial_array(), and this.

◆ resolution()

VArray< int > CurvesGeometry::resolution ( ) const

How many evaluated points to create for each segment when evaluating Bezier, Catmull Rom, and NURBS curves. On the curve domain. Values must be one or greater.

Definition at line 428 of file curves_geometry.cc.

References blender::bke::ATTR_RESOLUTION, and get_varray_attribute().

Referenced by blender::bke::calculate_evaluated_offsets(), blender::nodes::node_geo_curve_spline_parameter_cc::calculate_point_lengths(), blender::geometry::compute_curve_trim_parameters(), blender::io::alembic::ABCCurveWriter::create_alembic_objects(), blender::bke::curve_normal_point_domain(), and blender::nodes::node_geo_input_tangent_cc::curve_tangent_point_domain().