blender::bke::greasepencil Namespace Reference

Namespaces
namespace	convert
namespace	tests

Classes
class	Drawing
class	DrawingReference
class	DrawingRuntime
class	Layer
class	LayerGroup
class	LayerGroupRuntime
class	LayerMask
class	LayerRuntime
struct	LayerTransformData
class	TreeNode

Typedefs
using	FramesMapKeyT = int

Functions
void	copy_drawing_array (Span< const GreasePencilDrawingBase * > src_drawings, MutableSpan< GreasePencilDrawingBase * > dst_drawings)
	TREENODE_COMMON_METHODS_FORWARD_IMPL (Layer)
	TREENODE_COMMON_METHODS_FORWARD_IMPL (LayerGroup)
const AttributeAccessorFunctions &	get_attribute_accessor_functions ()
void	ensure_non_empty_layer_names (Main &bmain, GreasePencil &grease_pencil)
static int	domain_num (const CurvesGeometry &curves, const AttrDomain domain)
static CustomData &	domain_custom_data (CurvesGeometry &curves, const AttrDomain domain)
template<typename T >
static MutableSpan< T >	get_mutable_attribute (CurvesGeometry &curves, const AttrDomain domain, const StringRef name, const T default_value=T())
static void	update_triangle_cache (const Span< float3 > positions, const Span< float3 > normals, const OffsetIndices< int > points_by_curve, const OffsetIndices< int > triangle_offsets, const IndexMask &curve_mask, MutableSpan< int3 > triangles)
static void	update_curve_plane_normal_cache (const Span< float3 > positions, const OffsetIndices< int > points_by_curve, const IndexMask &curve_mask, MutableSpan< float3 > normals)
static float4x2	get_local_to_stroke_matrix (const Span< float3 > positions, const float3 normal)
static float3x2	get_stroke_to_texture_matrix (const float uv_rotation, const float2 uv_translation, const float2 uv_scale)
static float4x3	expand_4x2_mat (float4x2 strokemat)
Vertex groups in drawings
void	validate_drawing_vertex_groups (GreasePencil &grease_pencil)
int	ensure_vertex_group (StringRef name, ListBase &vertex_group_names)
void	assign_to_vertex_group (Drawing &drawing, StringRef name, float weight)
void	assign_to_vertex_group_from_mask (CurvesGeometry &curves, const IndexMask &mask, StringRef name, float weight)
bool	remove_from_vertex_group (Drawing &drawing, StringRef name, bool use_selection)
void	clear_vertex_groups (GreasePencil &grease_pencil)

Variables
constexpr float	LEGACY_RADIUS_CONVERSION_FACTOR = 1.0f / 2000.0f
constexpr StringRef	ATTR_RADIUS = "radius"
constexpr StringRef	ATTR_OPACITY = "opacity"
constexpr StringRef	ATTR_VERTEX_COLOR = "vertex_color"
constexpr StringRef	ATTR_FILL_COLOR = "fill_color"

Typedef Documentation

FramesMapKeyT

using blender::bke::greasepencil::FramesMapKeyT = int

Definition at line 384 of file BKE_grease_pencil.hh.

Function Documentation

assign_to_vertex_group()

void blender::bke::greasepencil::assign_to_vertex_group	(	Drawing &	drawing,
		StringRef	name,
		float	weight )

Assign selected vertices to the vertex group.

Definition at line 98 of file grease_pencil_vertex_groups.cc.

References blender::bke::CurvesGeometry::attributes(), BKE_defgroup_name_index(), BKE_defvert_ensure_index(), BLI_addtail(), BLI_assert, BLI_listbase_count(), blender::bke::CurvesGeometry::deform_verts_for_write(), blender::MutableSpan< T >::index_range(), blender::bke::AttributeAccessor::lookup_or_default(), MEM_callocN(), bDeformGroup::name, name, blender::bke::Point, blender::bke::greasepencil::Drawing::strokes_for_write(), CurvesGeometry::vertex_group_names, and MDeformWeight::weight.

assign_to_vertex_group_from_mask()

void blender::bke::greasepencil::assign_to_vertex_group_from_mask	(	bke::CurvesGeometry &	curves,
		const IndexMask &	mask,
		StringRef	name,
		float	weight )

Definition at line 68 of file grease_pencil_vertex_groups.cc.

References BKE_defgroup_name_index(), BKE_defvert_ensure_index(), BLI_addtail(), BLI_assert, BLI_listbase_count(), blender::bke::CurvesGeometry::deform_verts_for_write(), mask(), MEM_callocN(), bDeformGroup::name, name, and CurvesGeometry::vertex_group_names.

Referenced by blender::ed::sculpt_paint::greasepencil::process_stroke_weights().

clear_vertex_groups()

void blender::bke::greasepencil::clear_vertex_groups

(

GreasePencil &

grease_pencil

)

Remove vertices from all vertex groups.

Definition at line 159 of file grease_pencil_vertex_groups.cc.

References BKE_defvert_clear(), blender::bke::CurvesGeometry::deform_verts_for_write(), GP_DRAWING, blender::bke::greasepencil::Drawing::strokes_for_write(), and wrap().

Referenced by BKE_object_defgroup_remove_all_ex(), and object_defgroup_remove_common().

copy_drawing_array()

void blender::bke::greasepencil::copy_drawing_array	(	Span< const GreasePencilDrawingBase * >	src_drawings,
		MutableSpan< GreasePencilDrawingBase * >	dst_drawings )

Copies the drawings from one array to another. Assumes that dst_drawings is allocated but not initialized, e.g. it will allocate new drawings and store the pointers.

Examples

/usr/src/RPM/BUILD/blender-4.5.8/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1011 of file grease_pencil.cc.

References BLI_assert, copy_drawing_array(), GP_DRAWING, GP_DRAWING_REFERENCE, blender::Span< T >::index_range(), blender::MutableSpan< T >::size(), blender::Span< T >::size(), and GreasePencilDrawingBase::type.

Referenced by BKE_grease_pencil_duplicate_drawing_array(), and copy_drawing_array().

domain_custom_data()

static CustomData & blender::bke::greasepencil::domain_custom_data ( CurvesGeometry & curves, const AttrDomain domain )

static

Definition at line 378 of file grease_pencil.cc.

References CurvesGeometry::curve_data, blender::bke::Point, and CurvesGeometry::point_data.

Referenced by get_mutable_attribute().

domain_num()

static int blender::bke::greasepencil::domain_num ( const CurvesGeometry & curves, const AttrDomain domain )

static

Definition at line 374 of file grease_pencil.cc.

References blender::bke::CurvesGeometry::curves_num(), blender::bke::Point, and blender::bke::CurvesGeometry::points_num().

Referenced by get_mutable_attribute().

ensure_non_empty_layer_names()

void blender::bke::greasepencil::ensure_non_empty_layer_names	(	Main &	bmain,
		GreasePencil &	grease_pencil )

Renames layers with empty names to "Layer".

Note

While original data should not have layers with empty names, we allow layer names to be empty in evaluated geometry.

Examples

/usr/src/RPM/BUILD/blender-4.5.8/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 1972 of file grease_pencil.cc.

References DATA_.

Referenced by blender::ed::object::apply_grease_pencil_for_modifier(), blender::ed::object::apply_grease_pencil_for_modifier_all_keyframes(), and blender::ed::geometry::store_result_geometry().

ensure_vertex_group()

int blender::bke::greasepencil::ensure_vertex_group	(	StringRef	name,
		ListBase &	vertex_group_names )

Find or create a vertex group in a drawing.

Definition at line 55 of file grease_pencil_vertex_groups.cc.

References BKE_defgroup_name_index(), BLI_addtail(), BLI_assert, BLI_listbase_count(), MEM_callocN(), bDeformGroup::name, and name.

Referenced by blender::write_weights_for_drawing().

expand_4x2_mat()

static float4x3 blender::bke::greasepencil::expand_4x2_mat ( float4x2 strokemat )

static

Definition at line 676 of file grease_pencil.cc.

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

get_attribute_accessor_functions()

const AttributeAccessorFunctions & blender::bke::greasepencil::get_attribute_accessor_functions

(

)

Examples

/usr/src/RPM/BUILD/blender-4.5.8/source/blender/blenkernel/BKE_grease_pencil.hh.

get_local_to_stroke_matrix()

static float4x2 blender::bke::greasepencil::get_local_to_stroke_matrix ( const Span< float3 > positions, const float3 normal )

static

Definition at line 609 of file grease_pencil.cc.

References cross, dot(), blender::MatBase< float, 4, 2 >::identity(), normalize, blender::Span< T >::size(), and transpose.

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

get_mutable_attribute()

template<typename T >

static MutableSpan< T > blender::bke::greasepencil::get_mutable_attribute ( CurvesGeometry & curves, const AttrDomain domain, const StringRef name, const T default_value = T() )

static

Definition at line 383 of file grease_pencil.cc.

References CD_SET_DEFAULT, blender::bke::cpp_type_to_custom_data_type(), CustomData_add_layer_named(), CustomData_get_layer_named_for_write(), data, domain_custom_data(), domain_num(), blender::MutableSpan< T >::fill(), blender::MutableSpan< T >::first(), blender::CPPType::get(), name, and num.

get_stroke_to_texture_matrix()

static float3x2 blender::bke::greasepencil::get_stroke_to_texture_matrix ( const float uv_rotation, const float2 uv_translation, const float2 uv_scale )

static

Definition at line 640 of file grease_pencil.cc.

References cos, blender::MatBase< T, NumCol, NumRow, Alignment >::identity(), rot, and sin.

remove_from_vertex_group()

bool blender::bke::greasepencil::remove_from_vertex_group	(	Drawing &	drawing,
		StringRef	name,
		bool	use_selection )

Remove selected vertices from the vertex group.

Returns

True if at least one vertex was removed from the group.

Definition at line 132 of file grease_pencil_vertex_groups.cc.

References blender::bke::CurvesGeometry::attributes(), BKE_defgroup_name_index(), BKE_defvert_find_index(), BKE_defvert_remove_group(), blender::bke::CurvesGeometry::deform_verts_for_write(), blender::MutableSpan< T >::index_range(), blender::bke::AttributeAccessor::lookup_or_default(), name, blender::bke::Point, blender::bke::greasepencil::Drawing::strokes_for_write(), and CurvesGeometry::vertex_group_names.

TREENODE_COMMON_METHODS_FORWARD_IMPL() [1/2]

blender::bke::greasepencil::TREENODE_COMMON_METHODS_FORWARD_IMPL

(

Layer

)

TREENODE_COMMON_METHODS_FORWARD_IMPL() [2/2]

blender::bke::greasepencil::TREENODE_COMMON_METHODS_FORWARD_IMPL

(

LayerGroup

)

update_curve_plane_normal_cache()

static void blender::bke::greasepencil::update_curve_plane_normal_cache ( const Span< float3 > positions, const OffsetIndices< int > points_by_curve, const IndexMask & curve_mask, MutableSpan< float3 > normals )

static

Definition at line 554 of file grease_pencil.cc.

References add_newell_cross_v3_v3v3(), blender::IndexRange::drop_back(), blender::index_mask::IndexMask::foreach_index(), blender::math::is_zero(), blender::IndexRange::last(), length(), blender::math::length_squared(), blender::math::normalize(), blender::math::normalize_and_get_length(), normals, and blender::IndexRange::size().

Referenced by blender::bke::greasepencil::Drawing::curve_plane_normals(), blender::bke::greasepencil::Drawing::tag_positions_changed(), and blender::bke::greasepencil::Drawing::tag_topology_changed().

update_triangle_cache()

static void blender::bke::greasepencil::update_triangle_cache ( const Span< float3 > positions, const Span< float3 > normals, const OffsetIndices< int > points_by_curve, const OffsetIndices< int > triangle_offsets, const IndexMask & curve_mask, MutableSpan< int3 > triangles )

static

Definition at line 490 of file grease_pencil.cc.

References axis_dominant_v3_to_m3(), BLI_memarena_alloc(), BLI_memarena_clear(), BLI_memarena_free(), BLI_memarena_new(), BLI_MEMARENA_STD_BUFSIZE, BLI_polyfill_calc_arena(), blender::MutableSpan< T >::data(), blender::index_mask::IndexMask::foreach_segment(), blender::threading::EnumerableThreadSpecific< T >::local(), mul_v2_m3v3(), normals, blender::MatBase< T, NumCol, NumRow, Alignment >::ptr(), blender::IndexRange::size(), and blender::MutableSpan< T >::slice().

Referenced by blender::bke::greasepencil::Drawing::tag_positions_changed(), blender::bke::greasepencil::Drawing::tag_topology_changed(), and blender::bke::greasepencil::Drawing::triangles().

validate_drawing_vertex_groups()

void blender::bke::greasepencil::validate_drawing_vertex_groups

(

GreasePencil &

grease_pencil

)

Make sure drawings only contain vertex groups of the GreasePencil.

Definition at line 26 of file grease_pencil_vertex_groups.cc.

References blender::Set< Key, InlineBufferCapacity, ProbingStrategy, Hash, IsEqual, Slot, Allocator >::add_new(), BLI_remlink(), blender::Set< Key, InlineBufferCapacity, ProbingStrategy, Hash, IsEqual, Slot, Allocator >::contains(), blender::bke::CurvesGeometry::deform_verts_for_write(), GP_DRAWING, LISTBASE_FOREACH, LISTBASE_FOREACH_MUTABLE, MEM_SAFE_FREE, blender::bke::remove_defgroup_index(), blender::bke::greasepencil::Drawing::strokes_for_write(), CurvesGeometry::vertex_group_names, GreasePencil::vertex_group_names, and wrap().

Referenced by BKE_object_defgroup_new(), and BKE_object_defgroup_remove().

Variable Documentation

ATTR_FILL_COLOR

StringRef blender::bke::greasepencil::ATTR_FILL_COLOR = "fill_color"

constexpr

Definition at line 371 of file grease_pencil.cc.

Referenced by blender::bke::greasepencil::Drawing::fill_colors(), and blender::bke::greasepencil::Drawing::fill_colors_for_write().

ATTR_OPACITY

StringRef blender::bke::greasepencil::ATTR_OPACITY = "opacity"

constexpr

Definition at line 369 of file grease_pencil.cc.

Referenced by blender::bke::greasepencil::Drawing::opacities(), and blender::bke::greasepencil::Drawing::opacities_for_write().

ATTR_RADIUS

StringRef blender::bke::greasepencil::ATTR_RADIUS = "radius"

constexpr

Definition at line 368 of file grease_pencil.cc.

ATTR_VERTEX_COLOR

StringRef blender::bke::greasepencil::ATTR_VERTEX_COLOR = "vertex_color"

constexpr

Definition at line 370 of file grease_pencil.cc.

Referenced by blender::bke::greasepencil::Drawing::vertex_colors(), and blender::bke::greasepencil::Drawing::vertex_colors_for_write().

LEGACY_RADIUS_CONVERSION_FACTOR

float blender::bke::greasepencil::LEGACY_RADIUS_CONVERSION_FACTOR = 1.0f / 2000.0f

constexpr

Examples

/usr/src/RPM/BUILD/blender-4.5.8/source/blender/blenkernel/BKE_grease_pencil.hh.

Definition at line 49 of file BKE_grease_pencil.hh.

Referenced by blo_do_versions_420(), blo_do_versions_430(), blender::ed::greasepencil::image_render::draw_dots(), blender::ed::greasepencil::image_render::draw_grease_pencil_stroke(), blender::bke::greasepencil::convert::fcurve_convert_thickness_cb(), blender::ed::sculpt_paint::GreasePencilFillOpData::from_context(), blender::ed::sculpt_paint::grease_pencil_apply_fill(), blender::bke::greasepencil::convert::legacy_gpencil_frame_to_grease_pencil_drawing(), blender::bke::greasepencil::convert::legacy_object_modifier_thickness(), blender::bke::greasepencil::convert::lineart_unwrap_v3(), blender::bke::greasepencil::convert::lineart_wrap_v3(), and blender::modify_drawing().