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<99> 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.
