List of Nodes

To view which nodes are only available in the Pro version of Retrobatch, read here.

Read

Clipboard: Copy an image from the clipboard and process it, or optionally write a processed image to the clipboard. Or do both! Take an image from the clipboard, process it, and then copy it back. When writing to the clipboard when more than one image is present in the workflow, Retrobatch will write the last image listed.

Photos Library: Read images directly from Photos library, with images selectable by album.

Prompt for Files: A prompt via an open panel for files or a folder of images, and optionally subfolders, in order to pick images to be processed when the workflow is run.

RAW Process: Processes RAW images before converting them to the RGB color space. Check the 'draft mode' box for faster processing.

  • Exposure: Adjust the lightness or darkness of your entire image.

  • Shadow Boost: Changes the darkness of the darker areas of the photo.

  • Boost: Changes the brightness of the lighter areas of the photo.

  • Bias: Increases and decreases in the amount of black in an image.

  • Noise Reduction: Decreases the appearance of random speckled dots in areas where color should be even.

  • Temperature: Changes the photo colors from warm to cool.

  • Tint: Gives image a more green tint when slider is all the way to the left, more blue all the way to the right.

  • Scale: Change the scale of the image using a percentage slider. For more control, add a Scale node in your workflow.

  • Color Profile: Various color profile options are available.

  • Bits per Channel/Depth: Choose from 8, 16, or 32 bits per channel.

  • File type: Choose from HEIC, JPEG, JPEG2000, and TIFF.

Read Folder: Read a folder (and optionally subfolders) of images. Images can be sorted in the preview alphabetically by ascending or descending file name. Multiple Read Folders can be chained together in a workflow. Easily add a Read Folder by dragging and dropping a folder of images onto Retrobatch's canvas.

Read Individual Files: Read a single file, or multiple files from different locations. After adding the node, click the '+' to add images, or drag and drop images onto the node. Alternatively, drag and drop an image into Retrobatch, and a Read Individual Files node will be created. Click the '-' to remove images from this node.

Write

Open In App (Pro): Open an image in a chosen application by adding this node after the 'write images' node.

Write Images: Write out images to a folder, change the file name if desired, and optionally convert images to HEIC, JPG, JPEG2K, PDF, PNG, PSD, TIFF.

  • When a Write Images node is added to the canvas, you will be prompted to select a folder to write your images into.
  • Find and select an existing folder.
  • To create a new folder, navigate to where you want a new folder to be located, then click on 'New Folder' located on the lower lefthand corner of the window.
  • The file name field / token field in the Write node has the ability to create subfolders. For example, if you want your images to be in a folder with the year on it, you would add a Capture Date token to the front, then a "/" (path separator) token, and the file name will be after that.
  • In the file name field, tokens can be separated using characters such as underscores, or inserting additional spaces.

Blur

Blur Box Blur: Smooths or sharpens an image using a box-shaped convolution kernel.

Gaussian Blur: Spreads source pixels by an amount specified by a Gaussian distribution.

Noise Reduction: Reduces noise using a threshold value to define what is considered noise. Small changes in luminance below that value are considered noise and get a noise reduction treatment, which is a local blur. Changes above the threshold value are considered edges, so they are sharpened.

Color Adjustment

Auto Enhance: Make your photos look better through black magic.

Change Color Profile (Pro): Assign a new color profile to an image.

Color Controls: Adjust saturation, brightness, and contrast values.

Exposure Adjust: Adjust the exposure setting for an image similar to controlling exposure for a camera when changing the F-stop.

Gamma Adjust: Adjust midtone brightness. This filter is typically used to compensate for nonlinear effects of displays. Adjusting the gamma effectively changes the slope of the transition between black and white.

Instant Alpha: Removes pixels from your image based on a sampling location and tolerance.

Opacity: Adjust the opacity or transparency of an image.

Vibrance: Adjust the saturation of an image while keeping pleasing skin tones.

Color Effect

Add Border: Add a solid color border to images. The width of the border is measured in pixels and the border extends outwards from the image bounds. Adding a transparent border will add an even amount of transparency to all sides of the image. This can be useful for adding a drop shadow or resizing an image without scaling it. Multiple Add Border nodes can be used in succession to create different border effects.

Color Invert: Inverts the colors in an image, similar to converting a photo negative to a photo or vice versa.

Color Posterize: Remaps red, green, and blue color components, flattening colors to achieve a look similar to that of a silk-screened poster.

Dither: Options for Atkinson, Classic Mac, Floyd Steinberg, Gaussian Blue, and Ordered Reproducible algorithms.

Drop Shadow: Creates a drop shadow for the transparent areas of an image. Adjust the color, offset, opacity, and blur of the shadow. Click on the shadow color well to bring up the Colors Palette.

Grayscale: Turns a colored image into grayscale with optional red, blue, and green biases. Black and white only option available by checking 'Assign Gray Profile'.

Matte: Adds a colored background to transparent areas of images. Click on the color well to bring up the Colors Palette to select a matte color.

Photo Chrome: A preconfigured set of effects that imitate vintage photography film with exaggerated color.

Photo Fade: A preconfigured set of effects that imitate vintage photography film with diminished color.

Photo Instant: A preconfigured set of effects that imitate vintage photography film with distorted colors.

Photo Mono: A preconfigured set of effects that imitate black-and-white photography film with low contrast.

Photo Noir: A preconfigured set of effects that imitate black-and-white photography film with exaggerated contrast.

Photo Process: A preconfigured set of effects that imitate vintage photography film with emphasized cool colors.

Photo Tonal: A preconfigured set of effects that imitate black-and-white photography film without significantly altering contrast.

Photo Transfer: A preconfigured set of effects that imitate vintage photography film with emphasized warm colors.

Sepia Tone: Maps the colors of an image to various shades of brown.

Generator

Layer & Page Splitter (Pro): Split up multilayer or multipage GIFs, PNGs, TIFFs, PDFs, Icon, PSD, and Acorn files into individual images.

PDF Image Extractor (Pro): Pulls out bitmaps from PDF files and writes them out either as JPEG or PNG files. A PDF page can have multiple images in it, each at different resolutions. This node grabs the raw data for it, and pulls it out.

PDF Maker (Pro): Combine any images into a multi-page PDF. Editable field to create a PDF name. The order of the images in the Read folder will dictate the order they are placed in the PDF.

PSD Maker (Pro): Combine any images into a multi-layered Photoshop file.

Screenshots & Windows: Produces an image for every visible window, or one image for every screen.

Style Transfer (Pro): Using machine learning, use style transfer models (also known as feedforward style transfers) to imprint styles from one image to another. Example models can be downloaded from: https://coreml.store/. Download a CoreML model and place it in your ~/Library/Application Support/Retrobatch/MLModels/ folder, restart Retrobatch, and it will then show up in the Style Transfer node.

Metadata

Delete Metadata: Remove all metatdata from an image, such as GPS, time picture created, lens information, etc. Useful when uploading to social sites such as Facebook and Twitter. Checkbox option available to keep orientation data intact to ensure your image will still orient in the correct direction.

Fix EXIF Rotation: Rotates an image correctly based on its EXIF rotation setting.

Remove GPS: Removes the location metadata from images.

Set DPI: Change the DPI (dots per inch) setting for images.

Set General Metadata: Change limited metadata values in an image including title, author, description, and copyright.

Set Specific Metadata (Pro): Change a wide array of metadata values in an image including IPTC and EXIF data.

Misc

Change Bits Per Channel (Pro): Change the bits per channel component of images to 8, 16, or 32 bits.

Delay (Pro): Pauses the processing of the images for a set amount of time measured in seconds.

Extract Depth Data (Pro): Copies out the depth data to the write folder from images which contain it. It turns the image asset into an asset for the depth data

ImageAlpha: If ImageAlpha is installed on your machine, use this node to compress PNG images. When you open up this node you will see the option to install ImageAlpha. Clicking this option will direct you to their website in order to download and install. After installing, you will need to quit and restart Retrobatch for its features to be available.

Single Transparent Pixel: Puts a single transparent pixel in the bottom left corner of an image. Great for social sites which will otherwise compress an image if it has no transparency. Only TIFF, PNG, and JPEG2000 file formats support transparency.

Workflow Notes: A place to add text and notes about your workflow. The information in the workflow notes node does not get written out with your images.

Script

AppleScript (Pro): Run an AppleScript file as part of a workflow. The node references a script file and also works by calling 3 different handlers- on processStart(), on processAsset(anAsset), and on processEnd(). The processAsset handler can also return a Boolean value, which lets the AppleScript node know whether or not to continue processing the asset. The AppleScript code can act as a filter by calling various properties on the passed in asset. Open up Retrobatch's scripting dictionary in either Script Debugger (the preferred way) or Script Editor to see the list of properties on assets.

JavaScript (Pro): The JavaScript node allows you to run a JavaScript function when your workflow starts, each time an image is processed by the node, and at workflow end.

Shell Script (Pro): Run a shell script before, after, or for each image run through this node. When each image is run through the script, the first argument to the script is the location of the image.

Sharpen

Sharpen Luminance: Increases image detail by sharpening. It operates on the luminance of the image, the chrominance of the pixels remains unchanged.

Unsharp Mask: Increases the contrast of the edges between pixels of different colors in an image.

Sort

Classify Images (Pro): Analyzes images using machine learning to try and figure out subjects present in the image. Useful when combined with the Rules node to filter out wanted or unwanted subjects. Retrobatch allows you to choose additional CoreML classification models (Retrobatch uses MobileNet) to analyze images. Download a CoreML model and place it in your ~/Library/Application Support/Retrobatch/MLModels/ folder, restart Retrobatch, and it will then show up in the Classification node.

Additional CoreML models can be downloaded from:

Rules (Pro): Filter out images based on set criteria. Click the '+' button in the inspector palette to add additional rules criteria within the same node.

  • File Name: Option for separating images based on whether the file name contains, matches, is like, begins with, ends with, is, is not....compared to the manually entered text.

  • File Path: Option for separating images based on whether the file path contains, matches, is like, begins with, ends with, is, is not....compared to the manually entered text. The file path is what specifies a file's unique location in a file system.

  • Top Classification: Option for sorting images based on whether the top classification term for that image contains, matches, is like, begins with, ends with, is, is not....compared to the manually entered text.

  • Any Classification: Option for sorting images taking into account the first 20 classifications for an image with a classification confidence greater than 1%. Choose whether the image classification term contains, matches, is like, begins with, ends with, is, is not....compared to the manually entered text.

  • Color Model: Option for separating images based on whether it is / is not, and choose from RGB, CMYK, Gray, and Lab.

  • Image type: Option for separating images based on whether it is / is not, and choose a file type from the list.

  • Bits per Channel: Options for separating images based on manually entered bits per channel value and whether image is greater than, equal to, or less than this value.

  • DPI: Options for separating images based on manually entered DPI (dots per inch or pixels per inch) value, and whether image is greater than, equal to, or less than this value.

  • Image Pixel Width: Options for separating images based on manually entered image pixel width value, and whether image is greater than, equal to, or less than this value.

  • Image Pixel Height: Options for separating images based on manually entered image pixel height value, and whether image is greater than, equal to, or less than this value.

  • Megapixels: Options for separating images based on manually entered megapixel value, and whether image is greater than, equal to, or less than this value.

  • Classification Confidence: Options for separating images based on manually entered classification confidence, and whether image is greater than, equal to, or less than this percentage value.

Transform

Crop: Crops images by specific pixel dimensions, preset aspect ratios, or percent. Adjust the placement of the crop with the location widget in the inspector palette.

Flip: Flips an image vertical, horizontal, or both.

Multi Scale (Pro): Resizes an image multiple times, making copies for each resize to be processed by the next node. Useful for instances where an image needs to be written out in multiple sizes. Click on the '+' button in the inspector palette to add additional scaling fields.

Rotate: Rotates images by a given amount in degrees via manual entry or widget.

Scale: Resizes an image with various options for scaling including by percentage, fixed dimensions, fixed width, fixed height, with various quality settings available. Checkbox option available to match even edges to create images that can more easily be handled when sizing for retina display. Some scaling types include option to 'only scale smaller' which prevents images smaller than the chosen dimensions from being scaled up.

Trim To Edges: Trims the image down in size by removing any transparent pixels from the edges of an image. Useful for trimming up screenshot windows, or after adding a drop shadow.

Watermark

Image Watermark: Add an image watermark image to images. Choose the file you wish you use as a watermark, and adjust its scale, opacity, blending mode, and check the 'tile' box if desired.

Text Watermark: Add a text watermark to images, with various settings. Token options you can select from include DPI, description, current date, image capture date, etc. .

Blending Mode Definitions

Compositing is the process of taking one or more images and putting them together into a single image. This is what Retrobatch does when it puts a watermark on top of an image, forming a single image. Retrobatch gives you the ability to decide how the watermark is drawn, which is known as its "blend mode". You may want to change a watermark's blend mode depending on how you want it to appear. The default blending mode is Normal. The best way to become familiar with blending modes is to play around and experiment.
Note: Descriptions taken from Apple's Quartz 2D Programming Guide

  • Normal: The default blend mode. Retrobatch draws the watermark on top of the image below, without any specific blending tricks.

  • Darken: Works by keeping whichever pixels are darker on the watermark or the main image.

  • Color Burn: Darkens the main image over the watermark. White produces no change.

  • Color Dodge: Brighten the main image over the watermark. Black produces no change.

  • Linear Burn: Sums the value in the main image and watermark and subtracts 1. This is the same as inverting each image, adding them together (as in Linear Dodge), and then inverting the result. Blending with white leaves the image unchanged.

  • Linear Dodge: Sums the values in the two images. Blending with white gives white. Blending with black does not change the image.

  • Color: Uses the luminance values of the main image with the hue and saturation values of the watermark. This mode preserves the gray levels in the image.

  • Screen: Multiplies the inverse of the watermark with the inverse of the main image to obtain colors that are at least as light as either of the two contributing colors. Screening any color with white will produce white while screening with black will leave the original color unchanged.

  • Lighten: The opposite of Darken, the Lighten blend mode draws whichever parts are lighter on the watermark or the main image.

  • Hue: Uses the luminance and saturation values of the main image with the hue of the watermark.

  • Saturation: Uses the luminance and hue values of the main image with the saturation of the watermark. Pure gray areas do not produce a change.

  • Difference: Subtracts either the watermark color from the main image color, or the reverse, depending on which has the greater brightness value. Watermark values that are black produce no change; white inverts the main image color values.

  • Addition: Looks at the color information in each channel, and adds the watermark color to the main image color.

  • Subtract: Looks at the color information in each channel and subtracts the watermark color from the main image color.

  • Divide: Looks at the color information in each channel and divides the watermark color from the main image color.

  • Multiply: Multiplies the watermark with the main image. The resulting color is at least as dark as either the source or background color. Multiplying any color with black will give black, and multiplying any color with white preserves the original color.

  • Exclusion: Produces a lower-contrast version of the difference blend mode. Watermark values that are black do not produce a change; white inverts the main image color values.

  • Luminosity: Uses the hue and saturation of the main image with the luminance of the watermark to create an effect that is inverse to the effect created by the color blend mode.

  • Pin Light: Replaces the colors, depending on the blend color. If the blend color (light source) is lighter than 50% gray, pixels darker than the blend color are replaced, and pixels lighter than the blend color do not change. If the blend color is darker than 50% gray, pixels lighter than the blend color are replaced, and pixels darker than the blend color do not change.

  • Soft Light: Either darkens or lightens colors, depending on the watermark color. If the watermark color is lighter than 50% gray, the main image lightens, similar to dodging. If the watermark color is darker than 50% gray, the main image darkens, similar to burning.

  • Hard Light: Either multiplies or screens colors, depending on the watermark color. If the watermark color is lighter than 50% gray, the main image is lightened, similar to screening. If the watermark color is darker than 50% gray, the main image is darkened, similar to multiplying.

  • Mask: Works under the same principles as a layer mask. White in the watermark will expose pixels in the main image below, where as black hides them.

  • Overlay: Either multiplies or screens the watermark with the main image, depending on the color of the main image. The result is to overlay the watermark while preserving the highlights and shadows of the main image.

  • Source Atop: The area of the watermark which overlaps the main image replaces that area of the main image, with the remaining area retained.