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/
67 lines
2.1 KiB
C
67 lines
2.1 KiB
C
/* SPDX-FileCopyrightText: 2008 Blender Foundation
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bli
|
|
*/
|
|
|
|
#include "BLI_compiler_attrs.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* Generate time-code/frame number string and store in \a str
|
|
*
|
|
* \param str: destination string
|
|
* \param maxncpy: maximum number of characters to copy `sizeof(str)`
|
|
* \param brevity_level: special setting for #View2D grid drawing,
|
|
* used to specify how detailed we need to be
|
|
* \param time_seconds: time total time in seconds
|
|
* \param fps: frames per second, typically from the #FPS macro
|
|
* \param timecode_style: enum from #eTimecodeStyles
|
|
* \return length of \a str
|
|
*/
|
|
size_t BLI_timecode_string_from_time(char *str,
|
|
size_t maxncpy,
|
|
int brevity_level,
|
|
float time_seconds,
|
|
double fps,
|
|
short timecode_style) ATTR_NONNULL();
|
|
|
|
/**
|
|
* Generate time string and store in \a str
|
|
*
|
|
* \param str: destination string
|
|
* \param maxncpy: maximum number of characters to copy `sizeof(str)`
|
|
* \param time_seconds: time total time in seconds
|
|
* \return length of \a str
|
|
*/
|
|
size_t BLI_timecode_string_from_time_simple(char *str, size_t maxncpy, double time_seconds)
|
|
ATTR_NONNULL();
|
|
|
|
/**
|
|
* Generate time string and store in \a str
|
|
*
|
|
* \param str: destination string
|
|
* \param maxncpy: maximum number of characters to copy `sizeof(str)`
|
|
* \param brevity_level: special setting for #View2D grid drawing,
|
|
* used to specify how detailed we need to be
|
|
* \param time_seconds: time total time in seconds
|
|
* \return length of \a str
|
|
*
|
|
* \note in some cases this is used to print non-seconds values.
|
|
*/
|
|
size_t BLI_timecode_string_from_time_seconds(char *str,
|
|
size_t maxncpy,
|
|
int brevity_level,
|
|
float time_seconds) ATTR_NONNULL();
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|