Add toroidal wrap function

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

Bắt đầu bằng cách xác định các entry point toán học hiện có của thư viện core Processing và mọi logic wrap liên quan. Định nghĩa hàm wrap hình xuyến được mô tả trong issue, sau đó thêm hoặc cập nhật độ bao phủ kiểm thử cho các giá trị nhỏ hơn 0, các giá trị bằng hoặc lớn hơn giá trị tối đa và các giá trị đã nằm trong phạm vi.