TImageEnView Actions
ImageEn includes a large set of actions for ImageEnView, ImageEnView Layers, ImageEnMView , ImageEnFolderMView and ImageEnVect components to allow you to rapidly develop your UI.
TImageEnViewDoEditPreviews
To use actions:
1. Add a TActionList component to your form
2. Double-click your TActionList to open it
3. Select "New Standard Action"
4. Scroll down to the ImageEnView actions, select the ones you require and click OK
5. Select your actions and set the ImageEnView property to your TImageEnView component
6. Assign the actions to menu items and buttons
Demos
 | Demos\Actions\Actions_Viewer\Actions.dpr |
| | Demos\Actions\Actions_Layers\Actions.dpr |
| | Demos\Actions\AllActions\AllActions.dpr |
Notes:
- You must set the ImageEnView property of the actions
- The ActionType property advises whether the control only performs a function (ieaButton), toggles a state (ieaCheckbox), or changes between multiple states (ieaRadioButton)
- You can set MsgLanguage to localize the actions
- See the list of the default ImageIndexes if you are planning to add graphics to your actions
General Actions
| Action | Name | Description | Associated Method | Extra Properties |
|---|---|---|---|---|
| TImageEnViewAutoShrink | Auto-Shrink | Display large images at the window size | AutoShrink | - |
| TImageEnViewAutoStretch | Auto-Stretch | Display small images at the window size | AutoStretch | - |
| TImageEnViewBlank | Clear | Clear the image | Blank | - |
| TImageEnViewClearAll | Clear All | Clear the image and layers | ClearAll | - |
| TImageEnViewDeselect | Deselect | Clear your selection | Deselect | - |
| TImageEnViewFit | Fit Image | Display the image at the size of the window | Fit | - |
| TImageEnViewFitToHeight | Fit Image to Height | Display the image at the height of the window | FitToHeight | - |
| TImageEnViewFitToWidth | Fit Image to Width | Display the image at the width of the window | FitToWidth | - |
| TImageEnViewEnableAdjustOrientation | Auto-Rotate Display | Automatically display image with the correct orientation | EnableAdjustOrientation | - |
| TImageEnViewPlaying | Animate | Display the animation of a GIF or AVI file | Playing | - |
| TImageEnViewPlayLoop | Loop Playback | Continuously loop the playback of a GIF or AVI file | PlayLoop" | - |
| TImageEnViewShowGuidelines | Show Guidelines | Show guidelines over image to aid rotation | DisplayGridKind | - |
| TImageEnViewShowRulers | Show Rulers | Show measurement rulers beside image | ShowRulers | - |
| TImageEnViewRulerUnitPixels | Pixels | Show ruler in pixels | Units | - |
| TImageEnViewRulerUnitInches | Inches | Show ruler in onches | Units | - |
| TImageEnViewRulerUnitMillimeters | Millimeters | Show ruler in millimeters | Units | - |
| TImageEnViewRulerUnitCentimeters | Centimeters | Show ruler in centimeters | Units | - |
| TImageEnViewZoomIn | Zoom In | Display the image larger | ZoomIn | - |
| TImageEnViewZoomOut | Zoom Out | Display the image smaller | ZoomOut | - |
| TImageEnViewZoomFullSize | Zoom to Full Size | Display the image at full size | Zoom | - |
| TImageEnViewSetZoom | Zoom to x% | Display the image at x% Zoom | Zoom | Zoom |
| TImageEnViewPromptForColor | Select Color | Display the color selection dialog | IEPromptForColor | ColorSelectAction, SelectedColor |
| TImageEnSetLanguage | Set Language to X | Change the language of all ImageEn controls and dialogs | MsgLanguage | Language |
General Mouse Actions
| Action | Name | Description | Associated Method | Extra Properties |
|---|---|---|---|---|
| TImageEnViewMouseMovingScroll | Scroll to Cursor | Move the mouse to scroll the image | miMovingScroll | Exclusive |
| TImageEnViewMouseScroll | Scroll Image | Click the image and drag the mouse to scroll | miScroll | Exclusive |
| TImageEnViewMouseSelect | Rectangular Select | Select a rectangular area of your image | miSelect | Exclusive |
| TImageEnViewMouseSelectCircle | Circular Select | Select a circular area of your image | miSelectCircle | Exclusive |
| TImageEnViewMouseSelectLasso | Lasso Select | Perform an irregular selection of your image by dragging the mouse | miSelectLasso | Exclusive |
| TImageEnViewMouseSelectMagicWand | Select by Color (Magic Wand) | Select a portion of your image of a similar color | miSelectMagicWand | Exclusive |
| TImageEnViewMouseSelectChromaKey | Select by Color (Chroma Key) | Select a portion of your image of a similar color | miSelectChromaKey | Exclusive |
| TImageEnViewMouseSelectPolygon | Polygon Select | Perform an irregular selection of your image by clicking the mouse | miSelectPolygon | Exclusive |
| TImageEnViewMouseSelectZoom | Zoom to Selection | Select an area of the image to zoom into | miSelectZoom | Exclusive |
| TImageEnViewMouseZoom | Zoom | Left-click the image to Zoom In. Right-click to Zoom Out | miZoom | Exclusive |
| TImageEnViewMouseZoomAndScroll | Zoom and Scroll | Left-click the image to Zoom In. Right-click to Zoom Out. Click the image and drag the mouse to scroll | miZoom and miScroll | Exclusive |
| TImageEnViewMouseMeasureLength | Measure Length | Left-click and drag to measure a length | miMeasureLength | Exclusive |
| TImageEnViewMouseMeasureRect | Measure Area | Left-click and drag to measure a rectangular area | miMeasureRect | Exclusive |
| TImageEnViewMouseMeasureEllipse | Measure Ellipse | Left-click and drag to measure a circular area | miMeasureEllipse | Exclusive |
| TImageEnViewColorPicker | Enable the Color Picker | Enable the Color Picker so the user can select a color within the image. The effect of the selection is configured by TImageEnView.FillTool.ColorSelectActions | miColorPicker | - |
* Also see Layer Mouse Actions
Interactive Editing Tools
| Action | Name | Description | Associated Method | Extra Properties |
|---|---|---|---|---|
| TImageEnViewBrushTool | Enable the Paint Brush | Enable the brush tool to paint content onto the image | TIEBrushToolInteraction | BrushShape, BrushFill |
| TImageEnViewEraserTool | Enable the Eraser Can | Enable the brush tool with an eraser fill to clear content from the image | TIEBrushToolInteraction | EraserOpacity |
| TImageEnViewCloneTool | Enable Cloning | Enable the clone brush tool to clone content from one part of an image to another | TIECloneToolInteraction | - |
| TImageEnViewCropToolEnable | Enable Cropping | Enable cropping mode to select an area of image to maintain | TIECropToolInteraction | CropMode |
| TImageEnViewCropToolEnactCrop | Crop to Selection | Crop the image to the selection | Enact | - |
| TImageEnViewCropToolCancelCrop | Cancel Cropping | Clear the current crop selection | Cancel | - |
| TImageEnViewRotateTool | Drag to Rotate | Enable the Rotate tool to freely rotate the image with the mouse | TIERotateToolInteraction | BackgroundColor |
| TImageEnViewRotateAndCropTool | Drag to Rotate and Crop | Enable the Rotate tool to freely rotate the image with the mouse and then crop | TIERotateToolInteraction | CropAlgorithm, BackgroundColor |
| TImageEnViewSprayTool | Enable the Spray Can | Enable the brush tool with a spray fill to paint content onto the image | TIEBrushToolInteraction | BrushFill |
| TImageEnViewColorFillTool | Enable the Flood Fill Tool | Enable the flood fill tool with to replace areas of a similar color with a new color | TIEFillToolInteraction | - |
| TImageEnViewAlphaFillTool | Enable the Alpha Fill Tool | Enable the alpha fill tool with to replace areas of a similar color with transparency | TIEFillToolInteraction | - |
Proc Actions
| Action | Name | Description | Associated Method | Extra Properties |
|---|---|---|---|---|
| TImageEnViewDoPreviews | Do Effects | Display the Effects dialog for editing and enhancing the image (all or a specific effect) | DoPreviews | Effects |
| TImageEnViewDoAdjustPreviews | Adjust Colors | Perform color enhancement functions on the image | DoPreviews(ppeColorAdjustments) | - |
| TImageEnViewDoEffectPreviews | Image Effects | Perform effects on the image | DoPreviews(ppeSpecialEffects) | - |
| TImageEnViewDoEditPreviews | Edit Image | Perform editing functions on the image: rotate, resize, crop, etc. | DoPreviews(ppeEditingFunctions) | - |
| TImageEnViewPromptToResize | Prompt to Resize | Display the previews dialog to allow the user to resample (resize) the image | DoPreviews | ResampleFilter |
| TImageEnViewPromptToRotate | Prompt to Rotate | Display the previews dialog to allow the user to rotate the image to a custom angle | DoPreviews | AntiAliasMode |
| TImageEnViewRotateRight | Rotate Right | Rotate the image 90° clockwise | Rotate | - |
| TImageEnViewRotate180 | Rotate 180° | Rotate the image 180° clockwise | Rotate | - |
| TImageEnViewRotateLeft | Rotate Left | Rotate the image 90° counter-clockwise | Rotate | - |
| TImageEnViewFlipHorizontal | Flip Horizontal | Flip the image from top to bottom | Flip | - |
| TImageEnViewFlipVertical | Flip Vertical | Flip the image from left to right | Flip | - |
| TImageEnViewCrop | Crop to Selection | Remove all parts of the image outside the current selection | Crop | - |
| TImageEnViewDeleteSelection | Delete Selection | Remove the selection area of the image | CutToClipboard | - |
| TImageEnViewCutToClipboard | Cut | Cut the current image or selection to the clipboard | CutToClipboard | Cut Source |
| TImageEnViewCopyToClipboard | Copy | Copy the current image or selection to the clipboard | CopyToClipboard | Copy Source |
| TImageEnViewPasteFromClipboard | Paste | Paste an image from the clipboard | PasteFromClipboard | Paste Dest |
| TImageEnViewUndo | Undo | Undo the last action | Undo | ShowUndoAction |
| TImageEnViewRedo | Redo | Redo the last action that was undone | Redo | ShowRedoAction |
| TImageEnViewConvertToGray | Convert to Gray | Reduce the colors of the image to grayscale | ConvertToGray | - |
| TImageEnViewHistAutoEqualize | Auto Equalize Colors | Equalizes the color histogram for the selected region | HistAutoEqualize | - |
| TImageEnViewNegative | Negative | Invert the colors of the image | Negative | - |
| TImageEnViewRemoveRedEyes | Remove Red-Eyes | Remove the red-eye effect from the selection | RemoveRedEyes | - |
| TImageEnViewSharpen | Sharpen | Apply a sharpening filter to the image | Sharpen | Intensity, Neighbourhood |
| TImageEnViewRemoveChromaKey | Remove Chroma-Key | Removes the Chroma-Key background from the image | RemoveChromaKey | KeyColor (if clNone, it is guessed using the whole image or current selection), Tolerance, Saturation, FeatherEdges, HueReduction, RemoveNoise |
IO Actions
| Action | Name | Description | Associated Method | Extra Properties |
|---|---|---|---|---|
| TImageEnViewPromptToOpen | Open | Load an image from file | ExecuteOpenDialog, LoadFromFile | DialogTitle, DefaultFilter, LimitToFileType, FileName |
| TImageEnViewSave | Save | Save changes to this image to file | SaveToFile | EnableOnlyWhenChanged, FileName |
| TImageEnViewPromptToSave | Save as | Save this image to a new filename | ExecuteSaveDialog, SaveToFile | DialogTitle, DefaultFilter, LimitToFileType, FileName |
| TImageEnViewDoIOPreviews | Save Properties | Specify advanced properties for this image | DoPreviews | PreviewParams |
| TImageEnViewDoPrintPreviewDialog | Print Preview | Display a preview of this image for printing | DoPrintPreviewDialog | DialogType |
| TImageEnViewPrintImageNormal | Print this image at its original size | PrintImage | - | |
| TImageEnViewPrintImageFitToPage | Print to Page | Print this image to fit the page | PrintImage | - |
| TImageEnViewSelectAcquireSource | Select Acquisition Source | Select the camera or scanner to acquire images from | SelectAcquireSource | Apis |
| TImageEnViewAcquire | Acquire | Retrieve an image from a camera or scanner | Acquire | - |
| TImageEnViewSeekFirst | First Frame | Display the first frame of this image | Seek | - |
| TImageEnViewSeekPrior | Previous Frame | Display the prior frame of this image | Seek | - |
| TImageEnViewSeekNext | Next Frame | Display the next frame of this image | Seek | - |
| TImageEnViewSeekLast | Last Frame | Display the last frame of this image | Seek | - |