Blender V4.5
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_index_mask.hh"
#include "BLI_listbase.h"
#include "BLI_math_matrix.h"
#include "BLI_task.h"
#include "BKE_ccg.hh"
#include "BKE_editmesh.hh"
#include "BKE_mesh.h"
#include "BKE_mesh_legacy_derived_mesh.hh"
#include "BKE_mesh_runtime.hh"
#include "BKE_mesh_types.hh"
#include "BKE_modifier.hh"
#include "BKE_multires.hh"
#include "BKE_paint.hh"
#include "BKE_paint_bvh.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, const int lo_level, const int hi_level, const BLI_bitmap *prev_hidden)
static BLI_bitmapmultires_mdisps_downsample_hidden (const BLI_bitmap *old_hidden, const int old_level, const int new_level)
static void multires_output_hidden_to_ccgdm (CCGDerivedMesh *ccgdm, Mesh *mesh, const int level)
static void multires_mdisps_subdivide_hidden (MDisps *md, const 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, const bool use_first)
int multires_get_level (const Scene *scene, const Object *ob, const MultiresModifierData *mmd, const bool render, const bool ignore_simplify)
void multires_set_tot_level (Object *ob, MultiresModifierData *mmd, const int lvl)
static void multires_ccg_mark_as_modified (SubdivCCG *subdiv_ccg, const MultiresModifiedFlags flags)
void multires_mark_as_modified (Depsgraph *depsgraph, Object *object, const 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, const int lvl)
static void multires_reallocate_mdisps (const int totloop, MDisps *mdisps, const int lvl)
static void multires_copy_grid (float(*gridA)[3], float(*gridB)[3], const int sizeA, const 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, const int level)
static void multires_del_higher (MultiresModifierData *mmd, Object *ob, const int lvl)
void multiresModifier_del_levels (MultiresModifierData *mmd, Scene *scene, Object *ob, const int direction)
static DerivedMeshmultires_dm_create_local (Scene *scene, Object *ob, DerivedMesh *dm, const int lvl, const int totlvl, const bool alloc_paint_mask, MultiresFlags flags)
static DerivedMeshsubsurf_dm_create_local (Scene *scene, Object *ob, DerivedMesh *dm, const int lvl, const bool is_simple, const bool is_optimal, const bool is_plain_uv, const bool alloc_paint_mask, const bool for_render, SubsurfFlags flags)
static void grid_tangent (const CCGKey &key, const int x, const int y, const int axis, CCGElem *grid, float t[3])
static void grid_tangent_matrix (float mat[3][3], const CCGKey &key, const int x, const 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, const 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, const 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 55 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()

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 296 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()

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

Definition at line 781 of file multires.cc.

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

Referenced by grid_tangent_matrix().

◆ grid_tangent_matrix()

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

Definition at line 815 of file multires.cc.

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

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 1503 of file multires.cc.

References FLT_MAX, i, len, len_v3v3(), v, w(), x, and y.

Referenced by get_ccgdm_data().

◆ multires_apply_smat()

◆ multires_apply_uniform_scale()

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

◆ multires_ccg_mark_as_modified()

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

◆ multires_copy_dm_grid()

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

Definition at line 585 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()

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

Definition at line 558 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()

DerivedMesh * multires_dm_create_local ( Scene * scene,
Object * ob,
DerivedMesh * dm,
const int lvl,
const int totlvl,
const 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 1464 of file multires.cc.

References CD_MASK_MDISPS, CD_MDISPS, CD_SET_DEFAULT, Mesh::corner_data, Mesh::corners_num, CustomData_add_layer(), CustomData_external_read(), CustomData_external_test(), CustomData_get_layer(), i, Mesh::id, 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()

void multires_grid_paint_mask_downsample ( GridPaintMask * gpm,
const 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 1391 of file multires.cc.

References MDisps::totdisp.

Referenced by bm_corners_to_loops_ex(), and layerSwap_mdisps().

◆ multires_mdisps_downsample_hidden()

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

◆ multires_mdisps_subdivide_hidden()

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

◆ multires_mdisps_upsample_hidden()

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

◆ multires_modifier_update_hidden()

◆ multires_modifier_update_mdisps()

◆ multires_output_hidden_to_ccgdm()

◆ multires_reallocate_mdisps()

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

◆ multires_set_tot_level()

◆ multires_set_tot_mdisps()

◆ multires_stitch_grids()

◆ multires_sync_levels()

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

◆ multires_topology_changed()

void multires_topology_changed ( Mesh * mesh)

◆ 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 1317 of file multires.cc.

References CatmullClark, multires_del_higher(), 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 1266 of file multires.cc.

References add_v3_v3v3(), floor, isnan, mul_v3_fl(), mul_v3_v3fl(), out, 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 49 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 51 of file multires.cc.

Referenced by multires_del_higher(), and multiresModifier_disp_run().