1 // sky.hxx -- ssg based sky model
3 // Written by Curtis Olson, started December 1997.
4 // SSG-ified by Curtis Olson, February 2000.
6 // Copyright (C) 1997-2000 Curtis L. Olson - curt@flightgear.org
8 // This program is free software; you can redistribute it and/or
9 // modify it under the terms of the GNU General Public License as
10 // published by the Free Software Foundation; either version 2 of the
11 // License, or (at your option) any later version.
13 // This program is distributed in the hope that it will be useful, but
14 // WITHOUT ANY WARRANTY; without even the implied warranty of
15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 // General Public License for more details.
18 // You should have received a copy of the GNU General Public License
19 // along with this program; if not, write to the Free Software
20 // Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
30 # error This library requires C++
34 #include <plib/ssg.h> // plib include
36 #include <simgear/misc/fgpath.hxx>
46 // components of the sky
53 ssgSelector *sky_selector;
54 ssgTransform *sky_transform;
66 // initialize the sky and connect the components to the scene
67 // graph at the provided branch
68 ssgBranch *build( double sun_size, double moon_size,
69 int nplanets, sgdVec3 *planet_data, double planet_dist,
70 int nstars, sgdVec3 *star_data, double star_dist );
72 // repaint the sky components based on current value of sun_angle,
73 // sky, and fog colors.
75 // sun angle in degrees relative to verticle
76 // 0 degrees = high noon
77 // 90 degrees = sun rise/set
78 // 180 degrees = darkest midnight
79 bool repaint( sgVec4 sky_color, sgVec4 fog_color,
80 double sun_angle, double moon_angle,
81 int nplanets, sgdVec3 *planet_data,
82 int nstars, sgdVec3 *star_data );
84 // reposition the sky at the specified origin and orientation
86 // lon specifies a rotation about the Z axis
87 // lat specifies a rotation about the new Y axis
88 // spin specifies a rotation about the new Z axis (this allows
89 // additional orientation for the sunrise/set effects and is used
90 // by the skydome and perhaps clouds.
91 bool reposition( sgVec3 view_pos, sgVec3 zero_elev,
92 double lon, double lat, double spin,
94 double sun_ra, double sun_dec, double sun_dist,
95 double moon_ra, double moon_dec, double moon_dist );
97 // specify the texture path (optional, defaults to current directory)
98 inline void texture_path( const string& path ) {
99 tex_path = FGPath( path );
102 // enable the sky in the scene graph (default)
103 inline void enable() { sky_selector->select( 1 ); }
105 // disable the sky in the scene graph. The leaf node is still
106 // there, how ever it won't be traversed on by ssgCullandRender()
107 inline void disable() { sky_selector->select( 0 ); }
111 #endif // _SG_SKY_HXX