Command line specification for the Photoview photometric viewer
You will probably use these commands in a batch to convert file formats or save the zillion images you need to a catalog. Here is an example:
PhotoView.Exe LOADFILE "C:\TESTDATA\AX412W.LDT" SHOW_TAB POLAR SAVE_IMAGE "C:\TESTDATA\POLAR-231Q.PNG"
This will load the Eulumdat file, C:\TESTDATA\AX412W.LDT, show its polar image and then save the polar image as a PNG file here: C:\TESTDATA\POLAR-231Q.PNG. Here is an example of saving vectorial EPS files of a polar diagram:
LOADFILE "C:\TestData\Test-Fotom.LDT" SHOW_TAB POLAR SAVE_IMAGE "C:\OXY\POLAR.EPS"
Since PhotoView can generate many images and data sets from photometric files each image or data set is shown on a separate tab. Hence the command to SHOW_TAB POLAR in the above example. The image which gets saved with the SAVE_IMAGE command depends on which tab is active. Here is the polar tab:
Here is the US Road Classification tab, which you get with the command SHOW_TAB US_ROADS :
One last example of what photometric details you can specify for image saving, the cartesian diagram, SHOW_TAB CARTESIAN :
Here is the complete list of strings which SHOW_TAB accepts:
The SAVE_FILE, SAVE_IMAGE and SAVE_TEXT commands assume that you are running in batch mode and that you do not want the photometry to remain in the program after the file or image has been saved. For this reason the window of that document is closed after the save.
In all cases names of files must be complete paths and contained inside double quotes. This is so that paths with spaces in them do not get misinterpreted. This is a good command line even though there are spaces in the paths:
PhotoView.Exe LOADFILE "C:\TEST DATA\AX412W.LDT" SHOW_TAB POLAR SAVE_FILE "C:\TEST DATA\POLAR-231Q.IES"
The following example is a bad command line, there are no quotes to say when the path starts and ends:
PhotoView.Exe LOADFILE C:\TEST DATA\AX412W.LDT SHOW_TAB POLAR SAVE_FILE C:\TEST DATA\POLAR-231Q.IES
With the SAVE_IMAGE command the format of the image is deduced from the file extension. George.PNG will be saved as a PNG file, Albert.JPG will be saved as a JPG file. You can even save graphics as vector files by specificing the EPS or PS extension.
Note that not all tabs have images to save, for example MAIN_DATA.
SAVE_FILE works in the same way as SAVE_IMAGE, deducing the photometric file format from the extension. .IES will save in IESNA format, and .LDT will save in Eulumdat format etc. This shows how PhotoView can be used to convert between photometric file formats: You load the IESNA file for example and then save it as an Eulumdat file.
For printing there are three commands: PRINT_CUSTOM, PRINT_TITLED and PRINT_CUSTOM_TITLED.
If you put the CLOSE_PROG command at the end of the command line then PhotoView.exe will exit after running the command line.
LOAD_FILE and SAVE_FILE needs a bit more explanation when the files are IESNA (.IES extension). There are options to specify which IESNA to save, whether to rotate the files, and whether it is an absolute (candles) or relative (candles per kilolumen) photometry. The command is SET_IESNA and here is an example:
And here is an explanation
So the example above reads a IESNA file with no import or export rotation and save it as a relative photometry in LM86 format.
If you just want to save a photometry you have read it is not neccessary to have SHOW_TAB in your command line. For example:
PhotoView.exe LOADFILE "C:\TestData\SrcFot\DXSYNO-7534.LDT" SAVE_FILE "C:\DXSYNO-7534.LDT"
Here is another example using the IESNA setting options:
PhotoView.exe LOADFILE "C:\Test Data\DIS-7534.OXL" SET_IESNA RI_RE_AP_LM91 SAVE_FILE "C:\IESNA_TEST.IES"
You can load a photometry and simply show a specific tab:
LOADFILE "C:\TESTDATA\PIPPO.IES" SHOW_TAB CARTESIAN
In the above case the program and luminaire data stays active and the user can view other things and do other calculations.
For more detail on the terms Candelas, Lumens, and Lux have a look at this book: