User:Jusonex: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 2: Line 2:
===Awesomium API===
===Awesomium API===
====How to test====
====How to test====
1.) Install the 1.4 r6293 nightly build. Link: http://nightly.mtasa.com/mtasa-1.4-full_unstable-6293-20140409.exe
1.) Install the latest 1.4 nightly: nightly.mtasa.com/?mtasa-1.4-latest


2.) Replace the files you've got from https://github.com/Jusonex/mtasa-awesomium/releases/download/testbuild/Awesomium0.2.zip
2.) Replace the files you've got from http://jusonex.net/public/mta/awesomium/r6465.zip


If it doesn't work, you'll have to install the x86 VC++ Redist 2013 (http://www.microsoft.com/en-us/download/details.aspx?id=40784).
If it doesn't work, you'll have to install the x86 VC++ Redist 2013 (http://www.microsoft.com/en-us/download/details.aspx?id=40784).
Line 10: Line 10:
====Functions====
====Functions====
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
browser createBrowser(int width, int height)
browser createBrowser(int width, int height, bool isLocal)
</syntaxhighlight>
</syntaxhighlight>
*'''isLocal:''' Specifies whether to use the browser in local or global mode
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool updateBrowser(browser webBrowser)
bool updateBrowser(browser webBrowser)
Line 34: Line 35:
</syntaxhighlight>
</syntaxhighlight>
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool injectBrowserMouseDown(browser webBrowser, int mouseButton) -- mouseButton: 0 = left, 1 = middle, 2 = right
bool injectBrowserMouseDown(browser webBrowser, string mouseButton) -- mouseButton: left/middle/right
</syntaxhighlight>
</syntaxhighlight>
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool injectBrowserMouseUp(browser webBrowser, int mouseButton) -- mouseButton: 0 = left, 1 = middle, 2 = right
bool injectBrowserMouseUp(browser webBrowser, string mouseButton) -- mouseButton: left/middle/right
</syntaxhighlight>
</syntaxhighlight>
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 55: Line 56:
</syntaxhighlight>
</syntaxhighlight>
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool executeBrowserJavascript(brower webBrowser, string jsCode) -- works only on local websites
bool executeBrowserJavascript(brower webBrowser, string jsCode) -- works only in local mode
</syntaxhighlight>
</syntaxhighlight>


Line 61: Line 62:
====Events====
====Events====
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
onClientWebsiteRequestResult
onClientBrowserRequestResult
Parameters: bool wasAllowed
Parameters: bool wasAllowed
</syntaxhighlight>
</syntaxhighlight>
Line 67: Line 68:
====Examples====
====Examples====
=====Example 1: A 2D browser with mouse and a simple input handler=====
=====Example 1: A 2D browser with mouse and a simple input handler=====
<syntaxhighlight lang="lua">local webBrowser = createBrowser(1024, 768)
<syntaxhighlight lang="lua">local webBrowser = createBrowser(1024, 768, false)
requestBrowserPages({"youtube.com"})
requestBrowserPages({"youtube.com"})


Line 73: Line 74:
function()
function()
-- Load the url
-- Load the url
loadBrowserURL(webBrowser, "http://youtube.com")
loadBrowserURL(webBrowser, "http://youtube.com") -- This line is potentially needless since YouTube is whitelisted
end
end
)
)
Line 96: Line 97:
)
)


local buttons = {left = 0, middle = 1, right = 2}
addEventHandler("onClientClick", root,
addEventHandler("onClientClick", root,
function(button, state)
function(button, state)
if state == "down" then
if state == "down" then
injectBrowserMouseDown(webBrowser, buttons[button])
injectBrowserMouseDown(webBrowser, button)
else
else
injectBrowserMouseUp(webBrowser, buttons[button])
injectBrowserMouseUp(webBrowser, button)
end
end
end
end
Line 136: Line 136:


-- Create the browser
-- Create the browser
local webBrowser = createBrowser(width, height)
local webBrowser = createBrowser(width, height, false)


-- Request the pages
-- Request the pages

Revision as of 14:46, 28 May 2014

Features

Awesomium API

How to test

1.) Install the latest 1.4 nightly: nightly.mtasa.com/?mtasa-1.4-latest

2.) Replace the files you've got from http://jusonex.net/public/mta/awesomium/r6465.zip

If it doesn't work, you'll have to install the x86 VC++ Redist 2013 (http://www.microsoft.com/en-us/download/details.aspx?id=40784).

Functions

browser createBrowser(int width, int height, bool isLocal)
  • isLocal: Specifies whether to use the browser in local or global mode
bool updateBrowser(browser webBrowser)

bool requestBrowserPages(table pages)

bool loadBrowserURL(browser webBrowser, string url)

bool isBrowserLoading(browser webBrowser)

string getBrowserTitle(browser webBrowser)

string getBrowserURL(browser webBrowser)

bool injectBrowserMouseMove(browser webBrowser, int x, int y)

bool injectBrowserMouseDown(browser webBrowser, string mouseButton) -- mouseButton: left/middle/right

bool injectBrowserMouseUp(browser webBrowser, string mouseButton) -- mouseButton: left/middle/right

bool injectBrowserMouseWheel(browser webBrowser, int scrollVertical, int scrolLHorizontal)

bool injectBrowserKeyDown(brower webBrowser, string key) -- key names: https://wiki.multitheftauto.com/wiki/Key_names

bool injectBrowserKeyUp(browser webBrowser, string key) -- key names: https://wiki.multitheftauto.com/wiki/Key_names

bool injectBrowserCharacter(browser webBrowser, string character) -- takes case sensitivity and unicode characters into account

bool setBrowserRenderingPaused(browser webBrowser, bool isPaused)

bool executeBrowserJavascript(brower webBrowser, string jsCode) -- works only in local mode


Events

onClientBrowserRequestResult
Parameters: bool wasAllowed

Examples

Example 1: A 2D browser with mouse and a simple input handler
local webBrowser = createBrowser(1024, 768, false)
requestBrowserPages({"youtube.com"})

addCommandHandler("load",
	function()
		-- Load the url
		loadBrowserURL(webBrowser, "http://youtube.com") -- This line is potentially needless since YouTube is whitelisted
	end
)

addEventHandler("onClientRender", root,
	function()
		-- Update the browser
		updateBrowser(webBrowser)
		
		-- Draw a nice border
		dxDrawRectangle(195, 95, 1024+10, 768+10, tocolor(255, 255, 0))
		
		-- Draw the browser
		dxDrawImage(200, 100, 1024, 768, webBrowser)
	end
)

addEventHandler("onClientCursorMove", root,
	function(relativeX, relativeY, absoluteX, absoluteY)
		injectBrowserMouseMove(webBrowser, absoluteX - 200, absoluteY - 100)
	end
)

addEventHandler("onClientClick", root,
	function(button, state)
		if state == "down" then
			injectBrowserMouseDown(webBrowser, button)
		else
			injectBrowserMouseUp(webBrowser, button)
		end
	end
)

addEventHandler("onClientKey", root,
	function(button, pressKey)
		if pressKey then
			injectBrowserKeyDown(webBrowser, button)
		else
			injectBrowserKeyUp(webBrowser, button)
		end
                
		if button == "mouse_wheel_down" then
			injectBrowserMouseWheel(webBrowser, -40, 0)
		elseif button == "mouse_wheel_up" then
			injectBrowserMouseWheel(webBrowser, 40, 0)
		end
	end
)

addEventHandler("onClientCharacter", root,
	function(c)
		injectBrowserCharacter(webBrowser, c)
	end
)

showCursor(true)
A 3D browser at the car cinema in Fort Carson (Demo: https://www.youtube.com/watch?v=9w2qU6mZDh8)
local width, height = 1600, 900

-- Create the browser
local webBrowser = createBrowser(width, height, false)

-- Request the pages
requestBrowserPages({"www.youtube.com", "nyan.cat"})

addEventHandler("onClientRender", root,
	function()
		-- Update pixel data
		updateBrowser(webBrowser)
	
		-- Draw the line
		local x, y = 110.7, 1024.15
		dxDrawMaterialLine3D(x, y, 23.25, x, y, 14.75, webBrowser, 18.2, tocolor(255, 255, 255, 255), x, y+1, 19)
	end
)

addCommandHandler("youtube",
	function()
		outputChatBox("YouTube?")
		loadBrowserURL(webBrowser, "http://www.youtube.com/watch?v=kdemFfbS5H0")
	end
)

addCommandHandler("nyan",
	function()
		outputChatBox("Nyan!")
		loadBrowserURL(webBrowser, "http://nyan.cat")
	end
)

Notes

  • Crosshair position (weapons that use the "normal" crosshair texture "siteM16"): X = screenWidth * 0.5299999714f; Y = screenHeight * 0.4f

Useful stuff

Resources

Tools

SA Reversing

Retrieved from "https://wiki.multitheftauto.com/wiki/User:Jusonex?oldid=39646"