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
|
#ifndef __NR_3DUTILS_H__
#define __NR_3DUTILS_H__
/*
* 3D utils. Definition of gdouble vectors of dimension 3 and of some basic
* functions.
*
* Authors:
* Jean-Rene Reinhard <jr@komite.net>
*
* Copyright (C) 2007 authors
*
* Released under GNU GPL, read the file 'COPYING' for more information
*/
#include <gdk/gdktypes.h>
struct NRPixBlock;
namespace NR {
struct Matrix;
#define X_3D 0
#define Y_3D 1
#define Z_3D 2
/**
* a type of 3 gdouble components vectors
*/
typedef gdouble Fvector[3];
/**
* The eye vector
*/
const static Fvector EYE_VECTOR = {0, 0, 1};
/**
* returns the euclidian norm of the vector v
*
* \param v a reference to a vector with double components
* \return the euclidian norm of v
*/
gdouble norm(const Fvector &v);
/**
* Normalizes a vector
*
* \param v a reference to a vector to normalize
*/
void normalize_vector(Fvector &v);
/**
* Computes the scalar product between two Fvectors
*
* \param a a Fvector reference
* \param b a Fvector reference
* \return the scalar product of a and b
*/
gdouble scalar_product(const Fvector &a, const Fvector &b);
/**
* Computes the normalized sum of two Fvectors
*
* \param r a Fvector reference where we store the result
* \param a a Fvector reference
* \param b a Fvector reference
*/
void normalized_sum(Fvector &r, const Fvector &a, const Fvector &b);
/**
* Computes the unit suface normal vector of surface given by "in" at (i, j)
* and store it into N. "in" is a (NRPixBlock *) in mode RGBA but only the alpha
* channel is considered as a bump map. ss is the altitude when for the alpha
* value 255. dx and dy are the deltas used to compute in our discrete setting
*
* \param N a reference to a Fvector in which we store the unit surface normal
* \param ss the surface scale
* \param in a NRPixBlock * whose alpha channel codes the surface
* \param i the x coordinate of the point at which we compute the normal
* \param j the y coordinate of the point at which we compute the normal
* \param dx the delta used in the x coordinate
* \param dy the delta used in the y coordinate
*/
void compute_surface_normal(Fvector &N, gdouble ss, NRPixBlock *in, int i, int j, int dx, int dy);
/**
* Applies the transformation matrix to (x, y, z). This function assumes that
* trans[0] = trans[3]. x and y are transformed according to trans, z is
* multiplied by trans[0].
*
* \param x a reference to a x coordinate
* \param y a reference to a y coordinate
* \param z a reference to a z coordinate
* \param z a reference to a transformation matrix
*/
void convert_coord(gdouble &x, gdouble &y, gdouble &z, Matrix const &trans);
} /* namespace NR */
#endif /* __NR_3DUTILS_H__ */
/*
Local Variables:
mode:c++
c-file-style:"stroustrup"
c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
indent-tabs-mode:nil
fill-column:99
End:
*/
// vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=99 :
|
