C# Class SurfaceToTUIO.App1

This is the main type for your application.
Inheritance: Microsoft.Xna.Framework.Game
ファイルを表示 Open project: touchcoder/SurfaceToTUIO Class Usage Examples

Private Properties

Property Type Description
InitializeSurfaceInput void
OnAffine2DDelta void
OnAffine2DManipulationCompleted void
OnAffine2DManipulationStarted void
OnApplicationActivated void
OnApplicationDeactivated void
OnApplicationPreviewed void
SetWindowOnSurface void

Public Methods

Method Description
App1 ( ) : System

Default constructor.

addManipulationProcessor ( Contact c ) : void

Each Contact gets its own ManipulationProcessor assigned This way we can use the Manipulator data even if there are multiple Contacts

cleanHistory ( int id ) : void

Removes all unnecessary entries from the history Dictionaries

cleanManipulationProcessorList ( List removedContacts ) : void

Removes ManipulationProcessor assigned to removed Contacts

computeAngularVelocity ( Contact currentContact, Contact previousContact, float &angularVelocity, float &angularAcceleration ) : void

Computes the angular velocity and the angular acceleration of a Contact The unit for the velocity is: Rotations / Seconds The unit for the acceleration is: Rotations / Seconds^2

getMotionAcceleration ( int id, float &acceleration, long frameTimestamp ) : void

If possible, computes the motion acceleration This is done by subtracting the preceding Contact velocity from the current contact velocity, devided by the time delta The unit is acceleration is: Screen Dimesion / Seconds^2

getVelocity ( int id, float &velocityX, float &velocityY, InteractiveSurface surface ) : void

Retrieve the movement velocity of a Contact The data is taken from a ManipulationProcessor linked to the Contact The final unit is: SurfaceDimension / Seconds

processContactManipulator ( Contact c, ReadOnlyContactCollection currentContacts, ReadOnlyContactCollection previousContacts ) : void
sendTUIO_2DBlb ( List contacts, ReadOnlyContactCollection previousContacts ) : void

Sends a /tuio/2Dblb message The remote Host is specified in the appConfig The message is built according to TUIO 1.1 specifications (see http://www.tuio.org/?specification)

sendTUIO_2DCur ( List contacts, ReadOnlyContactCollection previousContacts ) : void

Sends a /tuio/2Dcur message The remote Host is specified in the appConfig The message is built according to TUIO 1.1 specifications (see http://www.tuio.org/?specification)

sendTUIO_2DObj ( List contacts, ReadOnlyContactCollection previousContacts ) : void

Sends a /tuio/2Dobj message The remote Host is specified in the appConfig The message is built according to TUIO 1.1 specifications (see http://www.tuio.org/?specification)

updateHistoryData ( int id, long frameTimestamp ) : void

Updates the history data needed for computing Contact velocities

Protected Methods

Method Description
Draw ( GameTime gameTime ) : void

This is called when the app should draw itself.

Initialize ( ) : void

Allows the app to perform any initialization it needs to before starting to run. This is where it can query for any required services and load any non-graphic related content. Calling base.Initialize will enumerate through any components and initialize them as well.

LoadContent ( ) : void

Load your graphics content.

UnloadContent ( ) : void

Unload your graphics content.

Update ( GameTime gameTime ) : void

Main application Logic We retrieve the current Contacts and send TUIO messages accordingly You can specify via appConfig if you want a Finger Contact to be sent as /tuio/2Dcur or /tuio/2Dblb Sending it as /tuio/2Dblb conserves the Contact size, rotation, angular velocity and angular acceleration

Private Methods

Method Description
InitializeSurfaceInput ( ) : void

Initializes the surface input system. This should be called after any window initialization is done, and should only be called once.

OnAffine2DDelta ( object sender, Affine2DOperationDeltaEventArgs e ) : void

Extract the Manipulation Data and write it into our Dictionary

OnAffine2DManipulationCompleted ( object sender, Affine2DOperationCompletedEventArgs e ) : void

Unused

OnAffine2DManipulationStarted ( object sender, Affine2DOperationStartedEventArgs e ) : void

Unused

OnApplicationActivated ( object sender, EventArgs e ) : void

This is called when application has been activated.

OnApplicationDeactivated ( object sender, EventArgs e ) : void

This is called when application has been deactivated.

OnApplicationPreviewed ( object sender, EventArgs e ) : void

This is called when application is in preview mode.

SetWindowOnSurface ( ) : void

Moves and sizes the window to cover the input surface.

Method Details

App1() public method

Default constructor.
public App1 ( ) : System
return System

Draw() protected method

This is called when the app should draw itself.
protected Draw ( GameTime gameTime ) : void
gameTime Microsoft.Xna.Framework.GameTime Provides a snapshot of timing values.
return void

Initialize() protected method

Allows the app to perform any initialization it needs to before starting to run. This is where it can query for any required services and load any non-graphic related content. Calling base.Initialize will enumerate through any components and initialize them as well.
protected Initialize ( ) : void
return void

LoadContent() protected method

Load your graphics content.
protected LoadContent ( ) : void
return void

UnloadContent() protected method

Unload your graphics content.
protected UnloadContent ( ) : void
return void

Update() protected method

Main application Logic We retrieve the current Contacts and send TUIO messages accordingly You can specify via appConfig if you want a Finger Contact to be sent as /tuio/2Dcur or /tuio/2Dblb Sending it as /tuio/2Dblb conserves the Contact size, rotation, angular velocity and angular acceleration
protected Update ( GameTime gameTime ) : void
gameTime Microsoft.Xna.Framework.GameTime
return void

addManipulationProcessor() public method

Each Contact gets its own ManipulationProcessor assigned This way we can use the Manipulator data even if there are multiple Contacts
public addManipulationProcessor ( Contact c ) : void
c Contact Contact to add the Manipulator to
return void

cleanHistory() public method

Removes all unnecessary entries from the history Dictionaries
public cleanHistory ( int id ) : void
id int Contact Id that is no longer active
return void

cleanManipulationProcessorList() public method

Removes ManipulationProcessor assigned to removed Contacts
public cleanManipulationProcessorList ( List removedContacts ) : void
removedContacts List
return void

computeAngularVelocity() public method

Computes the angular velocity and the angular acceleration of a Contact The unit for the velocity is: Rotations / Seconds The unit for the acceleration is: Rotations / Seconds^2
public computeAngularVelocity ( Contact currentContact, Contact previousContact, float &angularVelocity, float &angularAcceleration ) : void
currentContact Contact
previousContact Contact
angularVelocity float Output parameter for the angular velocity
angularAcceleration float Output parameter for the angular acceleration
return void

getMotionAcceleration() public method

If possible, computes the motion acceleration This is done by subtracting the preceding Contact velocity from the current contact velocity, devided by the time delta The unit is acceleration is: Screen Dimesion / Seconds^2
public getMotionAcceleration ( int id, float &acceleration, long frameTimestamp ) : void
id int Contact ID
acceleration float Output parameter
frameTimestamp long Timestamp of the current Contact
return void

getVelocity() public method

Retrieve the movement velocity of a Contact The data is taken from a ManipulationProcessor linked to the Contact The final unit is: SurfaceDimension / Seconds
public getVelocity ( int id, float &velocityX, float &velocityY, InteractiveSurface surface ) : void
id int Contact Id
velocityX float Output parameter
velocityY float Output parameter
surface InteractiveSurface Object representing the Surface
return void

processContactManipulator() public method

public processContactManipulator ( Contact c, ReadOnlyContactCollection currentContacts, ReadOnlyContactCollection previousContacts ) : void
c Contact
currentContacts ReadOnlyContactCollection
previousContacts ReadOnlyContactCollection
return void

sendTUIO_2DBlb() public method

Sends a /tuio/2Dblb message The remote Host is specified in the appConfig The message is built according to TUIO 1.1 specifications (see http://www.tuio.org/?specification)
public sendTUIO_2DBlb ( List contacts, ReadOnlyContactCollection previousContacts ) : void
contacts List Current active contacts
previousContacts ReadOnlyContactCollection Contacts from the previous frame
return void

sendTUIO_2DCur() public method

Sends a /tuio/2Dcur message The remote Host is specified in the appConfig The message is built according to TUIO 1.1 specifications (see http://www.tuio.org/?specification)
public sendTUIO_2DCur ( List contacts, ReadOnlyContactCollection previousContacts ) : void
contacts List Current active contacts
previousContacts ReadOnlyContactCollection Contacts from the previous frame
return void

sendTUIO_2DObj() public method

Sends a /tuio/2Dobj message The remote Host is specified in the appConfig The message is built according to TUIO 1.1 specifications (see http://www.tuio.org/?specification)
public sendTUIO_2DObj ( List contacts, ReadOnlyContactCollection previousContacts ) : void
contacts List Current acitve Contacts
previousContacts ReadOnlyContactCollection Contacts from the previous frame
return void

updateHistoryData() public method

Updates the history data needed for computing Contact velocities
public updateHistoryData ( int id, long frameTimestamp ) : void
id int Contact Id
frameTimestamp long Contact Frame Timestamp
return void