Julian Eisel
aa64fd69e7
Having a centeral place to find a list of all library overrides should be useful for managing production scenes where library overrides are used a lot. This change adds the individually overridden properties of a data-block under the data-block itself. Just how we show modifiers, constraints or pose channels there. This way we can also expose library override operations/options better in future. There's also a filter option for the library overrides now, so they can be hidden. It is only available in the View Layer display mode though, like the other filter options. One internal change this has to do is adding more informative return values to undo pushes and the library override functions called by it. That way we can send a notifier when library overrides change for the Outliner to know when to rebuild the tree. Differential Revision: https://developer.blender.org/D7631 Reviewed by: Andy Goralczyk, Bastien Montagne, William Reynish
172 lines
8.0 KiB
C++
172 lines
8.0 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 by Blender Foundation.
|
|
* All rights reserved.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bke
|
|
*
|
|
* API to manage data-blocks inside of Blender's Main data-base, or as independent runtime-only
|
|
* data.
|
|
*
|
|
* \note `BKE_lib_` files are for operations over data-blocks themselves, although they might
|
|
* alter Main as well (when creating/renaming/deleting an ID e.g.).
|
|
*
|
|
* \section Function Names
|
|
*
|
|
* \warning Descriptions below is ideal goal, current status of naming does not yet fully follow it
|
|
* (this is WIP).
|
|
*
|
|
* - `BKE_lib_override_library_` should be used for function affecting a single ID.
|
|
* - `BKE_lib_override_library_main_` should be used for function affecting the whole collection
|
|
* of IDs in a given Main data-base.
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct ID;
|
|
struct IDOverrideLibrary;
|
|
struct IDOverrideLibraryProperty;
|
|
struct IDOverrideLibraryPropertyOperation;
|
|
struct Main;
|
|
struct Object;
|
|
struct PointerRNA;
|
|
struct PropertyRNA;
|
|
struct Scene;
|
|
struct ViewLayer;
|
|
|
|
struct IDOverrideLibrary *BKE_lib_override_library_init(struct ID *local_id,
|
|
struct ID *reference_id);
|
|
void BKE_lib_override_library_copy(struct ID *dst_id,
|
|
const struct ID *src_id,
|
|
const bool do_full_copy);
|
|
void BKE_lib_override_library_clear(struct IDOverrideLibrary *override, const bool do_id_user);
|
|
void BKE_lib_override_library_free(struct IDOverrideLibrary **override, const bool do_id_user);
|
|
|
|
struct ID *BKE_lib_override_library_create_from_id(struct Main *bmain,
|
|
struct ID *reference_id,
|
|
const bool do_tagged_remap);
|
|
bool BKE_lib_override_library_create_from_tag(struct Main *bmain);
|
|
void BKE_lib_override_library_dependencies_tag(struct Main *bmain,
|
|
struct ID *id_root,
|
|
const uint tag,
|
|
const bool do_create_main_relashionships);
|
|
void BKE_lib_override_library_override_group_tag(struct Main *bmain,
|
|
struct ID *id_root,
|
|
const uint tag,
|
|
const uint missing_tag,
|
|
const bool do_create_main_relashionships);
|
|
bool BKE_lib_override_library_create(struct Main *bmain,
|
|
struct Scene *scene,
|
|
struct ViewLayer *view_layer,
|
|
struct ID *id_root,
|
|
struct ID *id_reference);
|
|
bool BKE_lib_override_library_proxy_convert(struct Main *bmain,
|
|
struct Scene *scene,
|
|
struct ViewLayer *view_layer,
|
|
struct Object *ob_proxy);
|
|
bool BKE_lib_override_library_resync(struct Main *bmain,
|
|
struct Scene *scene,
|
|
struct ViewLayer *view_layer,
|
|
struct ID *id_root);
|
|
void BKE_lib_override_library_delete(struct Main *bmain, struct ID *id_root);
|
|
|
|
struct IDOverrideLibraryProperty *BKE_lib_override_library_property_find(
|
|
struct IDOverrideLibrary *override, const char *rna_path);
|
|
struct IDOverrideLibraryProperty *BKE_lib_override_library_property_get(
|
|
struct IDOverrideLibrary *override, const char *rna_path, bool *r_created);
|
|
void BKE_lib_override_library_property_delete(struct IDOverrideLibrary *override,
|
|
struct IDOverrideLibraryProperty *override_property);
|
|
bool BKE_lib_override_rna_property_find(struct PointerRNA *idpoin,
|
|
const struct IDOverrideLibraryProperty *library_prop,
|
|
struct PointerRNA *r_override_poin,
|
|
struct PropertyRNA **r_override_prop);
|
|
|
|
struct IDOverrideLibraryPropertyOperation *BKE_lib_override_library_property_operation_find(
|
|
struct IDOverrideLibraryProperty *override_property,
|
|
const char *subitem_refname,
|
|
const char *subitem_locname,
|
|
const int subitem_refindex,
|
|
const int subitem_locindex,
|
|
const bool strict,
|
|
bool *r_strict);
|
|
struct IDOverrideLibraryPropertyOperation *BKE_lib_override_library_property_operation_get(
|
|
struct IDOverrideLibraryProperty *override_property,
|
|
const short operation,
|
|
const char *subitem_refname,
|
|
const char *subitem_locname,
|
|
const int subitem_refindex,
|
|
const int subitem_locindex,
|
|
const bool strict,
|
|
bool *r_strict,
|
|
bool *r_created);
|
|
void BKE_lib_override_library_property_operation_delete(
|
|
struct IDOverrideLibraryProperty *override_property,
|
|
struct IDOverrideLibraryPropertyOperation *override_property_operation);
|
|
|
|
bool BKE_lib_override_library_property_operation_operands_validate(
|
|
struct IDOverrideLibraryPropertyOperation *override_property_operation,
|
|
struct PointerRNA *ptr_dst,
|
|
struct PointerRNA *ptr_src,
|
|
struct PointerRNA *ptr_storage,
|
|
struct PropertyRNA *prop_dst,
|
|
struct PropertyRNA *prop_src,
|
|
struct PropertyRNA *prop_storage);
|
|
|
|
bool BKE_lib_override_library_status_check_local(struct Main *bmain, struct ID *local);
|
|
bool BKE_lib_override_library_status_check_reference(struct Main *bmain, struct ID *local);
|
|
|
|
bool BKE_lib_override_library_operations_create(struct Main *bmain, struct ID *local);
|
|
bool BKE_lib_override_library_main_operations_create(struct Main *bmain, const bool force_auto);
|
|
|
|
void BKE_lib_override_library_id_reset(struct Main *bmain, struct ID *id_root);
|
|
void BKE_lib_override_library_id_hierarchy_reset(struct Main *bmain, struct ID *id_root);
|
|
|
|
void BKE_lib_override_library_operations_tag(struct IDOverrideLibraryProperty *override_property,
|
|
const short tag,
|
|
const bool do_set);
|
|
void BKE_lib_override_library_properties_tag(struct IDOverrideLibrary *override,
|
|
const short tag,
|
|
const bool do_set);
|
|
void BKE_lib_override_library_main_tag(struct Main *bmain, const short tag, const bool do_set);
|
|
|
|
void BKE_lib_override_library_id_unused_cleanup(struct ID *local);
|
|
void BKE_lib_override_library_main_unused_cleanup(struct Main *bmain);
|
|
|
|
void BKE_lib_override_library_update(struct Main *bmain, struct ID *local);
|
|
void BKE_lib_override_library_main_update(struct Main *bmain);
|
|
|
|
/* Storage (.blend file writing) part. */
|
|
|
|
/* For now, we just use a temp main list. */
|
|
typedef struct Main OverrideLibraryStorage;
|
|
|
|
OverrideLibraryStorage *BKE_lib_override_library_operations_store_init(void);
|
|
struct ID *BKE_lib_override_library_operations_store_start(
|
|
struct Main *bmain, OverrideLibraryStorage *override_storage, struct ID *local);
|
|
void BKE_lib_override_library_operations_store_end(OverrideLibraryStorage *override_storage,
|
|
struct ID *local);
|
|
void BKE_lib_override_library_operations_store_finalize(OverrideLibraryStorage *override_storage);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|