1 // tilemgr.hxx -- routines to handle dynamic management of scenery tiles
3 // Written by Curtis Olson, started January 1998.
5 // Copyright (C) 1997 Curtis L. Olson - curt@infoplane.com
7 // This program is free software; you can redistribute it and/or
8 // modify it under the terms of the GNU General Public License as
9 // published by the Free Software Foundation; either version 2 of the
10 // License, or (at your option) any later version.
12 // This program is distributed in the hope that it will be useful, but
13 // WITHOUT ANY WARRANTY; without even the implied warranty of
14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 // General Public License for more details.
17 // You should have received a copy of the GNU General Public License
18 // along with this program; if not, write to the Free Software
19 // Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
29 # error This library requires C++
32 #include <simgear/compiler.h>
33 #include <simgear/math/point3d.hxx>
34 #include <simgear/scene/model/location.hxx>
40 #include <simgear/bucket/newbucket.hxx>
42 # include <simgear/threads/SGQueue.hxx>
43 #endif // ENABLE_THREADS
45 #include "FGTileLoader.hxx"
46 #include "hitlist.hxx"
47 #include "newcache.hxx"
49 #if defined(USE_MEM) || defined(WIN32)
50 # define FG_MEM_COPY(to,from,n) memcpy(to, from, n)
52 # define FG_MEM_COPY(to,from,n) bcopy(from, to, n)
55 SG_USING_STD( queue );
58 // forward declaration
60 class FGDeferredModel;
76 // initialize the cache
77 void initialize_queue();
79 // schedule a tile for loading
80 void sched_tile( const SGBucket& b );
82 // schedule a needed buckets for loading
83 void schedule_needed(double visibility_meters, SGBucket curr_bucket);
85 // see comment at prep_ssg_nodes()
86 void prep_ssg_node( int idx );
90 SGBucket previous_bucket;
91 SGBucket current_bucket;
94 FGTileEntry *current_tile;
96 // x and y distance of tiles to load/draw
100 // current longitude latitude
108 FGNewCache tile_cache;
111 * Queue tiles for loading.
119 * attach_queue is the tiles that have been loaded [by the pager]
120 * that can be attached to the scene graph by the render thread.
122 * model_queue is the set of models that need to be loaded by the
123 * primary render thread.
125 #ifdef ENABLE_THREADS
126 static SGLockedQueue<FGTileEntry *> attach_queue;
127 static SGLockedQueue<FGDeferredModel *> model_queue;
129 static queue<FGTileEntry *> attach_queue;
130 static queue<FGDeferredModel *> model_queue;
131 #endif // ENABLE_THREADS
132 static queue<FGTileEntry *> delete_queue;
137 * Add a loaded tile to the 'attach to the scene graph' queue.
139 static void ready_to_attach( FGTileEntry *t ) { attach_queue.push( t ); }
142 * Add a pending model to the 'deferred model load' queue
144 static void model_ready( FGDeferredModel *dm ) { model_queue.push( dm ); }
154 // Initialize the Tile Manager subsystem
157 // Update the various queues maintained by the tilemagr (private
158 // internal function, do not call directly.)
159 void update_queues();
161 // given the current lon/lat (in degrees), fill in the array of
162 // local chunks. If the chunk isn't already in the cache, then
163 // read it from disk.
164 int update( double visibility_meters );
165 int update( SGLocation *location, double visibility_meters,
166 sgdVec3 abs_pos_vector );
168 int updateCurrentElevAtPos( sgdVec3 abs_pos_vector, double altitude_m,
171 // Determine scenery altitude. Normally this just happens when we
172 // render the scene, but we'd also like to be able to do this
173 // explicitely. lat & lon are in radians. abs_view_pos in
174 // meters. Returns result in meters.
175 void my_ssg_los( string s, ssgBranch *branch, sgdMat4 m,
176 const sgdVec3 p, const sgdVec3 dir, sgdVec3 normal );
178 void my_ssg_los( ssgBranch *branch, sgdMat4 m,
179 const sgdVec3 p, const sgdVec3 dir,
182 // Prepare the ssg nodes corresponding to each tile. For each
183 // tile, set the ssg transform and update it's range selector
184 // based on current visibilty void prep_ssg_nodes( float
185 // visibility_meters );
186 void prep_ssg_nodes( SGLocation *location, float visibility_meters );
188 // Set flag with event manager so that non-moving view refreshes
190 void refresh_view_timestamps();
192 inline SGBucket get_current_bucket () { return current_bucket; }
193 inline SGBucket get_previous_bucket () { return previous_bucket; }
197 #endif // _TILEMGR_HXX