Convert Image Aspect Ratio

An Apify actor that transforms images to a target aspect ratio. It handles resizing, cropping, and background filling for various use cases like social media, e-commerce, and web design.

Overview

This actor converts images to a specified aspect ratio. You provide image URLs and configuration settings; it returns the processed images. It supports multiple resize modes, background options, and common cloud storage platforms.

Key Features

• Flexible Aspect Ratios: Convert to standard ratios (1:1, 16:9, 9:16, 4:5, etc.) or any custom ratio.
• Multiple Resize Modes:
  • Fit: Maintains original proportions, filling empty space with a background.
  • Fill: Crops the image to fit the exact aspect ratio.
  • Stretch: Distorts the image to fit the dimensions exactly.
• Background Options: Fill areas with solid colors, transparency, a blurred version of the original image, or a custom hex color.
• Batch Processing: Convert multiple images in a single run.
• Format Support: Input and output support for PNG, JPEG, WebP, GIF, BMP, and TIFF.
• High Resolution: Output images up to 8192x8192 pixels.
• Cloud Storage Integration: Accepts direct URLs or shareable links from Google Drive, Dropbox, OneDrive, Box, and GitHub.

How to Use

Configure the actor run with the following input:

1. Image Sources: Provide an array of image URLs. These can be direct links or shareable links from supported cloud platforms.
2. Target Aspect Ratio: Define the desired width and height ratio (e.g., {"width": 16, "height": 9}).
3. Resize Mode: Choose fit, fill, or stretch.
4. Background Settings: Configure the style (solid, transparent, blur, custom) and color if needed.
5. Output Format: Specify the desired image format (e.g., jpeg, png).

The actor processes the images and saves the results to the Apify dataset. You can then download them via the Apify console or API.

Input/Output

Input (example JSON):

{
  "imageUrls": [
    "https://example.com/photo.jpg",
    "https://drive.google.com/file/d/FILE_ID/view"
  ],
  "aspectRatio": {
    "width": 1,
    "height": 1
  },
  "resizeMode": "fit",
  "background": {
    "style": "solid",
    "color": "#FFFFFF"
  },
  "outputFormat": "png"
}

Output:
The actor stores processed image files in the run's dataset. Each item typically contains the processed image buffer, a unique key, and metadata like the original source URL.