Difference between revisions of "TntVirtualPad"

From GiderosMobile
m (rename virtualpad to tntvirtualpad)
 
(31 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
<!-- GIDEROSOBJ:TntVirtualPad -->
+
<!-- GIDEROSOBJ:CTNTVirtualPad-->
 
'''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]][[File:Platform html5.png]][[File:Platform winrt.png]][[File:Platform win32.png]]<br/>
 
'''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]][[File:Platform html5.png]][[File:Platform winrt.png]][[File:Platform win32.png]]<br/>
 
'''Available since:''' Gideros 2019.4<br/>
 
'''Available since:''' Gideros 2019.4<br/>
Line 6: Line 6:
 
=== Description ===
 
=== Description ===
 
Adds a virtual pad to your game/app screen.
 
Adds a virtual pad to your game/app screen.
 +
<syntaxhighlight lang="lua">
 +
require "tntvirtualpad"
 +
</syntaxhighlight>
 +
 +
You can find the graphics for the pads and the text file that comes with it:
 +
*[[media:TNTVirtualPad.png]]
 +
*[[media:TNTVirtualPad.txt]]
 +
[[file:TNTVirtualPad.png]]
  
=== Examples ===
+
=== Example ===
'''TO DO'''
+
'''Add a virtual pad to your scene'''
<source lang="lua">
+
<syntaxhighlight lang="lua">
 
require "tntvirtualpad"
 
require "tntvirtualpad"
</source>
+
 
 +
LevelX = Core.class(Sprite)
 +
 
 +
function LevelX:init()
 +
-- bg
 +
application:setBackgroundColor(0x0099a0)
 +
-- tnt virtual pad
 +
local texturevpad = TexturePack.new("gfx/UI/TNTVirtualPad.txt", "gfx/UI/TNTVirtualPadX.png", true)
 +
self.vPad = CTNTVirtualPad.new(self, texturevpad, PAD.STICK_SINGLE, PAD.BUTTONS_ONE, 100, 0)
 +
self.vPad:setJoyStyle(PAD.COMPO_LEFTPAD, PAD.STYLE_FOLLOW)
 +
self.vPad:setScale(PAD.COMPO_LEFTPAD, 1)
 +
self.vPad:setScale(PAD.COMPO_BUTTON1, 1)
 +
self.vPad:setHideDelay(5000)
 +
self.vPad:start()
 +
-- tnt virtual pad listeners
 +
self.vPad:addEventListener(PAD.LEFTPAD_EVENT, self.onVKeyDown, self)
 +
self.vPad:addEventListener(PAD.BUTTON1_EVENT, self.vShoot, self)
 +
end
 +
 
 +
-- VIRTUAL PAD HANDLER
 +
function LevelX:onVKeyDown(event)
 +
print(event.data.power)
 +
print(event.data.angle)
 +
print(math.cos(event.data.angle))
 +
print(math.sin(event.data.angle))
 +
-- example usage
 +
--self.player.posx += self.player.vx * math.cos(event.data.angle)
 +
--self.player.posy += self.player.vy * math.sin(event.data.angle)
 +
--if math.cos(event.data.angle) < 0 then self.player:setSkew(5, -5)
 +
--elseif math.cos(event.data.angle) > 0 then self.player:setSkew(-5, 5)
 +
--else self.player:setSkew(0, 0)
 +
--end
 +
end
 +
 
 +
function LevelX:vShoot(event)
 +
if event.data.state == PAD.STATE_BEGIN then
 +
-- example usage
 +
--local missile = Missiles.new(self.player.posx, self.player.posy - 12)
 +
--table.insert(self.missiles_list, missile)
 +
end
 +
end
 +
</syntaxhighlight>
  
 
{|-
 
{|-
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
 
=== Methods ===
 
=== Methods ===
<!--[[camera.availableDevices]] ''Return a list of available devices.''<br/>-->
+
[[CTNTVirtualPad.new]] ''creates a new VPAD object class''<br/><!-- GIDEROSMTD:CTNTVirtualPad.new() creates a new TNT Virtual Pad object (Class)-->
 +
 
 +
[[CTNTVirtualPad:free]] ''frees the VPAD''<br/><!--GIDEROSMTD:CTNTVirtualPad:free() frees the VPAD-->
 +
[[CTNTVirtualPad:setAlpha]] ''sets VPAD alpha values''<br/><!--GIDEROSMTD:CTNTVirtualPad:setAlpha(alphaOn, alphaOff) max alpha value when pad is visible on screen, min alpha value when pad is in “ghost” mode-->
 +
[[CTNTVirtualPad:setColor]] ''sets VPAD colors''<br/><!--GIDEROSMTD:CTNTVirtualPad:setColor(padComponent, r, g, b) sets the VPAD components colors-->
 +
[[CTNTVirtualPad:setDefaultButtonSprites]] ''sets VPAD default buttons sprites''<br/><!--GIDEROSMTD:CTNTVirtualPad:setDefaultButtonSprites(spriteA, spriteB) sets the VPAD default buttons sprites !warning! SEE THE WIKI-->
 +
[[CTNTVirtualPad:setDefaultJoySprites]] ''sets VPAD default joysticks sprites''<br/><!--GIDEROSMTD:CTNTVirtualPad:setDefaultJoySprites(spriteA, spriteB) sets the VPAD default joysticks sprites !warning! SEE THE WIKI-->
 +
[[CTNTVirtualPad:setHideDelay]] ''sets VPAD hide delay''<br/><!--GIDEROSMTD:CTNTVirtualPad:setHideDelay(msDelay) sets the VPAD hide delay-->
 +
[[CTNTVirtualPad:setHideMode]] ''sets VPAD hide mode''<br/><!--GIDEROSMTD:CTNTVirtualPad:setHideMode(hideMode) sets the VPAD hide mode-->
 +
[[CTNTVirtualPad:setJoyAsAnalog]] ''sets VPAD joysticks analog mode''<br/><!--GIDEROSMTD:CTNTVirtualPad:setJoyAsAnalog(padComponent, isAnalogic) sets the VPAD joysticks analog mode-->
 +
[[CTNTVirtualPad:setJoyStyle]] ''sets VPAD joysticks movement style''<br/><!--GIDEROSMTD:CTNTVirtualPad:setJoyStyle(padComponent, style) sets the VPAD joysticks movement style-->
 +
[[CTNTVirtualPad:setMaxRadius]] ''sets VPAD max touch radius''<br/><!--GIDEROSMTD:CTNTVirtualPad:setMaxRadius(padComponent, maxRadius) sets the VPAD max touch radius-->
 +
[[CTNTVirtualPad:setPosition]] ''sets VPAD joysticks positions''<br/><!--GIDEROSMTD:CTNTVirtualPad:setPosition(padComponent, x, y) sets the VPAD joysticks positions-->
 +
[[CTNTVirtualPad:setScale]] ''sets VPAD joysticks scale''<br/><!--GIDEROSMTD:CTNTVirtualPad:setScale(padComponent, scale) sets the VPAD joysticks scale-->
 +
[[CTNTVirtualPad:setTextures]] ''sets VPAD components textures''<br/><!--GIDEROSMTD:CTNTVirtualPad:setTextures(padComponent, textureA, textureB) sets the VPAD components textures-->
 +
[[CTNTVirtualPad:start]] ''starts the VPAD''<br/><!--GIDEROSMTD:CTNTVirtualPad:start() starts the VPAD-->
 +
[[CTNTVirtualPad:stop]] ''stops the VPAD''<br/><!--GIDEROSMTD:CTNTVirtualPad:stop() stops the VPAD and its events-->
  
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
 
=== Events ===
 
=== Events ===
 +
<!--[[Event.ADDED_TO_STAGE]]<br/>--><!--GIDEROSEVT:Event.ADDED_TO_STAGE addedToStage-->
 +
[[CTNTVirtualPad.Event|PAD.LEFTPAD_EVENT]] ''Event on the left pad'' <br/><!--GIDEROSEVT:PAD.LEFTPAD_EVENT Event on the left pad -->
 +
[[CTNTVirtualPad.Event|PAD.RIGHTPAD_EVENT]] ''Event on the right pad'' <br/><!--GIDEROSEVT:PAD.RIGHTPAD_EVENT Event on the right pad -->
 +
 +
[[CTNTVirtualPad.Event|PAD.BUTTON1_EVENT]] ''Event on the button 1'' <br/><!--GIDEROSEVT:PAD.BUTTON1_EVENT Event on the button 1-->
 +
[[CTNTVirtualPad.Event|PAD.BUTTON2_EVENT]] ''Event on the button 2'' <br/><!--GIDEROSEVT:PAD.BUTTON2_EVENT Event on the button 2-->
 +
[[CTNTVirtualPad.Event|PAD.BUTTON3_EVENT]] ''Event on the button 3'' <br/><!--GIDEROSEVT:PAD.BUTTON3_EVENT Event on the button 3-->
 +
[[CTNTVirtualPad.Event|PAD.BUTTON4_EVENT]] ''Event on the button 4'' <br/><!--GIDEROSEVT:PAD.BUTTON4_EVENT Event on the button 4-->
 +
[[CTNTVirtualPad.Event|PAD.BUTTON5_EVENT]] ''Event on the button 5'' <br/><!--GIDEROSEVT:PAD.BUTTON5_EVENT Event on the button 5-->
 +
[[CTNTVirtualPad.Event|PAD.BUTTON6_EVENT]] ''Event on the button 6'' <br/><!--GIDEROSEVT:PAD.BUTTON6_EVENT Event on the button 6-->
 +
 
=== Constants ===
 
=== Constants ===
 +
[[CTNTVirtualPad.Constants|PAD.BUTTONS_NONE]]<br/><!--GIDEROSCST:PAD.BUTTONS_NONE 3-->
 +
[[CTNTVirtualPad.Constants|PAD.BUTTONS_ONE]]<br/><!--GIDEROSCST:PAD.BUTTONS_ONE 4-->
 +
[[CTNTVirtualPad.Constants|PAD.BUTTONS_TWO]]<br/><!--GIDEROSCST:PAD.BUTTONS_TWO 5-->
 +
[[CTNTVirtualPad.Constants|PAD.BUTTONS_THREE]]<br/><!--GIDEROSCST:PAD.BUTTONS_THREE 6-->
 +
[[CTNTVirtualPad.Constants|PAD.BUTTONS_FOUR]]<br/><!--GIDEROSCST:PAD.BUTTONS_FOUR 7-->
 +
[[CTNTVirtualPad.Constants|PAD.BUTTONS_FIVE]]<br/><!--GIDEROSCST:PAD.BUTTONS_FIVE 8-->
 +
[[CTNTVirtualPad.Constants|PAD.BUTTONS_SIX]]<br/><!--GIDEROSCST:PAD.BUTTONS_SIX 9-->
 +
 +
[[CTNTVirtualPad.Constants|PAD.COMPO_BUTTON1]]<br/><!--GIDEROSCST:PAD.COMPO_BUTTON1 20-->
 +
[[CTNTVirtualPad.Constants|PAD.COMPO_BUTTON2]]<br/><!--GIDEROSCST:PAD.COMPO_BUTTON2 21-->
 +
[[CTNTVirtualPad.Constants|PAD.COMPO_BUTTON3]]<br/><!--GIDEROSCST:PAD.COMPO_BUTTON3 22-->
 +
[[CTNTVirtualPad.Constants|PAD.COMPO_BUTTON4]]<br/><!--GIDEROSCST:PAD.COMPO_BUTTON4 23-->
 +
[[CTNTVirtualPad.Constants|PAD.COMPO_BUTTON5]]<br/><!--GIDEROSCST:PAD.COMPO_BUTTON5 24-->
 +
[[CTNTVirtualPad.Constants|PAD.COMPO_BUTTON6]]<br/><!--GIDEROSCST:PAD.COMPO_BUTTON6 25-->
 +
[[CTNTVirtualPad.Constants|PAD.COMPO_LEFTPAD]]<br/><!--GIDEROSCST:PAD.COMPO_LEFTPAD 26-->
 +
[[CTNTVirtualPad.Constants|PAD.COMPO_RIGHTPAD]]<br/><!--GIDEROSCST:PAD.COMPO_RIGHTPAD 27-->
 +
 +
[[CTNTVirtualPad.Constants|PAD.MODE_NOHIDE]]<br/><!--GIDEROSCST:PAD.MODE_NOHIDE 13-->
 +
[[CTNTVirtualPad.Constants|PAD.MODE_GHOST]]<br/><!--GIDEROSCST:PAD.MODE_GHOST 14-->
 +
[[CTNTVirtualPad.Constants|PAD.MODE_HIDDEN]]<br/><!--GIDEROSCST:PAD.MODE_HIDDEN 15-->
 +
 +
[[CTNTVirtualPad.Constants|PAD.STICK_NONE]]<br/><!--GIDEROSCST:PAD.STICK_NONE 0-->
 +
[[CTNTVirtualPad.Constants|PAD.STICK_SINGLE]]<br/><!--GIDEROSCST:PAD.STICK_SINGLE 1-->
 +
[[CTNTVirtualPad.Constants|PAD.STICK_DOUBLE]]<br/><!--GIDEROSCST:PAD.STICK_DOUBLE 2-->
 +
 +
[[CTNTVirtualPad.Constants|PAD.STYLE_CLASSIC]]<br/><!--GIDEROSCST:PAD.STYLE_CLASSIC 10-->
 +
[[CTNTVirtualPad.Constants|PAD.STYLE_MOVABLE]]<br/><!--GIDEROSCST:PAD.STYLE_MOVABLE 11-->
 +
[[CTNTVirtualPad.Constants|PAD.STYLE_FOLLOW]]<br/><!--GIDEROSCST:PAD.STYLE_FOLLOW 12-->
 
|}
 
|}
  
 
{{GIDEROS IMPORTANT LINKS}}
 
{{GIDEROS IMPORTANT LINKS}}

Latest revision as of 23:26, 12 November 2023

Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
Available since: Gideros 2019.4

Description

Adds a virtual pad to your game/app screen.

require "tntvirtualpad"

You can find the graphics for the pads and the text file that comes with it:

TNTVirtualPad.png

Example

Add a virtual pad to your scene

require "tntvirtualpad"

LevelX = Core.class(Sprite)

function LevelX:init()
	-- bg
	application:setBackgroundColor(0x0099a0)
	-- tnt virtual pad
	local texturevpad = TexturePack.new("gfx/UI/TNTVirtualPad.txt", "gfx/UI/TNTVirtualPadX.png", true)
	self.vPad = CTNTVirtualPad.new(self, texturevpad, PAD.STICK_SINGLE, PAD.BUTTONS_ONE, 100, 0)
	self.vPad:setJoyStyle(PAD.COMPO_LEFTPAD, PAD.STYLE_FOLLOW)
	self.vPad:setScale(PAD.COMPO_LEFTPAD, 1)
	self.vPad:setScale(PAD.COMPO_BUTTON1, 1)
	self.vPad:setHideDelay(5000)
	self.vPad:start()
	-- tnt virtual pad listeners
	self.vPad:addEventListener(PAD.LEFTPAD_EVENT, self.onVKeyDown, self)
	self.vPad:addEventListener(PAD.BUTTON1_EVENT, self.vShoot, self)
end

-- VIRTUAL PAD HANDLER
function LevelX:onVKeyDown(event)
	print(event.data.power)
	print(event.data.angle)
	print(math.cos(event.data.angle))
	print(math.sin(event.data.angle))
	-- example usage
	--self.player.posx += self.player.vx * math.cos(event.data.angle)
	--self.player.posy += self.player.vy * math.sin(event.data.angle)
	--if math.cos(event.data.angle) < 0 then self.player:setSkew(5, -5)
	--elseif math.cos(event.data.angle) > 0 then self.player:setSkew(-5, 5)
	--else self.player:setSkew(0, 0)
	--end
end

function LevelX:vShoot(event)
	if event.data.state == PAD.STATE_BEGIN then
		-- example usage
		--local missile = Missiles.new(self.player.posx, self.player.posy - 12)
		--table.insert(self.missiles_list, missile)
	end
end

Methods

CTNTVirtualPad.new creates a new VPAD object class

CTNTVirtualPad:free frees the VPAD
CTNTVirtualPad:setAlpha sets VPAD alpha values
CTNTVirtualPad:setColor sets VPAD colors
CTNTVirtualPad:setDefaultButtonSprites sets VPAD default buttons sprites
CTNTVirtualPad:setDefaultJoySprites sets VPAD default joysticks sprites
CTNTVirtualPad:setHideDelay sets VPAD hide delay
CTNTVirtualPad:setHideMode sets VPAD hide mode
CTNTVirtualPad:setJoyAsAnalog sets VPAD joysticks analog mode
CTNTVirtualPad:setJoyStyle sets VPAD joysticks movement style
CTNTVirtualPad:setMaxRadius sets VPAD max touch radius
CTNTVirtualPad:setPosition sets VPAD joysticks positions
CTNTVirtualPad:setScale sets VPAD joysticks scale
CTNTVirtualPad:setTextures sets VPAD components textures
CTNTVirtualPad:start starts the VPAD
CTNTVirtualPad:stop stops the VPAD

Events

PAD.LEFTPAD_EVENT Event on the left pad
PAD.RIGHTPAD_EVENT Event on the right pad

PAD.BUTTON1_EVENT Event on the button 1
PAD.BUTTON2_EVENT Event on the button 2
PAD.BUTTON3_EVENT Event on the button 3
PAD.BUTTON4_EVENT Event on the button 4
PAD.BUTTON5_EVENT Event on the button 5
PAD.BUTTON6_EVENT Event on the button 6

Constants

PAD.BUTTONS_NONE
PAD.BUTTONS_ONE
PAD.BUTTONS_TWO
PAD.BUTTONS_THREE
PAD.BUTTONS_FOUR
PAD.BUTTONS_FIVE
PAD.BUTTONS_SIX

PAD.COMPO_BUTTON1
PAD.COMPO_BUTTON2
PAD.COMPO_BUTTON3
PAD.COMPO_BUTTON4
PAD.COMPO_BUTTON5
PAD.COMPO_BUTTON6
PAD.COMPO_LEFTPAD
PAD.COMPO_RIGHTPAD

PAD.MODE_NOHIDE
PAD.MODE_GHOST
PAD.MODE_HIDDEN

PAD.STICK_NONE
PAD.STICK_SINGLE
PAD.STICK_DOUBLE

PAD.STYLE_CLASSIC
PAD.STYLE_MOVABLE
PAD.STYLE_FOLLOW