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.