  	 Common Controls Replacement Project - Animation Control
   	        Release v.1.04.108 (VB5) - 3rd July 1999

This control is a direct replacement for the Animation Control provided by 
COMCT232.OCX. It was created by Jeremy Adams (jeremyadams@hotmail.com), a 
member of the VB Common Controls Replacement Project, a group aiming to provide 
separate ActiveX controls to replace and extend the controls found in 
COMCTL32.OCX and COMCT232.OCX

This control also includes new features found in COMCTL32.DLL but not present 
in the control provided by COMCT232.OCX. These features include the ability to 
load an AVI resource and to use a Timer rather than a Thread when displaying 
the Animation.

Other features in this control are:

* AutoOpen will automatically open the AVI when the control is loaded. If 
  AutoPlay is also true then no code is required to display an AVI.
* Alignment for easy alignment of control to the sides of a form.
* AutoSize property to automatically resize the control to fit the frame 
  size of the AVI being displayed.
* Filename property to set filename without code
* OpenAVIResource can be called to load an AVI resource from a compiled EXE 
  using the control.


Revision History:

Beta 2:

* Added mouse Events
* Added status Property and StatusChanged Event to return the current status
  of the control
* Appearance property can specify a Raised or Sunken 3D effect 
* Added support for loading standard resources used by Explorer
* Added support for loading resources from a DLL
* Control now raises errors as appropriate such as when opening AVI fails.
* When AutoSize is set to true, the changes to Height and Width are
  reflected correctly. In beta 1 the Height and Width properties did not 
  change.

Release v.1.00.101

* A bug was fixed which was causing a GPF when AutoOpen = True and
  the Filename property was set to an invalid filename.

Release v.1.00.102

* A bug was fixed for v1.00.102 which was causing a GPF when the control was
  placed on a form with ScaleMode = 0 (User)

Release v.1.03.105

* Some bug fixes and optimisations.

Release v.1.04.108 

* Grab handles are now displayed correctly when the control is part of a 
  multiple selection in the IDE.

Notes:

The Open, Close and Stop methods of the COMCT232.OCX Animation control have 
been renamed to OpenAVI, CloseAVI and StopPlaying as VB will not allow 
creation of methods called Open, Close or Stop as they are VB reserved 
keywords.

When using LoadAVIResource, you must pass App.hInstance as the second 
parameter or the control will not be able to locate the resource.

See the included Resource Readme!.txt file for important information about 
loading AVI resources.

If an AVI does not load, it may be that the AVI is not compatible with the
control. The same restrictions apply to AVI files using this control
as apply to AVIs loaded using the animation control found in COMCT232.OCX.
This means that AVIs with audio streams or AVIs compressed in non-RLE formats
may not work. Consult the documentation for COMCT232.OCX for more information.

The AutoSize property works only at runtime. It resizes the control to the
size of the AVI. It does not alter the playing of the AVI in any way. Also,
the Center property is ignored if AutoSize is true.

Included Demos:

Two demos are included with this control and should be placed in 
subdirectories when the ZIP is decompressed.

DEMO contains a project that demonstrates most of the Animation Control's features.
RESDEMO contains a project that demonstrates how to load an AVI resource.

The Resource demo is based on work by Ramon Guerrero (zonecorp@dallas.net).

The code to display the File Open Common Dialog was written by Domenico Statuto 
(dstatuto@mbox.vol.it). He has developed the FileDialogs Control for CCRP which 
wraps this and much more functionality into an OCX that provides advanced features
not provided by COMDLG32.DLL such as allowing the addition of extra controls to the
dialog. 

Registering the control:

Use RegSvr32 or the Browse button in the Components dialog box within VB5 to 
register the control. If you get an error whilst attempting to register ccrpani.ocx 
it is possible that you do not have SP2 installed (see note below about SP2 issues).  

SP2 issues:

This control uses the apartment threading features found in SP2 and will not 
function without SP2 or higher installed.

Help Files:

A Help File is provided with this beta. Videosoft (http://www.videosoft.com)
have kindly provided CCRP with a copy of their VSDOCX software for 
documenting ActiveX controls. The included help file was created using VSDOCX.
                                                                   
CCRP Licensing and Distribution Agreement:

You must agree to the following distribution and licensing agreement before 
using the control. By using the control you indicate your full agreement to 
the following:

Developers:

CCRP controls are provided as freeware to developers who are solely 
responsible for determining the suitability of the controls for their use. 
CCRP controls and related files are the property of the Common Controls 
Replacement Project, and the CCRP retains the exclusive property rights to 
the controls. This agreement grants application developers conditional 
permission for their use. 

Application developers are free to distribute with their completed 
application any required CCRP control. This also extends to include any 
demo code that may have been modified in order to achieve the functionality 
desired in their application. By using CCRP software, the developer 
acknowledges these conditions covering both the use and distribution of 
CCRP controls, and their use shall constitute acceptance of this agreement.

Under no circumstance does the control author or the Common Controls 
Replacement Project assume any responsibility for the reliability of 
the CCRP controls, nor responsibility in the unlikely event of any 
possible loss of data that may be incurred from such use.

Distributors:

The CCRP website (http://www.mvps.org/ccrp) and the CCRP newsgroup 
(news.mvps.org) are the sole legal distributors of CCRP controls. No 
control or portion of any control package (ocx, dll, help file, demo code
 or zip) may be posted or distributed via any web site, online service or 
BBS, or included on any CD or with any other software media without explicit 
written permission from CCRP control lead developer unless the control is a 
required part of a completed application being distributed. In addition, 
CCRP controls may not be distributed via any fee-based service or media. 
Email addresses of the lead developers can be found on the CCRP Membership 
page.

The Common Controls Replacement Project and/or the author of this control 
reserves the right to stop anyone from using this control at any point 
if he wishes.

Support and Updates:

Visit the official CCRP website at http://www.mvps.org/ccrp to:
	
    * obtain updates and other CCRP controls, 
    * report bugs or suggest improvements, 
    * obtain technical support through the CCRP newsgroups.

Enjoy!

Jeremy Adams
jeremyadams@hotmail.com
CCRP: http://www.mvps.org/ccrp