## 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. 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 | Enables auto-start of media playback (when IsMedia = True).
MediaPlayCount | Number of times (default is 1) media will be played (when IsMedia = True). Note: You should not use 0 for the endless playback, this is not supported in all WMP versions. For the endless playback use MediaLoop.
MediaLoop | Loops media playback (when IsMedia = True). When it is set, MediaPlayCount is ignored.
MediaPlaylistPause | Pause (in milliseconds, default is 500 msec) between media playback end and firing the OnMediaPlaybackEnd event (when IsMedia = True).
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: MediaFit: Enables fitting of images. Works in Multimedia (both for images and for movies) and Plugins modes. MediaFitOnlyBig: Enables fitting of big images only. Works in Multimedia (for images only) and Plugins modes. MediaCenter: 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.