Jitterbit Image Processor Examples¶

Image Types¶

The Image Processor uses simple patterns to determine where there is a change in the colors of an image and from there sets the cropping. This means that simple adjustments in the Cloud Studio UI can easily break the processor. Don’t be surprised when issues arise. Always check all images after processing for correct cropping.

Images will be cropped with a 20-pixel margin as an outer border outside of all elements.

The following image types are supported for processing. They are ordered by the X-type first (as it is the most common) with the others following alphabetically:

X: An image with a large “X” in the upper right corner. Marking an image as an “X” type tells the processor to ignore that “X” when calculating the location of the right-hand side. It uses the bottom of the “X” to determine where the base line of the top-most text is and from there determines where to crop.

However, if the calculation of the location of the right side of the “X” is in the bottom half of the image (has a y component greater than 50% of the height), then that means that the “X” is actually in line with the other elements. In that case, use that location as the right-hand side rather than attempting to crop off the “X”.
A: A component palette image of an existing endpoint, showing its activities.
B: An image cropped “tight” with a 20 pixel border (scaled based on the assumed DPI) added using its background color.
C: A component palette image of a connector or an endpoint, but not to show any activities. If any activities show, they will be cropped off.
I: An inline image trimmed to the first pixels different than the background with a 2 pixel border (scaled based on the assumed DPI) added using its background color.
M: A modal dialog image, a white rectangle, possibly with an orange bottom border, on a gray overlay background. Rounded corners on the rectangle are acceptable and are cleaned up when cropped.
O: An image of an operation example, trimmed to eliminate the outer border.
S: An activity step image without an “X” in the upper-right corner.
T: A “tight” image, trimmed to all outer pixels.

Note

An empty type value with a revised filename means that the file will be renamed but not otherwise processed.
An empty type value with an empty revised filename means that the file will not be processed.

The inline and tight images detect their backgrounds by calculating the color distance of a pixel from the background (the background being the color of the corner pixels) and using a threshold of 20 units. (The maximum distance in the RGB color space is from white to black and is approximately 765 units.) Any pixel under the threshold is considered part of the background and not considered when detecting edges.

A hint can be added for this file attribute:

F: A full-page image includes the entire contents of the browser tab or window with the current Cloud Studio display.

A full-page image includes the entire contents of the browser tab or window with the current Cloud Studio display. It can be applied to these image types:
- Image with an “X” in the upper-right corner (“X” type)
- Modal dialog image (“M” type)
- Activity step image (“S” type)
For other image types, a setting of full-page is ignored.

Generate a full-page image using a browser plugin or another screenshot application. For example:
R: A resized image is resized using a LANCZOS filter based on the current image calibration.

Borders and margins are scaled based on a combination of an assumed image resolution of 72 DPI and the current image calibration. The current calibration is a percentage determined by the relative monitor DPI where the screenshot was taken.

Files without a type are not processed unless they are given a name, in which case they are renamed without further processing.

Selecting multiple screenshot images to set them all to the same type is supported. You can also select multiple images and use your keyboard to enter the appropriate type (either lowercase or uppercase keys). The deletion and space character keys (such as the macOS delete, forward-delete, and space keys or the Windows Backspace, DEL, and Spacebar keys) all remove the current type.

Double-clicking the F or R columns of an image’s row will toggle that setting.

Image Examples¶

X Type¶

An image with a large “X” in the upper right corner.

Original Image	Processed Image

A Type¶

A component palette image of an existing endpoint, showing its activities.

Original Image	Processed Image

B Type¶

An image cropped “tight” with a 20 pixel border (scaled based on the assumed DPI) added using its background color.

Original Image	Processed Image

C Type¶

A component palette image of a connector or an endpoint, but not to show any activities. If any activities show, they will be cropped off.

Original Image	Processed Image

I Type¶

An inline image trimmed to the first pixels different than the background with a 2 pixel border (scaled based on the assumed DPI) added using its background color.

Original Image	Processed Image

M Type¶

A modal dialog image, a white rectangle, possibly with an orange bottom border, on a gray overlay background. Rounded corners on the rectangle are acceptable and are cleaned up when cropped.

Original Image	Processed Image

O Type¶

An image of an operation example, trimmed to eliminate the outer border. Displayed here with no border to show that it has been eliminated from the original image.

Original Image	Processed Image

R Type¶

An image that is resized with no edge detection or cropping. In this example the image is resized to 50% of its original size.

Original Image	Processed Image

S Type¶

An activity step image without an “X” in the upper-right corner.

Original Image	Processed Image

T Type¶

A “tight” image, trimmed to all outer pixels.

Original Image	Processed Image