Add `beginClip()` and `endClip()` masking functions

Offen

#1,191 erstellt am 28.7.2025 4 Kommentare 2 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 5/5
Geschätzter Aufwand: Über eine Woche
Anfängerfreundlichkeit: 35/100

Issue-Typ: Feature
Klarheit: Größtenteils klar
Aktivitätsstatus: Veraltet
Tech-Stack: java
Bereich: computer-graphics

Rechercherichtung

Beginne im Bereich Core/Environment/Rendering, indem du das bestehende Verhalten von mask() und die verknüpfte p5.js beginClip()-Referenz liest. Definiere, wie beginClip(), endClip() und das optionale invert-Flag funktionieren sollen, und überprüfe anschließend, dass Zeichenbefehle zwischen den Aufrufen das erwartete normale und inverse Clipping-Verhalten erzeugen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

Relevant sub-area for this feature?

Core/Environment/Rendering

Feature details

Feature description

Add beginClip() and endClip() to define clipping masks using drawing commands. Shapes drawn between these calls become the mask. An optional invert flag enables inverse masking.

Benefits

More intuitive and less verbose than mask()
Matches p5.js API and reduces cognitive load when switching from one to the other

Challenges

Not sure

Additional context

See https://p5js.org/reference/p5/beginClip/

Example code

This mask() code...

  // Create pattern graphics
  pattern = createGraphics(width, height);
  pattern.beginDraw();
  pattern.background(255);
  pattern.stroke(0);
  pattern.strokeWeight(2);
  for (int x = 0; x < width; x += 10) {
    pattern.line(x, 0, x, height);
  }
  pattern.endDraw();

  // Create mask graphics (white circle on black)
  maskImg = createGraphics(width, height);
  maskImg.beginDraw();
  maskImg.background(0);
  maskImg.noStroke();
  maskImg.fill(255);
  maskImg.ellipse(width/2, height/2, 200, 200);
  maskImg.endDraw();

  // Apply mask to pattern
  pattern.mask(maskImg);

... becomes this using beginClip()/endClip():

  // Define clipping region
  beginClip();
  ellipse(width/2, height/2, 200, 200);
  endClip();

  // Draw pattern inside the clip
  stroke(0);
  strokeWeight(2);
  for (int x = 0; x < width; x += 10) {
    line(x, 0, x, height);
  }

Would you like to help implement this feature?

No, I’m just suggesting the feature

Vorherrschende Sprache: Java
Sterne: 497
Forks: 183
Ø Merge: 4 Std. 39 Min.
Gemergte PRs (30 T.): 3

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus processing/processing4

Fixing the "Cannot access sketchbook" error requires resetting "org.processing.four," but that does not exist. Offen

bug

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 64/100

processing/processing4#1554 · 1 Kommentar · Erstellt am 25.7.2026
determining path for portable preferences file is wrong for windows OS Offen

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100

processing/processing4#1515 · 1 Reaktion · Erstellt am 06.5.2026
PDE doesn't report invalid size() arguments as a logic error Offen

bug

Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 55/100

processing/processing4#1573 · Erstellt am 21.9.2026
startup error Offen

Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 25/100

processing/processing4#1569 · 7 Kommentare · Erstellt am 14.9.2026
Binaries under bin directory lack executable permissions for the snap and .deb packages for Linux Offen

bug

processing/processing4#1567 · 3 Kommentare · 1 Reaktion · 1 zugewiesene Person · Erstellt am 23.8.2026

Alle Issues in processing/processing4