iTGB Touch Control System *updated May 12*

Touch Control System
This system adds a new GUI Control Image that will greatly increase the performance of the touch controls. Users can now drag their finger off the buttons without it staying in the on position. It allows multi controls to be used at the same time. (updated for pressing 2 or more buttons at the same time.)

No Torque script programming required to manage and is fully automatic. Add 2 files to iTGB source and recompile.

NOTE: I have not added image fade on touch. Any image you use should be prefaded (opacity 30%).

Updated:
- In order for this system to work, you MUST enable Multiple Touch in the defaultPrefs.cs and commonConfig.xml files.
- joydisc control will send -1 when user lifts finger off image.
- fixed problem with mouse down, removed code that was not needed.

iTGB Files
1) Download the www.deanparker.com/guiControlImage3.zip and save the files into engine_source_gui_controls folder.
Contains guiControlImage.cpp and guiControlImage.h

2) Place the files in BOTH TorqueGameBuilder and TGBGame solution.

3) Recompile TorqueGameBuilder and TGBGame.


How It Works
1) Go to the GUI editor.



2) Place a GUIControlImage on the main screen, call it maskBitmap.
* Use a clear image for the bitmap. If you do not have one, you can use this www.deanparker.com/maskBitmap.png
* The maskBitmap image size MUST be 480 by 320, at position 0,0.

3) Place a GUIControlImage for any of your buttons you want.
* These MUST be on top of the maskBitmap.
* You need to create a name for EVERY control you add.
* When you are picking images for buttons, use an image that has the opacity at 30%.


The image has been COLORED to highlight the MASK/buttons. The MASK does not alter the appearance of your game.
The Green lines show where each control is.



Torque Script Code

The 'oniPhoneTouchXXXX' code is replaced with the following.

function oniPhoneTouchUp( %touchCount, %touchX, %touchY ) 
{
   return;
}
function oniPhoneTouchDown( %touchCount, %touchX, %touchY ) 
{
   return;
}
function oniPhoneTouchMove( %touchCount, %touchX, %touchY ) 
{
   return;
}
function oniPhoneTouchTap ( %touchCount, %touchX, %touchY )
{ 
   return;
}

This is the NEW oniPhoneTouch code. NOTE this is only a sample and you should change it for your needs.

%val contains: ( "The name of the control", 1 (touched) or 0 (not touched) )

function oniPhoneTouch(%val)
{
   %controlName = getWord(%val,0);
   %doit = getWord(%val,1);

   if (%controlName $= "maskBitmap")
   {
      $downOn = false;
      $upOn = false;
      $spaceOn = false;
   }

   if (%controlName $= "upBitmap")
      if (%doit == 1)
            $downOn = true;
      else
            $downOn = false;

   if (%controlName $= "dnBitmap")
      if (%doit == 1)
            $upOn = true;
      else
            $upOn = false;

   if (%controlName $= "dropBitmap")
      if (%doit == 1)
         $spaceOn = true;
      else
         $spaceOn = false;

   return;
}

The final part
In your main loop with schedule()...

//control
if ($upOn)
  player.setPositionX(player.getPositionX()-1);

if ($downOn)
  player.setPositionX(player.getPositionX()+1);

if ($spaceOn)
  dosomething();

Using The Joydisc


In order to use an image as a Joydisc, checkmark the UseJoyDisc.


Here is a joypad image or create your own.

%val contains: ( "The name of the control", 1 (touched) or 0 (not touched), Cos, Sin, Angle )

$speed = 20;

...

function oniPhoneTouch(%val)
{
   %controlName = getWord(%val,0);
   %doit = getWord(%val,1);
   
   // if user touches the mask bitmap, set velocity to zero.   
   if (%controlName $= "maskBitmap")
   {
      player.setLinearVelocity(0,0);
      $spaceOn = false;
   }

   if (%controlName $= "joyBitmap")
   {
      %joyCos = getWord(%val,2);
      %joySin = getWord(%val,3);
      %joyAngle = getWord(%val,4);   
  
      // if finger is off, don't do a rotation.         
      if (joyAngle > -1)   
         player.setRotation(mRadToDeg(%joyAngle) + 90);

      player.setLinearVelocity(%joyCos*$speed,%joySin*$speed);
   }

   if (%controlName $= "dropBitmap")
      if (%doit == 1)
         $spaceOn = true;
      else
         $spaceOn = false;

   return;
}

If you want to convert the joydisc to up/down/left/right, you could use...

if (%controlName $= "joy_0")   
   {   
     %ang = mRadToDeg(getWord(%val, 4));

      if (%ang>-1)
      {
         %dir = (%ang <= 315 && %ang >=225) ? "up" : (%ang <= 225 && %ang > 135 ? "left" : (%ang <= 135 && %ang >= 45 ? "down" : "right"));
			
         if (%dir $= "up")
            echo("up arrow");
         else if (%dir $= "left")
            echo("left arrow");
         else if (%dir $= "down")
            echo("down arrow");
         else
            echo("right arrow");
      }
   }