Description
***********

XImgEdit is an ActiveX image editor. It supports both BMP and JPG file formats.

Installation
************
Although not necessary, it is a good idea to copy the ocx file to windows\system directory, which is the usual destination of ActiveX controls. To use XImgEdit in your projects you must first register it using Regsvr32.exe (you'll find it in windows\system directory). Alternatively, you can browse for it from within VB IDE, in which case it is registered automatically. If you do not feel comfortable with either method please download ActiveX Manager from our website. It will let you manage controls with ease.
NOTE: you must register the control BEFORE you attempt to use it or run sample project included in the package.

XImgEdit has the following properties:
**************************************
Brightness (integer)
It adjusts the brightness of the image. Positive values make image brighter, negative values make it darker.
Example: XImgEdit1.Brightness=20

Contrast (integer)
Positive values increase image contrast, negative values decrease it.
Example: XImgEdit1.Contrast=-30

Saturation (integer)
This property adjusts the color saturation. Positive values increase saturation, negative decrease (including color inversion).
Example: XImgEdit1.Saturation=500

Sharpen (integer)
Using this property allows to enhance image sharpness.
Example: XImgEdit1.Sharpen=10

Blur (integer)
This applies Gaussian blur to the image. The value indicates number of edge pixels involved in transformation (blur radius).
Example: XImgEdit1.Blur=2

Pixelate (integer)
Using this property applies a special filter to image making it appear 'grainy'.
Example: XImgEdit1.Pixelate=10

Embossed (boolean)
Switches embossing filter on/off.
Example: XImgEdit1.Embossed=true

Grayscale (boolean)
Converts image to grayscale. Note that while it is easy to convert color image to grayscale it is impossible to do the reverse.
Example: XImgEdit1.Grayscale=true

FlipHorizontal (boolean)
Flips image horizontally.
Example: XImgEdit1.FlipHorizontal=true

FlipVertical (boolean)
Flips image vertically.
Example: XImgEdit1.FlipVertical=true

Inverted (boolean)
Inverts the image colors making it a 'negative' image.
Example: XImgEdit1.Inverted=true

Rotation (integer)
Rotates the image by an arbitrary angle (in degrees).
Example: XImgEdit1.Rotation=45

AlphaBlend (byte)
Value 0 indicates only original image visible. Value 255 indicates only Alpha image visible. Values in between make both images visible (blended). Note that you must first load Alpha image to be able to blend it in.
Example: XImgEdit1.AlphaBlend=128


XImgEdit has the following methods:
***********************************
LoadAlphaImage (path as string)
Loads image to be blended with original image. Only BMP files can be used here. For best results use Alpha images having the same dimensions as original images.
Example: XImgEdit1.LoadAlphaImage("c:\images\dog.bmp")

LoadImage (path as string)
Loads image you want to process. Both BMP and JPG file formats are supported.
Example: XImgEdit1.LoadImage("c:\windows\cat.jpg")

SaveImage (path as string)
Saves the image you finished processing. Only BMP file format is supported.
Example: XImgEdit1.SaveImage("c:\windows\desktop\test.bmp")

License information
*******************
You should carefully read the following terms and conditions before using this software.  Your use of this software indicates your acceptance of this license agreement and warranty.
One retail copy of XImgEdit may either be used by a single person who uses the software personally on one or more computers, or installed on a single workstation used non-simultaneously by multiple people, but not both. Note that it only applies to the development stage. Once the control is compiled in your application the above restrictions no longer apply. You may distribute programs using XImgEdit control royalty-free.

Disclaimer of Warranty
**********************
THIS SOFTWARE AND THE ACCOMPANYING FILES ARE SOLD "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. Because of the various hardware and software environments into which XImgEdit may be put, NO WARRANTY OF FITNESS FOR ANY PARTICULAR PURPOSE IS OFFERED.

Common sense dictates that any program be thoroughly tested with non-critical data before relying on it. While every precaution was taken to produce bug free code, you use it at your own risk. The author will not be liable for data loss, damages, loss of profits or any other kind of loss while using or misusing this software.

Release information
*******************
XImgEdit v2.0 is a stand-alone component. It does not require any other files to work.


Thank you for using Softuarium XImgEdit.
For more controls, mailing list subscription, feedback or technical info please visit our website:
www.softuarium.com