processing / processing/p5.js

Enhance reference of blend() and Image.blend() and make it consistent with blendMode()

Open
#7,236 9 comments 0 reactions 1 assignee View on GitHub

@vaishnavirrapolu-06 is already working on this.

Since Jan 31, 2026.

Area:Image Documentation Enhancement
Dominant language
JavaScript
Stars
24k
Forks
3.8k
Avg merge
3d 16h
Merged PRs (30d)
25

Description

Increasing access

Comprehensive examples of blend modes will provide a quick overview for people who are not used to work with image blending/layering.

Most appropriate sub-area of p5.js?
  • Accessibility
  • Color
  • Core/Environment/Rendering
  • Data
  • DOM
  • Events
  • Image
  • IO
  • Math
  • Typography
  • Utilities
  • WebGL
  • Build process
  • Unit testing
  • Internationalization
  • Friendly errors
  • Other (specify if possible)
Feature enhancement details

I noticed a few small things, that might improve the documentation consistency between blend(), Image.blend() and blendMode():

  • blendMode() provides a comprehensive overview of all blend modes, while blend() and Image.blend() don't. However it might help people without experience on image blending to see, how other blend modes affect the images as well.
  • I noticed, that blend() and Image.blend() do not mention REMOVE as blend mode. However, as far as I tested it, it seems to work and acts as an inverse mask, if an image with alpha channel is provided (see example below). I wonder, if this behaviour is intentional, but if so, it probably should be documented as well.
let photo;
let maskImage;

// Load the images.
function preload() {
 photo = loadImage('/assets/rockies.jpg');
 maskImage = loadImage('/assets/mask2.png');
}

function setup() {
 createCanvas(100, 100);

 // Apply the mask.
 photo.blend(maskImage, 0, 0, 100, 100, 0, 0, 100, 100, REMOVE);

 // Display the image.
 image(photo, 0, 0);

 describe('A white canvas. The right side of the canvas has a faded patch of an image of a mountain landscape.');
Bildschirmfoto 2024-09-05 um 17 49 02
  • Also, the parameter reference of Image.blend() contains remnants of an outdated documentation including a broken link.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.