|
Blender V5.0
|
#include <optional>#include <string>#include "BLI_array.hh"#include "BLI_math_matrix_types.hh"#include "BLI_math_vector_types.hh"#include "BLI_span.hh"#include "DNA_key_types.h"Go to the source code of this file.
Definition at line 225 of file key.cc.
References BKE_id_new(), Key::elemsize, Key::elemstr, Key::from, GS, ID_CU_LEGACY, ID_LT, ID_ME, IPO_BPOINT, IPO_FLOAT, KEY_NORMAL, KEYELEM_ELEM_SIZE_CURVE, KEYELEM_FLOAT_LEN_COORD, ID::name, Key::type, and Key::uidgen.
Referenced by ED_mesh_shapes_join_objects_exec(), blender::io::fbx::import_blend_shapes(), blender::io::usd::import_blendshapes(), insert_curvekey(), insert_lattkey(), insert_meshkey(), blender::ed::mesh::join_shape_keys(), and blender::ed::object::modifier_apply_shape().
Definition at line 1611 of file key.cc.
References BKE_key_evaluate_object_ex().
Referenced by BKE_curve_calc_modifiers_pre(), insert_curvekey(), insert_lattkey(), and insert_meshkey().
| float * BKE_key_evaluate_object_ex | ( | Object * | ob, |
| int * | r_totelem, | ||
| float * | arr, | ||
| size_t | arr_size, | ||
| ID * | obdata ) |
Returns key coordinates (+ tilt) when key applied, NULL otherwise.
| obdata | if given, also update that geometry with the result of the shape keys evaluation. |
Definition at line 1488 of file key.cc.
References BKE_key_from_object(), BKE_keyblock_curve_element_count(), BKE_keyblock_from_object(), BLI_assert_unreachable, BLI_findlink(), BLI_listbase_is_empty(), Key::block, cp_cu_key(), cp_key(), Object::data, Lattice::def, do_curve_key(), do_latt_key(), do_mesh_key(), ELEM, ListBase::first, KeyBlock::flag, get_weights_array(), GS, ID_CU_LEGACY, ID_LT, ID_ME, keyblock_data_convert_to_curve(), keyblock_data_convert_to_lattice(), KEYBLOCK_MUTE, KEYELEM_ELEM_SIZE_CURVE, KEYELEM_FLOAT_LEN_COORD, MEM_calloc_arrayN(), MEM_freeN(), min_ii(), ID::name, Curve::nurb, OB_CURVES_LEGACY, OB_LATTICE, OB_MESH, OB_SHAPE_LOCK, OB_SURF, OB_TYPE_SUPPORT_VGROUP, out, Lattice::pntsu, Lattice::pntsv, Lattice::pntsw, Key::refkey, Object::shapeflag, Object::shapenr, size(), Object::type, Mesh::verts_num, and KeyBlock::vgroup.
Referenced by BKE_key_evaluate_object(), deform_verts(), and blender::ed::object::shape_key_remove_exec().
| void BKE_key_free_nolib | ( | Key * | key | ) |
Definition at line 215 of file key.cc.
References BLI_pophead(), Key::block, and MEM_freeN().
Definition at line 1771 of file key.cc.
References BKE_key_from_id_p().
Referenced by BKE_blendfile_library_relocate(), BKE_id_copy_for_duplicate(), BKE_id_newptr_and_tag_clear(), BKE_lib_id_clear_library_data(), BKE_lib_id_make_local_generic(), BKE_lib_override_library_create_from_id(), BKE_lib_override_library_create_from_tag(), BKE_lib_override_library_main_operations_create(), BKE_lib_override_library_make_local(), BKE_lib_override_library_update(), blendfile_library_relocate_id_remap_prepare(), blendfile_relocate_postprocess_cleanup(), BLO_main_validate_shapekeys(), blender::deg::DepsgraphNodeBuilder::build_object_data_geometry_datablock(), blender::deg::DepsgraphRelationBuilder::build_object_data_geometry_datablock(), blender::animrig::find_related_ids(), id_delete(), id_free(), lib_override_library_create_from(), lib_override_library_resync(), lib_override_prefill_newid_from_existing_overrides(), lib_override_remapper_overrides_add(), pack_linked_id(), and shapekey_owner_pointer_get().
Definition at line 1746 of file key.cc.
References GS, ID_CU_LEGACY, ID_LT, ID_ME, Curve::key, Lattice::key, Mesh::key, ID::name, OB_FONT, and Curve::ob_type.
Referenced by BKE_id_copy_for_use_in_bmain(), BKE_key_from_id(), BKE_key_from_object_p(), BKE_lib_override_library_update(), blendfile_library_relocate_id_remap_finalize(), blendfile_library_relocate_id_remap_prepare(), and lib_override_library_resync().
Definition at line 1791 of file key.cc.
References BKE_key_from_object_p().
Referenced by actedit_get_shapekeys(), action_new_poll(), ANIM_active_action_from_area(), animdata_filter_dopesheet_ob(), BKE_key_evaluate_object_ex(), BKE_keyblock_from_object(), BKE_keyblock_from_object_reference(), BKE_keyblock_move(), BKE_modifiers_get_virtual_modifierlist(), BKE_object_is_deform_modified(), BKE_object_is_modified(), BKE_object_shapekey_remove(), blender::deg::DepsgraphRelationBuilder::build_object_data(), blender::deg::DepsgraphRelationBuilder::build_object_data_geometry(), blender::ed::object::shapekey::ShapeKeyTreeView::build_tree(), blender::io::AbstractHierarchyWriter::check_is_animated(), deform_matrices(), deform_matrices_EM(), deform_verts(), deform_verts(), deform_verts_EM(), draw_selected_name(), ED_actedit_animdata_from_context(), blender::bke::get_orco_coords(), object_deforms_in_time(), blender::ed::object::object_is_any_shape_key_locked(), blender::ed::object::object_shape_key_add(), blender::ed::object::object_shape_key_mirror(), blender::ed::object::object_update_shapes_poll(), blender::ed::object::shapekey::ShapeKeyDropTarget::on_drop(), blender::ed::sculpt_paint::undo::restore_active_shape_key(), blender::ed::object::shape_key_clear_exec(), blender::ed::object::shape_key_copy_exec(), blender::ed::object::shape_key_lock_exec(), blender::ed::object::shape_key_make_basis_exec(), blender::ed::object::shape_key_move_exec(), blender::ed::object::shape_key_move_poll(), blender::ed::object::shape_key_remove_exec(), blender::ed::object::shape_key_retime_exec(), and blender::ed::transform::special_aftertrans_update__actedit().
Definition at line 1782 of file key.cc.
References BKE_key_from_id_p(), and Object::data.
Referenced by BKE_key_from_object(), and BKE_object_shapekey_free().
| bool BKE_key_idtype_support | ( | short | id_type | ) |
Definition at line 1734 of file key.cc.
References ID_CU_LEGACY, ID_LT, and ID_ME.
Referenced by BLO_main_validate_shapekeys().
| void BKE_key_sort | ( | Key * | key | ) |
Sort shape keys after a change. This assumes that at most one key was moved, which is a valid assumption for the places it's currently being called.
Definition at line 277 of file key.cc.
References BLI_insertlinkafter(), BLI_remlink(), Key::block, ListBase::first, LISTBASE_FOREACH, KeyBlock::next, KeyBlock::pos, and Key::refkey.
Referenced by BKE_keyblock_add_ctime(), and blender::ed::mesh::join_objects_exec().
Definition at line 1802 of file key.cc.
References BLI_addtail(), BLI_listbase_count(), BLI_uniquename(), Key::block, DATA_, KEY_LINEAR, ListBase::last, MEM_callocN(), KeyBlock::name, name, offsetof, KeyBlock::pos, Key::refkey, KeyBlock::slidermax, KeyBlock::slidermin, SNPRINTF_UTF8, STRNCPY_UTF8, Key::totkey, KeyBlock::type, KeyBlock::uid, and Key::uidgen.
Referenced by BKE_keyblock_add_ctime(), BKE_keyblock_duplicate(), bm_to_mesh_shape(), ED_mesh_shapes_join_objects_exec(), blender::io::fbx::import_blend_shapes(), blender::io::usd::import_blendshapes(), blender::ed::mesh::join_shape_keys(), keyblock_ensure_from_uid(), and blender::ed::object::modifier_apply_shape().
| key | The key datablock to add to. |
| name | Optional name for the new keyblock. |
| do_force | always use ctime even for relative keys. |
Definition at line 1862 of file key.cc.
References BKE_key_sort(), BKE_keyblock_add(), Key::block, compare_ff(), Key::ctime, KEY_RELATIVE, LISTBASE_FOREACH, name, KeyBlock::pos, and Key::type.
Referenced by insert_curvekey(), insert_lattkey(), and insert_meshkey().
Definition at line 2101 of file key.cc.
References BKE_keyblock_curve_element_count(), BKE_keyblock_update_from_curve(), KeyBlock::data, Key::elemsize, Curve::key, MEM_malloc_arrayN(), MEM_SAFE_FREE, and KeyBlock::totelem.
Referenced by insert_curvekey().
Definition at line 1976 of file key.cc.
References BKE_keyblock_update_from_lattice(), KeyBlock::data, Key::elemsize, Lattice::key, MEM_malloc_arrayN(), MEM_SAFE_FREE, Lattice::pntsu, Lattice::pntsv, Lattice::pntsw, and KeyBlock::totelem.
Referenced by insert_lattkey().
Definition at line 2170 of file key.cc.
References BKE_keyblock_update_from_mesh(), KeyBlock::data, Key::elemsize, len, MEM_malloc_arrayN(), MEM_SAFE_FREE, KeyBlock::totelem, and Mesh::verts_num.
Referenced by ED_mesh_shapes_join_objects_exec(), blender::io::fbx::import_blend_shapes(), blender::io::usd::import_blendshapes(), insert_meshkey(), and blender::ed::object::modifier_apply_shape().
Definition at line 2147 of file key.cc.
References BKE_keyblock_curve_element_count(), KeyBlock::data, keyblock_data_convert_to_curve(), min_ii(), and KeyBlock::totelem.
Referenced by BKE_object_shapekey_remove(), and ED_curve_editnurb_make().
Definition at line 2002 of file key.cc.
References KeyBlock::data, Lattice::def, float, keyblock_data_convert_to_lattice(), min_ii(), Lattice::pntsu, Lattice::pntsv, Lattice::pntsw, and KeyBlock::totelem.
Referenced by BKE_editlattice_make(), and BKE_object_shapekey_remove().
| void BKE_keyblock_convert_to_mesh | ( | const KeyBlock * | kb, |
| blender::MutableSpan< blender::float3 > | vert_positions ) |
Definition at line 2186 of file key.cc.
References blender::MutableSpan< T >::copy_from(), KeyBlock::data, blender::MutableSpan< T >::take_front(), and KeyBlock::totelem.
Referenced by BKE_keyblock_mesh_calc_normals(), BKE_object_shapekey_remove(), blender::ed::object::create_applied_mesh_for_modifier(), and blender::io::usd::get_shape_key_basis_mesh().
copy shape-key attributes, but not key data or name/UID.
Definition at line 1931 of file key.cc.
References KeyBlock::curval, KeyBlock::pos, KeyBlock::relative, KeyBlock::slidermax, KeyBlock::slidermin, STRNCPY(), KeyBlock::type, and KeyBlock::vgroup.
Referenced by BKE_keyblock_duplicate(), and blender::ed::mesh::join_shape_keys().
| std::optional< std::string > BKE_keyblock_curval_rnapath_get | ( | const Key * | key, |
| const KeyBlock * | kb ) |
Get RNA-Path for 'value' setting of the given shape-key.
Definition at line 1942 of file key.cc.
References ELEM, Key::id, ptr, RNA_path_from_ID_to_property(), RNA_pointer_create_discrete(), and RNA_struct_find_property().
Referenced by achannel_setting_slider_shapekey_cb(), ANIM_channel_draw_widgets(), and make_new_animlistelem().
| void BKE_keyblock_curve_data_set_with_mat4 | ( | Key * | key, |
| const ListBase * | nurb, | ||
| int | shape_index, | ||
| const void * | data, | ||
| const blender::float4x4 & | transform ) |
Set the data for all key-blocks (or shape_index if != -1), transforming by mat.
Definition at line 1701 of file key.cc.
References BKE_keyblock_curve_data_transform(), Key::block, data, ELEM, Key::elemsize, ListBase::first, KeyBlock::next, and transform().
Referenced by blender::ed::object::data_xform_by_mat4().
| void BKE_keyblock_curve_data_transform | ( | const ListBase * | nurb, |
| const float | mat[4][4], | ||
| const void * | src, | ||
| void * | dst ) |
Definition at line 2070 of file key.cc.
References i, KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, LISTBASE_FOREACH, and mul_v3_m4v3().
Referenced by BKE_keyblock_curve_data_set_with_mat4().
| int BKE_keyblock_curve_element_count | ( | const ListBase * | nurb | ) |
Definition at line 2013 of file key.cc.
References Nurb::bezt, Nurb::bp, ListBase::first, KEYELEM_ELEM_LEN_BEZTRIPLE, KEYELEM_ELEM_LEN_BPOINT, Nurb::next, Nurb::pntsu, and Nurb::pntsv.
Referenced by BKE_curve_calc_modifiers_pre(), BKE_key_evaluate_object_ex(), BKE_keyblock_convert_from_curve(), BKE_keyblock_convert_to_curve(), BKE_keyblock_update_from_curve(), calc_shapeKeys(), and do_versions_after_linking_280().
| void BKE_keyblock_data_get | ( | const Key * | key, |
| blender::MutableSpan< blender::float3 > | arr ) |
| void BKE_keyblock_data_get_from_shape | ( | const Key * | key, |
| blender::MutableSpan< blender::float3 > | arr, | ||
| int | shape_index ) |
| shape_index | The index to use or all (when -1). |
Referenced by blender::ed::object::data_xform_create_ex().
| void BKE_keyblock_data_set | ( | Key * | key, |
| int | shape_index, | ||
| const void * | data ) |
Set the data for all key-blocks (or shape_index if != -1).
Definition at line 1719 of file key.cc.
References Key::block, data, ELEM, Key::elemsize, ListBase::first, and KeyBlock::next.
Referenced by blender::ed::object::data_xform_restore().
| void BKE_keyblock_data_set_with_mat4 | ( | Key * | key, |
| int | shape_index, | ||
| blender::Span< blender::float3 > | coords, | ||
| const blender::float4x4 & | transform ) |
Set the data to all key-blocks (or shape_index if != -1).
References data, and transform().
Referenced by blender::ed::object::data_xform_by_mat4().
Add a copy of the source key-block with a copy of its data array.
Definition at line 1849 of file key.cc.
References BKE_keyblock_add(), BKE_keyblock_copy_settings(), BLI_assert, BLI_findindex(), BLI_insertlinkafter(), BLI_remlink(), Key::block, KeyBlock::data, KeyBlock::flag, MEM_dupallocN(), KeyBlock::name, and KeyBlock::totelem.
Referenced by blender::ed::object::shape_key_copy_exec().
| size_t BKE_keyblock_element_calc_size | ( | const Key * | key | ) |
Definition at line 1640 of file key.cc.
References BKE_keyblock_element_calc_size_from_shape().
| size_t BKE_keyblock_element_calc_size_from_shape | ( | const Key * | key, |
| int | shape_index ) |
| shape_index | The index to use or all (when -1). |
Definition at line 1635 of file key.cc.
References BKE_keyblock_element_count_from_shape(), and Key::elemsize.
Referenced by BKE_keyblock_element_calc_size(), and blender::ed::object::data_xform_create_ex().
| int BKE_keyblock_element_count | ( | const Key * | key | ) |
Definition at line 1630 of file key.cc.
References BKE_keyblock_element_count_from_shape().
| int BKE_keyblock_element_count_from_shape | ( | const Key * | key, |
| int | shape_index ) |
| shape_index | The index to use or all (when -1). |
Definition at line 1616 of file key.cc.
References Key::block, ELEM, ListBase::first, KeyBlock::next, and result.
Referenced by BKE_keyblock_element_calc_size_from_shape(), and BKE_keyblock_element_count().
Get the appropriate KeyBlock given an index (0 refers to the basis key). Key may be null.
Definition at line 1907 of file key.cc.
References BLI_findlink(), and Key::block.
Referenced by BKE_keyblock_from_object(), deform_verts(), ED_curve_get_edit_shape_key(), ED_lattice_get_edit_shape_key(), ED_mesh_get_edit_shape_key(), blender::ed::sculpt_paint::ShapeKeyData::from_object(), and blender::bke::get_orco_coords().
Get the appropriate KeyBlock given a name to search for.
Definition at line 1916 of file key.cc.
References BLI_findstring(), Key::block, name, and offsetof.
Referenced by ED_mesh_shapes_join_objects_exec(), edbm_blend_from_shape_exec(), blender::io::fbx::import_blend_shape_full_weights(), blender::ed::mesh::join_shape_keys(), and blender::ed::sculpt_paint::undo::restore_active_shape_key().
Definition at line 1921 of file key.cc.
References Key::block, and LISTBASE_FOREACH.
Referenced by keyblock_ensure_from_uid().
Only the active key-block.
Definition at line 1889 of file key.cc.
References BKE_key_from_object(), BKE_keyblock_find_by_index(), and Object::shapenr.
Referenced by BKE_editlattice_make(), BKE_key_evaluate_object_ex(), deform_matrices(), deform_matrices_EM(), do_curve_key(), do_latt_key(), do_mesh_key(), ED_curve_editnurb_make(), get_stats_string(), blender::ed::sculpt_paint::undo::save_common_data(), sculpt_update_object(), blender::ed::object::shape_key_copy_exec(), blender::ed::object::shape_key_exists_poll(), blender::ed::object::shape_key_mode_exists_poll(), and blender::ed::object::shape_key_report_if_active_locked().
Definition at line 1896 of file key.cc.
References BKE_key_from_object(), and Key::refkey.
| std::optional< blender::Array< bool > > BKE_keyblock_get_dependent_keys | ( | const Key * | key, |
| int | index ) |
Returns a newly allocated array containing true for every key that has this one as basis. If none are found, returns null.
Definition at line 2371 of file key.cc.
References BLI_listbase_count(), Key::block, count, i, KEY_RELATIVE, LISTBASE_FOREACH_INDEX, KeyBlock::relative, and Key::type.
Referenced by bm_to_mesh_shape(), calc_shapeKeys(), and blender::ed::sculpt_paint::ShapeKeyData::from_object().
| bool BKE_keyblock_is_basis | ( | const Key * | key, |
| int | index ) |
Check if given key-block (as index) is used as basis by others in given key.
Definition at line 2355 of file key.cc.
References Key::block, ListBase::first, i, KEY_RELATIVE, KeyBlock::next, KeyBlock::relative, and Key::type.
| void BKE_keyblock_mesh_calc_normals | ( | const KeyBlock * | kb, |
| Mesh * | mesh, | ||
| float(*) | r_vert_normals[3], | ||
| float(*) | r_face_normals[3], | ||
| float(*) | r_loop_normals[3] ) |
Computes normals (vertices, faces and/or loops ones) of given mesh for given shape key.
| kb | the KeyBlock to use to compute normals. |
| mesh | the Mesh to apply key-block to. |
| r_vert_normals | if non-NULL, an array of vectors, same length as number of vertices. |
| r_face_normals | if non-NULL, an array of vectors, same length as number of faces. |
| r_loop_normals | if non-NULL, an array of vectors, same length as number of loops. |
Definition at line 2193 of file key.cc.
References BKE_keyblock_convert_to_mesh(), blender::bke::Corner, blender::bke::Edge, blender::bke::Face, faces, float, blender::bke::AttributeAccessor::lookup(), MEM_freeN(), MEM_malloc_arrayN(), blender::bke::mesh::normals_calc_corners(), blender::bke::mesh::normals_calc_faces(), and blender::bke::mesh::normals_calc_verts().
| bool BKE_keyblock_move | ( | Object * | ob, |
| int | org_index, | ||
| int | new_index ) |
Move shape key from org_index to new_index. Safe, clamps index to valid range, updates reference keys, the object's active shape index, the 'frame' value in case of absolute keys, etc. Note indices are expected in real values (not fake shapenr +1 ones).
| org_index | if < 0, current object's active shape will be used as shape-key to move. |
Definition at line 2274 of file key.cc.
References BKE_key_from_object(), BLI_listbase_swaplinks(), Key::block, CLAMP, ListBase::first, i, ListBase::last, KeyBlock::next, KeyBlock::pos, KeyBlock::prev, Key::refkey, KeyBlock::relative, Object::shapenr, and Key::totkey.
Referenced by blender::ed::object::shapekey::ShapeKeyDropTarget::on_drop(), blender::ed::object::shape_key_make_basis_exec(), and blender::ed::object::shape_key_move_exec().
Definition at line 2032 of file key.cc.
References BKE_keyblock_curve_element_count(), BLI_assert, copy_v3_v3(), KeyBlock::data, i, KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, LISTBASE_FOREACH, BezTriple::radius, BPoint::radius, BezTriple::tilt, BPoint::tilt, KeyBlock::totelem, BezTriple::vec, and BPoint::vec.
Referenced by BKE_keyblock_convert_from_curve().
Definition at line 1956 of file key.cc.
References BLI_assert, copy_v3_v3(), KeyBlock::data, Lattice::def, float, Lattice::pntsu, Lattice::pntsv, Lattice::pntsw, KeyBlock::totelem, and BPoint::vec.
Referenced by BKE_keyblock_convert_from_lattice().
Definition at line 2157 of file key.cc.
References BLI_assert, blender::Span< T >::data(), KeyBlock::data, KeyBlock::totelem, and Mesh::verts_num.
Referenced by BKE_keyblock_convert_from_mesh(), and ED_mesh_shapes_join_objects_exec().
| void key_curve_normal_weights | ( | float | t, |
| float | data[4], | ||
| KeyInterpolationType | type ) |
Second derivative.
Definition at line 391 of file key.cc.
References data, KEY_BSPLINE, KEY_CARDINAL, KEY_CATMULL_ROM, and KEY_LINEAR.
| void key_curve_position_weights | ( | float | t, |
| float | data[4], | ||
| KeyInterpolationType | type ) |
Definition at line 308 of file key.cc.
References data, KEY_BSPLINE, KEY_CARDINAL, KEY_CATMULL_ROM, and KEY_LINEAR.
Referenced by BKE_colorband_evaluate(), BKE_lattice_deform_data_eval_co(), BKE_where_on_path(), blender::bke::subdiv::mesh_interpolate_position_on_edge(), psys_interpolate_particle(), setkeys(), and tilt_bezpart().
| void key_curve_tangent_weights | ( | float | t, |
| float | data[4], | ||
| KeyInterpolationType | type ) |
First derivative.
Definition at line 351 of file key.cc.
References data, KEY_BSPLINE, KEY_CARDINAL, KEY_CATMULL_ROM, and KEY_LINEAR.
Referenced by BKE_where_on_path().