Readme file for TWebPageImage Component

DESCRIPTION
TWebPageImage Component is a Delphi component that displays an image of a Web
Page as a graphic.

It is similar to TImage treating HTML documents as just another graphic file 
format. In fact it has a TImage (WebImage) subcomponent as one of its 
properties that you can manipulate.

REQUIREMENTS
TWebPageImage requires Internet Explorer v4.0 or above. It will work with
Netscape but only if IE exists on the same system also.

FEATURES
- High quality thumbnail images of any Web Page
- Easy to use access to the entire web image. Not just a screen capture
- Auto update continually refreshes the image a specified intervals
- Drag-n-Drop URL directly onto TWebPageImage
- Save image to BMP, JPG, or PNG
- Can be used invisibly too.

INSTALLATION
Select Component/Install Packages

Add the respective package (wpimageD4.bpl or wpimageD5.bpl) for Delphi 4 
or Delphi 5 from either the "D4" or "D5" folders.

TWebPageImage will register itself in the "Windswept" tab of the component 
palette

The OLE2 interface unit (OLE2.DCU) is required and has been provided. If 
you wish, you can delete this file as long as you have a version of it 
somewhere in your search path.

OPERATION
Once you drop an instance of TWebPageImage on your form, it is pretty 
much ready to go.

Within your application, you "load" TWebPageImage by assigning a value 
to the URL property. Assuming a live connection to the internet is available, 
TWebPageImage will begin downloading the content necessary to construct the 
image. Once complete, the graphic image of the web page specified by the URL 
is displayed.

PROPERTIES, METHODS & EVENTS

Properties
URL           - Specifies the web site to display
Active        - Determine whether TWebPageImage is active or not
WebPageView   - Type of Web page "view"
                This determines how much of the web page is captured.
                WvScreen= catures as much of the page as would fit on your screen.
                WvFull = The entire HTML document is displayed
                WvCustom = You specify the extents in "ViewWidth" and ViewHeight"
ViewWidth     - Specifies how much of the html doc is displayed horizontally 
ViewHeight    - Specifies how much of the html doc is displayed vertically
Proportional  - When TRUE, scales the image to fit while keeping the aspect ratio
TimedUpdate   - Updates the image at a specified interval
TimerInterval - Interval to update the image (30000=30 secs)
Username      - User name of the registered user
UserRegKey    - Registration Key

{ Public declarations }
WebImage        - This is the host TImage component that contains the graphic 
                  image
IsImageComplete - This is a Boolean flag that indicates that image is complete

Methods
SaveToFile(sFN : string;ImageW, ImageH: integer) : integer;
Use this method to save the current image to either a BMP, JPG, or PNG file. 
If you specify -1 for the ImageW, the file is saved using the current component 
dimensions. If you specify a ImageW and ImageH, the image will be saved to these 
dimensions.

Refresh
This simply refreshes or updates the current image with the latest version of 
the web document.

Events
OnWebImageReady- Fired when the complete document is downloaded and displayed

SAMPLES
There is a sample project provided which exersizes most of TWebPageImage's 
functionality

VERSION HISTORY
20 Dec 2000
v1.0 - Initial Release

PRICE
Registration of TWebPageImage is $45 USD
You can purchase at the following
http://www.windsweptsoftware.net/purchasewpi.htm

Support
Please send all inquiries to support@windsweptsoftware.net
or visit www.windsweptsoftware.net

LEGAL
TWebPageImage is Shareware. You are free to use it as long as you like under
these conditions. When you register TWebPageImage, the "UNREGISTERED" text 
on the images will not appear.

TWebPageImage is Copyright (c) 2000 by Windswept Software LLC, All rights 
reserved.
