MediaMode |
Player mode (used when Mode = vmodeMedia).
Possible values:
- vmmodeNone: "Uninitialized" value that is set when no other modes are available - see Notes.
- vmmodeMCI: Usage of TMediaPlayer component (Windows MCI interface).
- vmmodeWMP64: Usage of Windows Media Player 6.4 ActiveX.
- vmmodeWMP9: Usage of Windows Media Player 9.0 ActiveX.
- wmmodeCE: Usage of DirectX (Cubic Explorer version).
Notes:
- MCI and WMP modes are available only when corresponding defines are uncommented
in ATViewerOptions.inc.
- WMP 9.0 mode will not work on end user's machine if no Windows Media Player 9+ is installed,
while WMP 6.4 mode should work on all machines since Windows Media Player 6.4 is preinstalled
even on Windows 95. Use ATxWMP unit from Universal Viewer demo to check
availability of different WMP versions.
|
MediaAutoPlay
MediaPlayCount
MediaLoop
MediaPlaylistPause
MediaShowControls
MediaShowTracker
|
Media properties (when IsMedia = True).
- Enables auto-start of media playback.
- Number of times (default is 1) media will be played.
- Loops media playback. When it is set, MediaPlayCount is ignored.
- Pause (in msec, default is 500 msec) between media playback end
and firing the OnMediaPlaybackEnd event.
- WMP 6.4 only: Show play controls on WMP control.
- WMP 6.4 only: Show play tracker on WMP control.
|
MediaVolume (public) |
Volume of media player (when IsMedia = True).
It is in the range from 0 to 10.
Notes:
- Currently not supported with MediaMode = vmmodeMCI.
- WMP ActiveX controls use different volume ranges in 6.4 and 9+ versions.
This property correctly handles both cases.
- WMP 6.4 ActiveX has an issue: it doesn't always update its Volume
property when state is changed using visual controls (when volume
slider is dragged by mouse).
|
MediaMute (public) |
Mute state of media player (when IsMedia = True).
Note:
- Currently not supported with MediaMode = vmmodeMCI.
- WMP 6.4 ActiveX has an issue: it doesn't always update its Mute property
when state is changed using visual control (when Mute button is
pressed by mouse).
|
MediaFit
MediaFitOnlyBig
MediaCenter
|
Media/image fitting options:
- Enables fitting of images.
Works in Multimedia (both for images and for movies) and Plugins modes.
- Enables fitting of big images only.
Works in Multimedia (for images only) and Plugins modes.
- Enables centering of smaller images.
Works in Multimedia (for images only) and Plugins modes.
|
IsImage
IsIcon
IsMetafile
IsMedia
(public, read-only)
|
Flags which show what media type is loaded in Multimedia mode:
- IsImage: Image (any format).
- IsIcon: Image which is an icon (ICO).
- IsMetafile: Image which is a metafile (WMF, EMF).
- IsMedia: Video or audio clip.
Note:
- Images and media files are detected by file extension
using global variable ATViewerOptions.
See description of ModeDetect property for details.
|
ImageWidth
ImageHeight
ImageBPP
(public, read-only)
|
Image properties (when IsImage = True):
- Width.
- Height.
- Bits per pixel.
Notes:
- ImageBPP is supported for GIF, PNG, BMP, JPG (with IJL usage), GraphicEx types. Otherwise it is 0.
- ImageWidth, ImageHeight change when size effect is applied (ImageEffect method).
|
ImageColor
ImageDrag
ImageCursor
ImageDragCursor
ImageTransparent
ImageResample
ImageKeepPosition
|
Image control properties (when IsImage = True):
- ImageColor: Color of image background.
- ImageDrag: Enables dragging of large images by mouse.
- ImageCursor: Cursor of image object (default is crDefault).
- ImageDragCursor: Cursor used for image dragging (default is crSizeAll).
- ImageTransparent: Enables image transparency showing.
Affects only formats with transparency (GIF, PNG etc).
- ImageResample: Enables image resampling on scaling.
- ImageKeepPosition: Enables keeping of image view position
on image scaling and control resizing.
|
ImageScale (public) |
Current image scale in percents (%).
Notes:
- When MediaFit = False, this value is 100 initially;
when MediaFit = True, this value is affected by current control size.
- Changing of this property sets MediaFit to False.
- You can increase/decrease ImageScale in predefined row of values
using ImageScaleInc / ImageScaleDec methods.
|
ImageBox (public, read-only) |
Embedded imagebox object (of type TATImageBox, declared in ATImageBox.pas).
Note:
- Use this object to access advanced image-related properties,
such as image label caption/visibility, border size, scrollbars etc.
|
ImageError
ImageErrorMessage
(public, read-only)
ImageErrorMessageBox
|
Image error state (when IsImage = True):
- ImageError: True if image loading error occured.
- ImageErrorMessage: String describing the error.
- ImageErrorMessageBox: Enables to display messagebox when error occurs.
Note:
- When ImageErrorMessageBox = True, messagebox is displayed on image loading error
and you don't need to read ImageError/ImageErrorMessage properties.
When ImageErrorMessageBox = False, you should read these properties
and show error text inside image label, like in this example:
procedure TFormView.UpdateImageLabel;
begin
with ATViewer1 do
if IsImage and Assigned(ImageBox) then
if ImageError then
begin
ImageBox.ImageLabel.Visible := True;
ImageBox.ImageLabel.Caption := ImageErrorMessage;
ImageBox.ImageLabel.Font.Color := clRed;
end
else
begin
ImageBox.ImageLabel.Visible := FImageLabelVisibleFlag;
ImageBox.ImageLabel.Caption := Format(
'%d x %d (%d%%)',
[ImageWidth, ImageHeight, ImageScale]);
ImageBox.ImageLabel.Font.Color := clBlue;
end;
end;
|
IViewIntegration |
Options that allow to integrate IrfanView/XnView
applications into Image mode.
This is record that contains the following fields:
- Enabled: Enables integration.
- ExeName: IrfanView or XnView application executable path.
- ExtList: List (comma separated) of file extensions supported by IrfanView/XnView.
- HighPriority: Sets the priority for IrfanView/XnView higher than for internal image library.
This option works when a file extension (e.g. 'JPG') can be handled by both
the internal library and IrfanView/XnView.
Notes:
- This property is available only when "IVIEW" define
is uncommented in ATViewerOptions.inc file.
- User can switch image loading between internal library and IrfanView/XnView
by setting the Mode to vmodeMedia.
|
IJLIntegration |
Options that allow to integrate IJL (Intel JPEG Library, ijl15.dll)
into Image mode.
This is record that contains the following fields:
- Enabled: Enables integration.
- ExtList: List (comma separated) of JPEG file extensions.
Notes:
- This property is available only when "IJL" define
is uncommented in ATViewerOptions.inc file.
- IJL is used when Enabled = True, and "ijl15.dll" file is present in %PATH%.
DLL is loaded dynamically.
|