Use the following syntax to run PIX from the command line.
PIXWin.exe file [ fileOptions ]
There are three types of files PIX can open: experiment files, run files, and image files. Each file type uses optional 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. |
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.
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.