giiQueryValInfo(3) GGI giiQueryValInfo(3)NAME
giiQueryValInfo - Get data about valuators
SYNOPSIS
#include <ggi/gii.h>
int giiQueryValInfo(gii_input_t inp, uint32_t origin,
uint32_t valnumber, gii_cmddata_getvalinfo *info);
DESCRIPTION
Though when using GII inputs the exact type of device is fully transparent to the program, information about the device that is actually
attached to a given gii input and origin id can be queried, e.g. for configuration interfaces.
For giiQueryValInfo is used on devices, where giiQueryDeviceInfo(3) has indicated that the device has one or more valuator axes and you
want to gather additional info about the physical equivalent of each axis.The parameters inp and origin select the input to query and val-
number selects the specific valuator (an input can have multiple valuators).
The queried data is put into info. See gii_cmddata_getvalinfo(3) for the description of the structure.
RETURN VALUE
Returns 0 on success (info is valid, then) or -1 otherwise.
SEE ALSO giiQueryDeviceInfo(3)libgii-1.0.x 2006-12-30 giiQueryValInfo(3)
Check Out this Related Man Page
gii_cmddata_getvalinfo(3) GGI gii_cmddata_getvalinfo(3)NAME
gii_cmddata_getvalinfo, gii_phystype, gii_valrange - GII valuators description
SYNOPSIS
#include <ggi/events.h>
typedef struct gii_valrange {
int32_t min, center, max;
} gii_valrange;
typedef struct {
uint32_t number;
char longname[75];
char shortname[5];
gii_valrange range;
gii_phystype phystype;
int32_t SI_add,SI_mul,SI_div,SI_shift;
} gii_cmddata_getvalinfo;
DESCRIPTION
This structure is used to describe the values reported by a specific valuator.
STRUCTURE MEMBERS
gii_cmddata_getvalinfo fields are defined as follow:
number Number of the queried valuator.
longname
A human-redable NULL terminated string identifying the valuator.
shortname
A NULL terminated abbreviated name for this valuator.
range Contains the minimum, center and maximum values for this valuator. Note that this range may change on some devices due to calibra-
tion, but it is usually not expected that a device recalibrates while in use. You should react gracefully to values received from
the valuator that are outside the specified range, though.
phystype
Gives the physical quantity the device measures. The idea is to report the thing the user actually controls. I.e. a Joystick actu-
ally measures resistance, but should report GII_PT_ANGLE or GII_PT_FORCE, as that is what the user does to the stick and what
results in the changed resistance.
SI_add, SI_mul, SI_div, SI_shift
Using these values, it is possible to give calibration data to the application or to compute the actual floating point value (in the
unit expressed in phystype) reported by the valuator with the following formula:
(float)(SI_add + value) * (float)SI_mul / (float)SI_div * pow(2.0, SI_shift);
PHYSICAL UNITS
The following physical units are defined for gii_phystype:
o GII_PT_UNKNOWN : unknown
o GII_PT_TIME : base unit s (second)
o GII_PT_FREQUENCY : base unit 1/s (Hz)
o GII_PT_LENGTH : base unit m (meter)
o GII_PT_VELOCITY : base unit m/s
o GII_PT_ACCELERATION : base unit m/s^2
o GII_PT_ANGLE : base unit radian
o GII_PT_ANGVELOCITY : base unit radian/s
o GII_PT_ANGACCELERATION : base unit radian/s^2
o GII_PT_AREA : base unit m^2
o GII_PT_VOLUME : base unit m^3
o GII_PT_MASS : base unit kg
o GII_PT_FORCE : base unit N (kg*m/s^2)
o GII_PT_PRESSURE : base unit N/m^2 (Pa)
o GII_PT_TORQUE : base unit Nm
o GII_PT_ENERGY : base unit Nm, VAs, J
o GII_PT_POWER : base unit Nm/s, VA, W
o GII_PT_TEMPERATURE : base unit K
o GII_PT_CURRENT : base unit A
o GII_PT_VOLTAGE : base unit V (kg*m^2/(As^3))
o GII_PT_RESISTANCE : base unit V/A (Ohm)
o GII_PT_CAPACITY : base unit As/V (Farad)
o GII_PT_INDUCTIVITY : base unit Vs/A (Henry)
SEE ALSO giiQueryValInfo(3)libgii-1.0.x 2006-12-30 gii_cmddata_getvalinfo(3)