CSV Lists provide a powerful way to automate and organize image processing tasks in Frame-A-Face. By specifying input images, crop presets, and output locations in a CSV file, users can efficiently manage bulk processing workflows.
A CSV file used in Frame-A-Face consists of lines containing comma-separated values (CSV), which can have the following structure:
<Input path>,<Preset name>,<Output path>,[[Name suffix],[Export pixel size],[Image format]]
Input path
Specifies the location of the input image or folder containing images. Supported formats include JPG, PNG, and TIFF.
Preset name
The name of an existing Frame-A-Face preset as displayed in the Presets menu.
Output path
Defines the export destination. If the path doesn’t exist, it will be created automatically.
Optional fields:
*
asterisk symbol. "C:\Users\User\Pictures\School","Square","C:\Users\User\Pictures\Output\School","_S"
"C:\Users\User\Pictures\School","Wide Body Centered","C:\Users\User\Pictures\Output\School","_W","3000","png"
In the examples above:
CSV files can be created and edited using any plain text editor or spreadsheet application (e.g., Excel, Notepad, Numbers).
Comments can be added to CSV files using the #
character at the beginning of a line.
Example:
# This is a comment
"C:\Users\User\Pictures\School","5x7","C:\Users\User\Pictures\Output\School","_5x7"
Processing a whole folder:
"C:\Users\User\Pictures\Events","5x7 Centered","C:\Users\User\Pictures\Processed\Events","_5x7"
This processes all images in the “Events” folder using the “5x7 Centered” preset and saves them in the “Processed\Events” folder with a “_5x7” suffix.
Processing a single image:
"C:\Users\User\Pictures\Events\image1.jpg","5x7 Centered","C:\Users\User\Pictures\Processed\Events","_5x7"
This processes only “image1.jpg” using the “5x7 Centered” preset and saves it in the “Processed\Events” folder with a “_5x7” suffix.
Processing with both input and output as image names:
"C:\Users\User\Pictures\Events\image1.jpg","5x7 Centered","C:\Users\User\Pictures\Processed\Events\image1_cropped.jpg"
This processes “image1.jpg” and exports the result directly as “image1_cropped.jpg” in the specified folder.
"C:\Users\User\Pictures\School","Square","C:\Users\User\Pictures\Output\School","_S"
"C:\Users\User\Pictures\School","Wide Body Centered","C:\Users\User\Pictures\Output\School","_W"
"C:\Users\User\Pictures\School","Tight Headshot Centered","C:\Users\User\Pictures\Output\School","_T"
"C:\Users\User\Pictures\School","5x7","C:\Users\User\Pictures\WebPreview\School","*","800"
In this example, all images from the “School” folder are processed using different crop presets. The cropped images are saved with respective suffixes in the “Output\School" folder. Additionally, a 5x7 crop is created, resized to 800 pixels wide, and exported to the “WebPreview\School" folder with the original file names.
If Frame-A-Face encounters issues with the CSV list, it will display an alert message specifying the problem (e.g., invalid paths, incorrect file format).
Ensure that:
By using CSV lists, users can streamline their workflows and achieve consistent, high-quality results efficiently.