GraphPoint is distributed using the Swift Package Manager. To install it into a project, add it as a
dependency within your
let package = Package( ... dependencies: [ .package(url: "https://github.com/richardpiazza/GraphPoint.git", from: "4.0.0") ], ... )
Then import GraphPoint wherever you'd like to use it:
GraphPoint relies heavily on the Swift2D library, which reimplements
Point in a cross-platform, non-Foundation reliant way.
CoreGraphics aliases have been deprecated and replaced by their Cartesian counterparts. These type-aliases and
GraphPointUI will be removed in a future version.
There are several key aspects to understand when using GraphPoint.
A Cartesian plane is defined by two perpendicular number lines: the x-axis, which is horizontal, and the y-axis, which is vertical. Using these axes, we can describe any point in the plane using an ordered pair of numbers.
In GraphPoint ever rectangle is a cartesian plane with the origin at the center.
Rect contained within a
CartesianPlane with an
origin relative to the
cartesianOrigin of the plane. For example:
// Visualize graph paper with axes extending 50 points in all four directions from the center of the paper. let plane = CartesianPlan(size: Size(width: 100, height: 100)) // A 10x10 piece of paper is placed on top of the graph paper; placed 40 points from both the top and left edges. let rect = Rect(origin: Point(x: 40, y: 40), size: Size(width: 10, height: 10)) // In relation to the graph, the smaller rectangle would have an 'origin' at (-10, 10). let cartesianFrame = plane.rect(for: rect) cartesianFrame == Rect(origin: Point(x: -10, y: 10), size: Size(width: 10, height: 10))
A point within a
CartesianPlane. The x & y coordinates of a
CartesianPoint represent the offset from the planes 'origin' (0, 0).