pointing::SubPixelFunction Class Reference

The SubPixelFunction class is the subclass of TransferFunction which can be used to extend any TransferFunction to have subpixel functionality. More...

#include <SubPixelFunction.h>

Inheritance diagram for pointing::SubPixelFunction:

Public Member Functions
	SubPixelFunction (const char *uri, PointingDevice *input, DisplayDevice *output)
	SubPixelFunction (std::string uri, PointingDevice *input, DisplayDevice *output)
	SubPixelFunction (URI &uri, PointingDevice *input, DisplayDevice *output)
	SubPixelFunction (URI uri, URI funcUri, PointingDevice *input, DisplayDevice *output)
void	setSubPixeling (bool subpixeling)
	setSubPixeling Turn on or off subpixeling More...
bool	getSubPixeling () const
	Returns true if subpixeling is activated.
void	setHumanResolution (int humanResolution)
	setHumanResolution Sets the resolution of the pointing device at which humans have maximum pointing task efficiency. More...
int	getHumanResolution () const
	getHumanResolution Gets the resolution of the pointing device at which humans have maximum pointing task efficiency.
void	setCardinalitySize (int cardinality, int size)
	setCardinalitySize More...
void	getCardinalitySize (int *cardinality, int *size) const
	getCardinalitySize More...
void	clearState (void)
	Method which clears the current state of the device to be the default one (without any remainders or previous data).
void	applyi (int dxMickey, int dyMickey, int *dxPixel, int *dyPixel, TimeStamp::inttime timestamp=TimeStamp::undef)
	apply The main method of the class which applies the transfer function. More...
void	applyd (int dxMickey, int dyMickey, double *dxPixel, double *dyPixel, TimeStamp::inttime timestamp=TimeStamp::undef)
	apply The main method of the class which applies the transfer function. More...
URI	getURI (bool expanded=false) const
	getURI The method constructs URI corresponding to the type and parameters of the transfer function. More...
URI	getInnerURI (bool expanded=false) const
	getInnerURI The original transfer function URI without subpixeling More...
Public Member Functions inherited from pointing::TransferFunction
virtual void	setDebugLevel (int)
	Sets the level of information for debugging purposes (default = 0).
virtual void	debug (std::ostream &) const

Additional Inherited Members
Static Public Member Functions inherited from pointing::TransferFunction
static std::list< std::string >	schemes (void)
static TransferFunction *	create (const char *function_uri, PointingDevice *input, DisplayDevice *output)
	Static method to instantiate an object of a sub-class. More...
static TransferFunction *	create (std::string function_uri, PointingDevice *input, DisplayDevice *output)
static TransferFunction *	create (URI &function_uri, PointingDevice *input, DisplayDevice *output)
Protected Member Functions inherited from pointing::TransferFunction
void	normalizeInput (int *dx, int *dy, PointingDevice *input) const
	normalizeInput Normalizes input to a transfer function with respect to the given PointingDevice. For example, to prevent fast movements of the cursor for high resolution mice. dx and dy are changed according to the input->getResolution() More...
void	normalizeOutput (int *dx, int *dy, DisplayDevice *output) const
	normalizeOutput Normalizes output of a transfer function with respect to the given DisplayDevice. For example, to prevent slow movements of the cursor for high resolution display. dx and dy are changed according to the output->getResolution() More...

Detailed Description

The SubPixelFunction class is the subclass of TransferFunction which can be used to extend any TransferFunction to have subpixel functionality.

The implementation is based on the paper of N. Roussel, G. Casiez, J. Aceituno and D. Vogel. "Giving a hand to the eyes: leveraging input accuracy for subpixel interaction."

Member Function Documentation

void pointing::SubPixelFunction::applyd ( int  dxMickey, int  dyMickey, double *  dxPixel, double *  dyPixel, TimeStamp::inttime  timestamp = TimeStamp::undef  )

virtual

apply The main method of the class which applies the transfer function.

Parameters

dxMickey	Translation in dots of the input device along x direction.
dyMickey	Translation in dots of the input device along y direction.
dxPixel	(Double) Computed translation in pixels of the output device along x direction.
dyPixel	(Double) Computed translation in pixels of the output device along y direction.
timestamp

Implements pointing::TransferFunction.

void pointing::SubPixelFunction::applyi ( int  dxMickey, int  dyMickey, int *  dxPixel, int *  dyPixel, TimeStamp::inttime  timestamp = TimeStamp::undef  )

virtual

apply The main method of the class which applies the transfer function.

Parameters

dxMickey	Translation in dots of the input device along x direction.
dyMickey	Translation in dots of the input device along y direction.
dxPixel	(Integer) Computed translation in pixels of the output device along x direction.
dyPixel	(Integer) Computed translation in pixels of the output device along y direction.
timestamp

Implements pointing::TransferFunction.

void pointing::SubPixelFunction::getCardinalitySize	(	int *	cardinality,
		int *	size
	)		const

getCardinalitySize

Parameters

cardinality	Parameter defining the number of elements which users expect to select from.
size	The size of the model (element or widget) in pixels

URI pointing::SubPixelFunction::getInnerURI

(

bool

expanded = false

)

const

getInnerURI The original transfer function URI without subpixeling

Parameters

expanded

Indicates whether all parameters must be included in URI.

Returns

URI result

URI pointing::SubPixelFunction::getURI ( bool  expanded = false ) const

virtual

getURI The method constructs URI corresponding to the type and parameters of the transfer function.

Parameters

expanded

Indicates whether all parameters must be included in URI.

Returns

URI result.

Implements pointing::TransferFunction.

void pointing::SubPixelFunction::setCardinalitySize	(	int	cardinality,
		int	size
	)

setCardinalitySize

Parameters

cardinality	Parameter defining the number of elements which users expect to select from.
size	The size of the model (element or widget) in pixels

void pointing::SubPixelFunction::setHumanResolution

(

int

humanResolution

)

setHumanResolution Sets the resolution of the pointing device at which humans have maximum pointing task efficiency.

Parameters

humanResolution

Device's Human Resolution in CPI

void pointing::SubPixelFunction::setSubPixeling

(

bool

subpixeling

)

setSubPixeling Turn on or off subpixeling

Parameters

subpixeling

Subpixeling is turned on if True otherwise defined transfer function is applied

---

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

• SubPixelFunction.h
• SubPixelFunction.cpp