Properties, Media-related


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.
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.