diff options
Diffstat (limited to 'indra/newview/llappviewer.h')
-rw-r--r-- | indra/newview/llappviewer.h | 479 |
1 files changed, 246 insertions, 233 deletions
diff --git a/indra/newview/llappviewer.h b/indra/newview/llappviewer.h index 77a1cdb485..b4756eecd6 100644 --- a/indra/newview/llappviewer.h +++ b/indra/newview/llappviewer.h @@ -1,9 +1,9 @@ -/** +/** * @mainpage * @mainpage * * This is the sources for the Second Life Viewer; - * information on the open source project is at + * information on the open source project is at * https://wiki.secondlife.com/wiki/Open_Source_Portal * * The Mercurial repository for the trunk version is at @@ -18,21 +18,21 @@ * $LicenseInfo:firstyear=2007&license=viewerlgpl$ * Second Life Viewer Source Code * Copyright (C) 2010, Linden Research, Inc. - * + * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; * version 2.1 of the License only. - * + * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. - * + * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA - * + * * Linden Research, Inc., 945 Battery Street, San Francisco, CA 94111 USA * $/LicenseInfo$ * @@ -43,10 +43,10 @@ #ifndef LL_LLAPPVIEWER_H #define LL_LLAPPVIEWER_H -#include "llallocator.h" +#include "llapp.h" #include "llapr.h" #include "llcontrol.h" -#include "llsys.h" // for LLOSInfo +#include "llsys.h" // for LLOSInfo #include "lltimer.h" #include "llappcorehttp.h" #include "threadpool_fwd.h" @@ -66,89 +66,104 @@ class LLViewerRegion; extern LLTrace::BlockTimerStatHandle FTM_FRAME; +typedef enum +{ + LAST_EXEC_NORMAL = 0, + LAST_EXEC_FROZE, + LAST_EXEC_LLERROR_CRASH, + LAST_EXEC_OTHER_CRASH, + LAST_EXEC_LOGOUT_FROZE, + LAST_EXEC_LOGOUT_CRASH, + LAST_EXEC_BAD_ALLOC, + LAST_EXEC_MISSING_FILES, + LAST_EXEC_GRAPHICS_INIT, + LAST_EXEC_COUNT +} eLastExecEvent; + class LLAppViewer : public LLApp { public: - LLAppViewer(); - virtual ~LLAppViewer(); - - /** - * @brief Access to the LLAppViewer singleton. - * - * The LLAppViewer singleton is created in main()/WinMain(). - * So don't use it in pre-entry (static initialization) code. - */ - static LLAppViewer* instance() {return sInstance; } - - // - // Main application logic - // - virtual bool init(); // Override to do application initialization - virtual bool cleanup(); // Override to do application cleanup - virtual bool frame(); // Override for application body logic - - // Application control - void flushLFSIO(); // waits for lfs transfers to complete - void forceQuit(); // Puts the viewer into 'shutting down without error' mode. - void fastQuit(S32 error_code = 0); // Shuts down the viewer immediately after sending a logout message - void requestQuit(); // Request a quit. A kinder, gentler quit. - void userQuit(); // The users asks to quit. Confirm, then requestQuit() - void earlyExit(const std::string& name, - const LLSD& substitutions = LLSD()); // Display an error dialog and forcibly quit. - void earlyExitNoNotify(); // Do not display error dialog then forcibly quit. - void abortQuit(); // Called to abort a quit request. - - bool quitRequested() { return mQuitRequested; } - bool logoutRequestSent() { return mLogoutRequestSent; } - bool isSecondInstance() { return mSecondInstance; } + LLAppViewer(); + virtual ~LLAppViewer(); + + /** + * @brief Access to the LLAppViewer singleton. + * + * The LLAppViewer singleton is created in main()/WinMain(). + * So don't use it in pre-entry (static initialization) code. + */ + static LLAppViewer* instance() {return sInstance; } + + // + // Main application logic + // + virtual bool init(); // Override to do application initialization + virtual bool cleanup(); // Override to do application cleanup + virtual bool frame(); // Override for application body logic + + // Application control + void flushLFSIO(); // waits for lfs transfers to complete + void forceQuit(); // Puts the viewer into 'shutting down without error' mode. + void fastQuit(S32 error_code = 0); // Shuts down the viewer immediately after sending a logout message + void requestQuit(); // Request a quit. A kinder, gentler quit. + void userQuit(); // The users asks to quit. Confirm, then requestQuit() + void earlyExit(const std::string& name, + const LLSD& substitutions = LLSD()); // Display an error dialog and forcibly quit. + void earlyExitNoNotify(); // Do not display error dialog then forcibly quit. + void abortQuit(); // Called to abort a quit request. + + bool quitRequested() { return mQuitRequested; } + bool logoutRequestSent() { return mLogoutRequestSent; } + bool isSecondInstance() { return mSecondInstance; } bool isUpdaterMissing(); // In use by tests bool waitForUpdater(); - void writeDebugInfo(bool isStatic=true); + void writeDebugInfo(bool isStatic=true); - void setServerReleaseNotesURL(const std::string& url) { mServerReleaseNotesURL = url; } - LLSD getViewerInfo() const; - std::string getViewerInfoString(bool default_string = false) const; + void setServerReleaseNotesURL(const std::string& url) { mServerReleaseNotesURL = url; } + LLSD getViewerInfo() const; + std::string getViewerInfoString(bool default_string = false) const; - // Report true if under the control of a debugger. A null-op default. - virtual bool beingDebugged() { return false; } + // Report true if under the control of a debugger. A null-op default. + virtual bool beingDebugged() { return false; } - virtual bool restoreErrorTrap() = 0; // Require platform specific override to reset error handling mechanism. - // return false if the error trap needed restoration. - void checkForCrash(); - - // Thread accessors - static LLTextureCache* getTextureCache() { return sTextureCache; } - static LLImageDecodeThread* getImageDecodeThread() { return sImageDecodeThread; } - static LLTextureFetch* getTextureFetch() { return sTextureFetch; } - static LLPurgeDiskCacheThread* getPurgeDiskCacheThread() { return sPurgeDiskCacheThread; } + virtual bool restoreErrorTrap() = 0; // Require platform specific override to reset error handling mechanism. + // return false if the error trap needed restoration. + void checkForCrash(); - static U32 getTextureCacheVersion() ; - static U32 getObjectCacheVersion() ; + // Thread accessors + static LLTextureCache* getTextureCache() { return sTextureCache; } + static LLImageDecodeThread* getImageDecodeThread() { return sImageDecodeThread; } + static LLTextureFetch* getTextureFetch() { return sTextureFetch; } + static LLPurgeDiskCacheThread* getPurgeDiskCacheThread() { return sPurgeDiskCacheThread; } + + static U32 getTextureCacheVersion() ; + static U32 getObjectCacheVersion() ; static U32 getDiskCacheVersion() ; - const std::string& getSerialNumber() { return mSerialNumber; } + const std::string& getSerialNumber() { return mSerialNumber; } - bool getPurgeCache() const { return mPurgeCache; } + bool getPurgeCache() const { return mPurgeCache; } - std::string getSecondLifeTitle() const; // The Second Life title. - std::string getWindowTitle() const; // The window display name. + std::string getSecondLifeTitle() const; // The Second Life title. + std::string getWindowTitle() const; // The window display name. - void forceDisconnect(const std::string& msg); // Force disconnection, with a message to the user. - void badNetworkHandler(); // Cause a crash state due to bad network packet. + void forceDisconnect(const std::string& msg); // Force disconnection, with a message to the user. + void badNetworkHandler(); // Cause a crash state due to bad network packet. - bool hasSavedFinalSnapshot() { return mSavedFinalSnapshot; } - void saveFinalSnapshot(); + bool hasSavedFinalSnapshot() { return mSavedFinalSnapshot; } + void saveFinalSnapshot(); - void loadNameCache(); - void saveNameCache(); + void loadNameCache(); + void saveNameCache(); - void loadExperienceCache(); - void saveExperienceCache(); + void loadExperienceCache(); + void saveExperienceCache(); - void removeMarkerFiles(); + void removeMarkerFiles(); + void recordSessionToMarker(); - void removeDumpDir(); + void removeDumpDir(); // LLAppViewer testing helpers. // *NOTE: These will potentially crash the viewer. Only for debugging. virtual void forceErrorLLError(); @@ -157,205 +172,205 @@ public: virtual void forceErrorBadMemoryAccess(); virtual void forceErrorInfiniteLoop(); virtual void forceErrorSoftwareException(); + virtual void forceErrorOSSpecificException(); virtual void forceErrorDriverCrash(); virtual void forceErrorCoroutineCrash(); virtual void forceErrorThreadCrash(); - // The list is found in app_settings/settings_files.xml - // but since they are used explicitly in code, - // the follow consts should also do the trick. - static const std::string sGlobalSettingsName; - - LLCachedControl<bool> mRandomizeFramerate; - LLCachedControl<bool> mPeriodicSlowFrame; - - // Load settings from the location specified by loction_key. - // Key availale and rules for loading, are specified in - // 'app_settings/settings_files.xml' - bool loadSettingsFromDirectory(const std::string& location_key, - bool set_defaults = false); - - std::string getSettingsFilename(const std::string& location_key, - const std::string& file); - void loadColorSettings(); - - // For thread debugging. - // llstartup needs to control init. - // llworld, send_agent_pause() also controls pause/resume. - void initMainloopTimeout(const std::string& state, F32 secs = -1.0f); - void destroyMainloopTimeout(); - void pauseMainloopTimeout(); - void resumeMainloopTimeout(const std::string& state = "", F32 secs = -1.0f); - void pingMainloopTimeout(const std::string& state, F32 secs = -1.0f); - - // Handle the 'login completed' event. - // *NOTE:Mani Fix this for login abstraction!! - void handleLoginComplete(); - - LLAllocator & getAllocator() { return mAlloc; } - - // On LoginCompleted callback - typedef boost::signals2::signal<void (void)> login_completed_signal_t; - login_completed_signal_t mOnLoginCompleted; - boost::signals2::connection setOnLoginCompletedCallback( const login_completed_signal_t::slot_type& cb ) - { - return mOnLoginCompleted.connect(cb); - } - - void addOnIdleCallback(const boost::function<void()>& cb); // add a callback to fire (once) when idle + // The list is found in app_settings/settings_files.xml + // but since they are used explicitly in code, + // the follow consts should also do the trick. + static const std::string sGlobalSettingsName; + + LLCachedControl<bool> mRandomizeFramerate; + LLCachedControl<bool> mPeriodicSlowFrame; + + // Load settings from the location specified by loction_key. + // Key availale and rules for loading, are specified in + // 'app_settings/settings_files.xml' + bool loadSettingsFromDirectory(const std::string& location_key, + bool set_defaults = false); + + std::string getSettingsFilename(const std::string& location_key, + const std::string& file); + void loadColorSettings(); + + // For thread debugging. + // llstartup needs to control init. + // llworld, send_agent_pause() also controls pause/resume. + void initMainloopTimeout(const std::string& state, F32 secs = -1.0f); + void destroyMainloopTimeout(); + void pauseMainloopTimeout(); + void resumeMainloopTimeout(const std::string& state = "", F32 secs = -1.0f); + void pingMainloopTimeout(const std::string& state, F32 secs = -1.0f); + + // Handle the 'login completed' event. + // *NOTE:Mani Fix this for login abstraction!! + void handleLoginComplete(); + + // On LoginCompleted callback + typedef boost::signals2::signal<void (void)> login_completed_signal_t; + login_completed_signal_t mOnLoginCompleted; + boost::signals2::connection setOnLoginCompletedCallback( const login_completed_signal_t::slot_type& cb ) + { + return mOnLoginCompleted.connect(cb); + } + + void addOnIdleCallback(const boost::function<void()>& cb); // add a callback to fire (once) when idle void initGeneralThread(); - void purgeUserDataOnExit() { mPurgeUserDataOnExit = true; } - void purgeCache(); // Clear the local cache. - void purgeCacheImmediate(); //clear local cache immediately. - S32 updateTextureThreads(F32 max_time); + void purgeUserDataOnExit() { mPurgeUserDataOnExit = true; } + void purgeCache(); // Clear the local cache. + void purgeCacheImmediate(); //clear local cache immediately. + S32 updateTextureThreads(F32 max_time); + + void loadKeyBindings(); - void loadKeyBindings(); + // mute/unmute the system's master audio + virtual void setMasterSystemAudioMute(bool mute); + virtual bool getMasterSystemAudioMute(); - // mute/unmute the system's master audio - virtual void setMasterSystemAudioMute(bool mute); - virtual bool getMasterSystemAudioMute(); + // Metrics policy helper statics. + static void metricsUpdateRegion(U64 region_handle); + static void metricsSend(bool enable_reporting); - // Metrics policy helper statics. - static void metricsUpdateRegion(U64 region_handle); - static void metricsSend(bool enable_reporting); + // llcorehttp init/shutdown/config information. + LLAppCoreHttp & getAppCoreHttp() { return mAppCoreHttp; } - // llcorehttp init/shutdown/config information. - LLAppCoreHttp & getAppCoreHttp() { return mAppCoreHttp; } + void updateNameLookupUrl(const LLViewerRegion* regionp); - void updateNameLookupUrl(const LLViewerRegion* regionp); + // post given work to the "mainloop" work queue for handling on the main thread + void postToMainCoro(const LL::WorkQueue::Work& work); + + // Writes an error code into the error_marker file for use on next startup. + void createErrorMarker(eLastExecEvent error_code) const; + + // Attempt a 'soft' quit with disconnect and saving of settings/cache. + // Intended to be thread safe. + // Good chance of viewer crashing either way, but better than alternatives. + // Note: mQuitRequested can be aborted by user. + void outOfMemorySoftQuit(); protected: - virtual bool initWindow(); // Initialize the viewer's window. - virtual void initLoggingAndGetLastDuration(); // Initialize log files, logging system - virtual void initConsole() {}; // Initialize OS level debugging console. - virtual bool initHardwareTest() { return true; } // A false result indicates the app should quit. - virtual bool initSLURLHandler(); - virtual bool sendURLToOtherInstance(const std::string& url); + virtual bool initWindow(); // Initialize the viewer's window. + virtual void initLoggingAndGetLastDuration(); // Initialize log files, logging system + virtual void initConsole() {}; // Initialize OS level debugging console. + virtual bool initHardwareTest() { return true; } // A false result indicates the app should quit. + virtual bool initSLURLHandler(); + virtual bool sendURLToOtherInstance(const std::string& url); + + virtual bool initParseCommandLine(LLCommandLineParser& clp) + { return true; } // Allow platforms to specify the command line args. - virtual bool initParseCommandLine(LLCommandLineParser& clp) - { return true; } // Allow platforms to specify the command line args. + virtual std::string generateSerialNumber() = 0; // Platforms specific classes generate this. - virtual std::string generateSerialNumber() = 0; // Platforms specific classes generate this. + virtual bool meetsRequirementsForMaximizedStart(); // Used on first login to decide to launch maximized - virtual bool meetsRequirementsForMaximizedStart(); // Used on first login to decide to launch maximized + virtual void sendOutOfDiskSpaceNotification(); private: - bool doFrame(); + bool doFrame(); - void initMaxHeapSize(); - bool initThreads(); // Initialize viewer threads, return false on failure. - bool initConfiguration(); // Initialize settings from the command line/config file. - void initStrings(); // Initialize LLTrans machinery - bool initCache(); // Initialize local client cache. + void initMaxHeapSize(); + bool initThreads(); // Initialize viewer threads, return false on failure. + bool initConfiguration(); // Initialize settings from the command line/config file. + void initStrings(); // Initialize LLTrans machinery + bool initCache(); // Initialize local client cache. - // We have switched locations of both Mac and Windows cache, make sure - // files migrate and old cache is cleared out. - void migrateCacheDirectory(); + // We have switched locations of both Mac and Windows cache, make sure + // files migrate and old cache is cleared out. + void migrateCacheDirectory(); - void cleanupSavedSettings(); // Sets some config data to current or default values during cleanup. - void removeCacheFiles(const std::string& filemask); // Deletes cached files the match the given wildcard. + void cleanupSavedSettings(); // Sets some config data to current or default values during cleanup. + void removeCacheFiles(const std::string& filemask); // Deletes cached files the match the given wildcard. - void writeSystemInfo(); // Write system info to "debug_info.log" + void writeSystemInfo(); // Write system info to "debug_info.log" - void processMarkerFiles(); - static void recordMarkerVersion(LLAPRFile& marker_file); - bool markerIsSameVersion(const std::string& marker_name) const; + void processMarkerFiles(); + static void recordMarkerVersion(LLAPRFile& marker_file); + bool markerIsSameVersion(const std::string& marker_name) const; + LLUUID getMarkerSessionId(const std::string& marker_name) const; + S32 getMarkerErrorCode(const std::string& marker_name) const; + bool getMarkerData(const std::string& marker_name, std::string &data) const; - void idle(); - void idleShutdown(); - // update avatar SLID and display name caches - void idleNameCache(); - void idleNetwork(); + void idle(); + void idleShutdown(); + // update avatar SLID and display name caches + void idleNameCache(); + void idleNetwork(); - void sendLogoutRequest(); - void disconnectViewer(); + void sendLogoutRequest(); + void disconnectViewer(); - // *FIX: the app viewer class should be some sort of singleton, no? - // Perhaps its child class is the singleton and this should be an abstract base. - static LLAppViewer* sInstance; + // *FIX: the app viewer class should be some sort of singleton, no? + // Perhaps its child class is the singleton and this should be an abstract base. + static LLAppViewer* sInstance; - bool mSecondInstance; // Is this a second instance of the app? - bool mUpdaterNotFound; // True when attempt to start updater failed + bool mSecondInstance; // Is this a second instance of the app? + bool mUpdaterNotFound; // True when attempt to start updater failed - std::string mMarkerFileName; - LLAPRFile mMarkerFile; // A file created to indicate the app is running. + std::string mMarkerFileName; + LLAPRFile mMarkerFile; // A file created to indicate the app is running. - std::string mLogoutMarkerFileName; - LLAPRFile mLogoutMarkerFile; // A file created to indicate the app is running. + std::string mLogoutMarkerFileName; + LLAPRFile mLogoutMarkerFile; // A file created to indicate the app is running. - bool mReportedCrash; + bool mReportedCrash; - std::string mServerReleaseNotesURL; + std::string mServerReleaseNotesURL; - // Thread objects. - static LLTextureCache* sTextureCache; - static LLImageDecodeThread* sImageDecodeThread; - static LLTextureFetch* sTextureFetch; - static LLPurgeDiskCacheThread* sPurgeDiskCacheThread; + // Thread objects. + static LLTextureCache* sTextureCache; + static LLImageDecodeThread* sImageDecodeThread; + static LLTextureFetch* sTextureFetch; + static LLPurgeDiskCacheThread* sPurgeDiskCacheThread; LL::ThreadPool* mGeneralThreadPool; - S32 mNumSessions; + S32 mNumSessions; - std::string mSerialNumber; - bool mPurgeCache; - bool mPurgeCacheOnExit; - bool mPurgeUserDataOnExit; - LLViewerJoystick* joystick; + std::string mSerialNumber; + bool mPurgeCache; + bool mPurgeCacheOnExit; + bool mPurgeUserDataOnExit; + LLViewerJoystick* joystick; - bool mSavedFinalSnapshot; - bool mSavePerAccountSettings; // only save per account settings if login succeeded + bool mSavedFinalSnapshot; + bool mSavePerAccountSettings; // only save per account settings if login succeeded - boost::optional<U32> mForceGraphicsLevel; + boost::optional<U32> mForceGraphicsLevel; - bool mQuitRequested; // User wants to quit, may have modified documents open. - bool mLogoutRequestSent; // Disconnect message sent to simulator, no longer safe to send messages to the sim. - U32 mLastAgentControlFlags; - F32 mLastAgentForceUpdate; - struct SettingsFiles* mSettingsLocationList; + bool mQuitRequested; // User wants to quit, may have modified documents open. + bool mClosingFloaters; + bool mLogoutRequestSent; // Disconnect message sent to simulator, no longer safe to send messages to the sim. + struct SettingsFiles* mSettingsLocationList; - LLWatchdogTimeout* mMainloopTimeout; + LLWatchdogTimeout* mMainloopTimeout; - // For performance and metric gathering - class LLThread* mFastTimerLogThread; + // For performance and metric gathering + class LLThread* mFastTimerLogThread; - // for tracking viewer<->region circuit death - bool mAgentRegionLastAlive; - LLUUID mAgentRegionLastID; + // for tracking viewer<->region circuit death + bool mAgentRegionLastAlive; + LLUUID mAgentRegionLastID; - LLAllocator mAlloc; + // llcorehttp library init/shutdown helper + LLAppCoreHttp mAppCoreHttp; - // llcorehttp library init/shutdown helper - LLAppCoreHttp mAppCoreHttp; - - bool mIsFirstRun; + bool mIsFirstRun; }; -// consts from viewer.h -const S32 AGENT_UPDATES_PER_SECOND = 10; -const S32 AGENT_FORCE_UPDATES_PER_SECOND = 1; - // Globals with external linkage. From viewer.h // *NOTE:Mani - These will be removed as the Viewer App Cleanup project continues. // // "// llstartup" indicates that llstartup is the only client for this global. extern LLSD gDebugInfo; -extern BOOL gShowObjectUpdates; - -typedef enum -{ - LAST_EXEC_NORMAL = 0, - LAST_EXEC_FROZE, - LAST_EXEC_LLERROR_CRASH, - LAST_EXEC_OTHER_CRASH, - LAST_EXEC_LOGOUT_FROZE, - LAST_EXEC_LOGOUT_CRASH -} eLastExecEvent; +extern bool gShowObjectUpdates; extern eLastExecEvent gLastExecEvent; // llstartup extern S32 gLastExecDuration; ///< the duration of the previous run in seconds (<0 indicates unknown) +extern LLUUID gLastAgentSessionId; // will be set if agent logged in extern const char* gPlatform; @@ -364,12 +379,12 @@ extern U32 gForegroundFrameCount; extern LLPumpIO* gServicePump; -extern U64MicrosecondsImplicit gStartTime; -extern U64MicrosecondsImplicit gFrameTime; // The timestamp of the most-recently-processed frame -extern F32SecondsImplicit gFrameTimeSeconds; // Loses msec precision after ~4.5 hours... -extern F32SecondsImplicit gFrameIntervalSeconds; // Elapsed time between current and previous gFrameTimeSeconds -extern F32 gFPSClamped; // Frames per second, smoothed, weighted toward last frame -extern F32 gFrameDTClamped; +extern U64MicrosecondsImplicit gStartTime; +extern U64MicrosecondsImplicit gFrameTime; // The timestamp of the most-recently-processed frame +extern F32SecondsImplicit gFrameTimeSeconds; // Loses msec precision after ~4.5 hours... +extern F32SecondsImplicit gFrameIntervalSeconds; // Elapsed time between current and previous gFrameTimeSeconds +extern F32 gFPSClamped; // Frames per second, smoothed, weighted toward last frame +extern F32 gFrameDTClamped; extern LLTimer gRenderStartTime; extern LLFrameTimer gForegroundTime; @@ -380,14 +395,14 @@ extern LLTimer gLogoutTimer; extern S32 gPendingMetricsUploads; -extern F32 gSimLastTime; +extern F32 gSimLastTime; extern F32 gSimFrames; -extern BOOL gDisconnected; +extern bool gDisconnected; -extern LLFrameTimer gRestoreGLTimer; -extern BOOL gRestoreGL; -extern bool gUseWireframe; +extern LLFrameTimer gRestoreGLTimer; +extern bool gRestoreGL; +extern bool gUseWireframe; extern LLMemoryInfo gSysMemory; extern U64Bytes gMemoryAllocated; @@ -396,14 +411,12 @@ extern std::string gLastVersionChannel; extern LLVector3 gWindVec; extern LLVector3 gRelativeWindVec; -extern U32 gPacketsIn; -extern BOOL gPrintMessagesThisFrame; - -extern LLUUID gBlackSquareID; +extern U32 gPacketsIn; +extern bool gPrintMessagesThisFrame; -extern BOOL gRandomizeFramerate; -extern BOOL gPeriodicSlowFrame; +extern bool gRandomizeFramerate; +extern bool gPeriodicSlowFrame; -extern BOOL gSimulateMemLeak; +extern bool gSimulateMemLeak; #endif // LL_LLAPPVIEWER_H |