/* ***** BEGIN LICENSE BLOCK ***** * Version: MPL 1.1/GPL 2.0/LGPL 2.1 * * The contents of this file are subject to the Mozilla Public License Version * 1.1 (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * http://www.mozilla.org/MPL/ * * Software distributed under the License is distributed on an "AS IS" basis, * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License * for the specific language governing rights and limitations under the * License. * * The Original Code is Linden Lab Inc. (http://lindenlab.com) code. * * The Initial Developer of the Original Code is: * Callum Prentice (callum@ubrowser.com) * * Portions created by the Initial Developer are Copyright (C) 2006 * the Initial Developer. All Rights Reserved. * * Contributor(s): * Callum Prentice (callum@ubrowser.com) * * Alternatively, the contents of this file may be used under the terms of * either the GNU General Public License Version 2 or later (the "GPL"), or * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"), * in which case the provisions of the GPL or the LGPL are applicable instead * of those above. If you wish to allow use of your version of this file only * under the terms of either the GPL or the LGPL, and not to allow others to * use your version of this file under the terms of the MPL, indicate your * decision by deleting the provisions above and replace them with the notice * and other provisions required by the GPL or the LGPL. If you do not delete * the provisions above, a recipient may use your version of this file under * the terms of any one of the MPL, the GPL or the LGPL. * * ***** END LICENSE BLOCK ***** */ #ifndef LLMOZLIB_H #define LLMOZLIB_H #include #include class LLEmbeddedBrowser; class LLEmbeddedBrowserWindow; //////////////////////////////////////////////////////////////////////////////// // data class that is passed with an event class LLEmbeddedBrowserWindowEvent { public: LLEmbeddedBrowserWindowEvent( int eventWindowIdIn, std::string uriIn ) : mEventWindowId( eventWindowIdIn ), mEventUri( uriIn ) { }; // single int passed with the event - e.g. progress LLEmbeddedBrowserWindowEvent( int eventWindowIdIn, std::string uriIn, int intValIn ) : mEventWindowId( eventWindowIdIn ), mEventUri( uriIn ), mIntVal( intValIn ) { }; // string passed with the event LLEmbeddedBrowserWindowEvent( int eventWindowIdIn, std::string uriIn, std::string stringValIn ) : mEventWindowId( eventWindowIdIn ), mEventUri( uriIn ), mStringVal( stringValIn ) { }; // 2 strings passed with the event LLEmbeddedBrowserWindowEvent( int eventWindowIdIn, std::string uriIn, std::string stringValIn, std::string stringVal2In ) : mEventWindowId( eventWindowIdIn ), mEventUri( uriIn ), mStringVal( stringValIn ), mStringVal2( stringVal2In ) { }; // string and an int passed with the event LLEmbeddedBrowserWindowEvent( int eventWindowIdIn, std::string uriIn, std::string stringValIn, int intValIn ) : mEventWindowId( eventWindowIdIn ), mEventUri( uriIn ), mStringVal( stringValIn ), mIntVal( intValIn ) { }; // 4 ints passed (semantically as a rectangle but could be anything - didn't want to make a RECT type structure) LLEmbeddedBrowserWindowEvent( int eventWindowIdIn, std::string uriIn, int xIn, int yIn, int widthIn, int heightIn ) : mEventWindowId( eventWindowIdIn ), mEventUri( uriIn ), mXVal( xIn ), mYVal( yIn ), mWidthVal( widthIn ), mHeightVal( heightIn ) { }; virtual ~LLEmbeddedBrowserWindowEvent() { }; int getEventWindowId() const { return mEventWindowId; }; std::string getEventUri() const { return mEventUri; }; int getIntValue() const { return mIntVal; }; std::string getStringValue() const { return mStringVal; }; std::string getStringValue2() const { return mStringVal2; }; void getRectValue( int& xOut, int& yOut, int& widthOut, int& heightOut ) const { xOut = mXVal; yOut = mYVal; widthOut = mWidthVal; heightOut = mHeightVal; }; private: int mEventWindowId; std::string mEventUri; int mIntVal; std::string mStringVal; std::string mStringVal2; int mXVal; int mYVal; int mWidthVal; int mHeightVal; }; //////////////////////////////////////////////////////////////////////////////// // derrive from this class and override these methods to observe these events class LLEmbeddedBrowserWindowObserver { public: virtual ~LLEmbeddedBrowserWindowObserver() { }; typedef LLEmbeddedBrowserWindowEvent EventType; virtual void onPageChanged( const EventType& eventIn ) { }; virtual void onNavigateBegin( const EventType& eventIn ) { }; virtual void onNavigateComplete( const EventType& eventIn ) { }; virtual void onUpdateProgress( const EventType& eventIn ) { }; virtual void onStatusTextChange( const EventType& eventIn ) { }; virtual void onLocationChange( const EventType& eventIn ) { }; virtual void onClickLinkHref( const EventType& eventIn ) { }; virtual void onClickLinkNoFollow( const EventType& eventIn ) { }; }; //////////////////////////////////////////////////////////////////////////////// // main library class class LLMozLib { public: virtual ~LLMozLib(); // singleton access static LLMozLib* getInstance(); // housekeeping bool init( std::string applicationDir, std::string componentDir, std::string profileDir, void* nativeWindowHandleIn ); bool reset(); bool clearCache(); int getLastError(); const std::string getVersion(); void setBrowserAgentId( std::string idIn ); bool enableProxy( bool proxyEnabledIn, std::string proxyHostNameIn, int proxyPortIn ); bool enableCookies( bool enabledIn ); bool clearAllCookies(); bool enablePlugins( bool enabledIn ); // browser window - creation/deletion, mutation etc. int createBrowserWindow( int browserWindowWidthIn, int browserWindowHeightIn ); bool destroyBrowserWindow( int browserWindowIdIn ); bool setSize( int browserWindowIdIn, int widthIn, int heightIn ); bool scrollByLines( int browserWindowIdIn, int linesIn ); bool setBackgroundColor( int browserWindowIdIn, const int redIn, const int greenIn, const int blueIn ); bool setCaretColor( int browserWindowIdIn, const int redIn, const int greenIn, const int blueIn ); bool setEnabled( int browserWindowIdIn, bool enabledIn ); // add/remove yourself as an observer on browser events - see LLEmbeddedBrowserWindowObserver declaration bool addObserver( int browserWindowIdIn, LLEmbeddedBrowserWindowObserver* subjectIn ); bool remObserver( int browserWindowIdIn, LLEmbeddedBrowserWindowObserver* subjectIn ); // navigation - self explanatory bool navigateTo( int browserWindowIdIn, const std::string uriIn ); bool navigateStop( int browserWindowIdIn ); bool canNavigateBack( int browserWindowIdIn ); bool navigateBack( int browserWindowIdIn ); bool canNavigateForward( int browserWindowIdIn ); bool navigateForward( int browserWindowIdIn ); // javascript access/control std::string evaluateJavascript( int browserWindowIdIn, const std::string scriptIn ); // set/clear URL to redirect to when a 404 page is reached bool set404RedirectUrl( int browser_window_in, std::string redirect_url ); bool clr404RedirectUrl( int browser_window_in ); // access to rendered bitmap data const unsigned char* grabBrowserWindow( int browserWindowIdIn ); // renders page to memory and returns pixels const unsigned char* getBrowserWindowPixels( int browserWindowIdIn ); // just returns pixels - no render const bool flipWindow( int browserWindowIdIn, bool flipIn ); // optionally flip window (pixels) you get back const int getBrowserWidth( int browserWindowIdIn ); // current browser width (can vary slightly after page is rendered) const int getBrowserHeight( int browserWindowIdIn ); // current height const int getBrowserDepth( int browserWindowIdIn ); // depth in bytes const int getBrowserRowSpan( int browserWindowIdIn ); // width in pixels * depth in bytes // mouse/keyboard interaction bool mouseDown( int browserWindowIdIn, int xPosIn, int yPosIn ); // send a mouse down event to a browser window at given XY in browser space bool mouseUp( int browserWindowIdIn, int xPosIn, int yPosIn ); // send a mouse up event to a browser window at given XY in browser space bool mouseMove( int browserWindowIdIn, int xPosIn, int yPosIn ); // send a mouse move event to a browser window at given XY in browser space bool mouseLeftDoubleClick( int browserWindowIdIn, int xPosIn, int yPosIn ); // send a mouse left button double click to a browser window at given XY in browser space bool keyPress( int browserWindowIdIn, int keyCodeIn ); // send a key press event to a browser window bool unicodeInput ( int browserWindowIdIn, unsigned long uni_char ); // send a unicode keypress event to a browser window bool focusBrowser( int browserWindowIdIn, bool focusBrowserIn ); // set/remove focus to given browser window // accessor/mutator for scheme that browser doesn't follow - e.g. secondlife.com:// void setNoFollowScheme( int browserWindowIdIn, std::string schemeIn ); std::string getNoFollowScheme( int browserWindowIdIn ); private: LLMozLib(); LLEmbeddedBrowserWindow* getBrowserWindowFromWindowId( int browserWindowIdIn ); static LLMozLib* sInstance; const int mMaxBrowserWindows; typedef std::map< int, LLEmbeddedBrowserWindow* > BrowserWindowMap; typedef std::map< int, LLEmbeddedBrowserWindow* >::iterator BrowserWindowMapIter; BrowserWindowMap mBrowserWindowMap; }; // Mozilla virtual keycodes. // We don't want to suck in Mozilla headers so we copy these consts // from nsIDOMKeyEvent.idl. const unsigned long LL_DOM_VK_CANCEL = 0x03; const unsigned long LL_DOM_VK_HELP = 0x06; const unsigned long LL_DOM_VK_BACK_SPACE = 0x08; const unsigned long LL_DOM_VK_TAB = 0x09; const unsigned long LL_DOM_VK_CLEAR = 0x0C; const unsigned long LL_DOM_VK_RETURN = 0x0D; const unsigned long LL_DOM_VK_ENTER = 0x0E; const unsigned long LL_DOM_VK_SHIFT = 0x10; const unsigned long LL_DOM_VK_CONTROL = 0x11; const unsigned long LL_DOM_VK_ALT = 0x12; const unsigned long LL_DOM_VK_PAUSE = 0x13; const unsigned long LL_DOM_VK_CAPS_LOCK = 0x14; const unsigned long LL_DOM_VK_ESCAPE = 0x1B; const unsigned long LL_DOM_VK_SPACE = 0x20; const unsigned long LL_DOM_VK_PAGE_UP = 0x21; const unsigned long LL_DOM_VK_PAGE_DOWN = 0x22; const unsigned long LL_DOM_VK_END = 0x23; const unsigned long LL_DOM_VK_HOME = 0x24; const unsigned long LL_DOM_VK_LEFT = 0x25; const unsigned long LL_DOM_VK_UP = 0x26; const unsigned long LL_DOM_VK_RIGHT = 0x27; const unsigned long LL_DOM_VK_DOWN = 0x28; const unsigned long LL_DOM_VK_PRINTSCREEN = 0x2C; const unsigned long LL_DOM_VK_INSERT = 0x2D; const unsigned long LL_DOM_VK_DELETE = 0x2E; // LL_DOM_VK_0 - LL_DOM_VK_9 match their ASCII values const unsigned long LL_DOM_VK_0 = 0x30; const unsigned long LL_DOM_VK_1 = 0x31; const unsigned long LL_DOM_VK_2 = 0x32; const unsigned long LL_DOM_VK_3 = 0x33; const unsigned long LL_DOM_VK_4 = 0x34; const unsigned long LL_DOM_VK_5 = 0x35; const unsigned long LL_DOM_VK_6 = 0x36; const unsigned long LL_DOM_VK_7 = 0x37; const unsigned long LL_DOM_VK_8 = 0x38; const unsigned long LL_DOM_VK_9 = 0x39; const unsigned long LL_DOM_VK_SEMICOLON = 0x3B; const unsigned long LL_DOM_VK_EQUALS = 0x3D; // LL_DOM_VK_A - LL_DOM_VK_Z match their ASCII values const unsigned long LL_DOM_VK_A = 0x41; const unsigned long LL_DOM_VK_B = 0x42; const unsigned long LL_DOM_VK_C = 0x43; const unsigned long LL_DOM_VK_D = 0x44; const unsigned long LL_DOM_VK_E = 0x45; const unsigned long LL_DOM_VK_F = 0x46; const unsigned long LL_DOM_VK_G = 0x47; const unsigned long LL_DOM_VK_H = 0x48; const unsigned long LL_DOM_VK_I = 0x49; const unsigned long LL_DOM_VK_J = 0x4A; const unsigned long LL_DOM_VK_K = 0x4B; const unsigned long LL_DOM_VK_L = 0x4C; const unsigned long LL_DOM_VK_M = 0x4D; const unsigned long LL_DOM_VK_N = 0x4E; const unsigned long LL_DOM_VK_O = 0x4F; const unsigned long LL_DOM_VK_P = 0x50; const unsigned long LL_DOM_VK_Q = 0x51; const unsigned long LL_DOM_VK_R = 0x52; const unsigned long LL_DOM_VK_S = 0x53; const unsigned long LL_DOM_VK_T = 0x54; const unsigned long LL_DOM_VK_U = 0x55; const unsigned long LL_DOM_VK_V = 0x56; const unsigned long LL_DOM_VK_W = 0x57; const unsigned long LL_DOM_VK_X = 0x58; const unsigned long LL_DOM_VK_Y = 0x59; const unsigned long LL_DOM_VK_Z = 0x5A; const unsigned long LL_DOM_VK_CONTEXT_MENU = 0x5D; const unsigned long LL_DOM_VK_NUMPAD0 = 0x60; const unsigned long LL_DOM_VK_NUMPAD1 = 0x61; const unsigned long LL_DOM_VK_NUMPAD2 = 0x62; const unsigned long LL_DOM_VK_NUMPAD3 = 0x63; const unsigned long LL_DOM_VK_NUMPAD4 = 0x64; const unsigned long LL_DOM_VK_NUMPAD5 = 0x65; const unsigned long LL_DOM_VK_NUMPAD6 = 0x66; const unsigned long LL_DOM_VK_NUMPAD7 = 0x67; const unsigned long LL_DOM_VK_NUMPAD8 = 0x68; const unsigned long LL_DOM_VK_NUMPAD9 = 0x69; const unsigned long LL_DOM_VK_MULTIPLY = 0x6A; const unsigned long LL_DOM_VK_ADD = 0x6B; const unsigned long LL_DOM_VK_SEPARATOR = 0x6C; const unsigned long LL_DOM_VK_SUBTRACT = 0x6D; const unsigned long LL_DOM_VK_DECIMAL = 0x6E; const unsigned long LL_DOM_VK_DIVIDE = 0x6F; const unsigned long LL_DOM_VK_F1 = 0x70; const unsigned long LL_DOM_VK_F2 = 0x71; const unsigned long LL_DOM_VK_F3 = 0x72; const unsigned long LL_DOM_VK_F4 = 0x73; const unsigned long LL_DOM_VK_F5 = 0x74; const unsigned long LL_DOM_VK_F6 = 0x75; const unsigned long LL_DOM_VK_F7 = 0x76; const unsigned long LL_DOM_VK_F8 = 0x77; const unsigned long LL_DOM_VK_F9 = 0x78; const unsigned long LL_DOM_VK_F10 = 0x79; const unsigned long LL_DOM_VK_F11 = 0x7A; const unsigned long LL_DOM_VK_F12 = 0x7B; const unsigned long LL_DOM_VK_F13 = 0x7C; const unsigned long LL_DOM_VK_F14 = 0x7D; const unsigned long LL_DOM_VK_F15 = 0x7E; const unsigned long LL_DOM_VK_F16 = 0x7F; const unsigned long LL_DOM_VK_F17 = 0x80; const unsigned long LL_DOM_VK_F18 = 0x81; const unsigned long LL_DOM_VK_F19 = 0x82; const unsigned long LL_DOM_VK_F20 = 0x83; const unsigned long LL_DOM_VK_F21 = 0x84; const unsigned long LL_DOM_VK_F22 = 0x85; const unsigned long LL_DOM_VK_F23 = 0x86; const unsigned long LL_DOM_VK_F24 = 0x87; const unsigned long LL_DOM_VK_NUM_LOCK = 0x90; const unsigned long LL_DOM_VK_SCROLL_LOCK = 0x91; const unsigned long LL_DOM_VK_COMMA = 0xBC; const unsigned long LL_DOM_VK_PERIOD = 0xBE; const unsigned long LL_DOM_VK_SLASH = 0xBF; const unsigned long LL_DOM_VK_BACK_QUOTE = 0xC0; const unsigned long LL_DOM_VK_OPEN_BRACKET = 0xDB; const unsigned long LL_DOM_VK_BACK_SLASH = 0xDC; const unsigned long LL_DOM_VK_CLOSE_BRACKET = 0xDD; const unsigned long LL_DOM_VK_QUOTE = 0xDE; const unsigned long LL_DOM_VK_META = 0xE0; #endif // LLMOZLIB_H