Home Home
[ the standard for judder free playback ]
 
features screenshots downloads buy contact faq help
     
quick help 
help basics
interface
shortcuts
command line
guided help 
tips + tricks
tutorial 1
tutorial 2
integration 
maya
3ds max
loading + caching 
loading
load dialog
OpenEXR dialog
caching
update
display + playback 
speed + fields
display modes
sound
histogram
saving 
project / settings
export images
configuration 
preferences
display setup
refresh rate

command line parameters

AnimPlayer supports command line parameters when starting the application (AnimPlayer.exe).
This is quite useful if you want to include AnimPlayer in an existing workflow or pipline.

  • To launch AnimPlayer from Autodesk 3d Studio Max please click here.
  • To launch AnimPlayer from Autodesk Maya please click here.

In case your are not satisfied with the current command line support please contact us.

To load a sequence pass a single file name or folder name including the full path e.g.:

  • AnimPlayer "c:\data\media\test\test_01.0001.tga"
  • AnimPlayer "c:\data\media\test\"

You can also add a settings file name (.animplayer_set) to load a specific configuration, e.g.:

  • AnimPlayer "c:\data\test_01.0001.tga" "c:\data\ntsc.animplayer_set"

together with a sound file name (.wav) to load a sound file, e.g.:

  • AnimPlayer "c:\data\test.0001.tga" "c:\data\ntsc.animplayer_set" "c:\media\speech.wav"

Specifying a project file name (.animplayer_prj) to load an existing project is also valid, e.g.:

  • AnimPlayer "c:\data\media\current_project.animplayer_prj"

top file names, numbers and wildcards

It is highly recommended to put all file names in "double quotes".

AnimPlayer always expects an image file name in the following format:

path name number extension
c:\data\media\ test_01. 0001 .tga
  • The path can be either a drive path (c:\data\media\) or an UNC path (\\Server1\media\).
  • AnimPlayer supports any digit length of ordinal frame numbers but all files of an sequence must have the same amount of digits . The frame number have to be the last part of the file name, but in front of the extension.
  • An image extension starting with a . is always required.

 

List of valid wild cards

  • @ or ? substitute a single char in the name or number.
  • # or * substitute the entire frame number.
  • wildcards in path or extension may work but are currently not officially supported.

 

Valid examples:

  \\Server1\media\test_??.#.tga loads all frames of all tests (same as next line)
  \\Server1\media\test_??.####.tga loads all frames of all tests
  C:\media\test_01.00??.tga loads frames 0-99 of test 01

topunix style file names

AnimPlayer supports unix style file names. All unix filenames will be mapped to drive C:\, e.g:

/tmp/previews/render_01234.tga -> C:\tmp\previews\render_01234.tga

Better suggestions are welcome!

topcomplete command line reference

  • AnimPlayer imagefile|path [-singleframe]
  • AnimPlayer imagefile|path [settingsfile] [soundfile]
  • AnimPlayer imagemask [startframe[-endframe] [step]] [settingsfile] [soundfile]
  • AnimPlayer projectfile

 

Symbol Description Example
imagefile full qualified image filename without wildcards  
path full qualified path to a folder  
imagemask image file name with path where the number is replaced by wildcard(s)  
settingsfile filename of a AnimPlayer settings file with extension *.animplayer_set  
soundfile filename of a uncompressed wave sound file with extension *.wav  
projectfile filename of a AnimPlayer project file with extension
*.animplayer_prj
 
     
startframe number of start frame 123
-endframe number of end frame, works only together with startframe 123-244
step load only every step frame, works only together with start/endframe 2
     
-singleframe loads only the very first frame, operates AnimPlayer like an image viewer  
     
| means or  
[] for optional parameter(s)  

topexamples

AnimPlayer \\server1\media\layer_#.tga 120-340 2 d:\speech.wav d:\ntsc.animplayer_set

Loads every 2nd frame of sequence layer_#.tga from frame 120 to frame 340,
also loads a sound and settings file.

AnimPlayer c:\media\zbuffer_0123.tga -singleframe

Loads only c:\media\zbuffer_0123.tga and supress automatic sequence detection