Command-Line Syntax

Use the following syntax to run PIX from the command line.

PIXWin.exe file [ fileOptions ] 

File Options

There are three types of files PIX can open: experiment files, run files, and image files. Each file type uses optional file options.

Experiment File Options

Use this syntax to open an experiment file.

PIXWin.exe file.PIXExp [ -targetpath path ]
                       [ -targetstartfolder folder ]
                       [ -targetargs args ]
                       [ -runfile path ]
                       [ -start ]
                       [ -run ]
Arguments Description
file.PIXExp Required. PIX experiment file.
-targetpath path Optional. Set the target-program path.
-targetstartfolder folder Optional. Set the target-program folder.
-targetargs args Optional. Set command-line-arguments for the target program.
-runfile path Optional. Set the location to save the .PIXRun file.
-start Optional. Start the experiment.

Run File Options

Use this syntax to open a run file.

PIXWin.exe file.PIXRun [ -playstandalone ] 
                       [ -exporttocsv file.csv ] 
Arguments Description
file.PIXRun Required. PIX run file.
-playstandalone Optional. Play a run file within PIX, without bringing up the full PIX UI.
-exporttocsv Optional. Load a PIXRun file and export the results to a an Excel (.csv) file.

You must use at least one of these arguments.

Image File Options

Use this syntax to open one or more image files.

PIXWin.exe file1.png [ file2.png [ -appenddiffmeasure file3.txt ] 
                                 [ -outputdiffxor file4.jpg     ] ]
Arguments Description
file1.png First image file to open. See remarks for a list of the image files supported.
file2.png Optional. Second image file to open. See remarks for a list of the image files supported.
-appenddiffmeasure file3.txt Optional. Measure the per-pixel differences between file1 and file2, and save the result in file3.txt.
-outputdiffxor file4.jpg Optional. Exclusive-OR file1 with file2 and save the result in file4.jpg.

PIX supports the following image formats: .bmp, .emf, .exif, .gif, .icon, .jpg, .png, .tif, and .wmf.

outputdiffxor can be combined with appenddiffmeasure.

See Also

PIX