c650977534
Keeping these as linked datablocks to the brush does not match the idea that assets should generally be appended, and leads to some confusing situations with linked materials on objects. Now use either a local material with matching weak library reference or make a local copy if it does not exist yet. This also add weak library references to the materials in the 2D Animation template, so they will be reused. A problem is that weak library references include a full path to assets blend files, including the Blender version for the essentials assets files. This means weak library references do not work across platforms and Blender versions. Another known limitation is that if the (linked) Brush Asset material is edited, and there is already a local copy of it, this local copy will remain unchanged and will be used by future strokes as well. Ref #131186 Pull Request: https://projects.blender.org/blender/blender/pulls/134226
77 lines
2.5 KiB
C++
77 lines
2.5 KiB
C++
/* SPDX-FileCopyrightText: 2024 Blender Authors
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
/** \file
|
|
* \ingroup bke
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
/**
|
|
* Editing of datablocks from asset libraries.
|
|
*
|
|
* Asset blend files are linked into the global main database, with the asset
|
|
* datablock itself and its dependencies. These datablocks remain linked but
|
|
* are marked as editable.
|
|
*
|
|
* User edited asset datablocks are written to individual blend files per
|
|
* asset. These blend files include any datablock dependencies and packaged
|
|
* image files.
|
|
*
|
|
* This way the blend file can be easily saved, reloaded and deleted.
|
|
*
|
|
* This mechanism is currently only used for brush assets.
|
|
*/
|
|
|
|
#include <optional>
|
|
#include <string>
|
|
|
|
#include "BLI_string_ref.hh"
|
|
|
|
#include "DNA_ID_enums.h"
|
|
|
|
struct bUserAssetLibrary;
|
|
struct AssetWeakReference;
|
|
struct ID;
|
|
struct Main;
|
|
struct ReportList;
|
|
|
|
namespace blender::bke {
|
|
|
|
/** Get datablock from weak reference, loading the blend file as needed. */
|
|
ID *asset_edit_id_from_weak_reference(Main &global_main,
|
|
ID_Type id_type,
|
|
const AssetWeakReference &weak_ref);
|
|
|
|
/** Get asset weak reference from ID. */
|
|
std::optional<AssetWeakReference> asset_edit_weak_reference_from_id(const ID &id);
|
|
|
|
/** Asset editing operations. */
|
|
|
|
bool asset_edit_id_is_editable(const ID &id);
|
|
bool asset_edit_id_is_writable(const ID &id);
|
|
|
|
std::optional<std::string> asset_edit_id_save_as(Main &global_main,
|
|
const ID &id,
|
|
StringRefNull name,
|
|
const bUserAssetLibrary &user_library,
|
|
AssetWeakReference &r_weak_ref,
|
|
ReportList &reports);
|
|
|
|
bool asset_edit_id_save(Main &global_main, const ID &id, ReportList &reports);
|
|
/**
|
|
* Relink the asset from the library. This causes the ID to be re-allocated, so its address
|
|
* changes. Even in case of failure to reload the asset, \a id will be deleted.
|
|
* \return the new address of the reloaded \a id.
|
|
*/
|
|
ID *asset_edit_id_revert(Main &global_main, ID &id, ReportList &reports);
|
|
bool asset_edit_id_delete(Main &global_main, ID &id, ReportList &reports);
|
|
|
|
/** Find a local copy of the asset. */
|
|
ID *asset_edit_id_find_local(Main &global_main, ID &id);
|
|
/** Ensure a local copy of the asset exists. */
|
|
ID *asset_edit_id_ensure_local(Main &global_main, ID &id);
|
|
|
|
} // namespace blender::bke
|