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/compiler.h>
37 #include <simgear/misc/fgpath.hxx>
50 typedef vector < SGCloudLayer* > layer_list_type;
51 typedef layer_list_type::iterator layer_list_iterator;
52 typedef layer_list_type::const_iterator layer_list_const_iterator;
59 // components of the sky
65 layer_list_type cloud_layers;
67 ssgRoot *pre_root, *post_root;
69 ssgSelector *pre_selector, *post_selector;
70 ssgTransform *pre_transform, *post_transform;
82 // initialize the sky and connect the components to the scene
83 // graph at the provided branch
84 void build( double sun_size, double moon_size,
85 int nplanets, sgdVec3 *planet_data, double planet_dist,
86 int nstars, sgdVec3 *star_data, double star_dist );
88 // repaint the sky components based on current value of sun_angle,
89 // sky, and fog colors.
91 // sun angle in degrees relative to verticle
92 // 0 degrees = high noon
93 // 90 degrees = sun rise/set
94 // 180 degrees = darkest midnight
95 bool repaint( sgVec4 sky_color, sgVec4 fog_color,
96 double sun_angle, double moon_angle,
97 int nplanets, sgdVec3 *planet_data,
98 int nstars, sgdVec3 *star_data );
100 // reposition the sky at the specified origin and orientation
102 // lon specifies a rotation about the Z axis
103 // lat specifies a rotation about the new Y axis
104 // spin specifies a rotation about the new Z axis (this allows
105 // additional orientation for the sunrise/set effects and is used
106 // by the skydome and perhaps clouds.
107 bool reposition( sgVec3 view_pos, sgVec3 zero_elev, sgVec3 view_up,
108 double lon, double lat, double spin,
110 double sun_ra, double sun_dec, double sun_dist,
111 double moon_ra, double moon_dec, double moon_dist );
113 // draw background portions of the sky
114 void draw_background();
116 // draw scenery elements of the sky
119 // specify the texture path (optional, defaults to current directory)
120 inline void texture_path( const string& path ) {
121 tex_path = FGPath( path );
125 inline void enable() {
126 pre_selector->select( 1 );
127 post_selector->select( 1 );
130 // disable the sky in the scene graph. The leaf node is still
131 // there, how ever it won't be traversed on by ssgCullandRender()
132 inline void disable() {
133 pre_selector->select( 0 );
134 post_selector->select( 0 );
137 // add a cloud layer (above see level in meters)
138 void add_cloud_layer( double asl );
140 inline int get_num_layers() const { return cloud_layers.size(); }
141 inline SGCloudLayer *get_cloud_layer( int i ) const {
142 return cloud_layers[i];
147 #endif // _SG_SKY_HXX