Introduction
The CAP Image Processing Program is simple application which automatically watermarks digital imagery with geographically identifying details (target name, latitude/longitude, time on target, picture direction, etc).
The camera operator is responsible for collecting all of the required information and entering the information into a spreadsheet. Once the spreadsheet and original images are delivered by the camera operator, anyone with a computer and the CAP Image Processing Program can watermark the images prior to delivering the imagery to the customer.
Sample
Processed images are watermarked with identifying information and look like this:
Download (v1.3)
The Java Runtime Environment is a required prior to using the CAP Image Processing Program. Most computers already have Java installed. If you don't hava Java you can download it from:
java.com
Download:
You'll also need:
Instructions
Using the CAP Image Processor is simple:
- Download the software and template picture worksheet using the links above
- Place all of the source images into a folder on your computer
- Open the template picture worksheet and modify it:
- Replace the sample record with your own data
- Add additional records for each image which will be processed
- Save the worksheet in "Comma-delimited values (CSV)" format using "Save As" (note: in Office 2008 you must go to "Save As" -> "Other Formats" and then select "CSV")
- If prompted about "incompatible features", say yes
- Create a new folder to store the output of the program; this folder can be anywhere on your computer and can have any name
- Run the CAP Image Processor by double-clicking on CAPImageProcessor.exe (the file you downloaded above)
- In the "Spreadsheet" selection box, select the worksheet you created/saved above in step 3
- In the "Picture Directory" selection box, select the folder containing all of the source images
- In the "Output Directory" selection box, select the new (empty) folder you created above in step 4
- Click the "Process Images" button and wait a few minutes...
- You will be notified when the process is complete, and your "Output Directory" will contain the processed images
Notes on the fields in the picture worksheet:
- Filename: must match the filename of the image exactly; don't forget the file extension (usually ".jpg")
- Target ID: Can be any value; used to match the image back to the target deck / customer request
- Target Name: A descriptive name for the target
- City: The city/town where the target is located
- State: The state where the target is located
- Lat: The latitude of the target (valid formats: "DD MM SS", "DD MM.MM", "DD.DDDD"). North America is assumed, do not enter N/S. Latitude will be converted to the AFNORTH standard format on the output image.
- Lon: The longitude of the target (valid formats: "DDD MM SS", "DDD MM.MM", "DDD.DDDD"). North America is assumed; do not enter E/W or +/-. Longitude will be converted to the AFNORTH standard format on the output image.
- Zulu Date: The Zulu date of the photo (valid format: "DD-MMM-YY", ie: "15-Jun-08")
- Zulu Time: The Zulu time of the photo (valid format: "HH:MM", ie: "21:34")
- Picture Heading: The heading the camera was facing when the image was captured (in TRUE degrees, not magnetic)
Version History
- 1.0 - 08/03/2008 - Initial release
- 1.1 - 08/04/2008 - Updated lat/lon format to match AFNORTH directives
- 1.2 - 08/04/2008 - Added the CAP command patch to the upper-left corner of all processed images
- 1.3 - 03/16/2010 - Better error handling
Known Issues / Limitations / Wish list
- The program needs help documentation; currently there's no built-in help
- The program needs better error handling
- The program should be able to read native Excel files, without requiring the converstion to CSV
- The program should be more robust in handling different input types in the worksheet fields
- The program user interface could be a little nicer
- The program should show the user the parsed picture worksheet prior to processing photos
Need Help?
- Author: Tolga Tarhan, Charter: PCR-CA-001
- Email me: imageprocessor@ttar.org
- Call me: Look my mobile phone number up in eServices or WMIRS using the info above