Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 9.5   10.0   10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2    Statistic    FMM    Blog  


Returns an image for the asset at or near a specified time.

Component Version macOS Windows Linux Server FileMaker iOS SDK
AVAsset 5.2 ✅ Yes ❌ No ❌ No ✅ Yes ✅ Yes
MBS( "AVAsset.Image"; Asset; Time { ; ImageType; FileName; Width; Height } )   More


Parameter Description Example Flags
Asset The reference number of the asset. Please use AVAsset.OpenContainer, AVAsset.OpenFile or AVAsset.OpenURL function to get asset reference. $asset
Time The position in the video in seconds. 5.2
ImageType The type of image to return.
Either JPEG, PNG, GIF or BMP. Default is JPEG.
"JPEG" Optional
FileName The filename to use for the picture.
Default is "image" with the extension matching the image type.
"test.jpg" Optional
Width The maximum width to use. 500 Optional
Height The maximum height to use. 500 Optional


Returns container value with image or error.


Returns an image for the asset at or near a specified time.
The time may not exactly be possible, so a nearby frame may be picked.
You can call AVAsset.RequestImageTimePrecision before to request exact timings for images. Query AVAsset.ImageActualTime function to see which time the image was created from.

If you need this functionality on Linux or Windows, you can use Shell functions and run ffmpeg command line to extract a frame for you.


Queries image at 5 seconds:

MBS( "AVAsset.Image"; $asset; 5; "jpeg"; "preview.jpg")

See also

Example Databases

Blog Entries

Created 19th June 2015, last changed 1st March 2021

AVAsset.HasProtectedContent   -   AVAsset.ImageActualTime

Feedback: Report problem or ask question.

MBS Xojo PDF Plugins

Start Chat