Categories

← View All Tools

Image Translation

Apply translation transformation to move images horizontally and vertically. Visualize the translation matrix and see how pixel coordinates shift.

Click to upload file or drag and drop file here

Maximum file size: 10MB Supported formats: image/jpeg, image/png, image/webp, image/gif, image/bmp, image/tiff

Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) for translation transformation

-500 0 500

Horizontal translation in pixels (-500 to 500, positive = right, negative = left)

-500 0 500

Vertical translation in pixels (-500 to 500, positive = down, negative = up)

Background color for transparent areas (hex #RRGGBB or #RRGGBBAA, or color name)

Choose output format or keep original. PNG recommended for transparency

Output quality for lossy formats (JPEG, WebP). Higher = better quality but larger file size

Key Facts

Category
Media
Input Types
file, range, text, select, number
Output Type
file
Sample Coverage
4
API Ready
Yes

Overview

The Image Translation tool allows you to precisely shift the position of any image file horizontally or vertically using pixel-based coordinates. By applying a translation matrix, you can easily offset your visual content, adjust framing, or create space for design elements while maintaining high image quality.

When to Use

  • •Adjusting the composition of an image by shifting its subject to a specific side.
  • •Creating uniform margins or padding around an image for web or print layouts.
  • •Correcting alignment issues in graphics or icons by moving them within their canvas.

How It Works

  • •Upload your image file (JPEG, PNG, WebP, GIF, BMP, or TIFF).
  • •Use the Translate X and Translate Y sliders to set your desired pixel offset.
  • •Specify a background color for the newly created empty areas if needed.
  • •Select your preferred output format and quality, then process the image.

Use Cases

Centering off-center product photography for e-commerce listings.
Adding consistent padding to icons to ensure they align perfectly in a grid.
Repositioning elements within a graphic to make room for text overlays.

Examples

1. Centering a Product Icon

Graphic Designer
Background
A set of product icons were exported with inconsistent margins, making them look misaligned on the website.
Problem
The icons need to be shifted to the center of their square canvas to ensure visual consistency.
How to Use
Upload the icon, adjust Translate X and Y to shift the subject to the center, and export as a PNG.
Example Config
translateX: 20, translateY: -15, background: transparent, format: png
Outcome
The icon is perfectly centered within the canvas, providing a clean and professional look for the website.

2. Creating Space for Text

Social Media Manager
Background
A promotional image has the main subject too close to the right edge, leaving no room for a call-to-action text overlay.
Problem
The subject needs to be shifted to the left to create negative space for text.
How to Use
Upload the image, set a negative Translate X value to shift the subject left, and set a white background.
Example Config
translateX: -100, translateY: 0, background: #FFFFFF, format: jpeg, quality: 90
Outcome
The subject is shifted left, creating a clean white area on the right side perfect for adding marketing text.

Try with Samples

image, png, jpg
Web Image Processing Python Samples
Web Python image processing examples using PIL/Pillow including reading, saving, resizing, and format conversion
title token image
image
Windows Image Processing C++ Samples
Windows C++ image processing examples including reading/saving images, resizing, and format conversion using Windows Imaging Component (WIC)
title token image
image
Web Image Processing Rust Samples
Web Rust image processing examples including image read/save, scaling, and format conversion
title token image
image
macOS Image Processing Objective-C Samples
macOS Objective-C image processing examples including image reading/saving, image scaling, and format conversion
title token image
image

Related Hubs

Image Convert Tools
Explore 100 image tools for convert workflows and compare closely related utilities quickly.
Video Convert Tools
Explore 36 video tools for convert workflows and compare closely related utilities quickly.
Image Tools
Explore 40 image tools for utility workflows and compare closely related utilities quickly.
Video Tools
Explore 16 video tools for utility workflows and compare closely related utilities quickly.

FAQ

What happens to the empty space created by the shift?

The empty space is filled with the background color you specify. If you choose 'transparent', the area will remain transparent (best when using PNG format).

Can I move an image to the left or up?

Yes, use negative values for Translate X to move left and negative values for Translate Y to move up.

Which file formats are supported?

You can upload JPEG, PNG, WebP, GIF, BMP, and TIFF files.

Does this tool change the original image resolution?

The tool shifts the content within the existing canvas dimensions; it does not resize the image itself.

What is the maximum pixel shift allowed?

You can shift an image by up to 500 pixels in any direction.

API Documentation

Request Endpoint

POST /en/api/tools/image-translation

Request Parameters

Parameter Name Type Required Description
imageFile file (Upload required) Yes Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) for translation transformation
translateX range Yes Horizontal translation in pixels (-500 to 500, positive = right, negative = left)
translateY range Yes Vertical translation in pixels (-500 to 500, positive = down, negative = up)
background text No Background color for transparent areas (hex #RRGGBB or #RRGGBBAA, or color name)
format select No Choose output format or keep original. PNG recommended for transparency
quality number No Output quality for lossy formats (JPEG, WebP). Higher = better quality but larger file size

File type parameters need to be uploaded first via POST /upload/image-translation to get filePath, then pass filePath to the corresponding file field.

Response Format

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
File: File

AI MCP Documentation

Add this tool to your MCP server configuration: 

{
  "mcpServers": {
    "elysiatools-image-translation": {
      "name": "image-translation",
      "description": "Apply translation transformation to move images horizontally and vertically. Visualize the translation matrix and see how pixel coordinates shift.",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=image-translation",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

Supports URL file links or Base64 encoding for file parameters.

If you encounter any issues, please contact us at [email protected]