TRemoteControl
Version 2.4 (build 2.4.2) - December 6, 2004

Home page: http://www.datastead.com
mirror#1: http://www.delphicity.com
mirror#2: http://www.datastead.info

Contact: contact@datastead.com
Support: support@datastead.com

DESCRIPTION

REGISTRATION

USER GUIDE

- Package Install

- How does it work

- Properties and events

- Types

TRemoteControl package install

1. First of all, do not forget to install the ATI Remote Wonder driver and to properly connect the USB receiver.

2. If a previous TRemoteControl package is already installed, remove it first:

- Components | Install Packages,
- click on "Datastead TRemoteControl",
- click "Remove",
- click "Yes",
- click "Ok",
- search for all the "TRControl.*" and "RControl.*" files in your Borland directories and delete them, to be certain that old units will not remain in the Borland's search paths.

3. Install the current package:

- Unzip the archive in a folder of your choice (e.g. c:\rcontrol). Be sure to unzip the full directory structure (using WinZip check "use folders names" ).

- according to your version of Delphi/C++Builder, copy all the Delphi\*.* or CBuilder\*.* archive files to your \Borland\Delphi\Imports or \Borland\CBuilder\Imports directory,
- Run Delphi or C++Builder,

- Select Component | Install packages,

- Press the "Add" button,

- Locate the TRControl.bpl file in the Imports directory and select it,

- Select Open

- Select Ok

- Check the Datastead tab in the right of the component palette. The TRemoteControl object should have been added,

Note:

If you get a "TRControl.??? file not found" error when compiling or linking your project:

- go to Tools | Environment Options | Library, and check that you have ;$(DELPHI)\Imports (Delphi) or ;$(BCB)\Imports (C++Builder) in the Library path, otherwise add it at the end of the edit field.

- go to Project | Options | Packages, check "Build with runtime package", go to the end of the packages edit field, remove ";TRControl", and then uncheck "Build with runtime package".

HOW DOES IT WORK

TRemoteControl is very simple to use. It has an OnReceive event that returns remote control information every time a button is pressed on the remote control device.

When the TRemoteControl Enabled property is set to true:

- the component is activated and starts returning remote control events,
- the default ATI remote control software (e.g. that makes the cursor move when you use the remote control mouse) is disabled if AutoShutdownATIControl is true, otherwise both ATI remote control software and TRemoteControl work simultaneously.

See the demo project included in the package for sample code.

PUBLIC PROPERTIES

property DeviceInitialized: boolean;

After enabling the component (Enable = true) , test this property to know if the component has been successfully initialized.

This property returns usually "false" when the ATI Remote Wonder driver is not installed.

PUBLISHED PROPERTIES

property AutoShutdownATIControl: boolean;

If true, the ATI background software that controls the ATI Remote Wonder is disabled when the component is activated, to avoid interfering with TRemoteControl.
Defaut value: true

property Enabled: boolean;

If true, the component is activated, otherwise the component is deactivated.
Default value: false

EVENTS

procedure OnReceive (Sender: TObject; DeviceId: Integer; ButtonId: TRCButtonId; ButtonName: String; ButtonState: TRCButtonState; ButtonRepeatCount: Integer);

Occurs when a button is pressed or released on the remote control. Returns the following information:

DeviceId:
identifier of the remote control device used, from 0 to 15. Up to 16 remote control devices can be used concurrently.
See the remote control user guide to change the remote control identifier.

ButtonId: TRCButtonId:
identifier of the button pressed or released

ButtonName: string
name of the button pressed or released

ButtonState: TRCButtonState
return rc_On if the button is pressed, rc_Off if the button is released, or rc_Repeat if the button is pressed and not released

ButtonRepeatCount: integer
return the repeat count when the button is pressed and not released

TYPES

TRCButtonState = (

> rc_On,
> rc_Off,
> rc_Repeat
> );

TRCButtonId = (

> rc_None,
> rc_A,
> rc_B,
> rc_Power,
> rc_TV,
> rc_DVD,
> rc_Web,
> rc_Book,
> rc_Hand,
> rc_MouseUp,
> rc_MouseDown,
> rc_MouseLeft,
> rc_MouseRight,
> rc_MouseLeftUp,
> rc_MouseRightUp,
> rc_MouseLeftDown,
> rc_MouseRightDown,
> rc_MouseLeftClick,
> rc_MouseRightClick,
> rc_LButtonDown,
> rc_LButtonUp,
> rc_RButtonDown,
> rc_RButtonUp,
> rc_LButtonDoubleClick,
> rc_RButtonDoubleClick,
> rc_VolumeDown,
> rc_VolumeUp,
> rc_Mute,
> rc_ChannelDown,
> rc_ChannelUp,
> rc_0,
> rc_1,
> rc_2,
> rc_3,
> rc_4,
> rc_5,
> rc_6,
> rc_7,
> rc_8,
> rc_9,
> rc_10,
> rc_11,
> rc_Menu,
> rc_Check,
> rc_C,
> rc_D,
> rc_Up,
> rc_Down,
> rc_Left,
> rc_Right,
> rc_Bookmark,
> rc_Ok,
> rc_Resize,
> rc_E,
> rc_F,
> rc_Rewind,
> rc_Play,
> rc_Forward,
> rc_Record,
> rc_Stop,
> rc_Pause
> );

License Agreement

PLEASE READ THIS LICENSE AGREEMENT ("AGREEMENT") CAREFULLY:
BY INSTALLING, COPYING OR OTHERWISE USING THIS SOFTWARE AND ANY RELATED PRINTED MATERIALS ("SOFTWARE"), YOU ARE ACCEPTING AND AGREEING TO THE TERMS OF THIS AGREEMENT.
IF YOU DO NOT AGREE WITH THE TERMS OF THIS AGREEMENT, DO NOT USE THE SOFTWARE.

Copyright

All Datastead Software components and applications are copyrighted by Michel FORNENGO (hereafter "author"), and shall remain the exclusive property of the author.

General agreement

By installing this software you agree with:
- You may not use the source code or binaries in this package to create competitive software product,
- You may not manipulate any binary files included in this package or generated by Delphi or C++Builder from the package,
- You may not distribute any file included in this package (source code or binaries) to non registered people.

Licensed version

This software and any accompanying documentation are protected by International Copyright laws and Treaty provisions.
Any use of this software in violation of copyright law or the terms of this agreement will be prosecuted to the best of the author's ability.
You are hereby authorized to make archival copies of this software for the sole purpose of back-up and protecting your investment from loss.
Under no circumstances may you copy this software or documentation for the purposes of distribution to others. Under no conditions may you remove the copyright notices made part of the software or documentation.

Distribution Rights

You are granted a non-exclusive, royalty-free right to produce and distribute executable binary files (executables, DLLs, etc.) that are built with the registered version of the software unless specifically stated otherwise.

The origin of this software must not be misrepresented, you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
Restrictions

Without the express prior written consent of the author, you may not distribute any of the author's commercial source code, compiled units or documentation by any means whatsoever. You may not transfer, lease, lend, copy, modify, translate, sublicense, time-share, or electronically transmit or receive the software or documentation.

Upgrade

The upgrade version of the software constitutes a single product of the author's software that you upgraded. For example, the upgrade and the software that you upgraded cannot both be available for use by two different people at the same time, without written permission from the author.

Limited warranty

Datastead warrants that for a period of ninety (90) days from the date of shipment from Datastead: (i) the media on which the Software is furnished will be free of defects in materials and workmanship under normal use; and (ii) the Software substantially conforms to its published specifications. Except for the foregoing, the Software is provided AS IS. This limited warranty extends only to Customer as the original licensee. Customer's exclusive remedy and the entire liability of Datastead and its suppliers under this limited warranty will be the refund of the Software. In no event does Datastead warrant that the Software is error free or that Customer will be able to operate the Software without problems or interruptions.

This warranty does not apply if the software (a) has been altered, except by Datastead, (b) has not been installed, operated, repaired, or maintained in accordance with instructions supplied by Datastead, (c) has been subjected to abnormal physical or electrical stress, misuse, negligence, or accident, or (d) is used in ultra hazardous activities.

Disclaimer

The Author cannot and does not warrant that any functions contained in the Software will meet your requirements, or that its operations will be error free. The entire risk as to the Software performance or quality, or both, is solely with the user and not the Author. You assume responsibility for the selection of the component to achieve your intended results, and for the installation, use, and results obtained from the Software.
The Author makes no warranty, either implied or expressed, including without limitation any warranty with respect to this Software documented here, its quality, performance, or fitness for a particular purpose. In no event shall the Author be liable to you for damages, whether direct or indirect, incidental, special, or consequential arising out the use of or any defect in the Software, even if the Author has been advised of the possibility of such damages, or for any claim by any other party.

ALL DATASTEAD SOFTWARE IS NOT DESIGNED, MANUFACTURED, OR INTENDED FOR USE OR RESALE AS ON-LINE CONTROL EQUIPMENT IN HAZARDOUS ENVIRONMENTS REQUIRING FAIL-SAFE PERFORMANCE SUCH AS IN THE OPERATION OF NUCLEAR FACILITIES, AIRCRAFT NAVIGATION OR COMMUNICATION SYSTEMS, AIR TRAFFIC CONTROL, DIRECT LIFE SUPPORT MACHINES, OR WEAPONS SYSTEMS, IN WHICH THE FAILURE OF THE SOFTWARE COULD LEAD DIRECTLY OR INDIRECTLY TO DEATH, PERSONAL INJURY, OR SEVERE PHYSICAL OR ENVIRONMENTAL DAMAGE.
All other warranties of any kind, either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose, are expressly excluded.

General

This Agreement is the complete statement of the Agreement between the parties on the subject matter, and merges and supersedes all other or prior understandings, order orders, agreements and arrangements. This Agreement shall be governed by the laws of France. Exclusive jurisdiction and venue for all matters relating to this Agreement shall be in courts and fora located in France, and you consent to such jurisdiction and venue. There are no third party beneficiaries of any promises, obligations or representations made by Datastead.

DESCRIPTION

TRemoteControl is a remote control component for Delphi and C++Builder.

TRemoteControl allows you to add remote control capabilities to your project, using a radio remote control device.

Up to 16 remote control devices can be used concurrently with the same receiver.

When a remote control button is pressed, the OnReceive event returns the remote control id, the button state (on, off, repeat), the button id, the button name and the button repeat count.

System requirements

> - Windows 95/98/ME/NT/2000/XP
> - Delphi 4 / 5 / 6 / 7 or C++ Builder 4 / 5 / 6
> - ATI Remote Wonder or
>   Hercules Remote Control or
>   Niveus PC Remote Control or
>   Sapphire Remote Control or
>   MicroApplication Remote control

REGISTRATION

Click here to go to the TRemoteControl registration page.