EqapImage (version 1.1, 12.10.2011)
EqapImage is a part of EqapPackage and is a functional component designed for viewing and editing the graphic images formatted as Device Independent Bitmap (BMP) and Joint Photographic Experts Group (JPEG).
1. Appearance
The EqapImage (Fig. 1) has control panel with buttons (a), main field for an image drawing (b) and field of indication of image processing (c). Using zoom in and zoom out buttons makes the image area scrollbars (d) to be active. Field (e) is used to show a hint linked with a particular button on the control panel, when mouse cursor is moving over the button.
Fig. 1. EqapImage component
The control panel of EqapImage has buttons for quick actions with an image:
- loading an image from file;Some control panel buttons are linked with window of manual editing the parameters of an image (Fig. 2). The content of this window depends on the selected action. In some cases a parameter editing causes the corresponding change in an image content right away, before the confirmation button being selected. In other cases you should confirm your changes prior to actual change of an image content. You may discard the current editing by pressing "Cancel" button. Long image processing is indicated in the corresponding field (Fig. 1, c).
- saving an image to file;
- managing an image zoom;
- managing the brightness and contrast of an image;
- managing the contouring parameters (using different algorithms);
- managing the smoothing parameters (using different algorithms);
- changing the RGB channels' values differently;
Fig. 2. The window of manual editing the parameters of an image in EqapImage (this window appears when an user has selected a change of RGB channels' values differently)
2. Properties and events
The EqapImage inherits properties and events of TPanel except those used for text appearance (Alignment, AutoSize, Caption, Font etc.), and has own properties and events:
Properties
ModifiedCaption: string - string part that may appear in the caption of EqapImage's parent form. This name is followed by an image file name (if the image is loaded).
Options: TEqapImageOptions - component options. Consists of three flags: eioModifyOwnerCaption (indicates whether EqapImage can modify the caption of parent form), eioShowOwnToolbar (indicates whether the control panel is displayed), eioFixedImageSize (indicates whether an image should fit the component drawing area).
Events
OnCreateImage: TNotifyEvent - event arises after creation of EqapImage.
OnDestroyImage: TNotifyEvent - event arises before destroying of EqapImage.
OnLoadImage: TNotifyEvent - event arises at loading an image from a file.
OnSaveImage: TNotifyEvent - event arises at saving an image to a file.
3. The example of using
To demonstrate the functionality of EqapImage, just put the component on a form of your application and run it.
All the software products are free for use. Any commercial using is not permitted without author's permission (o.lookin@iip.uran.ru).
