Main

Main UI

• File Ingestion Area: Located in the top-left corner, this area accepts single or multiple image files via drag-and-drop. Dropping a valid file initiates the analysis and processing pipeline.

• Source Image Preview: Displays the original uploaded image. It features an overlay that visualizes the results of the AI semantic analysis with color-coded bounding boxes indicating detected elements like attention areas, objects, faces, and pets. A separate overlay shows the crop boundaries for the currently selected output preset.

• Source File Metadata: A set of informational labels below the source preview displays the original file's name, storage size, and pixel resolution.

• Preset Selection List: A scrollable panel on the left side displays all configured aspect ratio presets.
• Preset Card: Each entry displays the preset's title, ratio, and a brief description.
• Selection: Clicking anywhere on the row toggles the preset's active state for export. A visual indicator, such as a highlight or border, identifies the currently active preset.
• Contextual Actions: Each preset row provides icons to open the preset editor for modifications or to delete the preset.

• Preset Management Controls: A set of controls at the bottom of the preset list allows searching for presets by name or title, creating a new custom preset, and importing or exporting preset configurations as files.

• Interactive Crop Preview: The main area displays the currently selected target crop. This viewport supports direct interaction for fine-tuning:
• Panning: The user can drag the image to reposition the crop frame's center.
• Zooming: Pinch gestures adjust the zoom level to shrink or enlarge the crop area.

• Zoom Control: A dedicated slider below the preview adjusts the crop's zoom level. An accompanying label displays the current value as a percentage.

• Export File Type Tag: A label indicating the file format (e.g., PNG, JPEG, HEIC) that will be used for the final exported image, based on the current settings.

• Cropped Size Tag: A label displaying the pixel dimensions (width x height) of the final cropped image for the currently selected preset.

• Rotation Controls: A set of controls allows for correcting the image's orientation within the crop:
• Angle Adjustment Slider: A slider that enables precise micro-rotation (e.g., to correct a slanted horizon). The current angle is displayed numerically.
• Auto-Correction: A button that triggers an automatic analysis to detect and correct the image's horizon angle.
• 90° Rotation: Two buttons perform physical 90-degree rotations of the base image in either a clockwise or counter-clockwise direction.

• Grid Overlay: A dropdown menu toggles different composition grid overlays (e.g., Rule of Thirds, Golden Ratio) on the crop preview to assist with manual framing.

• AI Upscaling: A button toggles a 4x AI upscaling process. The button title reflects the current state, allowing the user to apply the upscale or revert to the original resolution.

• Export Action: A prominent button that triggers the export pipeline, generating cropped and resized images (or videos) for all active presets.

• Preset Item: Represents a single configurable aspect ratio or resolution preset for cropping. Each item includes the preset name, a brief description, the numerical aspect ratio, and controls for editing or removing the preset.

• Aspect Ratio Preview: A visual representation of the crop shape. It displays a bounding box corresponding to the preset's aspect ratio over a checkerboard background, helping the user quickly identify the geometry of the crop.

• Preset Title and Description: Text labels providing the user-facing name of the preset and a short explanation of its typical or intended use case.

• Ratio Label: A display of the preset's specific numerical aspect ratio, providing precise information about the width-to-height relationship for the crop.

• Settings/Edit Control: An action that opens an editor interface for the user to modify the preset's configuration, such as its title, ratio, and output settings.

• Delete Control: An action to remove the preset from the list, typically requiring the user to confirm the deletion to prevent accidental loss of custom configurations.

• Active State Indicator: A visual highlight, shown here as a pink border and background, that indicates a preset is currently selected. This signifies which preset's crop is being previewed in the main editor and will be included in the export process.

• Aspect Ratio Tabs: A horizontal navigation bar that displays a set of active crop presets. Each tab represents a specific aspect ratio or crop type configured by the user.

• Active Preset Indicator: A visual highlight, shown here as a pink background and text, that identifies the currently selected preset. Clicking a tab sets it as the active target, updating the main crop preview to reflect that preset's aspect ratio and framing.

AI Upscale

Preset Settings

Preset Settinga

• Identity Section: A group of text fields used to define the preset's basic metadata.
• Title: The user-facing name for the preset.
• Short Title: A concise name or ratio shorthand, useful for labels in compact spaces like tabs.
• Suffix: A text fragment appended to the exported file's name for easy identification.
• Description: A longer, explanatory text detailing the preset's purpose or intended use case.

• Size & Bounds Section: A section for configuring the crop's dimensions.
• Mode: A toggle that switches the dimension definition between a flexible aspect Ratio and a fixed pixel Resolution.
• Ratio: A numeric field defining the width-to-height relationship of the crop when in Ratio mode.
• Max Width / Max Height: Optional numeric fields that place an upper pixel limit on the output dimensions, preventing the crop from exceeding these sizes.

• Auto Close-Up Section: An option to control automatic framing.
• Perform Auto Close-Up: A toggle that, when enabled, instructs the AI to automatically adjust the crop's center and zoom to frame the most prominent face in the image.

• Export Settings Section: A group of overrides for the export pipeline.
• Override Global Export Options: A toggle that, when enabled, applies the settings within this section instead of the application's default export configuration.
• File Type: A dropdown menu to select the specific format (e.g., JPEG, PNG, HEIC) for the exported image.
• Quality: A slider to adjust the compression quality for lossy formats like JPEG. A percentage label displays the current setting.

Settings

Analysis

• Settings Navigation Tabs: A set of tabs that switch the settings panel between different configuration categories, such as Analysis, Face Landmarks, and Export. The currently active tab is highlighted with a pink background.

• Analysis Weights Section: A group of controls that define the relative importance of different types of visual elements when the AI calculates the optimal crop center.
• Objects Weight: A slider that sets the priority level for general physical objects detected in the image. The current value is shown as a percentage.
• Attention Weight: A slider that adjusts the priority for areas of visual saliency or general interest. The current value is shown as a percentage.
• Face Detection Weight: A slider that determines the priority for human faces. The current value is shown as a percentage.

• Analysis Options Section: A group of toggles and settings that enable or disable specific features of the AI analysis engine.
• Weight Faces with Expression Analysis Quality: A toggle that enables an experimental feature where facial expression quality scores influence the crop centering. A disclaimer notes that this may slow down processing.
• Include Pets: A toggle that determines whether the AI will detect and prioritize domestic animals like dogs and cats.
• Pets Weight: A slider that sets the priority level for detected pets when the "Include Pets" option is active. The current value is shown as a percentage.

Face Landmarks

• Settings Navigation Tabs: A set of tabs that switch the settings panel between different configuration categories. The active Face Landmarks tab is highlighted with a pink background.

• Eyes Section: A group of controls dedicated to configuring how the AI treats eye detection during the crop analysis.
• Include Eyes: A toggle that enables or disables the detection of eyes as a factor for the crop calculation.
• Weight: A slider that sets the priority level for detected eyes when the "Include Eyes" option is active. The current value is shown as a percentage.

• Lips Section: A group of controls dedicated to configuring how the AI treats lip detection during the crop analysis.
• Include Lips: A toggle that enables or disables the detection of lips as a factor for the crop calculation.
• Weight: A slider that sets the priority level for detected lips when the "Include Lips" option is active. The current value is shown as a percentage.

Export

• Settings Navigation Tabs: A set of tabs that switch the settings panel between different configuration categories. The active Export tab is highlighted with a pink background.

• Destination Section: A group of controls that determine where the processed files are saved.
• Save To: A segmented control offering three destination options: Same Folder (saves alongside the source image), Subfolder (saves within a new, dedicated folder next to the source), and Specific Folder (saves to an explicitly selected, custom directory).

• Format & Quality Section: A group of controls that configure the output file properties.
• File Type: A dropdown menu that allows the selection of the output container format for the exported image, such as PNG, JPEG, or HEIC.