Documentation clarification.
This commit is contained in:
@@ -18,25 +18,25 @@ certain design goals.
|
|||||||
|
|
||||||
* The library is specialized on the primitive types rather than attempting to
|
* The library is specialized on the primitive types rather than attempting to
|
||||||
support all types in a single class hierarchy. `pythagoras.f` and
|
support all types in a single class hierarchy. `pythagoras.f` and
|
||||||
`pythagoras.d` provide essentially the same functionality using 32-bit and
|
`pythagoras.d` provide equivalent functionality using 32-bit and 64-bit
|
||||||
64-bit floating point values throughout. `pythagoras.i` is specialized on int
|
floating point values throughout. `pythagoras.i` is specialized on int and
|
||||||
and contains none of the curved geometry classes. It is targeted toward
|
contains none of the curved geometry classes.
|
||||||
applications that need "pixel geometry".
|
|
||||||
|
|
||||||
* The library supports garbage creation avoidance for applications which are
|
* The library supports garbage creation avoidance (for applications which are
|
||||||
sensitive to garbage collection pauses, like video games. For example, in
|
sensitive to garbage collection pauses, like video games). For example, in
|
||||||
cases where entities return a `Rectangle` containing their bounds, a
|
cases where entities return a `Rectangle` containing their bounds, a
|
||||||
corresponding method exists which accepts a `Rectangle` into which to write
|
corresponding method exists which accepts a `Rectangle` into which to write
|
||||||
the bounds.
|
the bounds. Further work is needed here, as some of the implementation
|
||||||
|
internals create garbage that could be avoided.
|
||||||
|
|
||||||
* The library attempts to minimize the size of its instances, by avoiding the
|
* The library attempts to minimize the size of its instances by avoiding the
|
||||||
inclusion of any fields that are not essential to the function of a
|
inclusion of any fields that are not essential to the function of a
|
||||||
particular geometry entity. Thus no cached hash codes or cached computed
|
particular geometric entity. For example, no cached hash codes or cached
|
||||||
bounds are maintained.
|
computed bounds are maintained.
|
||||||
|
|
||||||
* Helper methods associated with a given geometric primitive are separated into
|
* Helper methods associated with a given geometric primitive are separated into
|
||||||
a separate utility class for that primitive. For example line-related
|
a utility class for each primitive. For example line-related primitives are
|
||||||
primitives are in a class named `Lines`.
|
in a class named `Lines`.
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user