PICTLIST.TXT

Category ?

Version 3.0

Description

This text file contains the core list of images that SPC will use. make_sumfiles creates or adds to PICTLIST.TXT when it runs and it lists all the images from make_sumfiles.in. The file terminates with the keyword "END" at the end. The image name starts on column 2, allowing for special characters to be placed in column 1. A space is the normal character before the image name, allowing it to be used.

In SPC, this file would contain all of the images in the entire system. This file is not designed to be changed by hand, but various tools within SPC will make modifications to it. If the image has the symbol # or ! as the first character (rather than a space), that image will be skipped.

lithos will update this file if the command "tuck" is used. Tuck will add or remove a "!" as the first character of an image. This routine is used if there are problems with the image and you don't want to ever use the image (i.e. all SPC routines will ignore this image).

$/!\$ Warning. If it's present, PICTLISTX.TXT is used before PICTLIST.TXT.

This file is used to make things run faster. However, you must be it is updated with make_pictlistX when new images are added (or tucked). If not, then the old list of images will be used rather than the updated PICTLIST.TXT.

When you run lithos, if you are using PICTLIST.TXT, it will limit images with an emission angle less than 75 degrees.

 N585107273F3
 N585107729F3
 N585107957F3
 N585108413F3
 N585108641F3
...


...
 N585109097F3
 N585109325F3
!N585109781F3
!N585110009F3
END

Creating PICTLIST.TXT

If necessary, you can create PICTLIST.TXT by hand by listing the IMAGEFILES directory. This should not normally be needed, and is only likely to be needed if a user mistakenly deleted the original one.

$/!\$ If you create the file by hand, you must add a space as the first character on each line. Without the leading space, SPC will read the image name wrong, neglecting the first character. You can use "sed" to fix this by using the substitute pattern of "s/^/ /", which is before the 1st character, add a space.
SPC uses "!" as the first character to indicate "don't use this image" (also known as a "tucked" image).

The following set of commands show an easy way to create a PICTLIST.TXT file:

cd IMAGES
/bin/list > ../PICTLIST.TXT
cd ..
echo END >> PICTLIST.TXT
vi PICTLIST.TXT
:%s/^/ /
:wq

Here is a sample PICTLIST.TXT file:

 FC11A0001225
 FC11A0001241
 FC11A0001257
 FC11A0001258
 FC11A0001259
 FC11A0001260
...
END

(Compiled by KD)

CategoryFiles CategoryInputFiles