| On this page |
Use mplay --help to display the list of options.
Profiles ¶
-
-default -
-tools -
-render -
-flipbook -
-viewer -
-full -
-minimal
Image options ¶
-g
Group the command line images into separate sequences, based on base name and extension.
-u
Leave the images in the command line unsorted (in the order they appear).
-Z ‹pad›
Load only images that are padded to ‹pad› digits (or 0 for non-padded images only).
-D
Load fractional frames: assume . is a decimal if it appears in
filenames to the left of the frame number.
-n
Disable negative frames: assume - is a separator, not a negative
symbol, when it appears in filenames to the left of the frame number.
-z ‹level›
Load images zoomed to a certain percentage, where ‹level› is
12, 25, 33, 50, 66, 75 or 100.
-v
Flip all images vertically.
-B ‹file›
Set the background image(s). This will automatically enable transparency and background images.
-c
Load RGB color components only (no alpha).
-U
Use an unlimited amount of memory for images.
-m ‹N›
Limit memory usage to ‹N› MB.
-w ‹width›
Images loaded from STDIN are ‹width› pixels wide.
-h ‹height›
Images loaded from STDIN are ‹height› pixels high.
-x ‹aspect›
Sets the pixel aspect ratio.
-X ‹on|off›
Enable or disable stretching to account for pixel ratio.
-S ‹n›
Load ‹n› images from STDIN in RGBA format.
-O ‹startframe› ‹step›
Load images from STDIN starting at ‹startframe› and skipping ‹step› frames.
-L ‹lutfile›
Sets ‹lutfile› as the lookup table for Cineon images.
-l ‹w› ‹g› ‹iw›
Sets the Cineon white point to ‹w›, the film gamma to ‹g› and the image white point ‹iw›.
-N
Leave Cineon files in their natural 10 bit log space.
-d ‹lutfile›
Set the display LUT to ‹lutfile›.
-i ‹lutfile›
Set the inspect LUT to ‹lutfile›.
-8
Always load images at 8-bit depth.
-G ‹gamma›
Sets the display gamma. For example, -G 2.2.
-j ‹x1› ‹y1› ‹x2› ‹y2›
Select a sub-region of the image to load, using fractional
values between 0 and 1. For example,
-j 0.25 0.25 0.75 0.75 to load the center region.
-J ‹x1› ‹y1› ‹x2› ‹y2›
Select a sub-region of the image to load, using pixels.
For example, -J 20 10 320 200.
-E ‹leftimg› ‹rightimg›
Load two images as a stereo image pair.
-E ‹file1› ‹file2›
Loads stereo image pairs. The first file specified should be the left image, and the second should be the right image.
Playback Options ¶
-C
Pre-cache all images at startup.
-f ‹start› ‹end› ‹step›
Sets the frame range (‹start› to ‹end›) and frame step.
-p
Startup in playback mode.
-P ‹mode›
Sets the playback mode to 'loop', 'once' or 'zigzag'.
-r ‹fps›
Set the frames per second for realtime play.
-R
Turn on realtime play without specifying a rate.
-M ‹mode›
How to deal with missing frames, where ‹mode› is one of:
black
Show a black frame.
prev
Show the previous frame.
next
Show the next frame.
close
Show the closest available frame.
UI Options ¶
-b ‹s|d›
Startup in single (s) or double (d) buffer mode. Single
buffer provides faster playback speed (default).
-F
Full image view mode; do not show any extra UI.
-H
Disable tool tips.
-K
Tell MPlay to listen on a socket for input images.
-k
Tell MPlay to listen on a socket for flipbook images. Images rendered to the ip device will be displayed.
-T
MPlay window stays on top (on Windows).
-V ‹x› ‹y›
Sets the viewport layout to ‹x› columns by ‹y› rows.
-e ‹c|s|h|v|b|d› [‹val›]
Enables diffing with the mode set to:
c
Compare
s
Subtract
h
Split horizontal (split at ‹val›, default 0.5)
v
Split vertical (split at ‹val›, default 0.5)
b
Blend (by ‹val› amount, default 0.5)
d
Highlight differences (uses ‹val›, default 0)
Audio Options ¶
-a ‹file›
Load audio from ‹file›.
-A ‹volume›
Sets the volume scale (default 1).
-o ‹fr› ‹sec›
Aligns the animation frame ‹fr› to ‹sec› audio seconds.
-s on|off
Enable or disable the audio scrub sustain.
-W ‹rate›
Sets the audio scrub rate.