Blender V4.3
BKE_multires.hh File Reference

Go to the source code of this file.

Namespaces

namespace  blender
 
namespace  blender::bke
 
namespace  blender::bke::subdiv
 

Enumerations

enum  MultiresFlags { MULTIRES_USE_LOCAL_MMD = 1 , MULTIRES_USE_RENDER_PARAMS = 2 , MULTIRES_ALLOC_PAINT_MASK = 4 , MULTIRES_IGNORE_SIMPLIFY = 8 }
 
enum  eMultiresSubdivideModeType { MULTIRES_SUBDIVIDE_CATMULL_CLARK , MULTIRES_SUBDIVIDE_SIMPLE , MULTIRES_SUBDIVIDE_LINEAR }
 

Functions

void multires_customdata_delete (Mesh *mesh)
 
void multires_set_tot_level (Object *ob, MultiresModifierData *mmd, int lvl)
 
void multires_mark_as_modified (Depsgraph *depsgraph, Object *object, MultiresModifiedFlags flags)
 
void multires_flush_sculpt_updates (Object *object)
 
void multires_force_sculpt_rebuild (Object *object)
 
void multires_force_external_reload (Object *object)
 
void multires_modifier_update_mdisps (DerivedMesh *dm, Scene *scene)
 
void multires_modifier_update_hidden (DerivedMesh *dm)
 
void multiresModifier_set_levels_from_disps (MultiresModifierData *mmd, Object *ob)
 
 ENUM_OPERATORS (MultiresFlags, MULTIRES_IGNORE_SIMPLIFY)
 
DerivedMeshmultires_make_derived_from_derived (DerivedMesh *dm, MultiresModifierData *mmd, Scene *scene, Object *ob, MultiresFlags flags)
 
MultiresModifierDatafind_multires_modifier_before (Scene *scene, ModifierData *lastmd)
 
MultiresModifierDataget_multires_modifier (Scene *scene, Object *ob, bool use_first)
 
int multires_get_level (const Scene *scene, const Object *ob, const MultiresModifierData *mmd, bool render, bool ignore_simplify)
 
MeshBKE_multires_create_mesh (Depsgraph *depsgraph, Object *object, MultiresModifierData *mmd)
 
blender::Array< blender::float3BKE_multires_create_deformed_base_mesh_vert_coords (Depsgraph *depsgraph, Object *object, MultiresModifierData *mmd)
 
void multiresModifier_del_levels (MultiresModifierData *mmd, Scene *scene, Object *object, int direction)
 
void multiresModifier_base_apply (Depsgraph *depsgraph, Object *object, MultiresModifierData *mmd)
 
int multiresModifier_rebuild_subdiv (Depsgraph *depsgraph, Object *object, MultiresModifierData *mmd, int rebuild_limit, bool switch_view_to_lower_level)
 
void multiresModifier_sync_levels_ex (Object *ob_dst, const MultiresModifierData *mmd_src, MultiresModifierData *mmd_dst)
 
void multires_stitch_grids (Object *)
 
void multiresModifier_scale_disp (Depsgraph *depsgraph, Scene *scene, Object *ob)
 
void multiresModifier_prepare_join (Depsgraph *depsgraph, Scene *scene, Object *ob, Object *to_ob)
 
int multires_mdisp_corners (const MDisps *s)
 
void multires_topology_changed (Mesh *mesh)
 
void multires_ensure_external_read (Mesh *mesh, int top_level)
 
void multiresModifier_ensure_external_read (Mesh *mesh, const MultiresModifierData *mmd)
 
void old_mdisps_bilinear (float out[3], float(*disps)[3], int st, float u, float v)
 
int mdisp_rot_face_to_crn (int face_size, int face_side, float u, float v, float *x, float *y)
 
bool multiresModifier_reshapeFromVertcos (Depsgraph *depsgraph, Object *object, MultiresModifierData *mmd, const float(*vert_coords)[3], int num_vert_coords)
 
bool multiresModifier_reshapeFromObject (Depsgraph *depsgraph, MultiresModifierData *mmd, Object *dst, Object *src)
 
bool multiresModifier_reshapeFromDeformModifier (Depsgraph *depsgraph, Object *ob, MultiresModifierData *mmd, ModifierData *deform_md)
 
bool multiresModifier_reshapeFromCCG (int tot_level, Mesh *coarse_mesh, SubdivCCG *subdiv_ccg)
 
void multiresModifier_subdivide (Object *object, MultiresModifierData *mmd, eMultiresSubdivideModeType mode)
 
void multires_subdivide_create_tangent_displacement_linear_grids (Object *object, MultiresModifierData *mmd)
 
void multiresModifier_subdivide_to_level (Object *object, MultiresModifierData *mmd, int top_level, eMultiresSubdivideModeType mode)
 
void BKE_multires_subdiv_settings_init (blender::bke::subdiv::Settings *settings, const MultiresModifierData *mmd)
 
void BKE_multires_subdiv_mesh_settings_init (blender::bke::subdiv::ToMeshSettings *mesh_settings, const Scene *scene, const Object *object, const MultiresModifierData *mmd, bool use_render_params, bool ignore_simplify, bool ignore_control_edges)
 
BLI_INLINE void BKE_multires_construct_tangent_matrix (float tangent_matrix[3][3], const float dPdu[3], const float dPdv[3], int corner)
 
void multires_do_versions_simple_to_catmull_clark (Object *object, MultiresModifierData *mmd)
 

Enumeration Type Documentation

◆ eMultiresSubdivideModeType

Enumerator
MULTIRES_SUBDIVIDE_CATMULL_CLARK 
MULTIRES_SUBDIVIDE_SIMPLE 
MULTIRES_SUBDIVIDE_LINEAR 

Definition at line 162 of file BKE_multires.hh.

◆ MultiresFlags

Enumerator
MULTIRES_USE_LOCAL_MMD 
MULTIRES_USE_RENDER_PARAMS 
MULTIRES_ALLOC_PAINT_MASK 
MULTIRES_IGNORE_SIMPLIFY 

Definition at line 50 of file BKE_multires.hh.

Function Documentation

◆ BKE_multires_construct_tangent_matrix()

BLI_INLINE void BKE_multires_construct_tangent_matrix ( float tangent_matrix[3][3],
const float dPdu[3],
const float dPdv[3],
int corner )

For a given partial derivatives of a PTEX face get tangent matrix for displacement.

Corner needs to be known to properly "rotate" partial derivatives when the matrix is being constructed for quad. For non-quad the corner is to be set to 0.

Definition at line 15 of file multires_inline.hh.

References BLI_assert_msg, copy_v3_v3(), cross_v3_v3v3(), mul_v3_fl(), and normalize_v3().

Referenced by blender::bke::subdiv::average_construct_tangent_matrix(), blender::bke::subdiv::eval_displacement(), and multires_reshape_tangent_matrix_for_corner().

◆ BKE_multires_create_deformed_base_mesh_vert_coords()

◆ BKE_multires_create_mesh()

◆ BKE_multires_subdiv_mesh_settings_init()

void BKE_multires_subdiv_mesh_settings_init ( blender::bke::subdiv::ToMeshSettings * mesh_settings,
const Scene * scene,
const Object * object,
const MultiresModifierData * mmd,
bool use_render_params,
bool ignore_simplify,
bool ignore_control_edges )

◆ BKE_multires_subdiv_settings_init()

◆ ENUM_OPERATORS()

ENUM_OPERATORS ( MultiresFlags ,
MULTIRES_IGNORE_SIMPLIFY  )

◆ find_multires_modifier_before()

◆ get_multires_modifier()

MultiresModifierData * get_multires_modifier ( Scene * scene,
Object * ob,
bool use_first )

used for applying scale on mdisps layer and syncing subdivide levels when joining objects.

Parameters
use_firstreturn first multi-res modifier if all multi-res'es are disabled.

Definition at line 304 of file multires.cc.

References BKE_modifier_is_enabled(), eModifierMode_Realtime, eModifierType_Multires, LISTBASE_FOREACH, and Object::modifiers.

Referenced by BKE_sculpt_get_first_deform_matrices(), join_mesh_single(), multires_apply_smat(), multires_sync_levels(), blender::ed::object::multiresbake_check(), blender::ed::object::multiresbake_create_hiresdm(), and blender::ed::object::multiresbake_create_loresdm().

◆ mdisp_rot_face_to_crn()

int mdisp_rot_face_to_crn ( int face_size,
int face_side,
float u,
float v,
float * x,
float * y )

Find per-corner coordinate with given per-face UV coord.

Definition at line 1531 of file multires.cc.

References FLT_MAX, len, len_v3v3(), v, and w().

Referenced by get_ccgdm_data().

◆ multires_customdata_delete()

◆ multires_do_versions_simple_to_catmull_clark()

◆ multires_ensure_external_read()

void multires_ensure_external_read ( Mesh * mesh,
int top_level )

Makes sure data from an external file is fully read.

Since the multi-res data files only contain displacement vectors without knowledge about subdivision level some extra work is needed. Namely make is to all displacement grids have proper level and number of displacement vectors set.

Definition at line 1492 of file multires.cc.

References CD_MASK_MDISPS, CD_MDISPS, CD_SET_DEFAULT, CustomData_add_layer(), CustomData_external_read(), CustomData_external_test(), CustomData_get_layer(), MDisps::level, MEM_SAFE_FREE, multires_grid_tot, and MDisps::totdisp.

Referenced by multiresModifier_ensure_external_read(), and multiresModifier_reshapeFromCCG().

◆ multires_flush_sculpt_updates()

◆ multires_force_external_reload()

void multires_force_external_reload ( Object * object)

◆ multires_force_sculpt_rebuild()

◆ multires_get_level()

◆ multires_make_derived_from_derived()

◆ multires_mark_as_modified()

◆ multires_mdisp_corners()

int multires_mdisp_corners ( const MDisps * s)

Definition at line 1417 of file multires.cc.

Referenced by bm_corners_to_loops_ex(), and layerSwap_mdisps().

◆ multires_modifier_update_hidden()

◆ multires_modifier_update_mdisps()

◆ multires_set_tot_level()

◆ multires_stitch_grids()

◆ multires_subdivide_create_tangent_displacement_linear_grids()

◆ multires_topology_changed()

void multires_topology_changed ( Mesh * mesh)

Update multi-res data after topology changing.

Definition at line 1456 of file multires.cc.

References CD_MASK_MDISPS, CD_MDISPS, CustomData_external_read(), CustomData_get_layer_for_write(), MDisps::disps, MEM_calloc_arrayN, and MDisps::totdisp.

◆ multiresModifier_base_apply()

◆ multiresModifier_del_levels()

◆ multiresModifier_ensure_external_read()

◆ multiresModifier_prepare_join()

void multiresModifier_prepare_join ( Depsgraph * depsgraph,
Scene * scene,
Object * ob,
Object * to_ob )

◆ multiresModifier_rebuild_subdiv()

◆ multiresModifier_reshapeFromCCG()

◆ multiresModifier_reshapeFromDeformModifier()

◆ multiresModifier_reshapeFromObject()

bool multiresModifier_reshapeFromObject ( Depsgraph * depsgraph,
MultiresModifierData * mmd,
Object * dst,
Object * src )

Returns truth on success, false otherwise.

This function might fail in cases like source and destination not having matched amount of vertices.

Definition at line 54 of file multires_reshape.cc.

References BKE_object_get_evaluated_mesh(), DEG_get_evaluated_object(), depsgraph, multiresModifier_reshapeFromVertcos(), and Mesh::verts_num.

Referenced by blender::ed::object::multires_reshape_exec().

◆ multiresModifier_reshapeFromVertcos()

◆ multiresModifier_scale_disp()

void multiresModifier_scale_disp ( Depsgraph * depsgraph,
Scene * scene,
Object * ob )

◆ multiresModifier_set_levels_from_disps()

void multiresModifier_set_levels_from_disps ( MultiresModifierData * mmd,
Object * ob )

◆ multiresModifier_subdivide()

void multiresModifier_subdivide ( Object * object,
MultiresModifierData * mmd,
eMultiresSubdivideModeType mode )

◆ multiresModifier_subdivide_to_level()

◆ multiresModifier_sync_levels_ex()

void multiresModifier_sync_levels_ex ( Object * ob_dst,
const MultiresModifierData * mmd_src,
MultiresModifierData * mmd_dst )

If ob_src and ob_dst both have multi-res modifiers, synchronize them such that ob_dst has the same total number of levels as ob_src.

Definition at line 1343 of file multires.cc.

References multires_del_higher(), MULTIRES_SUBDIVIDE_CATMULL_CLARK, multiresModifier_subdivide_to_level(), and MultiresModifierData::totlvl.

Referenced by BKE_object_copy_modifier(), and multires_sync_levels().

◆ old_mdisps_bilinear()

void old_mdisps_bilinear ( float out[3],
float(*) disps[3],
int st,
float u,
float v )

Definition at line 1290 of file multires.cc.

References add_v3_v3v3(), floor(), mul_v3_fl(), mul_v3_v3fl(), v, x, and y.

Referenced by loop_interp_multires_cb().