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
caching
update
display + playback 
speed + fields
display modes
sound
histogram
saving 
project / settings
export images
configuration 
preferences
display setup
refresh rate
command line parameters

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

  • To launch tv-player from Autodesk 3d Studio Max please click here.
  • To launch tv-player 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.:

  • tv-player.exe "c:\data\media\test\test_01.0001.tga"
  • tv-player.exe "c:\data\media\test\"

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

  • tv-player.exe "c:\data\test_01.0001.tga" "c:\data\ntsc.tvps"

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

  • tv-player.exe "c:\data\test_01.0001.tga" "c:\data\ntsc.tvps" "c:\media\speech.wav"

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

  • tv-player.exe "c:\data\media\current_project.tvpp"
top file names, numbers and wildcards

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

tv-player 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\).
  • tv-player 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

tv-player 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
  • tv-player.exe imagefile|path [-singleframe]
  • tv-player.exe imagefile|path [settingsfile] [soundfile]
  • tv-player.exe imagemask [startframe[-endframe] [step]] [settingsfile] [soundfile]
  • tv-player.exe 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 tv-player settings file with extension *.tvps  
soundfile filename of a uncompressed wave sound file with extension *.wav  
projectfile filename of a tv-player project file with extension *.tvpp  
     
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 tv-player like an image viewer  
     
| means or  
[] for optional parameter(s)  
topexamples

tv-player.exe \\server1\media\layer_#.tga 120-340 2 c:\media\speech.wav c:\tvp\ntsc.tvps

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

tv-player.exe c:\media\zbuffer_0123.tga -singleframe

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