1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
/* SPDX-License-Identifier: GPL-2.0-or-later
* Copyright 2001-2002 NaN Holding BV. All rights reserved. */
#pragma once
/** \file
* \ingroup bke
* \brief Camera data-block and utility functions.
*/
#ifdef __cplusplus
extern "C" {
#endif
struct Camera;
struct Depsgraph;
struct Main;
struct Object;
struct RegionView3D;
struct RenderData;
struct Scene;
struct View3D;
struct rctf;
/* Camera Data-block */
void *BKE_camera_add(struct Main *bmain, const char *name);
/* Camera Usage */
/**
* Get the camera's DOF value, takes the DOF object into account.
*/
float BKE_camera_object_dof_distance(const struct Object *ob);
int BKE_camera_sensor_fit(int sensor_fit, float sizex, float sizey);
float BKE_camera_sensor_size(int sensor_fit, float sensor_x, float sensor_y);
/**
* Camera Parameters:
*
* Intermediate struct for storing camera parameters from various sources,
* to unify computation of view-plane, window matrix, ... etc.
*/
typedef struct CameraParams {
/* lens */
bool is_ortho;
float lens;
float ortho_scale;
float zoom;
float shiftx;
float shifty;
float offsetx;
float offsety;
/* sensor */
float sensor_x;
float sensor_y;
int sensor_fit;
/* clipping */
float clip_start;
float clip_end;
/* computed viewplane */
float ycor;
float viewdx;
float viewdy;
rctf viewplane;
/* computed matrix */
float winmat[4][4];
} CameraParams;
/* Values for CameraParams.zoom, need to be taken into account for some operations. */
#define CAMERA_PARAM_ZOOM_INIT_CAMOB 1.0f
#define CAMERA_PARAM_ZOOM_INIT_PERSP 2.0f
void BKE_camera_params_init(CameraParams *params);
void BKE_camera_params_from_object(CameraParams *params, const struct Object *cam_ob);
void BKE_camera_params_from_view3d(CameraParams *params,
struct Depsgraph *depsgraph,
const struct View3D *v3d,
const struct RegionView3D *rv3d);
void BKE_camera_params_compute_viewplane(
CameraParams *params, int winx, int winy, float aspx, float aspy);
/**
* View-plane is assumed to be already computed.
*/
void BKE_camera_params_compute_matrix(CameraParams *params);
/* Camera View Frame */
void BKE_camera_view_frame_ex(const struct Scene *scene,
const struct Camera *camera,
float drawsize,
bool do_clip,
const float scale[3],
float r_asp[2],
float r_shift[2],
float *r_drawsize,
float r_vec[4][3]);
void BKE_camera_view_frame(const struct Scene *scene,
const struct Camera *camera,
float r_vec[4][3]);
/**
* \param r_scale: only valid/useful for orthographic cameras.
*
* \note Don't move the camera, just yield the fit location.
*/
bool BKE_camera_view_frame_fit_to_scene(struct Depsgraph *depsgraph,
const struct Scene *scene,
struct Object *camera_ob,
float r_co[3],
float *r_scale,
float *r_clip_start,
float *r_clip_end);
bool BKE_camera_view_frame_fit_to_coords(const struct Depsgraph *depsgraph,
const float (*cos)[3],
int num_cos,
struct Object *camera_ob,
float r_co[3],
float *r_scale);
/* Camera multi-view API */
/**
* Returns the camera to be used for render.
*/
struct Object *BKE_camera_multiview_render(const struct Scene *scene,
struct Object *camera,
const char *viewname);
/**
* The view matrix is used by the viewport drawing, it is basically the inverted model matrix.
*/
void BKE_camera_multiview_view_matrix(const struct RenderData *rd,
const struct Object *camera,
bool is_left,
float r_viewmat[4][4]);
void BKE_camera_multiview_model_matrix(const struct RenderData *rd,
const struct Object *camera,
const char *viewname,
float r_modelmat[4][4]);
void BKE_camera_multiview_model_matrix_scaled(const struct RenderData *rd,
const struct Object *camera,
const char *viewname,
float r_modelmat[4][4]);
void BKE_camera_multiview_window_matrix(const struct RenderData *rd,
const struct Object *camera,
const char *viewname,
float r_winmat[4][4]);
float BKE_camera_multiview_shift_x(const struct RenderData *rd,
const struct Object *camera,
const char *viewname);
void BKE_camera_multiview_params(const struct RenderData *rd,
struct CameraParams *params,
const struct Object *camera,
const char *viewname);
bool BKE_camera_multiview_spherical_stereo(const struct RenderData *rd,
const struct Object *camera);
/* Camera background image API */
struct CameraBGImage *BKE_camera_background_image_new(struct Camera *cam);
void BKE_camera_background_image_remove(struct Camera *cam, struct CameraBGImage *bgpic);
void BKE_camera_background_image_clear(struct Camera *cam);
#ifdef __cplusplus
}
#endif
|
