doxygen: prevent GPL license block from being parsed as doxygen comment.
[blender.git] / source / blender / blenlib / intern / uvproject.c
1 /*
2  * $Id$
3  *
4  * ***** BEGIN GPL LICENSE BLOCK *****
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software Foundation,
18  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19  *
20  * ***** END GPL LICENSE BLOCK *****
21  */
22
23 #include <math.h>
24
25 #include "MEM_guardedalloc.h"
26
27 #include "DNA_camera_types.h"
28 #include "DNA_object_types.h"
29
30 #include "BLI_math.h"
31 #include "BLI_uvproject.h"
32
33 typedef struct UvCameraInfo {
34         float camangle;
35         float camsize;
36         float xasp, yasp;
37         float shiftx, shifty;
38         float rotmat[4][4];
39         float caminv[4][4];
40         short do_persp, do_pano, do_rotmat;
41 } UvCameraInfo;
42
43 void project_from_camera(float target[2], float source[3], UvCameraInfo *uci)
44 {
45         float pv4[4];
46
47         copy_v3_v3(pv4, source);
48         pv4[3]= 1.0;
49
50         /* rotmat is the object matrix in this case */
51         if(uci->do_rotmat)
52                 mul_m4_v4(uci->rotmat, pv4);
53
54         /* caminv is the inverse camera matrix */
55         mul_m4_v4(uci->caminv, pv4);
56
57         if(uci->do_pano) {
58                 float angle= atan2f(pv4[0], -pv4[2]) / (M_PI * 2.0); /* angle around the camera */
59                 if (uci->do_persp==0) {
60                         target[0]= angle; /* no correct method here, just map to  0-1 */
61                         target[1]= pv4[1] / uci->camsize;
62                 }
63                 else {
64                         float vec2d[2]; /* 2D position from the camera */
65                         vec2d[0]= pv4[0];
66                         vec2d[1]= pv4[2];
67                         target[0]= angle * (M_PI / uci->camangle);
68                         target[1]= pv4[1] / (len_v2(vec2d) * uci->camsize);
69                 }
70         }
71         else {
72                 if (pv4[2]==0.0f) pv4[2]= 0.00001f; /* don't allow div by 0 */
73
74                 if (uci->do_persp==0) {
75                         target[0]= (pv4[0]/uci->camsize);
76                         target[1]= (pv4[1]/uci->camsize);
77                 }
78                 else {
79                         target[0]= (-pv4[0]*((1.0f/uci->camsize)/pv4[2])) / 2.0f;
80                         target[1]= (-pv4[1]*((1.0f/uci->camsize)/pv4[2])) / 2.0f;
81                 }
82         }
83
84         target[0] *= uci->xasp;
85         target[1] *= uci->yasp;
86         
87         /* adds camera shift + 0.5 */
88         target[0] += uci->shiftx;
89         target[1] += uci->shifty;
90 }
91
92 /* could rv3d->persmat */
93 void project_from_view(float target[2], float source[3], float persmat[4][4], float rotmat[4][4], float winx, float winy)
94 {
95         float pv[3], pv4[4], x= 0.0, y= 0.0;
96
97         mul_v3_m4v3(pv, rotmat, source);
98
99         copy_v3_v3(pv4, source);
100         pv4[3]= 1.0;
101
102         /* rotmat is the object matrix in this case */
103         mul_m4_v4(rotmat, pv4); 
104
105         /* almost project_short */
106         mul_m4_v4(persmat, pv4);
107         if(fabs(pv4[3]) > 0.00001) { /* avoid division by zero */
108                 target[0] = winx/2.0 + (winx/2.0) * pv4[0] / pv4[3];
109                 target[1] = winy/2.0 + (winy/2.0) * pv4[1] / pv4[3];
110         }
111         else {
112                 /* scaling is lost but give a valid result */
113                 target[0] = winx/2.0 + (winx/2.0) * pv4[0];
114                 target[1] = winy/2.0 + (winy/2.0) * pv4[1];
115         }
116
117         /* v3d->persmat seems to do this funky scaling */ 
118         if(winx > winy) {
119                 y= (winx - winy)/2.0;
120                 winy = winx;
121         }
122         else {
123                 x= (winy - winx)/2.0;
124                 winx = winy;
125         }
126
127         target[0]= (x + target[0]) / winx;
128         target[1]= (y + target[1]) / winy;
129 }
130
131 /* 'rotmat' can be obedit->obmat when uv project is used.
132  * 'winx' and 'winy' can be from scene->r.xsch/ysch */ 
133 UvCameraInfo *project_camera_info(Object *ob, float (*rotmat)[4], float winx, float winy)
134 {
135         UvCameraInfo uci;
136         Camera *camera= ob->data;
137
138         uci.do_pano = (camera->flag & CAM_PANORAMA);
139         uci.do_persp = (camera->type==CAM_PERSP);
140
141         uci.camangle= lens_to_angle(camera->lens) / 2.0f;
142         uci.camsize= uci.do_persp ? tanf(uci.camangle) : camera->ortho_scale;
143
144         if (invert_m4_m4(uci.caminv, ob->obmat)) {
145                 UvCameraInfo *uci_pt;
146
147                 /* normal projection */
148                 if(rotmat) {
149                         copy_m4_m4(uci.rotmat, rotmat);
150                         uci.do_rotmat= 1;
151                 }
152                 else {
153                         uci.do_rotmat= 0;
154                 }
155
156                 /* also make aspect ratio adjustment factors */
157                 if (winx > winy) {
158                         uci.xasp= 1.0f;
159                         uci.yasp= winx / winy;
160                 }
161                 else {
162                         uci.xasp= winy / winx;
163                         uci.yasp= 1.0f;
164                 }
165                 
166                 /* include 0.5f here to move the UVs into the center */
167                 uci.shiftx = 0.5f - camera->shiftx;
168                 uci.shifty = 0.5f - camera->shifty;
169                 
170                 uci_pt= MEM_mallocN(sizeof(UvCameraInfo), "UvCameraInfo");
171                 *uci_pt= uci;
172                 return uci_pt;
173         }
174
175         return NULL;
176 }
177
178 void project_from_view_ortho(float target[2], float source[3], float rotmat[4][4])
179 {
180         float pv[3];
181
182         mul_v3_m4v3(pv, rotmat, source);
183
184         /* ortho projection */
185         target[0] = -pv[0];
186         target[1] = pv[2];
187 }
188
189
190 void project_camera_info_scale(UvCameraInfo *uci, float scale_x, float scale_y)
191 {
192         uci->xasp *= scale_x;
193         uci->yasp *= scale_y;
194 }