# TUIO::TuioListener Class Reference

`#include <TuioListener.h>`

List of all members.

## Public Member Functions

virtual | ~TuioListener ()
virtual void | addTuioObject (TuioObject *tobj)=0
virtual void | updateTuioObject (TuioObject *tobj)=0
virtual void | removeTuioObject (TuioObject *tobj)=0
virtual void | addTuioCursor (TuioCursor *tcur)=0
virtual void | updateTuioCursor (TuioCursor *tcur)=0
virtual void | removeTuioCursor (TuioCursor *tcur)=0
virtual void | refresh (TuioTime ftime)=0

## Detailed Description

The TuioListener interface provides a simple callback infrastructure which is used by the TuioClient class to dispatch TUIO events to all registered instances of classes that implement the TuioListener interface defined here.

Any class that implements the TuioListener interface is required to implement all of the callback methods defined here. The TuioClient makes use of these interface methods in order to dispatch TUIO events to all registered TuioListener implementations.

`public class MyTuioListener implements TuioListener
...`

`MyTuioListener listener = new MyTuioListener();
TuioClient client = new TuioClient();
client.addTuioListener(listener);
client.start();
`

Author:
  Martin Kaltenbrunner

Version:
  1.4

## Constructor & Destructor Documentation

virtual TUIO::TuioListener::~TuioListener | ( |  | ) | `[inline, virtual]`

The destructor is doing nothing in particular.

## Member Function Documentation

virtual void TUIO::TuioListener::addTuioObject | ( | TuioObject * | tobj | ) | `[pure virtual]`

This callback method is invoked by the TuioClient when a new TuioObject is added to the session.

Parameters:

  | tobj | the TuioObject reference associated to the addTuioObject event

virtual void TUIO::TuioListener::updateTuioObject | ( | TuioObject * | tobj | ) | `[pure virtual]`

This callback method is invoked by the TuioClient when an existing TuioObject is updated during the session.

Parameters:

  | tobj | the TuioObject reference associated to the updateTuioObject event

virtual void TUIO::TuioListener::removeTuioObject | ( | TuioObject * | tobj | ) | `[pure virtual]`

This callback method is invoked by the TuioClient when an existing TuioObject is removed from the session.

Parameters:

  | tobj | the TuioObject reference associated to the removeTuioObject event

virtual void TUIO::TuioListener::addTuioCursor | ( | TuioCursor * | tcur | ) | `[pure virtual]`

This callback method is invoked by the TuioClient when a new TuioCursor is added to the session.

Parameters:

  | tcur | the TuioCursor reference associated to the addTuioCursor event

virtual void TUIO::TuioListener::updateTuioCursor | ( | TuioCursor * | tcur | ) | `[pure virtual]`

This callback method is invoked by the TuioClient when an existing TuioCursor is updated during the session.

Parameters:

  | tcur | the TuioCursor reference associated to the updateTuioCursor event

virtual void TUIO::TuioListener::removeTuioCursor | ( | TuioCursor * | tcur | ) | `[pure virtual]`

This callback method is invoked by the TuioClient when an existing TuioCursor is removed from the session.

Parameters:

  | tcur | the TuioCursor reference associated to the removeTuioCursor event

virtual void TUIO::TuioListener::refresh | ( | TuioTime | ftime | ) | `[pure virtual]`

This callback method is invoked by the TuioClient to mark the end of a received TUIO message bundle.

Parameters:

  | ftime | the TuioTime associated to the current TUIO message bundle

The documentation for this class was generated from the following file:

- TuioListener.h