Blender V4.3
multires.cc File Reference
#include "MEM_guardedalloc.h"
#include "DNA_mesh_types.h"
#include "DNA_meshdata_types.h"
#include "DNA_object_types.h"
#include "DNA_scene_types.h"
#include "BLI_bitmap.h"
#include "BLI_math_matrix.h"
#include "BLI_task.h"
#include "BLI_utildefines.h"
#include "BKE_ccg.hh"
#include "BKE_editmesh.hh"
#include "BKE_mesh.hh"
#include "BKE_mesh_legacy_derived_mesh.hh"
#include "BKE_mesh_runtime.hh"
#include "BKE_modifier.hh"
#include "BKE_multires.hh"
#include "BKE_paint.hh"
#include "BKE_pbvh_api.hh"
#include "BKE_scene.hh"
#include "BKE_subdiv_ccg.hh"
#include "BKE_subsurf.hh"
#include "BKE_object.hh"
#include "CCGSubSurf.h"
#include "DEG_depsgraph_query.hh"
#include <cmath>
#include <cstring>

Go to the source code of this file.

Classes

struct  MultiresThreadedData
 

Macros

#define DNA_DEPRECATED_ALLOW
 

Enumerations

enum  DispOp { APPLY_DISPLACEMENTS , CALC_DISPLACEMENTS , ADD_DISPLACEMENTS }
 

Functions

static void multiresModifier_disp_run (DerivedMesh *dm, Mesh *mesh, DerivedMesh *dm2, DispOp op, CCGElem **oldGridData, int totlvl)
 
void multires_customdata_delete (Mesh *mesh)
 
static BLI_bitmapmultires_mdisps_upsample_hidden (BLI_bitmap *lo_hidden, int lo_level, int hi_level, const BLI_bitmap *prev_hidden)
 
static BLI_bitmapmultires_mdisps_downsample_hidden (const BLI_bitmap *old_hidden, int old_level, int new_level)
 
static void multires_output_hidden_to_ccgdm (CCGDerivedMesh *ccgdm, Mesh *mesh, int level)
 
static void multires_mdisps_subdivide_hidden (MDisps *md, int new_level)
 
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)
 
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)
 
void multires_set_tot_level (Object *ob, MultiresModifierData *mmd, int lvl)
 
static void multires_ccg_mark_as_modified (SubdivCCG *subdiv_ccg, MultiresModifiedFlags flags)
 
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)
 
static int get_levels_from_disps (Object *ob)
 
void multiresModifier_set_levels_from_disps (MultiresModifierData *mmd, Object *ob)
 
static void multires_set_tot_mdisps (Mesh *mesh, int lvl)
 
static void multires_reallocate_mdisps (int totloop, MDisps *mdisps, int lvl)
 
static void multires_copy_grid (float(*gridA)[3], float(*gridB)[3], int sizeA, int sizeB)
 
static void multires_copy_dm_grid (CCGElem *gridA, CCGElem *gridB, CCGKey *keyA, CCGKey *keyB)
 
static void multires_grid_paint_mask_downsample (GridPaintMask *gpm, int level)
 
static void multires_del_higher (MultiresModifierData *mmd, Object *ob, int lvl)
 
void multiresModifier_del_levels (MultiresModifierData *mmd, Scene *scene, Object *ob, int direction)
 
static DerivedMeshmultires_dm_create_local (Scene *scene, Object *ob, DerivedMesh *dm, int lvl, int totlvl, bool alloc_paint_mask, MultiresFlags flags)
 
static DerivedMeshsubsurf_dm_create_local (Scene *scene, Object *ob, DerivedMesh *dm, int lvl, bool is_simple, bool is_optimal, bool is_plain_uv, bool alloc_paint_mask, bool for_render, SubsurfFlags flags)
 
static void grid_tangent (const CCGKey &key, int x, int y, int axis, CCGElem *grid, float t[3])
 
static void grid_tangent_matrix (float mat[3][3], const CCGKey &key, int x, int y, CCGElem *grid)
 
static void multires_disp_run_cb (void *__restrict userdata, const int pidx, const TaskParallelTLS *__restrict)
 
void multires_modifier_update_mdisps (DerivedMesh *dm, Scene *scene)
 
void multires_modifier_update_hidden (DerivedMesh *dm)
 
void multires_stitch_grids (Object *ob)
 
DerivedMeshmultires_make_derived_from_derived (DerivedMesh *dm, MultiresModifierData *mmd, Scene *scene, Object *ob, MultiresFlags flags)
 
void old_mdisps_bilinear (float out[3], float(*disps)[3], const int st, float u, float v)
 
void multiresModifier_sync_levels_ex (Object *ob_dst, const MultiresModifierData *mmd_src, MultiresModifierData *mmd_dst)
 
static void multires_sync_levels (Scene *scene, Object *ob_src, Object *ob_dst)
 
static void multires_apply_uniform_scale (Object *object, const float scale)
 
static void multires_apply_smat (Depsgraph *, Scene *scene, Object *object, const float smat[3][3])
 
int multires_mdisp_corners (const MDisps *s)
 
void multiresModifier_scale_disp (Depsgraph *depsgraph, Scene *scene, Object *ob)
 
void multiresModifier_prepare_join (Depsgraph *depsgraph, Scene *scene, Object *ob, Object *to_ob)
 
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)
 
int mdisp_rot_face_to_crn (const int face_size, const int face_side, const float u, const float v, float *x, float *y)
 

Variables

static const int multires_grid_tot []
 
static const int multires_side_tot []
 

Macro Definition Documentation

◆ DNA_DEPRECATED_ALLOW

#define DNA_DEPRECATED_ALLOW

Definition at line 12 of file multires.cc.

Enumeration Type Documentation

◆ DispOp

enum DispOp
Enumerator
APPLY_DISPLACEMENTS 
CALC_DISPLACEMENTS 
ADD_DISPLACEMENTS 

Definition at line 53 of file multires.cc.

Function Documentation

◆ BKE_multires_create_deformed_base_mesh_vert_coords()

◆ BKE_multires_create_mesh()

◆ find_multires_modifier_before()

◆ get_levels_from_disps()

static int get_levels_from_disps ( Object * ob)
static

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

◆ grid_tangent()

static void grid_tangent ( const CCGKey & key,
int x,
int y,
int axis,
CCGElem * grid,
float t[3] )
static

Definition at line 791 of file multires.cc.

References CCG_grid_elem_co(), CCGKey::grid_size, and sub_v3_v3v3().

Referenced by grid_tangent_matrix().

◆ grid_tangent_matrix()

static void grid_tangent_matrix ( float mat[3][3],
const CCGKey & key,
int x,
int y,
CCGElem * grid )
static

Definition at line 824 of file multires.cc.

References CCG_grid_elem_no(), copy_v3_v3(), grid_tangent(), and normalize_v3().

Referenced by multires_disp_run_cb().

◆ 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_apply_smat()

◆ multires_apply_uniform_scale()

static void multires_apply_uniform_scale ( Object * object,
const float scale )
static

Definition at line 1377 of file multires.cc.

References CD_MDISPS, CustomData_get_layer_for_write(), and mul_v3_fl().

Referenced by multires_apply_smat().

◆ multires_ccg_mark_as_modified()

static void multires_ccg_mark_as_modified ( SubdivCCG * subdiv_ccg,
MultiresModifiedFlags flags )
static

◆ multires_copy_dm_grid()

static void multires_copy_dm_grid ( CCGElem * gridA,
CCGElem * gridB,
CCGKey * keyA,
CCGKey * keyB )
static

Definition at line 591 of file multires.cc.

References CCG_elem_offset_co(), CCGKey::elem_size, CCGKey::grid_size, x, and y.

Referenced by multires_modifier_update_mdisps().

◆ multires_copy_grid()

static void multires_copy_grid ( float(*) gridA[3],
float(*) gridB[3],
int sizeA,
int sizeB )
static

Definition at line 567 of file multires.cc.

References copy_v3_v3(), x, and y.

Referenced by multires_del_higher().

◆ multires_customdata_delete()

◆ multires_del_higher()

◆ multires_disp_run_cb()

◆ multires_dm_create_local()

static DerivedMesh * multires_dm_create_local ( Scene * scene,
Object * ob,
DerivedMesh * dm,
int lvl,
int totlvl,
bool alloc_paint_mask,
MultiresFlags flags )
static

◆ 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_grid_paint_mask_downsample()

static void multires_grid_paint_mask_downsample ( GridPaintMask * gpm,
int level )
static

◆ 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_mdisps_downsample_hidden()

static BLI_bitmap * multires_mdisps_downsample_hidden ( const BLI_bitmap * old_hidden,
int old_level,
int new_level )
static

◆ multires_mdisps_subdivide_hidden()

static void multires_mdisps_subdivide_hidden ( MDisps * md,
int new_level )
static

◆ multires_mdisps_upsample_hidden()

static BLI_bitmap * multires_mdisps_upsample_hidden ( BLI_bitmap * lo_hidden,
int lo_level,
int hi_level,
const BLI_bitmap * prev_hidden )
static

◆ multires_modifier_update_hidden()

◆ multires_modifier_update_mdisps()

◆ multires_output_hidden_to_ccgdm()

static void multires_output_hidden_to_ccgdm ( CCGDerivedMesh * ccgdm,
Mesh * mesh,
int level )
static

◆ multires_reallocate_mdisps()

static void multires_reallocate_mdisps ( int totloop,
MDisps * mdisps,
int lvl )
static

◆ multires_set_tot_level()

◆ multires_set_tot_mdisps()

◆ multires_stitch_grids()

◆ multires_sync_levels()

static void multires_sync_levels ( Scene * scene,
Object * ob_src,
Object * ob_dst )
static

◆ 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_del_levels()

◆ multiresModifier_disp_run()

◆ multiresModifier_ensure_external_read()

◆ multiresModifier_prepare_join()

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

◆ 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_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],
const 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().

◆ subsurf_dm_create_local()

Variable Documentation

◆ multires_grid_tot

const int multires_grid_tot[]
static
Initial value:
= {
0, 4, 9, 25, 81, 289, 1089, 4225, 16641, 66049, 263169, 1050625, 4198401, 16785409}

Definition at line 47 of file multires.cc.

Referenced by multires_del_higher(), multires_ensure_external_read(), multires_reallocate_mdisps(), and multires_set_tot_mdisps().

◆ multires_side_tot

const int multires_side_tot[]
static
Initial value:
= {
0, 2, 3, 5, 9, 17, 33, 65, 129, 257, 513, 1025, 2049, 4097}

Definition at line 49 of file multires.cc.

Referenced by multires_del_higher(), and multiresModifier_disp_run().