Categories

← View All Tools

Image Duotone Effect

Apply duotone effect that maps image colors to two-color gradient for artistic effect

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) to apply duotone effect

Primary color for the duotone gradient (R,G,B values)

Secondary color for the duotone gradient (R,G,B values)

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, color, select, number
Output Type
file
Sample Coverage
4
API Ready
Yes

Overview

The Image Duotone Effect tool allows you to transform any standard image into a striking, artistic composition by mapping its colors to a custom two-color gradient. Perfect for branding, web design, or creative projects, this utility provides precise control over color selection and style modes to achieve a professional split-tone look.

When to Use

  • •Creating consistent, branded imagery for websites or social media profiles.
  • •Stylizing photos to match a specific color palette for design projects.
  • •Adding a modern, high-contrast aesthetic to portraits or product photography.

How It Works

  • •Upload your image file (JPEG, PNG, WebP, GIF, BMP, or TIFF).
  • •Select your primary and secondary colors to define the duotone gradient.
  • •Choose a specific duotone mode, such as 'Classic' or 'High Contrast', to adjust the intensity.
  • •Select your preferred output format and quality settings, then process the image.

Use Cases

Standardizing a collection of diverse photos to have a unified brand color scheme.
Generating eye-catching hero images for landing pages with a minimalist aesthetic.
Creating stylized profile pictures or avatars with a unique artistic flair.

Examples

1. Branded Social Media Assets

Graphic Designer
Background
A designer needs to prepare a series of product photos for a campaign that requires a specific brand color palette.
Problem
The original photos have inconsistent lighting and colors that clash with the brand identity.
How to Use
Upload the product images and apply the brand's primary and secondary colors using the 'Classic' duotone mode.
Example Config
primaryColor: #FF5733, secondaryColor: #2C3E50, mode: classic
Outcome
The product images are transformed into cohesive, branded assets that align perfectly with the campaign's visual style.

2. High-Contrast Web Hero Image

Web Developer
Background
A developer is building a landing page and wants a bold, high-contrast background image that doesn't distract from the text.
Problem
The original photograph is too busy and contains too many colors, making the overlay text hard to read.
How to Use
Upload the hero image and select the 'High Contrast' mode to simplify the color palette and emphasize the subject's silhouette.
Example Config
primaryColor: #FFFFFF, secondaryColor: #000000, mode: high-contrast
Outcome
The image is converted into a clean, black-and-white high-contrast graphic that provides excellent readability for the landing page 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.
Image Tools
Explore 40 image tools for utility workflows and compare closely related utilities quickly.
Json Convert Tools
Explore 100 json tools for convert workflows and compare closely related utilities quickly.
Audio Convert Tools
Explore 100 audio tools for convert workflows and compare closely related utilities quickly.

FAQ

What file formats are supported?

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

Can I choose any two colors?

Yes, you can select any primary and secondary color using the color picker to create your custom gradient.

What is the difference between the duotone modes?

Modes like 'Classic', 'Gradient', and 'High Contrast' change how the color mapping is applied to the image's highlights and shadows, resulting in different artistic intensities.

Will the image quality be reduced?

You can adjust the output quality from 1 to 100 for lossy formats like JPEG and WebP to balance file size and visual clarity.

Is there a file size limit?

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

API Documentation

Request Endpoint

POST /en/api/tools/image-duotone

Request Parameters

Parameter Name Type Required Description
imageFile file (Upload required) Yes Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) to apply duotone effect
primaryColor color No Primary color for the duotone gradient (R,G,B values)
secondaryColor color No Secondary color for the duotone gradient (R,G,B values)
mode select No -
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-duotone 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-duotone": {
      "name": "image-duotone",
      "description": "Apply duotone effect that maps image colors to two-color gradient for artistic effect",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=image-duotone",
      "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]