Categories

← View All Tools

Image Masking Effect

Apply masking effects to images using shapes, gradients, or custom masks for creative compositions

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

Image to apply masking effect

Type of mask to apply

Shape of the mask (when mask type is shape)

Position of the mask

Size of the mask as percentage of image dimensions

Soft edge radius for the mask (0 for hard edges)

Invert the mask effect (hide masked area instead of showing it)

Output format for the result image

Output quality for lossy formats

Key Facts

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

Overview

The Image Masking Effect tool allows you to creatively crop and shape your images by applying geometric shapes, gradients, or vignettes. Easily control transparency, edge softness, and positioning to create professional-grade compositions directly in your browser.

When to Use

  • •When you need to crop images into specific shapes like circles or stars for profile pictures or design assets.
  • •When you want to create soft-edged transitions or vignettes to focus attention on the center of an image.
  • •When preparing images for web layouts that require transparent backgrounds or specific cutout styles.

How It Works

  • •Upload your image file in any standard format like PNG, JPEG, or WebP.
  • •Select your preferred mask type, such as a geometric shape or a gradient, and adjust the position and size.
  • •Fine-tune the appearance by adjusting the feather radius for soft edges or inverting the mask to hide specific areas.
  • •Choose your desired output format and quality, then download the processed image.

Use Cases

Creating custom-shaped social media profile avatars.
Generating artistic vignettes for photography portfolios.
Preparing transparent-background assets for web design and UI mockups.

Examples

1. Circular Profile Picture

Social Media Manager
Background
Need to convert a square headshot into a clean circular icon for a brand profile.
Problem
Manual cropping often leaves uneven edges or incorrect aspect ratios.
How to Use
Upload the headshot, select 'Shape Mask' with the 'Circle' option, and center it.
Example Config
maskType: shape, maskShape: circle, maskPosition: center, maskSize: 100
Outcome
A perfectly circular portrait with a transparent background, ready for upload.

2. Soft-Focus Vignette

Graphic Designer
Background
Creating a moody hero image for a website landing page.
Problem
The original photo is too sharp, making it difficult to overlay text legibly.
How to Use
Upload the image, select 'Vignette Mask', and increase the 'Feather Radius' to create a soft fade.
Example Config
maskType: vignette, featherRadius: 40, outputFormat: webp
Outcome
An image with soft, darkened edges that draws the viewer's eye to the center and improves text readability.

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 image formats are supported?

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

Can I soften the edges of the mask?

Yes, use the 'Feather Radius' setting to add a soft, blurred transition to the edges of your mask.

What does the 'Invert Mask' option do?

Inverting the mask hides the area inside the selected shape and keeps the surrounding area visible.

Can I change the output file format?

Yes, you can export your result as a PNG, JPEG, WebP, or AVIF file.

Is there a limit to the file size?

The tool supports image files up to 10MB.

API Documentation

Request Endpoint

POST /en/api/tools/image-add-masking

Request Parameters

Parameter Name Type Required Description
imageFile file (Upload required) Yes Image to apply masking effect
maskType select No Type of mask to apply
maskShape select No Shape of the mask (when mask type is shape)
maskPosition select No Position of the mask
maskSize number No Size of the mask as percentage of image dimensions
featherRadius number No Soft edge radius for the mask (0 for hard edges)
invertMask checkbox No Invert the mask effect (hide masked area instead of showing it)
outputFormat select No Output format for the result image
quality number No Output quality for lossy formats

File type parameters need to be uploaded first via POST /upload/image-add-masking 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-add-masking": {
      "name": "image-add-masking",
      "description": "Apply masking effects to images using shapes, gradients, or custom masks for creative compositions",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=image-add-masking",
      "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]