Merge remote-tracking branch 'origin/main' into DRTVWR-600-maint-A

# Conflicts:
#	autobuild.xml
#	indra/cmake/CMakeLists.txt
#	indra/cmake/GoogleMock.cmake
#	indra/llaudio/llaudioengine_fmodstudio.cpp
#	indra/llaudio/llaudioengine_fmodstudio.h
#	indra/llaudio/lllistener_fmodstudio.cpp
#	indra/llaudio/lllistener_fmodstudio.h
#	indra/llaudio/llstreamingaudio_fmodstudio.cpp
#	indra/llaudio/llstreamingaudio_fmodstudio.h
#	indra/llcharacter/llmultigesture.cpp
#	indra/llcharacter/llmultigesture.h
#	indra/llimage/llimage.cpp
#	indra/llimage/llimagepng.cpp
#	indra/llimage/llimageworker.cpp
#	indra/llimage/tests/llimageworker_test.cpp
#	indra/llmessage/tests/llmockhttpclient.h
#	indra/llprimitive/llgltfmaterial.h
#	indra/llrender/llfontfreetype.cpp
#	indra/llui/llcombobox.cpp
#	indra/llui/llfolderview.cpp
#	indra/llui/llfolderviewmodel.h
#	indra/llui/lllineeditor.cpp
#	indra/llui/lllineeditor.h
#	indra/llui/lltextbase.cpp
#	indra/llui/lltextbase.h
#	indra/llui/lltexteditor.cpp
#	indra/llui/lltextvalidate.cpp
#	indra/llui/lltextvalidate.h
#	indra/llui/lluictrl.h
#	indra/llui/llview.cpp
#	indra/llwindow/llwindowmacosx.cpp
#	indra/newview/app_settings/settings.xml
#	indra/newview/llappearancemgr.cpp
#	indra/newview/llappearancemgr.h
#	indra/newview/llavatarpropertiesprocessor.cpp
#	indra/newview/llavatarpropertiesprocessor.h
#	indra/newview/llbreadcrumbview.cpp
#	indra/newview/llbreadcrumbview.h
#	indra/newview/llbreastmotion.cpp
#	indra/newview/llbreastmotion.h
#	indra/newview/llconversationmodel.h
#	indra/newview/lldensityctrl.cpp
#	indra/newview/lldensityctrl.h
#	indra/newview/llface.inl
#	indra/newview/llfloatereditsky.cpp
#	indra/newview/llfloatereditwater.cpp
#	indra/newview/llfloateremojipicker.h
#	indra/newview/llfloaterimsessiontab.cpp
#	indra/newview/llfloaterprofiletexture.cpp
#	indra/newview/llfloaterprofiletexture.h
#	indra/newview/llgesturemgr.cpp
#	indra/newview/llgesturemgr.h
#	indra/newview/llimpanel.cpp
#	indra/newview/llimpanel.h
#	indra/newview/llinventorybridge.cpp
#	indra/newview/llinventorybridge.h
#	indra/newview/llinventoryclipboard.cpp
#	indra/newview/llinventoryclipboard.h
#	indra/newview/llinventoryfunctions.cpp
#	indra/newview/llinventoryfunctions.h
#	indra/newview/llinventorygallery.cpp
#	indra/newview/lllistbrowser.cpp
#	indra/newview/lllistbrowser.h
#	indra/newview/llpanelobjectinventory.cpp
#	indra/newview/llpanelprofile.cpp
#	indra/newview/llpanelprofile.h
#	indra/newview/llpreviewgesture.cpp
#	indra/newview/llsavedsettingsglue.cpp
#	indra/newview/llsavedsettingsglue.h
#	indra/newview/lltooldraganddrop.cpp
#	indra/newview/llurllineeditorctrl.cpp
#	indra/newview/llvectorperfoptions.cpp
#	indra/newview/llvectorperfoptions.h
#	indra/newview/llviewerparceloverlay.cpp
#	indra/newview/llviewertexlayer.cpp
#	indra/newview/llviewertexturelist.cpp
#	indra/newview/macmain.h
#	indra/test/test.cpp

1 files changed, 334 insertions, 328 deletions

diff --git a/indra/llwindow/llwindow.h b/indra/llwindow/llwindow.h
index 396daec527..5eca3e8939 100644
--- a/indra/llwindow/llwindow.h
+++ b/indra/llwindow/llwindow.h
@@ -1,328 +1,334 @@
-/** 
- * @file llwindow.h
- * @brief Basic graphical window class
- *
- * $LicenseInfo:firstyear=2001&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$
- */
-
-#ifndef LL_LLWINDOW_H
-#define LL_LLWINDOW_H
-
-#include "llrect.h"
-#include "llcoord.h"
-#include "llstring.h"
-#include "llcursortypes.h"
-#include "llinstancetracker.h"
-#include "llsd.h"
-
-class LLSplashScreen;
-class LLPreeditor;
-class LLWindowCallbacks;
-
-// Refer to llwindow_test in test/common/llwindow for usage example
-
-class LLWindow : public LLInstanceTracker<LLWindow>
-{
-public:
-
-	struct LLWindowResolution
-	{
-		S32 mWidth;
-		S32 mHeight;
-	};
-	enum ESwapMethod
-	{
-		SWAP_METHOD_UNDEFINED,
-		SWAP_METHOD_EXCHANGE,
-		SWAP_METHOD_COPY
-	};
-	enum EFlags
-	{
-		// currently unused
-	};
-public:
-	virtual void show() = 0;
-	virtual void hide() = 0;
-	virtual void close() = 0;
-	virtual bool getVisible() = 0;
-	virtual bool getMinimized() = 0;
-	virtual bool getMaximized() = 0;
-	virtual bool maximize() = 0;
-	virtual void minimize() = 0;
-	virtual void restore() = 0;
-	bool getFullscreen()	{ return mFullscreen; };
-	virtual bool getPosition(LLCoordScreen *position) = 0;
-	virtual bool getSize(LLCoordScreen *size) = 0;
-	virtual bool getSize(LLCoordWindow *size) = 0;
-	virtual bool setPosition(LLCoordScreen position) = 0;
-	bool setSize(LLCoordScreen size);
-	bool setSize(LLCoordWindow size);
-	virtual void setMinSize(U32 min_width, U32 min_height, bool enforce_immediately = true);
-	virtual bool switchContext(bool fullscreen, const LLCoordScreen &size, bool enable_vsync, const LLCoordScreen * const posp = NULL) = 0;
-
-    //create a new GL context that shares a namespace with this Window's main GL context and make it current on the current thread
-    // returns a pointer to be handed back to destroySharedConext/makeContextCurrent
-    virtual void* createSharedContext() = 0;
-    //make the given context current on the current thread
-    virtual void makeContextCurrent(void* context) = 0;
-    //destroy the given context that was retrieved by createSharedContext()
-    //Must be called on the same thread that called createSharedContext()
-    virtual void destroySharedContext(void* context) = 0;
-
-    virtual void toggleVSync(bool enable_vsync) = 0;
-
-    virtual bool setCursorPosition(LLCoordWindow position) = 0;
-	virtual bool getCursorPosition(LLCoordWindow *position) = 0;
-#if LL_WINDOWS
-    virtual bool getCursorDelta(LLCoordCommon* delta) = 0;
-#endif
-	virtual void showCursor() = 0;
-	virtual void hideCursor() = 0;
-	virtual bool isCursorHidden() = 0;
-	virtual void showCursorFromMouseMove() = 0;
-	virtual void hideCursorUntilMouseMove() = 0;
-
-    // Provide a way to set the Viewer window title after the
-    // windows has been created. The initial use case for this
-    // is described in SL-16102 (update window title with agent 
-    // name, location etc. for non-interactive viewer) but it
-    // may also be useful in other cases.
-    virtual void setTitle(const std::string title);
-
-	// These two functions create a way to make a busy cursor instead
-	// of an arrow when someone's busy doing something. Draw an
-	// arrow/hour if busycount > 0.
-	virtual void incBusyCount();
-	virtual void decBusyCount();
-	virtual void resetBusyCount();
-	virtual S32 getBusyCount() const;
-
-	// Sets cursor, may set to arrow+hourglass
-	virtual void setCursor(ECursorType cursor) { mNextCursor = cursor; };
-    virtual ECursorType getCursor() const;
-    virtual ECursorType getNextCursor() const { return mNextCursor; };
-	virtual void updateCursor() = 0;
-
-	virtual void captureMouse() = 0;
-	virtual void releaseMouse() = 0;
-	virtual void setMouseClipping( bool b ) = 0;
-
-	virtual bool isClipboardTextAvailable() = 0;
-	virtual bool pasteTextFromClipboard(LLWString &dst) = 0;
-	virtual bool copyTextToClipboard(const LLWString &src) = 0;
-
-	virtual bool isPrimaryTextAvailable();
-	virtual bool pasteTextFromPrimary(LLWString &dst);
-	virtual bool copyTextToPrimary(const LLWString &src);
- 
-	virtual void flashIcon(F32 seconds) = 0;
-	virtual F32 getGamma() = 0;
-	virtual bool setGamma(const F32 gamma) = 0; // Set the gamma
-	virtual void setFSAASamples(const U32 fsaa_samples) = 0; //set number of FSAA samples
-	virtual U32	 getFSAASamples() = 0;
-	virtual bool restoreGamma() = 0;			// Restore original gamma table (before updating gamma)
-	virtual ESwapMethod getSwapMethod() { return mSwapMethod; }
-	virtual void processMiscNativeEvents();
-	virtual void gatherInput() = 0;
-	virtual void delayInputProcessing() = 0;
-	virtual void swapBuffers() = 0;
-	virtual void bringToFront() = 0;
-	virtual void focusClient() { };		// this may not have meaning or be required on other platforms, therefore, it's not abstract
-	virtual void setOldResize(bool oldresize) { };
-	// handy coordinate space conversion routines
-	// NB: screen to window and vice verse won't work on width/height coordinate pairs,
-	// as the conversion must take into account left AND right border widths, etc.
-	virtual bool convertCoords( LLCoordScreen from, LLCoordWindow *to) = 0;
-	virtual bool convertCoords( LLCoordWindow from, LLCoordScreen *to) = 0;
-	virtual bool convertCoords( LLCoordWindow from, LLCoordGL *to) = 0;
-	virtual bool convertCoords( LLCoordGL from, LLCoordWindow *to) = 0;
-	virtual bool convertCoords( LLCoordScreen from, LLCoordGL *to) = 0;
-	virtual bool convertCoords( LLCoordGL from, LLCoordScreen *to) = 0;
-
-	// query supported resolutions
-	virtual LLWindowResolution* getSupportedResolutions(S32 &num_resolutions) = 0;
-	virtual F32	getNativeAspectRatio() = 0;
-	virtual F32 getPixelAspectRatio() = 0;
-	virtual void setNativeAspectRatio(F32 aspect) = 0;
-
-    virtual void setMaxVRAMMegabytes(U32 max_vram) = 0;
-
-	virtual void beforeDialog() {};	// prepare to put up an OS dialog (if special measures are required, such as in fullscreen mode)
-	virtual void afterDialog() {};	// undo whatever was done in beforeDialog()
-
-	// opens system default color picker, modally
-	// Returns true if valid color selected
-	virtual bool dialogColorPicker(F32 *r, F32 *g, F32 *b);
-
-// return a platform-specific window reference (HWND on Windows, WindowRef on the Mac, Gtk window on Linux)
-	virtual void *getPlatformWindow() = 0;
-
-// return the platform-specific window reference we use to initialize llmozlib (HWND on Windows, WindowRef on the Mac, Gtk window on Linux)
-	virtual void *getMediaWindow();
-	
-	// control platform's Language Text Input mechanisms.
-	virtual void allowLanguageTextInput(LLPreeditor *preeditor, bool b) {}
-	virtual void setLanguageTextInput( const LLCoordGL & pos ) {};
-	virtual void updateLanguageTextInputArea() {}
-	virtual void interruptLanguageTextInput() {}
-	virtual void spawnWebBrowser(const std::string& escaped_url, bool async) {};
-
-	static std::vector<std::string> getDynamicFallbackFontList();
-	
-	// Provide native key event data
-	virtual LLSD getNativeKeyData() { return LLSD::emptyMap(); }
-
-	// Get system UI size based on DPI (for 96 DPI UI size should be 1.0)
-	virtual F32 getSystemUISize() { return 1.0; }
-
-	static std::vector<std::string> getDisplaysResolutionList();
-
-    // windows only DirectInput8 for joysticks
-    virtual void* getDirectInput8() { return NULL; };
-    virtual bool getInputDevices(U32 device_type_filter, void * devices_callback, void* userdata) { return false; };
-
-    virtual S32 getRefreshRate() { return mRefreshRate; }
-protected:
-	LLWindow(LLWindowCallbacks* callbacks, bool fullscreen, U32 flags);
-	virtual ~LLWindow();
-	// Defaults to true
-	virtual bool isValid();
-	// Defaults to true
-	virtual bool canDelete();
-
-	virtual bool setSizeImpl(LLCoordScreen size) = 0;
-	virtual bool setSizeImpl(LLCoordWindow size) = 0;
-
-protected:
-	LLWindowCallbacks*	mCallbacks;
-
-	bool		mPostQuit;		// should this window post a quit message when destroyed?
-	bool		mFullscreen;
-	S32			mFullscreenWidth;
-	S32			mFullscreenHeight;
-	S32			mFullscreenBits;
-	S32			mFullscreenRefresh;
-	LLWindowResolution* mSupportedResolutions;
-	S32			mNumSupportedResolutions;
-	ECursorType	mCurrentCursor;
-	ECursorType	mNextCursor;
-	bool		mCursorHidden;
-	S32			mBusyCount;	// how deep is the "cursor busy" stack?
-	bool		mIsMouseClipping;  // Is this window currently clipping the mouse
-	ESwapMethod mSwapMethod;
-	bool		mHideCursorPermanent;
-	U32			mFlags;
-	U16			mHighSurrogate;
-	S32			mMinWindowWidth;
-	S32			mMinWindowHeight;
-    S32         mRefreshRate;
-
- 	// Handle a UTF-16 encoding unit received from keyboard.
- 	// Converting the series of UTF-16 encoding units to UTF-32 data,
- 	// this method passes the resulting UTF-32 data to mCallback's
- 	// handleUnicodeChar.  The mask should be that to be passed to the
- 	// callback.  This method uses mHighSurrogate as a dedicated work
- 	// variable.
-	void handleUnicodeUTF16(U16 utf16, MASK mask);
-
-	friend class LLWindowManager;
-};
-
-
-// LLSplashScreen
-// A simple, OS-specific splash screen that we can display
-// while initializing the application and before creating a GL
-// window
-
-
-class LLSplashScreen
-{
-public:
-	LLSplashScreen() { };
-	virtual ~LLSplashScreen() { };
-
-
-	// Call to display the window.
-	static LLSplashScreen * create();
-	static void show();
-	static void hide();
-	static void update(const std::string& string);
-
-	static bool isVisible();
-protected:
-	// These are overridden by the platform implementation
-	virtual void showImpl() = 0;
-	virtual void updateImpl(const std::string& string) = 0;
-	virtual void hideImpl() = 0;
-
-	static bool sVisible;
-
-};
-
-// Platform-neutral for accessing the platform specific message box
-S32 OSMessageBox(const std::string& text, const std::string& caption, U32 type);
-const U32 OSMB_OK = 0;
-const U32 OSMB_OKCANCEL = 1;
-const U32 OSMB_YESNO = 2;
-
-const S32 OSBTN_YES = 0;
-const S32 OSBTN_NO = 1;
-const S32 OSBTN_OK = 2;
-const S32 OSBTN_CANCEL = 3;
-
-//
-// LLWindowManager
-// Manages window creation and error checking
-
-class LLWindowManager
-{
-public:
-	static LLWindow *createWindow(
-		LLWindowCallbacks* callbacks,
-		const std::string& title, const std::string& name, S32 x, S32 y, S32 width, S32 height,
-		U32 flags = 0,
-		bool fullscreen = false,
-		bool clearBg = false,
-		bool enable_vsync = false,
-		bool use_gl = true,
-		bool ignore_pixel_depth = false,
-		U32 fsaa_samples = 0,
-        U32 max_cores = 0,
-        U32 max_vram = 0,
-        F32 max_gl_version = 4.6f);
-	static bool destroyWindow(LLWindow* window);
-	static bool isWindowValid(LLWindow *window);
-};
-
-//
-// helper funcs
-//
-extern bool gDebugWindowProc;
-
-// Protocols, like "http" and "https" we support in URLs
-extern const S32 gURLProtocolWhitelistCount;
-extern const std::string gURLProtocolWhitelist[];
-//extern const std::string gURLProtocolWhitelistHandler[];
-
-void simpleEscapeString ( std::string& stringIn  );
-
-#endif // _LL_window_h_
+/**

+ * @file llwindow.h

+ * @brief Basic graphical window class

+ *

+ * $LicenseInfo:firstyear=2001&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$

+ */

+

+#ifndef LL_LLWINDOW_H

+#define LL_LLWINDOW_H

+

+#include "llrect.h"

+#include "llcoord.h"

+#include "llstring.h"

+#include "llcursortypes.h"

+#include "llinstancetracker.h"

+#include "llsd.h"

+

+class LLSplashScreen;

+class LLPreeditor;

+class LLWindowCallbacks;

+

+// Refer to llwindow_test in test/common/llwindow for usage example

+

+class LLWindow : public LLInstanceTracker<LLWindow>

+{

+public:

+

+    struct LLWindowResolution

+    {

+        S32 mWidth;

+        S32 mHeight;

+    };

+    enum ESwapMethod

+    {

+        SWAP_METHOD_UNDEFINED,

+        SWAP_METHOD_EXCHANGE,

+        SWAP_METHOD_COPY

+    };

+    enum EFlags

+    {

+        // currently unused

+    };

+public:

+    virtual void show() = 0;

+    virtual void hide() = 0;

+    virtual void close() = 0;

+    virtual bool getVisible() = 0;

+    virtual bool getMinimized() = 0;

+    virtual bool getMaximized() = 0;

+    virtual bool maximize() = 0;

+    virtual void minimize() = 0;

+    virtual void restore() = 0;

+    bool getFullscreen()    { return mFullscreen; };

+    virtual bool getPosition(LLCoordScreen *position) = 0;

+    virtual bool getSize(LLCoordScreen *size) = 0;

+    virtual bool getSize(LLCoordWindow *size) = 0;

+    virtual bool setPosition(LLCoordScreen position) = 0;

+    bool setSize(LLCoordScreen size);

+    bool setSize(LLCoordWindow size);

+    virtual void setMinSize(U32 min_width, U32 min_height, bool enforce_immediately = true);

+    virtual bool switchContext(bool fullscreen, const LLCoordScreen &size, bool enable_vsync, const LLCoordScreen * const posp = NULL) = 0;

+

+    //create a new GL context that shares a namespace with this Window's main GL context and make it current on the current thread

+    // returns a pointer to be handed back to destroySharedConext/makeContextCurrent

+    virtual void* createSharedContext() = 0;

+    //make the given context current on the current thread

+    virtual void makeContextCurrent(void* context) = 0;

+    //destroy the given context that was retrieved by createSharedContext()

+    //Must be called on the same thread that called createSharedContext()

+    virtual void destroySharedContext(void* context) = 0;

+

+    virtual void toggleVSync(bool enable_vsync) = 0;

+

+    virtual bool setCursorPosition(LLCoordWindow position) = 0;

+    virtual bool getCursorPosition(LLCoordWindow *position) = 0;

+#if LL_WINDOWS

+    virtual bool getCursorDelta(LLCoordCommon* delta) = 0;

+#endif

+    virtual void showCursor() = 0;

+    virtual void hideCursor() = 0;

+    virtual bool isCursorHidden() = 0;

+    virtual void showCursorFromMouseMove() = 0;

+    virtual void hideCursorUntilMouseMove() = 0;

+

+    // Provide a way to set the Viewer window title after the

+    // windows has been created. The initial use case for this

+    // is described in SL-16102 (update window title with agent

+    // name, location etc. for non-interactive viewer) but it

+    // may also be useful in other cases.

+    virtual void setTitle(const std::string title);

+

+    // These two functions create a way to make a busy cursor instead

+    // of an arrow when someone's busy doing something. Draw an

+    // arrow/hour if busycount > 0.

+    virtual void incBusyCount();

+    virtual void decBusyCount();

+    virtual void resetBusyCount();

+    virtual S32 getBusyCount() const;

+

+    // Sets cursor, may set to arrow+hourglass

+    virtual void setCursor(ECursorType cursor) { mNextCursor = cursor; };

+    virtual ECursorType getCursor() const;

+    virtual ECursorType getNextCursor() const { return mNextCursor; };

+    virtual void updateCursor() = 0;

+

+    virtual void captureMouse() = 0;

+    virtual void releaseMouse() = 0;

+    virtual void setMouseClipping( bool b ) = 0;

+

+    virtual bool isClipboardTextAvailable() = 0;

+    virtual bool pasteTextFromClipboard(LLWString &dst) = 0;

+    virtual bool copyTextToClipboard(const LLWString &src) = 0;

+

+    virtual bool isPrimaryTextAvailable();

+    virtual bool pasteTextFromPrimary(LLWString &dst);

+    virtual bool copyTextToPrimary(const LLWString &src);

+

+    virtual void flashIcon(F32 seconds) = 0;

+    virtual F32 getGamma() = 0;

+    virtual bool setGamma(const F32 gamma) = 0; // Set the gamma

+    virtual void setFSAASamples(const U32 fsaa_samples) = 0; //set number of FSAA samples

+    virtual U32  getFSAASamples() = 0;

+    virtual bool restoreGamma() = 0;            // Restore original gamma table (before updating gamma)

+    virtual ESwapMethod getSwapMethod() { return mSwapMethod; }

+    virtual void processMiscNativeEvents();

+    virtual void gatherInput() = 0;

+    virtual void delayInputProcessing() = 0;

+    virtual void swapBuffers() = 0;

+    virtual void bringToFront() = 0;

+    virtual void focusClient() { };     // this may not have meaning or be required on other platforms, therefore, it's not abstract

+    virtual void setOldResize(bool oldresize) { };

+    // handy coordinate space conversion routines

+    // NB: screen to window and vice verse won't work on width/height coordinate pairs,

+    // as the conversion must take into account left AND right border widths, etc.

+    virtual bool convertCoords( LLCoordScreen from, LLCoordWindow *to) = 0;

+    virtual bool convertCoords( LLCoordWindow from, LLCoordScreen *to) = 0;

+    virtual bool convertCoords( LLCoordWindow from, LLCoordGL *to) = 0;

+    virtual bool convertCoords( LLCoordGL from, LLCoordWindow *to) = 0;

+    virtual bool convertCoords( LLCoordScreen from, LLCoordGL *to) = 0;

+    virtual bool convertCoords( LLCoordGL from, LLCoordScreen *to) = 0;

+

+    // query supported resolutions

+    virtual LLWindowResolution* getSupportedResolutions(S32 &num_resolutions) = 0;

+    virtual F32 getNativeAspectRatio() = 0;

+    virtual F32 getPixelAspectRatio() = 0;

+    virtual void setNativeAspectRatio(F32 aspect) = 0;

+

+    virtual void setMaxVRAMMegabytes(U32 max_vram) = 0;

+

+    virtual void beforeDialog() {}; // prepare to put up an OS dialog (if special measures are required, such as in fullscreen mode)

+    virtual void afterDialog() {};  // undo whatever was done in beforeDialog()

+

+    // opens system default color picker, modally

+    // Returns true if valid color selected

+    virtual bool dialogColorPicker(F32 *r, F32 *g, F32 *b);

+

+// return a platform-specific window reference (HWND on Windows, WindowRef on the Mac, Gtk window on Linux)

+    virtual void *getPlatformWindow() = 0;

+

+// return the platform-specific window reference we use to initialize llmozlib (HWND on Windows, WindowRef on the Mac, Gtk window on Linux)

+    virtual void *getMediaWindow();

+

+    // control platform's Language Text Input mechanisms.

+    virtual void allowLanguageTextInput(LLPreeditor *preeditor, bool b) {}

+    virtual void setLanguageTextInput( const LLCoordGL & pos ) {};

+    virtual void updateLanguageTextInputArea() {}

+    virtual void interruptLanguageTextInput() {}

+    virtual void spawnWebBrowser(const std::string& escaped_url, bool async) {};

+

+    static std::vector<std::string> getDynamicFallbackFontList();

+

+    // Provide native key event data

+    virtual LLSD getNativeKeyData() { return LLSD::emptyMap(); }

+

+    // Get system UI size based on DPI (for 96 DPI UI size should be 1.0)

+    virtual F32 getSystemUISize() { return 1.0; }

+

+    static std::vector<std::string> getDisplaysResolutionList();

+

+    // windows only DirectInput8 for joysticks

+    virtual void* getDirectInput8() { return NULL; };

+    virtual bool getInputDevices(U32 device_type_filter,

+                                 std::function<bool(std::string&, LLSD&, void*)> osx_callback,

+                                 void* win_callback,

+                                 void* userdata)

+    {

+        return false;

+    };

+

+    virtual S32 getRefreshRate() { return mRefreshRate; }

+protected:

+    LLWindow(LLWindowCallbacks* callbacks, bool fullscreen, U32 flags);

+    virtual ~LLWindow();

+    // Defaults to true

+    virtual bool isValid();

+    // Defaults to true

+    virtual bool canDelete();

+

+    virtual bool setSizeImpl(LLCoordScreen size) = 0;

+    virtual bool setSizeImpl(LLCoordWindow size) = 0;

+

+protected:

+    LLWindowCallbacks*  mCallbacks;

+

+    bool        mPostQuit;      // should this window post a quit message when destroyed?

+    bool        mFullscreen;

+    S32         mFullscreenWidth;

+    S32         mFullscreenHeight;

+    S32         mFullscreenBits;

+    S32         mFullscreenRefresh;

+    LLWindowResolution* mSupportedResolutions;

+    S32         mNumSupportedResolutions;

+    ECursorType mCurrentCursor;

+    ECursorType mNextCursor;

+    bool        mCursorHidden;

+    S32         mBusyCount; // how deep is the "cursor busy" stack?

+    bool        mIsMouseClipping;  // Is this window currently clipping the mouse

+    ESwapMethod mSwapMethod;

+    bool        mHideCursorPermanent;

+    U32         mFlags;

+    U16         mHighSurrogate;

+    S32         mMinWindowWidth;

+    S32         mMinWindowHeight;

+    S32         mRefreshRate;

+

+    // Handle a UTF-16 encoding unit received from keyboard.

+    // Converting the series of UTF-16 encoding units to UTF-32 data,

+    // this method passes the resulting UTF-32 data to mCallback's

+    // handleUnicodeChar.  The mask should be that to be passed to the

+    // callback.  This method uses mHighSurrogate as a dedicated work

+    // variable.

+    void handleUnicodeUTF16(U16 utf16, MASK mask);

+

+    friend class LLWindowManager;

+};

+

+

+// LLSplashScreen

+// A simple, OS-specific splash screen that we can display

+// while initializing the application and before creating a GL

+// window

+

+

+class LLSplashScreen

+{

+public:

+    LLSplashScreen() { };

+    virtual ~LLSplashScreen() { };

+

+

+    // Call to display the window.

+    static LLSplashScreen * create();

+    static void show();

+    static void hide();

+    static void update(const std::string& string);

+

+    static bool isVisible();

+protected:

+    // These are overridden by the platform implementation

+    virtual void showImpl() = 0;

+    virtual void updateImpl(const std::string& string) = 0;

+    virtual void hideImpl() = 0;

+

+    static bool sVisible;

+

+};

+

+// Platform-neutral for accessing the platform specific message box

+S32 OSMessageBox(const std::string& text, const std::string& caption, U32 type);

+const U32 OSMB_OK = 0;

+const U32 OSMB_OKCANCEL = 1;

+const U32 OSMB_YESNO = 2;

+

+const S32 OSBTN_YES = 0;

+const S32 OSBTN_NO = 1;

+const S32 OSBTN_OK = 2;

+const S32 OSBTN_CANCEL = 3;

+

+//

+// LLWindowManager

+// Manages window creation and error checking

+

+class LLWindowManager

+{

+public:

+    static LLWindow *createWindow(

+        LLWindowCallbacks* callbacks,

+        const std::string& title, const std::string& name, S32 x, S32 y, S32 width, S32 height,

+        U32 flags = 0,

+        bool fullscreen = false,

+        bool clearBg = false,

+        bool enable_vsync = false,

+        bool use_gl = true,

+        bool ignore_pixel_depth = false,

+        U32 fsaa_samples = 0,

+        U32 max_cores = 0,

+        U32 max_vram = 0,

+        F32 max_gl_version = 4.6f);

+    static bool destroyWindow(LLWindow* window);

+    static bool isWindowValid(LLWindow *window);

+};

+

+//

+// helper funcs

+//

+extern bool gDebugWindowProc;

+

+// Protocols, like "http" and "https" we support in URLs

+extern const S32 gURLProtocolWhitelistCount;

+extern const std::string gURLProtocolWhitelist[];

+//extern const std::string gURLProtocolWhitelistHandler[];

+

+void simpleEscapeString ( std::string& stringIn  );

+

+#endif // _LL_window_h_