Categories

Image Levels Adjustment

Adjust image levels with precise control over shadows, midtones, and highlights for professional tonal correction

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 levels adjustment

Shadow input level (0 = pure black, 1 = white). Maps input shadow levels to new values

Shadow output level (0 = pure black, 1 = white). Sets the output for shadow areas

Midtone input level (0 = pure black, 0.5 = middle gray, 1 = white). Controls tonal balance

Midtone output level (0 = pure black, 0.5 = middle gray, 1 = white). Adjusts overall brightness

Highlight input level (0 = pure black, 1 = white). Maps input highlight levels to new values

Highlight output level (0 = pure black, 1 = white). Sets the output for highlight areas

Choose output format or keep original. PNG recommended for maximum quality

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

Key Facts

Category
Design
Input Types
file, number, select
Output Type
file
Sample Coverage
4
API Ready
Yes

Overview

The Image Levels Adjustment tool provides professional-grade control over your image's tonal range, allowing you to precisely map shadows, midtones, and highlights to improve contrast and visual clarity.

When to Use

  • Correcting underexposed or overexposed photos to recover detail.
  • Enhancing the contrast of flat or washed-out images.
  • Fine-tuning the tonal balance of digital graphics for professional output.

How It Works

  • Upload your image file in any supported format like JPEG, PNG, or WebP.
  • Adjust the input and output sliders for shadows, midtones, and highlights to define your desired tonal range.
  • Select your preferred output format and quality settings if you wish to convert or compress the file.
  • Process the image to apply the tonal corrections and download your adjusted file.

Use Cases

Restoring detail in dark, underexposed landscape photography.
Standardizing the brightness and contrast of product images for e-commerce.
Preparing digital artwork by expanding the dynamic range for better print quality.

Examples

1. Correcting Underexposed Photos

Amateur Photographer
Background
A series of landscape photos taken at dusk appear too dark, losing detail in the foreground shadows.
Problem
The images lack sufficient contrast and shadow detail, making them look muddy.
How to Use
Upload the image and adjust the Shadow Input Level to 0.15 to brighten the dark areas, then slightly increase the Midtone Input to 0.45 for better balance.
Example Config
shadowInput: 0.15, midtoneInput: 0.45
Outcome
The foreground shadows are lifted, revealing hidden textures while maintaining natural-looking highlights.

2. Optimizing Product Images

E-commerce Manager
Background
Product photos shot in a studio have gray backgrounds that should appear as pure white.
Problem
The white balance and highlight levels are inconsistent across the product catalog.
How to Use
Upload the product image and set the Highlight Input Level to 0.9 to push the near-white background pixels to pure white.
Example Config
highlightInput: 0.9, format: 'png'
Outcome
The product images now feature a clean, professional white background suitable for web listings.

Try with Samples

image, png, jpg

Related Hubs

FAQ

What file formats are supported?

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

How do the input and output levels differ?

Input levels define which pixels are treated as black, gray, or white, while output levels determine the final intensity range of those pixels in the resulting image.

Can I change the file format during adjustment?

Yes, you can choose to keep the original format or convert the output to JPEG, PNG, or WebP.

What is the purpose of the midtone input level?

The midtone input level (gamma) adjusts the brightness of the middle gray tones without significantly altering the extreme shadows or highlights.

Is there a limit to the file size I can upload?

Yes, the maximum file size for uploads is 10 MB.

API Documentation

Request Endpoint

POST /en/api/tools/image-levels

Request Parameters

Parameter Name Type Required Description
imageFile file (Upload required) Yes Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) for levels adjustment
shadowInput number No Shadow input level (0 = pure black, 1 = white). Maps input shadow levels to new values
shadowOutput number No Shadow output level (0 = pure black, 1 = white). Sets the output for shadow areas
midtoneInput number No Midtone input level (0 = pure black, 0.5 = middle gray, 1 = white). Controls tonal balance
midtoneOutput number No Midtone output level (0 = pure black, 0.5 = middle gray, 1 = white). Adjusts overall brightness
highlightInput number No Highlight input level (0 = pure black, 1 = white). Maps input highlight levels to new values
highlightOutput number No Highlight output level (0 = pure black, 1 = white). Sets the output for highlight areas
format select No Choose output format or keep original. PNG recommended for maximum quality
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-levels 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-levels": {
      "name": "image-levels",
      "description": "Adjust image levels with precise control over shadows, midtones, and highlights for professional tonal correction",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=image-levels",
      "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]