205 lines
7.2 KiB
Plaintext
205 lines
7.2 KiB
Plaintext
|
Logitech Controls Assignment SDK for PC
|
|||
|
|
Copyright (C) 2009 Logitech Inc. All Rights Reserved
|
|||
|
|
|
|||
|
|
|
|||
|
|
Introduction
|
|||
|
|
--------------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
This package enables developers to easily and quickly create a
|
|||
|
|
bulletproof solution for assigning any controls of any game controller
|
|||
|
|
to any functionality in their PC game.
|
|||
|
|
|
|||
|
|
The SDK also enables to easily calculate combined values for pairs of
|
|||
|
|
game actions so the developer can directly feed the values into his
|
|||
|
|
game.
|
|||
|
|
|
|||
|
|
NOTE: a game controller is any device that will appear in "Control
|
|||
|
|
Panel/Game Controllers" in Windows.
|
|||
|
|
|
|||
|
|
|
|||
|
|
Contents of the package
|
|||
|
|
--------------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
- Logitech Controls Assignment SDK Source Files
|
|||
|
|
- Documentation
|
|||
|
|
- Demo program
|
|||
|
|
- Sample in-game implementation program file
|
|||
|
|
|
|||
|
|
|
|||
|
|
Requisites
|
|||
|
|
--------------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
The SDK expects both DIJOYSTATE2 and XINPUT_STATE structures as
|
|||
|
|
input. To obtain them easily and get full hot plug/unplug support, be
|
|||
|
|
sure to use the Controller Input SDK.
|
|||
|
|
|
|||
|
|
The game also needs to have an options menu where the player can
|
|||
|
|
assign controls to various game actions. That options menu should
|
|||
|
|
offer a way to invert the controls if necessary (using checkboxes for
|
|||
|
|
example, like the sample program).
|
|||
|
|
|
|||
|
|
If the concerned game is a driving title, you may use the Steering
|
|||
|
|
Wheel SDK that will make it very easy to enumerate and read the
|
|||
|
|
wheels, as well as doing force feedback.
|
|||
|
|
|
|||
|
|
|
|||
|
|
The environment for use of the package
|
|||
|
|
--------------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
1. Microsoft DirectX 9.0c SDK or newer
|
|||
|
|
(http://msdn.microsoft.com/downloads)
|
|||
|
|
|
|||
|
|
2. Visual Studio 2005 or newer to build and run the demo program
|
|||
|
|
|
|||
|
|
3. Drivers installed for particular wheels/joysticks/rumble pads. For
|
|||
|
|
example if using Logitech wheels/joysticks/rumble pads make sure the
|
|||
|
|
latest Gaming Software is installed
|
|||
|
|
(http://www.logitech.com/index.cfm/support_downloads/&cl=us,en).
|
|||
|
|
|
|||
|
|
|
|||
|
|
Testing setup
|
|||
|
|
--------------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
Devices used
|
|||
|
|
|
|||
|
|
Logitech gamepads
|
|||
|
|
- Cordless Rumblepad<61> 2
|
|||
|
|
- Rumblepad<61> 2 Vibration Feedback Gamepad
|
|||
|
|
- Dual Action<6F> Gamepad
|
|||
|
|
- Precision<6F> Gamepad 2
|
|||
|
|
|
|||
|
|
Logitech wheels
|
|||
|
|
- MOMO<4D> Racing
|
|||
|
|
- Formula<6C> Force GP
|
|||
|
|
- NASCAR<41> Racing Wheel
|
|||
|
|
- Formula<6C> GP
|
|||
|
|
- Driving Force Pro
|
|||
|
|
- G25
|
|||
|
|
- G27
|
|||
|
|
|
|||
|
|
Logitech joysticks
|
|||
|
|
- Force<63> 3D Pro
|
|||
|
|
- Freedom 2.4<EFBFBD> Cordless Joystick
|
|||
|
|
- Force<63> 3D
|
|||
|
|
- Extreme<6D> 3D Pro
|
|||
|
|
- Attack<63> 3 Joystick
|
|||
|
|
|
|||
|
|
Microsoft
|
|||
|
|
- Sidewinder Force Feedback 2 (Stick)
|
|||
|
|
- Sidewinder Force (Wheel)
|
|||
|
|
|
|||
|
|
Other (Immersion drivers)
|
|||
|
|
- Gravis gamepad (XTerminator Force)
|
|||
|
|
|
|||
|
|
Operating Systems
|
|||
|
|
- Windows XP/Vista
|
|||
|
|
|
|||
|
|
DirectX versions
|
|||
|
|
- 9.0c
|
|||
|
|
|
|||
|
|
|
|||
|
|
Disclaimer
|
|||
|
|
--------------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
This is work in progress. If you find anything wrong with either
|
|||
|
|
documentation or code, please let us know so we can improve on it.
|
|||
|
|
|
|||
|
|
|
|||
|
|
Where to start
|
|||
|
|
--------------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
For a demo program to see how controls get assigned (you may plug in
|
|||
|
|
multiple controllers):
|
|||
|
|
|
|||
|
|
Launch ControlsAssignmentSDKDemo.exe.
|
|||
|
|
|
|||
|
|
Or:
|
|||
|
|
|
|||
|
|
1. Open up project in ControlsAssignment/Samples/ControlsAssignmentSDKDemo.
|
|||
|
|
|
|||
|
|
2. Compile and run
|
|||
|
|
|
|||
|
|
3. Plug in one or multiple PC wheel, joystick, gamepad or other game
|
|||
|
|
controllers at any time
|
|||
|
|
|
|||
|
|
4. Read instructions at top of program's window
|
|||
|
|
|
|||
|
|
|
|||
|
|
To implement game controller support in your game:
|
|||
|
|
|
|||
|
|
1. Copy all the source files in the ControlsAssignment/Src folder to
|
|||
|
|
your game.
|
|||
|
|
|
|||
|
|
2. To use the Controller Input SDK, copy all the source files in the
|
|||
|
|
ControllerInput/Src folder to your game.
|
|||
|
|
|
|||
|
|
3. Read and follow ControlsAssignment/Doc/SampleInGameImplementation.cpp
|
|||
|
|
|
|||
|
|
4. Check method details in ControlsAssignment/Doc/api.html and
|
|||
|
|
ControllerInput/Doc/api.html
|
|||
|
|
|
|||
|
|
|
|||
|
|
For questions/problems/suggestions send email to:
|
|||
|
|
cj@wingmanteam.com
|
|||
|
|
roland@wingmanteam.com
|
|||
|
|
|
|||
|
|
|
|||
|
|
End-User License Agreement for Logitech Controls Assignment SDK
|
|||
|
|
Agreement
|
|||
|
|
|
|||
|
|
This End-User License Agreement for Logitech Controls Assignment SDK
|
|||
|
|
Agreement ( "Agreement") is a legal agreement between you, either an
|
|||
|
|
individual or legal entity ("You" or "you") and Logitech
|
|||
|
|
Inc. ("Logitech") for the pre-release alpha test version of the
|
|||
|
|
Logitech Controls Assignment software development kit, which includes
|
|||
|
|
computer software and related media and documentation (hereinafter
|
|||
|
|
"Controls Assignment SDK"). By installing, copying or otherwise using the
|
|||
|
|
Controls Assignment SDK, you agree to be bound by the terms of this
|
|||
|
|
Agreement. If you do not agree to the terms of this Agreement, do not
|
|||
|
|
install or use the Controls Assignment SDK.
|
|||
|
|
|
|||
|
|
|
|||
|
|
1 Grant of License and Restrictions. Logitech grants You a limited,
|
|||
|
|
non-exclusive, nontransferable license to install and use an
|
|||
|
|
unlimited number of copies of the Controls Assignment SDK on
|
|||
|
|
computers for any purpose. All other rights are reserved to
|
|||
|
|
Logitech.
|
|||
|
|
|
|||
|
|
2 Intellectual Property Rights. The Controls Assignment SDK is
|
|||
|
|
licensed, not sold, to You for use only under the terms and
|
|||
|
|
conditions of this Agreement. Logitech and its suppliers retain
|
|||
|
|
title to the Controls Assignment SDK and all intellectual property
|
|||
|
|
rights therein. The Controls Assignment SDK is protected by
|
|||
|
|
intellectual property laws and international treaties, including
|
|||
|
|
U.S. copyright law and international copyright treaties. All rights
|
|||
|
|
not expressly granted by Logitech are reserved.
|
|||
|
|
|
|||
|
|
3 Disclaimer of Warranty. TO THE MAXIMUM EXTENT PERMITTED BY
|
|||
|
|
APPLICABLE LAW, LOGITECH AND ITS SUPPLIERS PROVIDE THE CONTROLLER
|
|||
|
|
INPUT SDK AND OTHER LOGITECH PRODUCTS AND SERVICES (IF ANY) AS IS
|
|||
|
|
AND WITHOUT WARRANTY OF ANY KIND. LOGITECH AND ITS SUPPLIERS
|
|||
|
|
EXPRESSLY DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING,
|
|||
|
|
BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
|
|||
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD-PARTY
|
|||
|
|
RIGHTS WITH RESPECT TO THE CONTROLS ASSIGNMENT SDK AND ANY
|
|||
|
|
WARRANTIES OF NON-INTERFERENCE OR ACCURACY OF INFORMATIONAL CONTENT.
|
|||
|
|
NO LOGITECH DEALER, AGENT, OR EMPLOYEE IS AUTHORIZED TO MAKE ANY
|
|||
|
|
MODIFICATION, EXTENSION, OR ADDITION TO THIS WARRANTY. Some
|
|||
|
|
jurisdictions do not allow limitations on how long an implied
|
|||
|
|
warranty lasts, so the above limitation may not apply to you.
|
|||
|
|
|
|||
|
|
4 Limitation of Liability. IN NO EVENT WILL LOGITECH OR ITS SUPPLIERS
|
|||
|
|
BE LIABLE FOR ANY COSTS OF PROCUREMENT OF SUBSTITUTE PRODUCTS OR
|
|||
|
|
SERVICES, LOST PROFITS, LOSS OF INFORMATION OR DATA, OR ANY OTHER
|
|||
|
|
SPECIAL, INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING IN
|
|||
|
|
ANY WAY OUT OF THE SALE OF, USE OF, OR INABILITY TO USE THE CONTROLS
|
|||
|
|
ASSIGNMENT SDK OR ANY LOGITECH PRODUCT OR SERVICE, EVEN IF LOGITECH
|
|||
|
|
HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO CASE
|
|||
|
|
SHALL LOGITECH'S AND ITS SUPPLIERS' TOTAL LIABILITY EXCEED THE
|
|||
|
|
ACTUAL MONEY PAID FOR THE LOGITECH PRODUCT OR SERVICE GIVING RISE TO
|
|||
|
|
THE LIABILITY. Some jurisdictions do not allow the exclusion or
|
|||
|
|
limitation of incidental or consequential damages, so the above
|
|||
|
|
limitation or exclusion may not apply to you. The above limitations
|
|||
|
|
will not apply in case of personal injury where and to the extent
|
|||
|
|
that applicable law requires such liability.
|