f17fbf8065
Motivation is to disambiguate on the naming level what the matrix actually means. It is very easy to understand the meaning backwards, especially since in Python the name goes the opposite way (it is called `world_matrix` in the Python API). It is important to disambiguate the naming without making developers to look into the comment in the header file (which is also not super clear either). Additionally, more clear naming facilitates the unit verification (or, in this case, space validation) when reading an expression. This patch calls the matrix `object_to_world` which makes it clear from the local code what is it exactly going on. This is only done on DNA level, and a lot of local variables still follow the old naming. A DNA rename is setup in a way that there is no change on the file level, so there should be no regressions at all. The possibility is to add `_matrix` or `_mat` suffix to the name to make it explicit that it is a matrix. Although, not sure if it really helps the readability, or is it something redundant. Differential Revision: https://developer.blender.org/D16328
55 lines
1.4 KiB
C
55 lines
1.4 KiB
C
/* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bli
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct Object;
|
|
struct ProjCameraInfo;
|
|
|
|
/**
|
|
* Create UV info from the camera, needs to be freed.
|
|
*
|
|
* \param rotmat: can be `obedit->object_to_world` when uv project is used.
|
|
* \param winx, winy: can be from `scene->r.xsch / ysch`.
|
|
*/
|
|
struct ProjCameraInfo *BLI_uvproject_camera_info(struct Object *ob,
|
|
float rotmat[4][4],
|
|
float winx,
|
|
float winy);
|
|
|
|
/**
|
|
* Apply UV from uvinfo (camera).
|
|
*/
|
|
void BLI_uvproject_from_camera(float target[2], float source[3], struct ProjCameraInfo *uci);
|
|
|
|
/**
|
|
* Apply uv from perspective matrix.
|
|
* \param persmat: Can be `rv3d->persmat`.
|
|
*/
|
|
void BLI_uvproject_from_view(float target[2],
|
|
float source[3],
|
|
float persmat[4][4],
|
|
float rotmat[4][4],
|
|
float winx,
|
|
float winy);
|
|
|
|
/**
|
|
* Apply orthographic UV's.
|
|
*/
|
|
void BLI_uvproject_from_view_ortho(float target[2], float source[3], const float rotmat[4][4]);
|
|
|
|
/**
|
|
* So we can adjust scale with keeping the struct private.
|
|
*/
|
|
void BLI_uvproject_camera_info_scale(struct ProjCameraInfo *uci, float scale_x, float scale_y);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|