Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The SetProperty() method will define various device behaviour properties such as input buffer sizes and axis modes.
Error Values that can be generated are:
DIERR_INVALIDPARAM
DIERR_NOTINITIALIZED
DIERR_OBJECTNOTFOUND
DIERR_UNSUPPORTED
- Parameters
Prop
The Prop property identifies the property that is to be retrieved.
This is one of the predefined values below or a pointer a GUID identifying the property.
DIPROP_AUTOCENTER
Set the device's auto centering function.
The associated TDIPropDWORD::Data property should be set to DIPROPAUTOCENTER_ON or DIPROPAUTOCENTER_OFF.
Not all devices support auto centering and sometimes the autocentering mechanism can interfere with force feedback effects.
DIPROP_AXISMODE
Set the axis mode.
The associated TDIPropDWORD::Data property should be set to DIPROPAXISMODE_REL or DIPROPAXISMODE_ABS.
DIPROP_BUFFERSIZE
Set the buffer size.
The associated TDIPropDWORD::Data property should be set to the desired value, which will be adjusted if it is larger than the device can support.
This indicates the amount of data the device can buffer between calls to TDx_InputDevice::GetDeviceData() without data being lost.
DIPROP_CALIBRATIONMODE
Set the calibration mode for an axis or device.
The associated TDIPropDWORD::Data property should be set to DIPROPCALIBRATIONMODE_RAW or DIPROPCALIBRATIONMODE_COOKED (the default).
The RAW setting causes raw, uncalibrated data to be returned and the deadzone, saturation and range settings to be ignored.
DIPROP_DEADZONE
Set the deadzone value for a joystick.
The associated TDIPropDWORD::Data property should be set to the desired value, in the range of 0 to 10000.
DIPROP_FFGAIN
Set the gain value for the device.
The associated TDIPropDWORD::Data property should be set to the desired value, in the range of 0 to 10000.
DIPROP_INSTANCENAME
Set the friendly instance name of the device.
The associated TDIPropString::String property should be set to the desired name, something like 'joystick 2' or 'mouse 1'.
It generally shouldn't be neccessary to modify a device's instance name.
DIPROP_PRODUCTNAME
Set the friendly product name of the device.
The associated TDIPropString::String property should be set to the desired name, which will be something like 'FlightMaster' or 'Super Trackball 3'.
It generally shouldn't be neccessary to modify a device's product name.
DIPROP_RANGE
Set the range of values the device object can report.
The associated TDIPropRange::Min must be set to a smaller value than TDIPropRange::Max.
For some devices this is a read only property and this command will fail.
DIPROP_SATURATION
Set the saturation zone value for a joystick.
The associated TDIPropDWORD::Data property should be set to the desired value, which represents the point on an axis where the device is considered to have reached its most extreme position.
Property
The Property parameter references a single TDIProperty-derived component: TDIPropRange, TDIPropDWORD, TDIPropString or TDIPropGuidAndPath, depending on the kind of property being set.
- See Also
- Top
TDx_Input_Library v2.00 Component Reference
|
|
|
[ TDx_InputDevice::SetProperty() ] [ next: Unacquire() ] [ prev: SetEventNotification() ] public:
virtual bool __fastcall SetProperty( REFGUID pProp, TDIProperty* pProperty );
TDX_INPUTDEVICE::SETPROPERTY()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|