Struct representing a SensorDevice, a meta device. More...

#include <SensorDevice.h>

Collaboration diagram for SensorDevice:

Public Attributes
	Device
	Base device.

CartesianCoordinates	Resolution
	Resolution of the device.

TouchActiveArea	TouchActiveArea
	Touch Active Area of the device.

bool(*	GetEnable )(SensorDevice *self)
	Ask the Device if it is enabled. More...

bool(*	SetEnable )(SensorDevice *self, bool continuousMode, uint32_t numberOfMessages)
	Enable the device. More...

bool(*	GetDisable )(SensorDevice *self)
	Ask the Device if it is disabled. More...

bool(*	SetDisable )(SensorDevice *self)
	Disable the device. More...

bool(*	GetOperationModes )(SensorDevice *self)
	Get the current Operating Modes of the Device. More...

bool(*	SetOperationModes )(SensorDevice *self, OperationModes modeMask, OperationModes modeValues)
	Set the current Operating Modes of the Device. More...

bool(*	GetResolution )(SensorDevice *self)
	Get the current Resolution of the Device. More...

bool(*	SetResolution )(SensorDevice *self, uint32_t x, bool xIsValid, uint32_t y, bool yIsValid, uint32_t z, bool zIsValid)
	Set the current Resolution of the Device. More...

bool(*	GetTouchActiveArea )(SensorDevice *self)
	Get the current Touch Active Area of the Device. More...

bool(*	SetTouchActiveArea )(SensorDevice *self, uint32_t lowerBoundaryX, uint32_t upperBoundaryX, bool xIsValid, bool xIsReversed, uint32_t lowerBoundaryY, uint32_t upperBoundaryY, bool yIsValid, bool yIsReversed)
	Set the current Touch Active Area of the Device. More...

bool(*	GetDetectedObjectSizeRestriction )(SensorDevice *self)
	Get the current Detected Object Size Restriction of the Device. More...

bool(*	SetDetectedObjectSizeRestriction )(SensorDevice *self, uint32_t minimumSize, uint32_t maximumSize, bool minimumSizeIsValid, bool maximumSizeIsValid)
	Set the current Detected Object Size Restriction of the Device. More...

bool(*	GetNumberOfTrackedObjects )(SensorDevice *self)
	Get the number of tracked objects. More...

bool(*	SetNumberOfTrackedObjects )(SensorDevice *self, uint32_t numberOfTrackedObjects)
	Set the number of tracked objects. More...

Detailed Description

Struct representing a SensorDevice, a meta device.

SensorDevice is a meta device as it is not a real device and cannot be instantiated by itself. It contains everything that is shared between all the touch Sensor types, currently CoreDevice, AirDevice and PlusDevice.

Member Data Documentation

bool( * SensorDevice::GetDetectedObjectSizeRestriction) (SensorDevice *self)

Get the current Detected Object Size Restriction of the Device.

Gets the current Detected Object Size Restriction.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.

Parameters

self	Pointer to the struct itself.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::GetDisable) (SensorDevice *self)

Ask the Device if it is disabled.

Ask the device if it is disabled.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.

Parameters

self	Pointer to the struct itself.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::GetEnable) (SensorDevice *self)

Ask the Device if it is enabled.

Ask the Device if it is enabled. Also reports if the device is in continuous mode and number of messages left to receive.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.

Parameters

self	Pointer to the struct itself.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::GetNumberOfTrackedObjects) (SensorDevice *self)

Get the number of tracked objects.

Get the number of tracked objects.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.

Parameters

self	Pointer to the struct itself.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::GetOperationModes) (SensorDevice *self)

Get the current Operating Modes of the Device.

Gets the current Operating Modes of the Device as two bitmasks.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.

Parameters

self	Pointer to the struct itself.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::GetResolution) (SensorDevice *self)

Get the current Resolution of the Device.

Gets the current Resolution of the Device.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.

Parameters

self	Pointer to the struct itself.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::GetTouchActiveArea) (SensorDevice *self)

Get the current Touch Active Area of the Device.

Gets the current Touch Active Area of the Device.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.

Parameters

self	Pointer to the struct itself.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::SetDetectedObjectSizeRestriction) (SensorDevice *self, uint32_t minimumSize, uint32_t maximumSize, bool minimumSizeIsValid, bool maximumSizeIsValid)

Set the current Detected Object Size Restriction of the Device.

Sets the current Detected Object Size Restriction of the device.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.
EINVALIDINPUT - Lower boundary input values must be lower than upper.

Parameters

self	Pointer to the struct itself.
minimumSize	The minimum object size to detect by device.
maximumSize	The maximum object size to detect by device.
minimumSizeIsValid	Set to True to alter minimumSize detection.
maximumSizeIsValid	Set to True to alter maximumSize detection.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::SetDisable) (SensorDevice *self)

Disable the device.

Disable the device. Messages will stop arriving as soon as the Device processes the request, but Messages already in progress will still arrive as normal.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.

Parameters

self	Pointer to the struct itself.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::SetEnable) (SensorDevice *self, bool continuousMode, uint32_t numberOfMessages)

Enable the device.

Enable the device and set it to either continuous mode or a specified number of messages. Not all protocols handle non-continuous mode.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.
EINVALIDINPUT - Continuous cannot be false when numberOfMessages = 0.

Parameters

self	Pointer to the struct itself.
continuousMode	Set to true for continuous mode.
numberOfMessages	When in non-continuous mode, specifies how many Messages to receive before the Device disables itself. May not be 0 when continuousMode == false.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::SetNumberOfTrackedObjects) (SensorDevice *self, uint32_t numberOfTrackedObjects)

Set the number of tracked objects.

Set the number of tracked objects.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.

Parameters

self	Pointer to the struct itself.
numberOfTrackedObjects	Tracked object count.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::SetOperationModes) (SensorDevice *self, OperationModes modeMask, OperationModes modeValues)

Set the current Operating Modes of the Device.

Sets the current Operating Modes of the Device as two bitmasks. Setting the modeMask bit for a specific Mode to 1 changes it to become the corresponding bit in modeValues but setting the bit to 0 does not change it.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.
EINVALIDINPUT - The modeMask and/or modeValue fields try to set bits that are not defined.

Parameters

self	Pointer to the struct itself.
modeMask	A bit set to 1 means set to the corresponding bit in the modeValue field and 0 means do not change this bit.
modeValue	The value to set the bits to.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::SetResolution) (SensorDevice *self, uint32_t x, bool xIsValid, uint32_t y, bool yIsValid, uint32_t z, bool zIsValid)

Set the current Resolution of the Device.

Sets the current Resolution of the Device.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.

Parameters

self	Pointer to the struct itself.
x	The Resolution of the X axis.
xIsValid	Set to true to change this value or false to ignore it. Ignored on a Device that does not allow it.
y	The Resolution of the Y axis.
yIsValid	Set to true to change this value or false to ignore it. Ignored on a Device that does not allow it.
z	The Resolution of the Z axis.
zIsValid	Set to true to change this value or false to ignore it. Ignored on a Device that does not allow it.

Returns: True for success, false for failure. See errno.

bool( * SensorDevice::SetTouchActiveArea) (SensorDevice *self, uint32_t lowerBoundaryX, uint32_t upperBoundaryX, bool xIsValid, bool xIsReversed, uint32_t lowerBoundaryY, uint32_t upperBoundaryY, bool yIsValid, bool yIsReversed)

Set the current Touch Active Area of the Device.

Sets the current Touch Active Area of the Device.

On failure, errno is set.

EALREADYINPROGRESS - Another request is currently in progress.
ENOTSUPPORTED - This request is not supported by this protocol and/or Device.
EINVALIDINPUT - Lower boundary input values must be lower than upper.

Parameters

self	Pointer to the struct itself.
lowerBoundaryX	The lower boundary for the X axis to set.
upperBoundaryX	The upper boundary for teh X axis to set.
xIsValid	Set to true to change the values or false to ignore.
xIsReversed	True to reverse the X axis.
lowerBoundaryY	The lower boundary for the Y axis to set.
upperBoundaryY	The upper boundary for teh Y axis to set.
yIsValid	Set to true to change the values or false to ignore.
yIsReversed	True to reverse the Y axis.

Returns: True for success, false for failure. See errno.

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

SensorDevice.h

Public Attributes

Detailed Description

Member Data Documentation