Copyright: ® 1994 Rimrock Software.


Contents
CYBWIN Contents

.

CYBWIN - CyberMan Windows 3.1 Driver

© 1995 Spatial Imaging Systems.  All rights reserved.

CyberMan is a trademark of Logitech, Inc.

•	License Agreement

•	Overview

•	Configuration

•	Programming

•	Registering

•	Becoming a Value Added Resaler

•	E-Mail

  Glossary

If you are unfamiliar with how Windows Help works, choose Help | How To Use Help from the Help menu now.


License Agreement

CYBWIN is marketed as shareware. You are allowed to evaluate the software for a period of 7 days before you must obtain a license. The following is that license agreement:

This is a legal agreement between you and Spatial Imaging Systems.  By your retention of the accompanying software which contains the "CYBWIN - CyberMan Windows Driver", which is owned and copyrighted by Spatial Imaging Systems, you agree to the terms of this Agreement.  If you do not agree, promptly remove the software from your computer.

1.	Released to Public as Shareware.  CYBWIN V1.0 has been released to the public as shareware. CYBWIN may be evaluated for a period of 7 (seven) days before it is required that the user must register and pay a fee.

2.	License Grant.  Software application developers may use one copy of the CYBWIN for development, design and testing purposes for their software product. Software application users may use one copy of CYBWIN as a "Driver" that interacts with a software application.

3.	Restriction.  You may not distribute CYBWIN with or in addition to a software application and charge a fee unless you have registered as a Value Added Resaler of CYBWIN with Spatial Imaging Systems. A Value Added Resaler of CYBWIN is required to pay Spatial Imaging Systems monthly, at $5 per copy, for each copy of CYBWIN distributed with or in addition to other software applications. There is no restrictions on what the Value Added Resaler may charge their end user for CYBWIN.

4.	NO WARRANTIES.  To the maximum extent permitted by law: (A) the CYBWIN is provided "as is" without warranty of any kind; (B) Spatial Imaging Systems and its suppliers disclaim all warranties, either express or implied, including, but not limited to implied warranties of merchantability and fitness for a particular purpose, with regard to the CYBWIN; and (C) the entire risk arising out of the use or performance of the CYBWIN remains with you.

5.	NO LIABILITY FOR CONSEQUENTIAL DAMAGES.  To the maximum extent permitted by law, in no event shall Spatial Imaging Systems or its suppliers be liable for any damages whatsoever (including without limitation, damages for loss of business profits, business interruption, loss of business information, or any other pecuniary loss) arising out of the use of or inability to use this Spatial Imaging Systems product, even if Spatial Imaging Systems has been advised of the possibility of such damages.  Because some states/jurisdictions do not allow the exclusion or limitation of liability for consequential or incidental damages, the above limitation may not apply to you.


Information
CYBWIN Information

CYBWIN is © 1995 Spatial Imaging Systems.  All rights reserved.


Configuration

•	Com Port:  - Select the serial COM port that CyberMan is connected to. Do NOT select the COM port that the mouse is connected to or a conflict can occur. The configuration is stored in system.ini. You may edit this, if necessary, system.ini, [cybwin], ComPort=(1,2,3,4).

•	Output Debugging Messages:  - Programming aid, default=off.

•	Restart Windows:  - Selected during installation, default=off.

•	Load Driver When Windows Boots:  - default=off.


Overview

CYBWIN is an installable Windows 3.1 device driver. It performs the functions of interfacing with the CyberMan over a serial COM port, processing the information to/from the CyberMan, and communicating with the application by means of Windows messages. The entire operation is event driven and is designed to behave properly in the Windows environment. CYBWIN is designed for the CyberMan to operate in Swift mode only. This means that CyberMan is used as a 3D controller and not as a mouse. The mouse is fully operational along with the CyberMan and has its own device driver.

Those applications programmers wanting to develop game, 3D, virtual reality, or CAD applications can simply:

Install CYBWIN using the Control Panel - Drivers

OpenDriver

ConfigDriver - Only Once

Process CYBWIN Messages

CloseDriver

The entire implementation is very painless and allows the programmer to focus on the application and not the device interface. Those Windows application users must be aware that the applications must be written to support CYBWIN.


Programming

A demo application, CybCube, has been supplied to those application programmers to show how CYBWIN is programmed. CybCube is a modified version of Cube supplied by Microsoft with the WinG SDK. WinG must be installed in order to run CybCube. Look at the source code in cube.cpp to see how the driver is opened, closed, configured, and the messages are processed. Pay special attention to the passing of Window handles and instances when opening the driver and the processing of wParam and lParam when receiving a message.


Registering

CYBWIN is marketed as shareware. This allows the applications programmer to evaluate the product before supporting it in his or her application. The evaluation period for CYBWIN is 7 days. If the applications developer is using CYBWIN after 7 days, they must register and pay a $20 license fee. Applications developers may only distribute CYBWIN along with or in addition to their product, if they are registered with Spatial Imaging Systems as a Value Added Resaler of CYBWIN. If applications users have been supplied CYBWIN along with or in addition to applications that they have purchased, their supplier must be registered as a Value Added Resaler of CYBWIN with Spatial Imaging Systems. A Value Added Resaler has an agreement with Spatial Imaging Systems to pay a license fee for each copy of CYBWIN provided with or in addition to applications that they market. Users of CYBWIN supplied by a third party may determine that their supplier is a Value Added Resaler by E-Mailing Spatial Imaging Systems to request a list of Value Added Resalers (sorry, VAR List sent by E-Mail only). If their supplier is not on that list, they are obliged to register and pay a $20 license fee.

Print out the registration from the Configuration menu, fill out and mail to:

Spatial Imaging Systems

303 S. Broadway, Suite B173

Denver, CO 80209


Becoming a Value Added Resaler

Value Added Resalers of CYBWIN have entered into an agreement with Spatial Imaging Systems to distribute CYBWIN along with or in addition to their products. To apply to become a Value Added Resaler of CYBWIN, request an application via E-Mail. All Value Added Resalers must be a registered licensed user of CYBWIN and will have paid a $20 license fee. The agreement states that Value Added Resalers will pay Spatial Imaging Systems on a monthly basis $5 for each copy of CYBWIN distributed along with or in addition to their products. Value Added Resalers will be added to a list of such that will be supplied upon request.


E-Mail

EMail SpImSy@aol.com


Glossary

WinG

Swift


wing (def.)
The Microsoft games API that allows fast graphics for games.


swift (def.)
Swift Devices are devices that give senses to the computer or output sensory feedback to the user via computer control. The device does not behave as a mouse.