c1bc70b711
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/
59 lines
1.9 KiB
C++
59 lines
1.9 KiB
C++
/* SPDX-FileCopyrightText: 2023 NVIDIA Corporation. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
#pragma once
|
|
|
|
#include "usd.h"
|
|
|
|
#include <pxr/usd/usd/stage.h>
|
|
|
|
#include <string>
|
|
|
|
namespace blender::io::usd {
|
|
|
|
/**
|
|
* Invoke the USD asset resolver to copy an asset.
|
|
*
|
|
* \param src: source path of the asset to copy
|
|
* \param dst: destination path of the copy
|
|
* \param name_collision_mode: behavior when `dst` already exists
|
|
* \return true if the copy succeeded, false otherwise
|
|
*/
|
|
bool copy_asset(const char *src, const char *dst, eUSDTexNameCollisionMode name_collision_mode);
|
|
|
|
/**
|
|
* Invoke the USD asset resolver to determine if the
|
|
* asset with the given path exists.
|
|
*
|
|
* \param path: the path to resolve
|
|
* \return true if the asset exists, false otherwise
|
|
*/
|
|
bool asset_exists(const char *path);
|
|
|
|
/**
|
|
* Invoke the USD asset resolver to copy an asset to a destination
|
|
* directory and return the path to the copied file. This function may
|
|
* be used to copy textures from a USDZ archive to a directory on disk.
|
|
* The destination directory will be created if it doesn't already exist.
|
|
* If the copy was unsuccessful, this function will log an error and
|
|
* return the original source file path unmodified.
|
|
*
|
|
* \param src: source path of the asset to import
|
|
* \param import_dir: path to the destination directory
|
|
* \param name_collision_mode: behavior when a file of the same name already exists
|
|
* \return path to copied file or the original `src` path if there was an error
|
|
*/
|
|
std::string import_asset(const char *src,
|
|
const char *import_dir,
|
|
eUSDTexNameCollisionMode name_collision_mode);
|
|
|
|
/**
|
|
* Check if the given path contains a UDIM token.
|
|
*
|
|
* \param path: the path to check
|
|
* \return true if the path contains a UDIM token, false otherwise
|
|
*/
|
|
bool is_udim_path(const std::string &path);
|
|
|
|
} // namespace blender::io::usd
|