key.c File Reference

#include <math.h>
#include <stddef.h>
#include <string.h>
#include "MEM_guardedalloc.h"
#include "BLI_blenlib.h"
#include "BLI_endian_switch.h"
#include "BLI_math_vector.h"
#include "BLI_string_utils.h"
#include "BLI_utildefines.h"
#include "BLT_translation.h"
#include "DNA_ID.h"
#include "DNA_anim_types.h"
#include "DNA_key_types.h"
#include "DNA_lattice_types.h"
#include "DNA_mesh_types.h"
#include "DNA_meshdata_types.h"
#include "DNA_object_types.h"
#include "DNA_scene_types.h"
#include "BKE_anim_data.h"
#include "BKE_curve.h"
#include "BKE_customdata.h"
#include "BKE_deform.h"
#include "BKE_editmesh.h"
#include "BKE_idtype.h"
#include "BKE_key.h"
#include "BKE_lattice.h"
#include "BKE_lib_id.h"
#include "BKE_lib_query.h"
#include "BKE_main.h"
#include "BKE_mesh.h"
#include "BKE_scene.h"
#include "RNA_access.h"
#include "BLO_read_write.h"

Go to the source code of this file.

Classes
struct	WeightsArrayCache

Macros
#define	DNA_DEPRECATED_ALLOW
#define	IPO_FLOAT   4
#define	IPO_BEZTRIPLE   100
#define	IPO_BPOINT   101
#define	KEY_MODE_DUMMY   0 /* use where mode isn't checked for */
#define	KEY_MODE_BPOINT   1
#define	KEY_MODE_BEZTRIPLE   2

Typedefs
typedef struct WeightsArrayCache	WeightsArrayCache

Functions
static void	shapekey_copy_data (Main *UNUSED(bmain), ID *id_dst, const ID *id_src, const int UNUSED(flag))
static void	shapekey_free_data (ID *id)
static void	shapekey_foreach_id (ID *id, LibraryForeachIDData *data)
static void	shapekey_blend_write (BlendWriter *writer, ID *id, const void *id_address)
static void	switch_endian_keyblock (Key *key, KeyBlock *kb)
static void	shapekey_blend_read_data (BlendDataReader *reader, ID *id)
static void	shapekey_blend_read_lib (BlendLibReader *reader, ID *id)
static void	shapekey_blend_read_expand (BlendExpander *expander, ID *id)
void	BKE_key_free (Key *key)
void	BKE_key_free_nolib (Key *key)
Key *	BKE_key_add (Main *bmain, ID *id)
void	BKE_key_sort (Key *key)
void	key_curve_position_weights (float t, float data[4], int type)
void	key_curve_tangent_weights (float t, float data[4], int type)
void	key_curve_normal_weights (float t, float data[4], int type)
static int	setkeys (float fac, ListBase *lb, KeyBlock *k[], float t[4], int cycl)
static void	flerp (int tot, float *in, const float *f0, const float *f1, const float *f2, const float *f3, const float *t)
static void	rel_flerp (int tot, float *in, const float *ref, const float *out, float fac)
static char *	key_block_get_data (Key *key, KeyBlock *actkb, KeyBlock *kb, char **freedata)
static bool	key_pointer_size (const Key *key, const int mode, int *poinsize, int *ofs, int *step)
static void	cp_key (const int start, int end, const int tot, char *poin, Key *key, KeyBlock *actkb, KeyBlock *kb, float *weights, const int mode)
static void	cp_cu_key (Curve *cu, Key *key, KeyBlock *actkb, KeyBlock *kb, const int start, int end, char *out, const int tot)
static void	key_evaluate_relative (const int start, int end, const int tot, char *basispoin, Key *key, KeyBlock *actkb, float **per_keyblock_weights, const int mode)
static void	do_key (const int start, int end, const int tot, char *poin, Key *key, KeyBlock *actkb, KeyBlock **k, float *t, const int mode)
static float *	get_weights_array (Object *ob, char *vgroup, WeightsArrayCache *cache)
static float **	keyblock_get_per_block_weights (Object *ob, Key *key, WeightsArrayCache *cache)
static void	keyblock_free_per_block_weights (Key *key, float **per_keyblock_weights, WeightsArrayCache *cache)
static void	do_mesh_key (Object *ob, Key *key, char *out, const int tot)
static void	do_cu_key (Curve *cu, Key *key, KeyBlock *actkb, KeyBlock **k, float *t, char *out, const int tot)
static void	do_rel_cu_key (Curve *cu, Key *key, KeyBlock *actkb, char *out, const int tot)
static void	do_curve_key (Object *ob, Key *key, char *out, const int tot)
static void	do_latt_key (Object *ob, Key *key, char *out, const int tot)
float *	BKE_key_evaluate_object_ex (Object *ob, int *r_totelem, float *arr, size_t arr_size)
float *	BKE_key_evaluate_object (Object *ob, int *r_totelem)
int	BKE_keyblock_element_count_from_shape (const Key *key, const int shape_index)
int	BKE_keyblock_element_count (const Key *key)
size_t	BKE_keyblock_element_calc_size_from_shape (const Key *key, const int shape_index)
size_t	BKE_keyblock_element_calc_size (const Key *key)
bool	BKE_key_idtype_support (const short id_type)
Key **	BKE_key_from_id_p (ID *id)
Key *	BKE_key_from_id (ID *id)
Key **	BKE_key_from_object_p (const Object *ob)
Key *	BKE_key_from_object (const Object *ob)
KeyBlock *	BKE_keyblock_add (Key *key, const char *name)
KeyBlock *	BKE_keyblock_add_ctime (Key *key, const char *name, const bool do_force)
KeyBlock *	BKE_keyblock_from_object (Object *ob)
KeyBlock *	BKE_keyblock_from_object_reference (Object *ob)
KeyBlock *	BKE_keyblock_from_key (Key *key, int index)
KeyBlock *	BKE_keyblock_find_name (Key *key, const char name[])
void	BKE_keyblock_copy_settings (KeyBlock *kb_dst, const KeyBlock *kb_src)
	copy shape-key attributes, but not key data.or name/uid More...
char *	BKE_keyblock_curval_rnapath_get (Key *key, KeyBlock *kb)
void	BKE_keyblock_update_from_lattice (Lattice *lt, KeyBlock *kb)
void	BKE_keyblock_convert_from_lattice (Lattice *lt, KeyBlock *kb)
void	BKE_keyblock_convert_to_lattice (KeyBlock *kb, Lattice *lt)
int	BKE_keyblock_curve_element_count (ListBase *nurb)
void	BKE_keyblock_update_from_curve (Curve *UNUSED(cu), KeyBlock *kb, ListBase *nurb)
void	BKE_keyblock_curve_data_transform (const ListBase *nurb, const float mat[4][4], const void *src_data, void *dst_data)
void	BKE_keyblock_convert_from_curve (Curve *cu, KeyBlock *kb, ListBase *nurb)
void	BKE_keyblock_convert_to_curve (KeyBlock *kb, Curve *UNUSED(cu), ListBase *nurb)
void	BKE_keyblock_update_from_mesh (Mesh *me, KeyBlock *kb)
void	BKE_keyblock_convert_from_mesh (Mesh *me, Key *key, KeyBlock *kb)
void	BKE_keyblock_convert_to_mesh (KeyBlock *kb, Mesh *me)
void	BKE_keyblock_mesh_calc_normals (struct KeyBlock *kb, struct Mesh *mesh, float(*r_vertnors)[3], float(*r_polynors)[3], float(*r_loopnors)[3])
void	BKE_keyblock_update_from_vertcos (Object *ob, KeyBlock *kb, const float(*vertCos)[3])
void	BKE_keyblock_convert_from_vertcos (Object *ob, KeyBlock *kb, const float(*vertCos)[3])
float(*	BKE_keyblock_convert_to_vertcos (Object *ob, KeyBlock *kb))[3]
void	BKE_keyblock_update_from_offset (Object *ob, KeyBlock *kb, const float(*ofs)[3])
bool	BKE_keyblock_move (Object *ob, int org_index, int new_index)
bool	BKE_keyblock_is_basis (Key *key, const int index)
Key-Block Data Access
Utilities for getting/setting key data as a single array, use BKE_keyblock_element_calc_size to allocate the size of the data needed.
void	BKE_keyblock_data_get_from_shape (const Key *key, float(*arr)[3], const int shape_index)
void	BKE_keyblock_data_get (const Key *key, float(*arr)[3])
void	BKE_keyblock_data_set_with_mat4 (Key *key, const int shape_index, const float(*coords)[3], const float mat[4][4])
void	BKE_keyblock_curve_data_set_with_mat4 (Key *key, const ListBase *nurb, const int shape_index, const void *data, const float mat[4][4])
void	BKE_keyblock_data_set (Key *key, const int shape_index, const void *data)

Variables
IDTypeInfo	IDType_ID_KE

Macro Definition Documentation

DNA_DEPRECATED_ALLOW

#define DNA_DEPRECATED_ALLOW

Definition at line 39 of file key.c.

IPO_BEZTRIPLE

#define IPO_BEZTRIPLE   100

Definition at line 139 of file key.c.

IPO_BPOINT

#define IPO_BPOINT   101

Definition at line 140 of file key.c.

IPO_FLOAT

#define IPO_FLOAT   4

Definition at line 138 of file key.c.

KEY_MODE_BEZTRIPLE

#define KEY_MODE_BEZTRIPLE   2

Definition at line 233 of file key.c.

KEY_MODE_BPOINT

#define KEY_MODE_BPOINT   1

Definition at line 232 of file key.c.

KEY_MODE_DUMMY

#define KEY_MODE_DUMMY   0 /* use where mode isn't checked for */

Definition at line 231 of file key.c.

Typedef Documentation

WeightsArrayCache

typedef struct WeightsArrayCache WeightsArrayCache

Function Documentation

BKE_key_add()

Key* BKE_key_add	(	Main *	bmain,
		ID *	id
	)

Definition at line 259 of file key.c.

References BKE_id_new(), Key::elemsize, Key::elemstr, Key::from, GS, id, ID_CU, ID_KE, 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_join_objects_exec(), ED_mesh_shapes_join_objects_exec(), insert_curvekey(), insert_lattkey(), insert_meshkey(), ArmatureImporter::make_shape_keys(), and modifier_apply_shape().

BKE_key_evaluate_object()

float* BKE_key_evaluate_object	(	Object *	ob,
		int *	r_totelem
	)

Definition at line 1616 of file key.c.

References BKE_key_evaluate_object_ex(), and NULL.

Referenced by BKE_curve_calc_modifiers_pre(), insert_curvekey(), insert_lattkey(), and insert_meshkey().

BKE_key_evaluate_object_ex()

float* BKE_key_evaluate_object_ex	(	Object *	ob,
		int *	r_totelem,
		float *	arr,
		size_t	arr_size
	)

Definition at line 1520 of file key.c.

References BKE_key_from_object(), BKE_keyblock_curve_element_count(), BKE_keyblock_from_object(), BLI_findlink(), BLI_listbase_is_empty(), Key::block, cp_cu_key(), cp_key(), Object::data, do_curve_key(), do_latt_key(), do_mesh_key(), ELEM, ListBase::first, KeyBlock::flag, get_weights_array(), KEYBLOCK_MUTE, KEYELEM_ELEM_SIZE_CURVE, KEYELEM_FLOAT_LEN_COORD, MEM_callocN, MEM_freeN, NULL, Curve::nurb, OB_CURVE, OB_LATTICE, OB_MESH, OB_SHAPE_LOCK, OB_SURF, OB_TYPE_SUPPORT_VGROUP, Lattice::pntsu, Lattice::pntsv, Lattice::pntsw, Key::refkey, Object::shapeflag, Object::shapenr, size(), Mesh::totvert, Object::type, and KeyBlock::vgroup.

Referenced by BKE_key_evaluate_object(), and deformVerts().

BKE_key_free()

void BKE_key_free

(

Key *

key

)

Free (or release) any data used by this shapekey (does not free the key itself).

Definition at line 242 of file key.c.

References Key::id, and shapekey_free_data().

Referenced by undomesh_free_data().

BKE_key_free_nolib()

void BKE_key_free_nolib

(

Key *

key

)

Definition at line 247 of file key.c.

References BLI_pophead(), Key::block, KeyBlock::data, and MEM_freeN.

BKE_key_from_id()

Key* BKE_key_from_id

(

ID *

id

)

Definition at line 1786 of file key.c.

References BKE_key_from_id_p(), and NULL.

Referenced by BKE_id_copy_for_duplicate(), BKE_id_free_ex(), BKE_lib_id_make_local_generic(), BKE_lib_override_library_create_from_id(), BKE_lib_override_library_create_from_tag(), BKE_lib_override_library_make_local(), BKE_lib_override_library_update(), BLO_main_validate_shapekeys(), blender::deg::DepsgraphRelationBuilder::build_object_data_geometry_datablock(), blender::deg::DepsgraphNodeBuilder::build_object_data_geometry_datablock(), lib_id_clear_library_data_ex(), lib_override_library_create_from(), and lib_relocate_do().

BKE_key_from_id_p()

Key** BKE_key_from_id_p

(

ID *

id

)

Definition at line 1761 of file key.c.

References GS, id, ID_CU, ID_LT, ID_ME, Curve::key, Lattice::key, Mesh::key, ID::name, NULL, and Curve::vfont.

Referenced by BKE_key_from_id(), BKE_key_from_object_p(), BKE_lib_override_library_update(), and lib_relocate_do().

BKE_key_from_object()

Key* BKE_key_from_object

(

const Object *

ob

)

Definition at line 1806 of file key.c.

References BKE_key_from_object_p(), and NULL.

Referenced by BKE_key_evaluate_object_ex(), BKE_keyblock_from_object(), BKE_keyblock_from_object_reference(), and BKE_keyblock_move().

BKE_key_from_object_p()

Key** BKE_key_from_object_p

(

const Object *

ob

)

Definition at line 1797 of file key.c.

References BKE_key_from_id_p(), Object::data, and NULL.

Referenced by BKE_key_from_object().

BKE_key_idtype_support()

bool BKE_key_idtype_support

(

const short

id_type

)

Definition at line 1749 of file key.c.

References ID_CU, ID_LT, and ID_ME.

Referenced by BLO_main_validate_shapekeys().

BKE_key_sort()

void BKE_key_sort

(

Key *

key

)

Definition at line 316 of file key.c.

References BLI_insertlinkafter(), BLI_remlink(), Key::block, ListBase::first, KeyBlock::next, KeyBlock::pos, KeyBlock::prev, and Key::refkey.

Referenced by BKE_keyblock_add_ctime(), and ED_mesh_join_objects_exec().

BKE_keyblock_add()

KeyBlock* BKE_keyblock_add	(	Key *	key,
		const char *	name
	)

Note

caller may want to set this to current time, but don't do it here since we need to sort which could cause problems in some cases, see BKE_keyblock_add_ctime

Definition at line 1817 of file key.c.

References BLI_addtail(), BLI_listbase_count(), BLI_snprintf(), BLI_strncpy(), BLI_uniquename(), Key::block, DATA_, KEY_LINEAR, ListBase::last, MEM_callocN, KeyBlock::name, KeyBlock::pos, Key::refkey, KeyBlock::slidermax, KeyBlock::slidermin, Key::totkey, KeyBlock::type, KeyBlock::uid, and Key::uidgen.

Referenced by BKE_keyblock_add_ctime(), BM_mesh_bm_to_me(), ED_mesh_join_objects_exec(), ED_mesh_shapes_join_objects_exec(), modifier_apply_shape(), and shapekey_layers_to_keyblocks().

BKE_keyblock_add_ctime()

KeyBlock* BKE_keyblock_add_ctime	(	Key *	key,
		const char *	name,
		const bool	do_force
	)

Note

sorting is a problematic side effect in some cases, better only do this explicitly by having its own function,

Parameters

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 1873 of file key.c.

References BKE_key_sort(), BKE_keyblock_add(), Key::block, compare_ff(), Key::ctime, ListBase::first, KEY_RELATIVE, KeyBlock::next, KeyBlock::pos, and Key::type.

Referenced by insert_curvekey(), insert_lattkey(), insert_meshkey(), and ArmatureImporter::make_shape_keys().

BKE_keyblock_convert_from_curve()

void BKE_keyblock_convert_from_curve	(	Curve *	cu,
		KeyBlock *	kb,
		ListBase *	nurb
	)

Definition at line 2133 of file key.c.

References BKE_keyblock_curve_element_count(), BKE_keyblock_update_from_curve(), KeyBlock::data, Key::elemsize, Curve::key, MEM_mallocN, MEM_SAFE_FREE, and KeyBlock::totelem.

Referenced by insert_curvekey().

BKE_keyblock_convert_from_lattice()

void BKE_keyblock_convert_from_lattice	(	Lattice *	lt,
		KeyBlock *	kb
	)

Definition at line 2008 of file key.c.

References BKE_keyblock_update_from_lattice(), KeyBlock::data, Key::elemsize, Lattice::key, MEM_mallocN, MEM_SAFE_FREE, Lattice::pntsu, Lattice::pntsv, Lattice::pntsw, and KeyBlock::totelem.

Referenced by insert_lattkey().

BKE_keyblock_convert_from_mesh()

void BKE_keyblock_convert_from_mesh	(	Mesh *	me,
		Key *	key,
		KeyBlock *	kb
	)

Definition at line 2208 of file key.c.

References BKE_keyblock_update_from_mesh(), KeyBlock::data, Key::elemsize, len, MEM_malloc_arrayN, MEM_SAFE_FREE, KeyBlock::totelem, and Mesh::totvert.

Referenced by BKE_mesh_runtime_eval_to_meshkey(), ED_mesh_shapes_join_objects_exec(), insert_meshkey(), ArmatureImporter::make_shape_keys(), and modifier_apply_shape().

BKE_keyblock_convert_from_vertcos()

void BKE_keyblock_convert_from_vertcos	(	Object *	ob,
		KeyBlock *	kb,
		const float(*)	vertCos[3]
	)

Definition at line 2380 of file key.c.

References BKE_keyblock_curve_element_count(), BKE_keyblock_update_from_vertcos(), KeyBlock::data, Object::data, ELEM, Key::elemsize, Curve::key, Lattice::key, Mesh::key, MEM_mallocN, MEM_SAFE_FREE, Curve::nurb, OB_CURVE, OB_LATTICE, OB_MESH, OB_SURF, Lattice::pntsu, Lattice::pntsv, Lattice::pntsw, Mesh::totvert, and Object::type.

BKE_keyblock_convert_to_curve()

void BKE_keyblock_convert_to_curve	(	KeyBlock *	kb,
		Curve *	UNUSEDcu,
		ListBase *	nurb
	)

Definition at line 2151 of file key.c.

References Freestyle::a, Nurb::bezt, BKE_keyblock_curve_element_count(), Nurb::bp, copy_v3_v3(), KeyBlock::data, ListBase::first, KEYELEM_ELEM_LEN_BEZTRIPLE, KEYELEM_ELEM_LEN_BPOINT, KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, min_ii(), Nurb::next, Nurb::pntsu, Nurb::pntsv, BezTriple::radius, BPoint::radius, BezTriple::tilt, BPoint::tilt, KeyBlock::totelem, BezTriple::vec, and BPoint::vec.

BKE_keyblock_convert_to_lattice()

void BKE_keyblock_convert_to_lattice	(	KeyBlock *	kb,
		Lattice *	lt
	)

Definition at line 2025 of file key.c.

References Freestyle::a, copy_v3_v3(), KeyBlock::data, Lattice::def, float(), min_ii(), Lattice::pntsu, Lattice::pntsv, Lattice::pntsw, KeyBlock::totelem, and BPoint::vec.

Referenced by BKE_editlattice_make(), and BKE_object_shapekey_remove().

BKE_keyblock_convert_to_mesh()

void BKE_keyblock_convert_to_mesh	(	KeyBlock *	kb,
		Mesh *	me
	)

Definition at line 2224 of file key.c.

References Freestyle::a, MVert::co, copy_v3_v3(), KeyBlock::data, float(), min_ii(), Mesh::mvert, KeyBlock::totelem, and Mesh::totvert.

Referenced by BKE_keyblock_mesh_calc_normals(), BKE_mesh_create_derived_for_modifier(), BKE_object_shapekey_remove(), and GeometryExporter::operator()().

BKE_keyblock_convert_to_vertcos()

float(* BKE_keyblock_convert_to_vertcos	(	Object *	ob,
		KeyBlock *	kb
	)		)[3]

Definition at line 2413 of file key.c.

References Freestyle::a, BKE_nurbList_verts_count(), copy_v3_v3(), KeyBlock::data, Object::data, ELEM, ListBase::first, float(), KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, MEM_mallocN, NULL, Curve::nurb, OB_CURVE, OB_LATTICE, OB_MESH, OB_SURF, Lattice::pntsu, Lattice::pntsv, Lattice::pntsw, Mesh::totvert, and Object::type.

Referenced by sculpt_undo_restore_coords(), sculpt_update_object(), and SCULPT_vertcos_to_key().

BKE_keyblock_copy_settings()

void BKE_keyblock_copy_settings	(	KeyBlock *	kb_dst,
		const KeyBlock *	kb_src
	)

copy shape-key attributes, but not key data.or name/uid

Definition at line 1952 of file key.c.

References BLI_strncpy(), KeyBlock::curval, KeyBlock::pos, KeyBlock::relative, KeyBlock::slidermax, KeyBlock::slidermin, KeyBlock::type, and KeyBlock::vgroup.

BKE_keyblock_curval_rnapath_get()

char* BKE_keyblock_curval_rnapath_get	(	Key *	key,
		KeyBlock *	kb
	)

Definition at line 1966 of file key.c.

References ELEM, Key::id, NULL, ptr, RNA_path_from_ID_to_property(), RNA_pointer_create(), RNA_ShapeKey, and RNA_struct_find_property().

Referenced by achannel_setting_slider_shapekey_cb(), ANIM_channel_draw_widgets(), and make_new_animlistelem().

BKE_keyblock_curve_data_set_with_mat4()

void BKE_keyblock_curve_data_set_with_mat4	(	Key *	key,
		const ListBase *	nurb,
		const int	shape_index,
		const void *	data,
		const float	mat[4][4]
	)

Set the data for all key-blocks (or shape_index if != -1), transforming by mat.

Definition at line 1716 of file key.c.

References BKE_keyblock_curve_data_transform(), Key::block, data, ELEM, Key::elemsize, and ListBase::first.

BKE_keyblock_curve_data_transform()

void BKE_keyblock_curve_data_transform	(	const ListBase *	nurb,
		const float	mat[4][4],
		const void *	src_data,
		void *	dst_data
	)

Definition at line 2102 of file key.c.

References Freestyle::a, ListBase::first, KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, and mul_v3_m4v3().

Referenced by BKE_keyblock_curve_data_set_with_mat4().

BKE_keyblock_curve_element_count()

int BKE_keyblock_curve_element_count

(

ListBase *

nurb

)

Definition at line 2044 of file key.c.

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_from_vertcos(), BKE_keyblock_convert_to_curve(), BKE_keyblock_update_from_curve(), BKE_keyblock_update_from_vertcos(), calc_shapeKeys(), and do_versions_after_linking_280().

BKE_keyblock_data_get()

void BKE_keyblock_data_get	(	const Key *	key,
		float(*)	arr[3]
	)

Definition at line 1677 of file key.c.

References BKE_keyblock_data_get_from_shape().

BKE_keyblock_data_get_from_shape()

void BKE_keyblock_data_get_from_shape	(	const Key *	key,
		float(*)	arr[3],
		const int	shape_index
	)

Parameters

shape_index

The index to use or all (when -1).

Definition at line 1664 of file key.c.

References Key::block, ELEM, Key::elemsize, and ListBase::first.

Referenced by BKE_keyblock_data_get().

BKE_keyblock_data_set()

void BKE_keyblock_data_set	(	Key *	key,
		const int	shape_index,
		const void *	data
	)

Set the data for all key-blocks (or shape_index if != -1).

Definition at line 1734 of file key.c.

References Key::block, data, ELEM, Key::elemsize, and ListBase::first.

Referenced by ED_object_data_xform_restore().

BKE_keyblock_data_set_with_mat4()

void BKE_keyblock_data_set_with_mat4	(	Key *	key,
		const int	shape_index,
		const float(*)	coords[3],
		const float	mat[4][4]
	)

Set the data to all key-blocks (or shape_index if != -1).

Definition at line 1685 of file key.c.

References BLI_assert, Key::block, ELEM, Key::elemsize, ListBase::first, float(), and mul_v3_m4v3().

Referenced by ED_object_data_xform_by_mat4().

BKE_keyblock_element_calc_size()

size_t BKE_keyblock_element_calc_size

(

const Key *

key

)

Definition at line 1649 of file key.c.

References BKE_keyblock_element_calc_size_from_shape().

BKE_keyblock_element_calc_size_from_shape()

size_t BKE_keyblock_element_calc_size_from_shape	(	const Key *	key,
		const int	shape_index
	)

Parameters

shape_index

The index to use or all (when -1).

Definition at line 1644 of file key.c.

References BKE_keyblock_element_count_from_shape(), and Key::elemsize.

Referenced by BKE_keyblock_element_calc_size().

BKE_keyblock_element_count()

int BKE_keyblock_element_count

(

const Key *

key

)

Definition at line 1636 of file key.c.

References BKE_keyblock_element_count_from_shape().

BKE_keyblock_element_count_from_shape()

int BKE_keyblock_element_count_from_shape	(	const Key *	key,
		const int	shape_index
	)

Parameters

shape_index

The index to use or all (when -1).

Definition at line 1624 of file key.c.

References Key::block, ELEM, ListBase::first, and result.

Referenced by BKE_keyblock_element_calc_size_from_shape(), and BKE_keyblock_element_count().

BKE_keyblock_find_name()

KeyBlock* BKE_keyblock_find_name	(	Key *	key,
		const char	name[]
	)

Definition at line 1944 of file key.c.

References BLI_findstring(), and Key::block.

Referenced by ED_mesh_join_objects_exec(), edbm_blend_from_shape_exec(), join_mesh_single(), and sculpt_undo_restore_coords().

BKE_keyblock_from_key()

KeyBlock* BKE_keyblock_from_key	(	Key *	key,
		int	index
	)

Definition at line 1926 of file key.c.

References Key::block, ListBase::first, KeyBlock::next, NULL, and Key::totkey.

Referenced by deformVerts(), get_orco_coords(), and shapekey_adrcodes_to_paths().

BKE_keyblock_from_object()

KeyBlock* BKE_keyblock_from_object

(

Object *

ob

)

Definition at line 1902 of file key.c.

References BKE_key_from_object(), BLI_findlink(), Key::block, NULL, and Object::shapenr.

Referenced by BKE_editlattice_make(), BKE_key_evaluate_object_ex(), deformMatrices(), deformMatricesEM(), do_curve_key(), do_latt_key(), do_mesh_key(), ED_curve_editnurb_make(), get_stats_string(), sculpt_update_object(), shape_key_clear_exec(), shape_key_mode_exists_poll(), and shape_key_retime_exec().

BKE_keyblock_from_object_reference()

KeyBlock* BKE_keyblock_from_object_reference

(

Object *

ob

)

Definition at line 1914 of file key.c.

References BKE_key_from_object(), NULL, and Key::refkey.

BKE_keyblock_is_basis()

bool BKE_keyblock_is_basis	(	Key *	key,
		const int	index
	)

Check if given keyblock (as index) is used as basis by others in given key.

Definition at line 2600 of file key.c.

References Key::block, ListBase::first, KEY_RELATIVE, KeyBlock::next, KeyBlock::relative, and Key::type.

Referenced by BM_mesh_bm_to_me(), calc_shapeKeys(), SCULPT_vertcos_to_key(), and undomesh_to_editmesh().

BKE_keyblock_mesh_calc_normals()

void BKE_keyblock_mesh_calc_normals	(	struct KeyBlock *	kb,
		struct Mesh *	mesh,
		float(*)	r_vertnors[3],
		float(*)	r_polynors[3],
		float(*)	r_loopnors[3]
	)

Computes normals (vertices, polygons and/or loops ones) of given mesh for given shape key.

Parameters

kb	the KeyBlock to use to compute normals.
mesh	the Mesh to apply keyblock to.
r_vertnors	if non-NULL, an array of vectors, same length as number of vertices.
r_polynors	if non-NULL, an array of vectors, same length as number of polygons.
r_loopnors	if non-NULL, an array of vectors, same length as number of loops.

Definition at line 2249 of file key.c.

References BKE_keyblock_convert_to_mesh(), BKE_mesh_calc_normals_poly(), BKE_mesh_normals_loop_split(), CD_CUSTOMLOOPNORMAL, CustomData_free(), CustomData_get_layer(), CustomData_reset(), Mesh::fdata, Mesh::flag, Mesh::ldata, ME_AUTOSMOOTH, Mesh::medge, MEM_dupallocN, MEM_freeN, MEM_mallocN, mesh, Mesh::mloop, Mesh::mpoly, Mesh::mvert, NULL, Mesh::smoothresh, Mesh::totedge, Mesh::totface, Mesh::totloop, Mesh::totpoly, and Mesh::totvert.

BKE_keyblock_move()

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).

Parameters

org_index

if < 0, current object's active shape will be used as skey to move.

Returns

true if something was done, else false.

Definition at line 2519 of file key.c.

References BKE_key_from_object(), BLI_listbase_swaplinks(), Key::block, CLAMP, ListBase::first, ListBase::last, KeyBlock::next, KeyBlock::pos, KeyBlock::prev, Key::refkey, KeyBlock::relative, Object::shapenr, SWAP, and Key::totkey.

Referenced by shape_key_move_exec().

BKE_keyblock_update_from_curve()

void BKE_keyblock_update_from_curve	(	Curve *	UNUSEDcu,
		KeyBlock *	kb,
		ListBase *	nurb
	)

Definition at line 2063 of file key.c.

References Freestyle::a, Nurb::bezt, BKE_keyblock_curve_element_count(), BLI_assert, Nurb::bp, copy_v3_v3(), KeyBlock::data, ListBase::first, KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, Nurb::next, Nurb::pntsu, Nurb::pntsv, BezTriple::radius, BPoint::radius, BezTriple::tilt, BPoint::tilt, KeyBlock::totelem, BezTriple::vec, and BPoint::vec.

Referenced by BKE_keyblock_convert_from_curve().

BKE_keyblock_update_from_lattice()

void BKE_keyblock_update_from_lattice	(	Lattice *	lt,
		KeyBlock *	kb
	)

Definition at line 1988 of file key.c.

References Freestyle::a, 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().

BKE_keyblock_update_from_mesh()

void BKE_keyblock_update_from_mesh	(	Mesh *	me,
		KeyBlock *	kb
	)

Definition at line 2188 of file key.c.

References Freestyle::a, BLI_assert, MVert::co, copy_v3_v3(), KeyBlock::data, float(), Mesh::mvert, KeyBlock::totelem, and Mesh::totvert.

Referenced by BKE_keyblock_convert_from_mesh(), and undomesh_to_editmesh().

BKE_keyblock_update_from_offset()

void BKE_keyblock_update_from_offset	(	Object *	ob,
		KeyBlock *	kb,
		const float(*)	ofs[3]
	)

Definition at line 2473 of file key.c.

References Freestyle::a, add_v3_v3(), KeyBlock::data, Object::data, ELEM, ListBase::first, KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, Curve::nurb, OB_CURVE, OB_LATTICE, OB_MESH, OB_SURF, KeyBlock::totelem, and Object::type.

Referenced by SCULPT_vertcos_to_key().

BKE_keyblock_update_from_vertcos()

void BKE_keyblock_update_from_vertcos	(	Object *	ob,
		KeyBlock *	kb,
		const float(*)	vertCos[3]
	)

Definition at line 2320 of file key.c.

References Freestyle::a, BKE_keyblock_curve_element_count(), BLI_assert, copy_v3_v3(), KeyBlock::data, Object::data, ELEM, ListBase::first, float(), KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, Curve::nurb, OB_CURVE, OB_LATTICE, OB_MESH, OB_SURF, Lattice::pntsu, Lattice::pntsv, Lattice::pntsw, KeyBlock::totelem, Mesh::totvert, and Object::type.

Referenced by BKE_keyblock_convert_from_vertcos(), and SCULPT_vertcos_to_key().

cp_cu_key()

static void cp_cu_key ( Curve *  cu, Key *  key, KeyBlock *  actkb, KeyBlock *  kb, const int  start, int  end, char *  out, const int  tot  )

static

Definition at line 834 of file key.c.

References Freestyle::a, Nurb::bezt, Nurb::bp, cp_key(), ListBase::first, KEY_MODE_BEZTRIPLE, KEY_MODE_BPOINT, KEYELEM_ELEM_LEN_BEZTRIPLE, KEYELEM_ELEM_LEN_BPOINT, max_ii(), min_ii(), Nurb::next, NULL, Curve::nurb, Nurb::pntsu, and Nurb::pntsv.

Referenced by BKE_key_evaluate_object_ex(), and do_curve_key().

cp_key()

static void cp_key ( const int  start, int  end, const int  tot, char *  poin, Key *  key, KeyBlock *  actkb, KeyBlock *  kb, float *  weights, const int  mode  )

static

Definition at line 697 of file key.c.

References Freestyle::a, BLI_assert, Key::elemsize, Key::elemstr, float(), floor(), IPO_BEZTRIPLE, IPO_BPOINT, IPO_FLOAT, key_block_get_data(), KEY_MODE_BEZTRIPLE, key_pointer_size(), KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, KEYELEM_FLOAT_LEN_COORD, MEM_freeN, Key::refkey, rel_flerp(), and KeyBlock::totelem.

Referenced by BKE_key_evaluate_object_ex(), cp_cu_key(), do_latt_key(), do_mesh_key(), and key_evaluate_relative().

do_cu_key()

static void do_cu_key ( Curve *  cu, Key *  key, KeyBlock *  actkb, KeyBlock **  k, float *  t, char *  out, const int  tot  )

static

Definition at line 1422 of file key.c.

References Freestyle::a, Nurb::bezt, Nurb::bp, do_key(), ListBase::first, KEY_MODE_BEZTRIPLE, KEY_MODE_BPOINT, KEYELEM_ELEM_LEN_BEZTRIPLE, KEYELEM_ELEM_LEN_BPOINT, Nurb::next, Curve::nurb, Nurb::pntsu, Nurb::pntsv, and t.

Referenced by do_curve_key().

do_curve_key()

static void do_curve_key ( Object *  ob, Key *  key, char *  out, const int  tot  )

static

Definition at line 1463 of file key.c.

References BKE_keyblock_from_object(), Key::block, cp_cu_key(), Key::ctime, Object::data, do_cu_key(), do_rel_cu_key(), Curve::key, KEY_RELATIVE, setkeys(), t, and Key::type.

Referenced by BKE_key_evaluate_object_ex().

do_key()

static void do_key ( const int  start, int  end, const int  tot, char *  poin, Key *  key, KeyBlock *  actkb, KeyBlock **  k, float *  t, const int  mode  )

static

Definition at line 1006 of file key.c.

References Freestyle::a, BLI_assert, Key::elemsize, Key::elemstr, flerp(), float(), floor(), IPO_BEZTRIPLE, IPO_BPOINT, IPO_FLOAT, key_block_get_data(), KEY_MODE_BEZTRIPLE, key_pointer_size(), KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, KEYELEM_FLOAT_LEN_COORD, MEM_freeN, t, and KeyBlock::totelem.

Referenced by do_cu_key(), do_latt_key(), and do_mesh_key().

do_latt_key()

static void do_latt_key ( Object *  ob, Key *  key, char *  out, const int  tot  )

static

Definition at line 1487 of file key.c.

References BKE_keyblock_from_object(), Key::block, cp_key(), Key::ctime, Object::data, do_key(), Lattice::flag, key_evaluate_relative(), KEY_MODE_DUMMY, KEY_RELATIVE, keyblock_free_per_block_weights(), keyblock_get_per_block_weights(), LT_OUTSIDE, NULL, outside_lattice(), setkeys(), t, and Key::type.

Referenced by BKE_key_evaluate_object_ex().

do_mesh_key()

static void do_mesh_key ( Object *  ob, Key *  key, char *  out, const int  tot  )

static

Definition at line 1394 of file key.c.

References BKE_keyblock_from_object(), Key::block, cp_key(), Key::ctime, do_key(), key_evaluate_relative(), KEY_MODE_DUMMY, KEY_RELATIVE, keyblock_free_per_block_weights(), keyblock_get_per_block_weights(), NULL, setkeys(), t, and Key::type.

Referenced by BKE_key_evaluate_object_ex().

do_rel_cu_key()

static void do_rel_cu_key ( Curve *  cu, Key *  key, KeyBlock *  actkb, char *  out, const int  tot  )

static

Definition at line 1443 of file key.c.

References Freestyle::a, Nurb::bezt, Nurb::bp, ListBase::first, key_evaluate_relative(), KEY_MODE_BEZTRIPLE, KEY_MODE_BPOINT, KEYELEM_ELEM_LEN_BEZTRIPLE, KEYELEM_ELEM_LEN_BPOINT, Nurb::next, NULL, Curve::nurb, Nurb::pntsu, and Nurb::pntsv.

Referenced by do_curve_key().

flerp()

static void flerp ( int  tot, float *  in, const float *  f0, const float *  f1, const float *  f2, const float *  f3, const float *  t  )

static

Definition at line 603 of file key.c.

References Freestyle::a, and t.

Referenced by do_key().

get_weights_array()

static float* get_weights_array ( Object *  ob, char *  vgroup, WeightsArrayCache *  cache  )

static

Definition at line 1273 of file key.c.

References BKE_defvert_find_weight(), BKE_object_defgroup_name_index(), BLI_listbase_count(), BMEditMesh::bm, BM_ELEM_CD_GET_VOID_P, BM_ITER_MESH_INDEX, BM_VERTS_OF_MESH, CD_MDEFORMVERT, CustomData_get_offset(), Object::data, Object::defbase, WeightsArrayCache::defgroup_weights, Lattice::dvert, Mesh::dvert, Mesh::edit_mesh, MEM_callocN, MEM_mallocN, NULL, WeightsArrayCache::num_defgroup_weights, OB_LATTICE, OB_MESH, Lattice::pntsu, Lattice::pntsv, Lattice::pntsw, BMesh::totvert, Mesh::totvert, Object::type, and BMesh::vdata.

Referenced by BKE_key_evaluate_object_ex(), and keyblock_get_per_block_weights().

key_block_get_data()

static char* key_block_get_data ( Key *  key, KeyBlock *  actkb, KeyBlock *  kb, char **  freedata  )

static

Definition at line 627 of file key.c.

References Freestyle::a, BMEditMesh::bm, BM_ITER_MESH, BM_VERTS_OF_MESH, BMVert::co, copy_v3_v3(), KeyBlock::data, Mesh::edit_mesh, float(), Key::from, GS, ID_ME, if(), MEM_mallocN, ID::name, NULL, KeyBlock::totelem, and BMesh::totvert.

Referenced by cp_key(), do_key(), and key_evaluate_relative().

key_curve_normal_weights()

void key_curve_normal_weights	(	float	t,
		float	data[4],
		int	type
	)

Definition at line 429 of file key.c.

References data, KEY_BSPLINE, KEY_CARDINAL, KEY_CATMULL_ROM, KEY_LINEAR, t, and type.

key_curve_position_weights()

void key_curve_position_weights	(	float	t,
		float	data[4],
		int	type
	)

Definition at line 348 of file key.c.

References data, KEY_BSPLINE, KEY_CARDINAL, KEY_CATMULL_ROM, KEY_LINEAR, t, and type.

Referenced by BKE_colorband_evaluate(), BKE_lattice_deform_data_eval_co(), BKE_where_on_path(), psys_interpolate_particle(), setkeys(), subdiv_mesh_vertex_of_loose_edge(), and tilt_bezpart().

key_curve_tangent_weights()

void key_curve_tangent_weights	(	float	t,
		float	data[4],
		int	type
	)

Definition at line 390 of file key.c.

References data, KEY_BSPLINE, KEY_CARDINAL, KEY_CATMULL_ROM, KEY_LINEAR, t, and type.

Referenced by BKE_where_on_path().

key_evaluate_relative()

static void key_evaluate_relative ( const int  start, int  end, const int  tot, char *  basispoin, Key *  key, KeyBlock *  actkb, float **  per_keyblock_weights, const int  mode  )

static

Definition at line 874 of file key.c.

References BLI_assert, BLI_findlink(), Key::block, cp_key(), KeyBlock::curval, KeyBlock::data, Key::elemsize, Key::elemstr, ListBase::first, KeyBlock::flag, from, IPO_BEZTRIPLE, IPO_BPOINT, IPO_FLOAT, key_block_get_data(), KEY_MODE_BEZTRIPLE, key_pointer_size(), KEYBLOCK_MUTE, KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, KEYELEM_FLOAT_LEN_COORD, MEM_freeN, KeyBlock::next, NULL, Key::refkey, rel_flerp(), KeyBlock::relative, and KeyBlock::totelem.

Referenced by do_latt_key(), do_mesh_key(), and do_rel_cu_key().

key_pointer_size()

static bool key_pointer_size ( const Key *  key, const int  mode, int *  poinsize, int *  ofs, int *  step  )

static

Definition at line 661 of file key.c.

References BLI_assert, Key::from, GS, ID_CU, ID_LT, ID_ME, KEY_MODE_BPOINT, KEYELEM_ELEM_LEN_BEZTRIPLE, KEYELEM_ELEM_LEN_BPOINT, KEYELEM_ELEM_SIZE_CURVE, KEYELEM_FLOAT_LEN_BEZTRIPLE, KEYELEM_FLOAT_LEN_BPOINT, KEYELEM_FLOAT_LEN_COORD, ID::name, and NULL.

Referenced by cp_key(), do_key(), and key_evaluate_relative().

keyblock_free_per_block_weights()

static void keyblock_free_per_block_weights ( Key *  key, float **  per_keyblock_weights, WeightsArrayCache *  cache  )

static

Definition at line 1366 of file key.c.

References Freestyle::a, WeightsArrayCache::defgroup_weights, MEM_freeN, NULL, WeightsArrayCache::num_defgroup_weights, and Key::totkey.

Referenced by do_latt_key(), and do_mesh_key().

keyblock_get_per_block_weights()

static float** keyblock_get_per_block_weights ( Object *  ob, Key *  key, WeightsArrayCache *  cache  )

static

Definition at line 1349 of file key.c.

References Key::block, ListBase::first, get_weights_array(), MEM_mallocN, KeyBlock::next, Key::totkey, and KeyBlock::vgroup.

Referenced by do_latt_key(), and do_mesh_key().

rel_flerp()

static void rel_flerp ( int  tot, float *  in, const float *  ref, const float *  out, float  fac  )

static

Definition at line 618 of file key.c.

References Freestyle::a.

Referenced by cp_key(), and key_evaluate_relative().

setkeys()

static int setkeys ( float  fac, ListBase *  lb, KeyBlock *  k[], float  t[4], int  cycl  )

static

Definition at line 463 of file key.c.

References ListBase::first, interp_v4_v4v4(), KEY_BSPLINE, key_curve_position_weights(), ListBase::last, KeyBlock::next, NULL, pos, KeyBlock::pos, t, and type.

Referenced by do_curve_key(), do_latt_key(), and do_mesh_key().

shapekey_blend_read_data()

static void shapekey_blend_read_data ( BlendDataReader *  reader, ID *  id  )

static

Definition at line 169 of file key.c.

References Key::adt, BKE_animdata_blend_read_data(), BLO_read_data_address, BLO_read_list(), BLO_read_requires_endian_switch(), Key::block, LISTBASE_FOREACH, Key::refkey, and switch_endian_keyblock().

shapekey_blend_read_expand()

static void shapekey_blend_read_expand ( BlendExpander *  expander, ID *  id  )

static

Definition at line 197 of file key.c.

References BLO_expand.

shapekey_blend_read_lib()

static void shapekey_blend_read_lib ( BlendLibReader *  reader, ID *  id  )

static

Definition at line 188 of file key.c.

References BLI_assert, BLO_read_id_address, Key::from, Key::id, ID::lib, LIB_TAG_EXTERN, and ID::tag.

shapekey_blend_write()

static void shapekey_blend_write ( BlendWriter *  writer, ID *  id, const void *  id_address  )

static

Definition at line 108 of file key.c.

References Key::adt, BKE_animdata_blend_write(), BKE_id_blend_write(), BLO_write_id_struct, BLO_write_is_undo(), BLO_write_raw(), BLO_write_struct_at_address, Key::block, KeyBlock::data, Key::elemsize, Key::id, ID_IS_OVERRIDE_LIBRARY, LISTBASE_FOREACH, NULL, KeyBlock::totelem, and ID::us.

shapekey_copy_data()

static void shapekey_copy_data ( Main *  UNUSEDbmain, ID *  id_dst, const ID *  id_src, const int   UNUSEDflag  )

static

Definition at line 68 of file key.c.

References BLI_duplicatelist(), Key::block, KeyBlock::data, ListBase::first, MEM_dupallocN, KeyBlock::next, and Key::refkey.

shapekey_foreach_id()

static void shapekey_foreach_id ( ID *  id, LibraryForeachIDData *  data  )

static

Definition at line 102 of file key.c.

References BKE_LIB_FOREACHID_PROCESS_ID, data, Key::from, and IDWALK_CB_LOOPBACK.

shapekey_free_data()

static void shapekey_free_data ( ID *  id )

static

Definition at line 89 of file key.c.

References BLI_pophead(), Key::block, KeyBlock::data, and MEM_freeN.

Referenced by BKE_key_free().

switch_endian_keyblock()

static void switch_endian_keyblock ( Key *  key, KeyBlock *  kb  )

static

Definition at line 142 of file key.c.

References Freestyle::a, BLI_endian_switch_float_array(), data, KeyBlock::data, Key::elemsize, Key::elemstr, float(), IPO_BEZTRIPLE, IPO_BPOINT, IPO_FLOAT, and KeyBlock::totelem.

Referenced by shapekey_blend_read_data().

Variable Documentation

IDType_ID_KE

IDTypeInfo IDType_ID_KE

Initial value:

= {
    .id_code = ID_KE,
    .id_filter = 0,
    .main_listbase_index = INDEX_ID_KE,
    .struct_size = sizeof(Key),
    .name = "Key",
    .name_plural = "shape_keys",
    .translation_context = BLT_I18NCONTEXT_ID_SHAPEKEY,
    .flags = IDTYPE_FLAGS_NO_LIBLINKING | IDTYPE_FLAGS_NO_MAKELOCAL,
 
    .init_data = NULL,
    .copy_data = shapekey_copy_data,
    .free_data = shapekey_free_data,
    .make_local = NULL,
    .foreach_id = shapekey_foreach_id,
    .foreach_cache = NULL,
    .owner_get = NULL, 
 
    .blend_write = shapekey_blend_write,
    .blend_read_data = shapekey_blend_read_data,
    .blend_read_lib = shapekey_blend_read_lib,
    .blend_read_expand = shapekey_blend_read_expand,
 
    .blend_read_undo_preserve = NULL,
 
    .lib_override_apply_post = NULL,
}

Definition at line 203 of file key.c.