processing / processing-docs

[Deprecated] Processing reference, examples, tutorials, and website
https://processing.org
371 stars 179 forks source link

There is no page for EPSILON on the reference #811

Closed villares closed 4 years ago

villares commented 4 years ago

Issue description

There is an EPSILON constant in the language, but no reference to it on the docs.

URL(s) of affected page(s)

https://processing.org/reference/

Proposed fix

Let's talk about EPSILON, a very small number.

Here an example of use from Golan Levin: https://github.com/golanlevin/Pattern_Master/blob/cbc80dbbb480336e64f6e98b21ec1674050ee78a/pattern_master/F04.pde

jeremydouglass commented 4 years ago

Interesting. Only five constants have their own reference pages -- the four PIs, plus TAU. Other than EPSILON, are there any other constants that you think should have reference pages?

villares commented 4 years ago

I'm not sure, I just found out about EPSILON today, reading Golan's code :D

That's a good question! Most other constants I can remember are documented in the context of the methods in which they usually work as selectors.

jeremydouglass commented 4 years ago

The tricky thing about EPSILON is it is an arbitrary value -- searching the Processing source it looks like it is mainly used for internal implementation of DXF export and for approximating a 0-length vector in P3D rotation? It isn't private, but I wonder what a reference for it would even say.

REAS commented 4 years ago

What goes in the HTML Reference and what remains only in the Javadoc is an ongoing discussion. I don't think EPSILON should have a page right now, but let's leave this open to see if others add opinions.