Add toroidal wrap function

Offen

#1,205 erstellt am 14.8.2025 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 2/5
Geschätzter Aufwand: 1-3 Stunden
Anfängerfreundlichkeit: 35/100

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

Rechercherichtung

Beginne damit, die vorhandenen mathematischen Einstiegspunkte der Processing-Kernbibliothek und jede zugehörige Wrap-Logik zu lokalisieren. Definiere die in der Issue beschriebene toroidale Wrap-Funktion und füge anschließend Testabdeckung für Werte unter null, Werte am oder über dem Maximum sowie Werte, die bereits im gültigen Bereich liegen, hinzu oder aktualisiere sie.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

Relevant sub-area for this feature?

Math

Feature details

Feature description

In many programs a value starts again at zero if it gets larger than a max value or appears at max value when it goes below zero. Provide a function that does the wrapping as a single function.

  /**
   * Wraps a value at 0 and max to constrain value between zero and max.
   * @param value The value to wrap
   * @param max The maximum value (excluded)
   * @return The toroidally wrapped value
  float wrap(float value, float max) {
    if (value < 0) {
      return value + max;
    } else if (value >= max) {
      return value - max;
    }
    return value;
  }

Benefits

This would reduce code sizes and make these toroidal worlds easier to understand.

Would you like to help implement this feature?

Yes, I’d like to help with this

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