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/
49 lines
1.1 KiB
C
49 lines
1.1 KiB
C
/* SPDX-FileCopyrightText: 2023 Blender Foundation
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bli
|
|
*
|
|
* \note dials act similar to old rotation based phones and output an angle.
|
|
*
|
|
* They just are initialized with the center of the dial and a threshold value as input.
|
|
*
|
|
* When the distance of the current position of the dial from the center
|
|
* exceeds the threshold, this position is used to calculate the initial direction.
|
|
* After that, the angle from the initial direction is calculated based on
|
|
* current and previous directions of the digit, and returned to the user.
|
|
*
|
|
* Usage examples:
|
|
*
|
|
* \code{.c}
|
|
* float start_position[2] = {0.0f, 0.0f};
|
|
* float current_position[2];
|
|
* float threshold = 0.5f;
|
|
* float angle;
|
|
* Dial *dial;
|
|
*
|
|
* dial = BLI_dial_init(start_position, threshold);
|
|
*
|
|
* angle = BLI_dial_angle(dial, current_position);
|
|
*
|
|
* MEM_freeN(dial);
|
|
* \endcode
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct Dial Dial;
|
|
|
|
Dial *BLI_dial_init(const float start_position[2], float threshold);
|
|
|
|
float BLI_dial_angle(Dial *dial, const float current_position[2]);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|