Kévin Dietrich
0a08ac2528
Override layers are a standard feature of Alembic, where archives can override data from other archives, provided that the hierarchies match. This is useful for modifying a UV map, updating an animation, or even creating some sort of LOD system where low resolution meshes are swapped by high resolution versions. It is possible to add UV maps and vertex colors using this system, however, they will only appear in the spreadsheet editor when viewing evaluated data, as the UV map and Vertex color UI only show data present on the original mesh. Implementation wise, this adds a `CacheFileLayer` data structure to the `CacheFile` DNA, as well as some operators and UI to present and manage the layers. For both the Alembic importer and the Cycles procedural, the main change is creating an archive from a list of filepaths, instead of a single one. After importing the base file through the regular import operator, layers can be added to or removed from the `CacheFile` via the UI list under the `Override Layers` panel located in the Mesh Sequence Cache modifier. Layers can also be moved around or hidden. See differential page for tests files and demos. Reviewed by: brecht, sybren Differential Revision: https://developer.blender.org/D13603
85 lines
3.1 KiB
C++
85 lines
3.1 KiB
C++
/*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*
|
|
* The Original Code is Copyright (C) 2016 Blender Foundation.
|
|
* All rights reserved.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bke
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct CacheFile;
|
|
struct CacheFileLayer;
|
|
struct CacheReader;
|
|
struct Depsgraph;
|
|
struct Main;
|
|
struct Object;
|
|
struct Scene;
|
|
|
|
void BKE_cachefiles_init(void);
|
|
void BKE_cachefiles_exit(void);
|
|
|
|
void *BKE_cachefile_add(struct Main *bmain, const char *name);
|
|
|
|
void BKE_cachefile_reload(struct Depsgraph *depsgraph, struct CacheFile *cache_file);
|
|
|
|
void BKE_cachefile_eval(struct Main *bmain,
|
|
struct Depsgraph *depsgraph,
|
|
struct CacheFile *cache_file);
|
|
|
|
bool BKE_cachefile_filepath_get(const struct Main *bmain,
|
|
const struct Depsgraph *depsgrah,
|
|
const struct CacheFile *cache_file,
|
|
char r_filename[1024]);
|
|
|
|
float BKE_cachefile_time_offset(const struct CacheFile *cache_file, float time, float fps);
|
|
|
|
/* Modifiers and constraints open and free readers through these. */
|
|
void BKE_cachefile_reader_open(struct CacheFile *cache_file,
|
|
struct CacheReader **reader,
|
|
struct Object *object,
|
|
const char *object_path);
|
|
void BKE_cachefile_reader_free(struct CacheFile *cache_file, struct CacheReader **reader);
|
|
|
|
/**
|
|
* Determine whether the #CacheFile should use a render engine procedural. If so, data is not read
|
|
* from the file and bounding boxes are used to represent the objects in the Scene.
|
|
* Render engines will receive the bounding box as a placeholder but can instead
|
|
* load the data directly if they support it.
|
|
*/
|
|
bool BKE_cache_file_uses_render_procedural(const struct CacheFile *cache_file,
|
|
struct Scene *scene,
|
|
int dag_eval_mode);
|
|
|
|
/* Add a layer to the cache_file. Return NULL if the filename is already that of an existing layer
|
|
* or if the number of layers exceeds the maximum allowed layer count. */
|
|
struct CacheFileLayer *BKE_cachefile_add_layer(struct CacheFile *cache_file,
|
|
const char filename[1024]);
|
|
|
|
struct CacheFileLayer *BKE_cachefile_get_active_layer(struct CacheFile *cache_file);
|
|
|
|
void BKE_cachefile_remove_layer(struct CacheFile *cache_file, struct CacheFileLayer *layer);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|