X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=simgear%2Fscene%2Fsky%2Fcloud.hxx;h=6a179d9f768719ef2d8d7ac67564d419ad089e3d;hb=68eb7031e2dce999d112d0164fa28d4b8d66922e;hp=92463f1db07b5e9d2f62952777510f2aae9f35bf;hpb=b6a683eb6e3a3a7e886aefa705fa4d18f128a523;p=simgear.git diff --git a/simgear/scene/sky/cloud.hxx b/simgear/scene/sky/cloud.hxx index 92463f1d..6a179d9f 100644 --- a/simgear/scene/sky/cloud.hxx +++ b/simgear/scene/sky/cloud.hxx @@ -1,8 +1,11 @@ -// cloud.hxx -- model a single cloud layer -// +/** + * \file cloud.hxx + * Provides a class to model a single cloud layer + */ + // Written by Curtis Olson, started June 2000. // -// Copyright (C) 2000 Curtis L. Olson - curt@flightgear.org +// Copyright (C) 2000 Curtis L. Olson - http://www.flightgear.org/~curt // // This library is free software; you can redistribute it and/or // modify it under the terms of the GNU Library General Public @@ -32,11 +35,21 @@ #include STL_STRING SG_USING_STD(string); +// #include +// SG_USING_STD(cout); +// SG_USING_STD(endl); -class SGCloudLayer { +class SGCloudField; +/** + * A class layer to model a single cloud layer + */ +class SGCloudLayer { public: + /** + * This is the list of available cloud coverages/textures + */ enum Coverage { SG_CLOUD_OVERCAST = 0, SG_CLOUD_BROKEN, @@ -47,55 +60,154 @@ public: SG_MAX_CLOUD_COVERAGES }; - // Constructors + /** + * Constructor + * @param tex_path the path to the set of cloud textures + */ SGCloudLayer( const string &tex_path ); - // Destructor + /** + * Destructor + */ ~SGCloudLayer( void ); + /** get the cloud span (in meters) */ float getSpan_m () const; + /** + * set the cloud span + * @param span_m the cloud span in meters + */ void setSpan_m (float span_m); + /** get the layer elevation (in meters) */ float getElevation_m () const; - void setElevation_m (float elevation_m); - + /** + * set the layer elevation. Note that this specifies the bottom + * of the cloud layer. The elevation of the top of the layer is + * elevation_m + thickness_m. + * @param elevation_m the layer elevation in meters + * @param set_span defines whether it is allowed to adjust the span + */ + void setElevation_m (float elevation_m, bool set_span = true); + + /** get the layer thickness */ float getThickness_m () const; + /** + * set the layer thickness. + * @param thickness_m the layer thickness in meters. + */ void setThickness_m (float thickness_m); + /** + * get the transition/boundary layer depth in meters. This + * allows gradual entry/exit from the cloud layer via adjusting + * visibility. + */ float getTransition_m () const; + + /** + * set the transition layer size in meters + * @param transition_m the transition layer size in meters + */ void setTransition_m (float transition_m); + /** get coverage type */ Coverage getCoverage () const; + + /** + * set coverage type + * @param coverage the coverage type + */ void setCoverage (Coverage coverage); - // build the cloud object + /** + * set the cloud movement direction + * @param dir the cloud movement direction + */ + inline void setDirection(float dir) { + // cout << "cloud dir = " << dir << endl; + direction = dir; + } + + /** get the cloud movement direction */ + inline float getDirection() { return direction; } + + /** + * set the cloud movement speed + * @param sp the cloud movement speed + */ + inline void setSpeed(float sp) { + // cout << "cloud speed = " << sp << endl; + speed = sp; + } + + /** get the cloud movement speed */ + inline float getSpeed() { return speed; } + + /** + * set the alpha component of the cloud base color. Normally this + * should be 1.0, but you can set it anywhere in the range of 0.0 + * to 1.0 to fade a cloud layer in or out. + * @param alpha cloud alpha value (0.0 to 1.0) + */ + inline void setAlpha( float alpha ) { + if ( alpha < 0.0 ) { alpha = 0.0; } + if ( alpha > 1.0 ) { alpha = 1.0; } + cloud_alpha = alpha; + } + + /** build the cloud object */ void rebuild(); - // repaint the cloud colors based on current value of sun_angle, - // sky, and fog colors. This updates the color arrays for - // ssgVtxTable. - // sun angle in degrees relative to verticle - // 0 degrees = high noon - // 90 degrees = sun rise/set - // 180 degrees = darkest midnight + /** + * repaint the cloud colors based on the specified fog_color + * @param fog_color the fog color + */ bool repaint( sgVec3 fog_color ); - // reposition the cloud layer at the specified origin and - // orientation - // lon specifies a rotation about the Z axis - // lat specifies a rotation about the new Y axis - // spin specifies a rotation about the new Z axis (and orients the - // sunrise/set effects - bool reposition( sgVec3 p, sgVec3 up, double lon, double lat, double alt ); + /** + * reposition the cloud layer at the specified origin and + * orientation. + * @param p position vector + * @param up the local up vector + * @param lon specifies a rotation about the Z axis + * @param lat specifies a rotation about the new Y axis + * @param spin specifies a rotation about the new Z axis + * (and orients the sunrise/set effects) + * @param dt the time elapsed since the last call + */ + bool reposition( sgVec3 p, sgVec3 up, double lon, double lat, double alt, + double dt = 0.0 ); - // draw the cloud layer - void draw(); + /** draw the cloud layer */ + void draw( bool top ); + + static bool enable_bump_mapping; + + /** return the 3D layer cloud associated with this 2D layer */ + SGCloudField *get_layer3D(void) { return layer3D; } private: + struct CloudVertex { + sgVec3 position; + sgVec2 texCoord; + sgVec3 tangentSpLight; + sgVec3 sTangent; + sgVec3 tTangent; + sgVec3 normal; + sgVec4 color; + }; + + CloudVertex *vertices; + unsigned int *indices; + ssgRoot *layer_root; ssgTransform *layer_transform; ssgLeaf *layer[4]; + ssgStateSelector *state_sel; + + float cloud_alpha; // 1.0 = drawn fully, 0.0 faded out completely ssgColourArray *cl[4]; ssgVertexArray *vl[4]; @@ -109,13 +221,16 @@ private: float layer_transition; Coverage layer_coverage; float scale; + float speed; + float direction; // for handling texture coordinates to simulate cloud movement // from winds, and to simulate the clouds being tied to ground // position, not view position // double xoff, yoff; - double last_lon, last_lat; + double last_lon, last_lat, last_course; + SGCloudField *layer3D; };