test/source/blender/blenkernel/intern/lib_intern.hh

/* SPDX-FileCopyrightText: 2018 Blender Authors
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */

/** \file
 * \ingroup bke
 */

#pragma once

#include "BKE_lib_remap.hh"

extern BKE_library_free_notifier_reference_cb free_notifier_reference_cb;

extern BKE_library_remap_editor_id_reference_cb remap_editor_id_reference_cb;

struct ID;
struct Main;

/**
 * Ensure new (copied) ID is fully made local.
 */
void lib_id_copy_ensure_local(Main *bmain, const ID *old_id, ID *new_id, const int flags);
License Headers: Set copyright to "Blender Authors", add AUTHORS Listing the "Blender Foundation" as copyright holder implied the Blender Foundation holds copyright to files which may include work from many developers. While keeping copyright on headers makes sense for isolated libraries, Blender's own code may be refactored or moved between files in a way that makes the per file copyright holders less meaningful. Copyright references to the "Blender Foundation" have been replaced with "Blender Authors", with the exception of `./extern/` since these this contains libraries which are more isolated, any changed to license headers there can be handled on a case-by-case basis. Some directories in `./intern/` have also been excluded: - `./intern/cycles/` it's own `AUTHORS` file is planned. - `./intern/opensubdiv/`. An "AUTHORS" file has been added, using the chromium projects authors file as a template. Design task: #110784 Ref !110783. 2023-08-16 00:20:26 +10:00			`/* SPDX-FileCopyrightText: 2018 Blender Authors`
Cleanup: Add a copyright notice to files and use SPDX format A lot of files were missing copyright field in the header and the Blender Foundation contributed to them in a sense of bug fixing and general maintenance. This change makes it explicit that those files are at least partially copyrighted by the Blender Foundation. Note that this does not make it so the Blender Foundation is the only holder of the copyright in those files, and developers who do not have a signed contract with the foundation still hold the copyright as well. Another aspect of this change is using SPDX format for the header. We already used it for the license specification, and now we state it for the copyright as well, following the FAQ: https://reuse.software/faq/ 2023-05-31 16:19:06 +02:00			`*`
			`* SPDX-License-Identifier: GPL-2.0-or-later */`
Cleanup/Refactor: Move ID deletion into its own .c file. Having functions defined in `BKE_lib_id.h` implemented into `lib_remap.c` was confusing at best. Besides trivial code splitting and header includes cleanup, had to add a new `lib_intern.h` header for callbacks used by both remapping and deletion code. 2020-02-10 15:55:43 +01:00
			`/** \file`
			`* \ingroup bke`
			`*/`

Fix mismatch in BKE headers' multi-include safeguards naming. Forgot to update those in recent `BKE_lib_` files renames. 2020-02-10 16:54:24 +01:00			`#pragma once`
Cleanup/Refactor: Move ID deletion into its own .c file. Having functions defined in `BKE_lib_id.h` implemented into `lib_remap.c` was confusing at best. Besides trivial code splitting and header includes cleanup, had to add a new `lib_intern.h` header for callbacks used by both remapping and deletion code. 2020-02-10 15:55:43 +01:00
BKE_lib: Convert `BKE_lib_remap` and `lib_intern` headers to be fully C++. 2023-11-30 19:51:22 +01:00			`#include "BKE_lib_remap.hh"`
LibOverride: Fix resync process no properly tagging newly used linked data as directly linked. LibOverride resync process would not properly 'make local' newly created overrides (copied from their linked reference). The main consequence was that some linked data used by these new liboverrides would not be properly tagged as directly linked. While this would not be an issue in current codebase, this was breaking upcomming readfile undo refactor, since some linked data did not get their local 'placeholder reference' data written in memfile blendfiles. NOTE: this is more of a quick fix, whole handling of library data in complex copying cases like that need some more general work, see #107848 and #107847. 2023-05-11 12:23:50 +02:00
Cleanup/Refactor: Move ID deletion into its own .c file. Having functions defined in `BKE_lib_id.h` implemented into `lib_remap.c` was confusing at best. Besides trivial code splitting and header includes cleanup, had to add a new `lib_intern.h` header for callbacks used by both remapping and deletion code. 2020-02-10 15:55:43 +01:00			`extern BKE_library_free_notifier_reference_cb free_notifier_reference_cb;`

			`extern BKE_library_remap_editor_id_reference_cb remap_editor_id_reference_cb;`
LibOverride: Fix resync process no properly tagging newly used linked data as directly linked. LibOverride resync process would not properly 'make local' newly created overrides (copied from their linked reference). The main consequence was that some linked data used by these new liboverrides would not be properly tagged as directly linked. While this would not be an issue in current codebase, this was breaking upcomming readfile undo refactor, since some linked data did not get their local 'placeholder reference' data written in memfile blendfiles. NOTE: this is more of a quick fix, whole handling of library data in complex copying cases like that need some more general work, see #107848 and #107847. 2023-05-11 12:23:50 +02:00
			`struct ID;`
			`struct Main;`

Cleanup: move function comments into headers or implementation notes For C/C++ doc-strings should be located in headers, move function comments into the headers, in some cases merging with existing doc-strings, in other cases, moving implementation notes into the function body. 2024-11-02 17:27:09 +11:00			`/**`
			`* Ensure new (copied) ID is fully made local.`
			`*/`
BKE_lib: Convert `BKE_lib_remap` and `lib_intern` headers to be fully C++. 2023-11-30 19:51:22 +01:00			`void lib_id_copy_ensure_local(Main bmain, const ID old_id, ID *new_id, const int flags);`