Geometric Primitives
VisualGeometryToolkitCore provides 2D geometric primitives with homogeneous matrix representations.
Points and Rectangles
Points
using GeometryBasics
# 2D points (from GeometryBasics, re-exported)
p = Point2(100.0, 150.0)
p = Point2f(100.0, 150.0) # Float32 version
# 3D points
p3d = Point3(100.0, 50.0, 0.0)Rectangles
# Create rectangle from origin and size
origin = Point2(10.0, 20.0)
size = Vec2(100.0, 50.0)
rect = Rect(origin, size)
# Or from intervals
using IntervalSets
x_range = ClosedInterval(10.0, 110.0)
y_range = ClosedInterval(20.0, 70.0)
rect = Rect(x_range, y_range)
# Utility functions
c = centroid(rect) # Get center pointCircles
# Create circle
center = Point2(100.0, 150.0)
radius = 25.0
circle = Circle(center, radius)
# Scale (dilate) circle
larger_circle = dilate(circle, 2.0) # 2× larger radius, same centerHomogeneous Circle Matrix
Circles can be represented as 3×3 symmetric matrices:
# Convert circle to matrix form
Q = HomCircleMat(circle)
# Transform circle with HomographyMap
H = HomographyMap(HomographyMat(camera))
Q′ = H(circle) # a Conic; Ellipse(Q′) once classify_conic(Q′) isa EllipseTrait
# Or work with conic matrices directly via matrix multiplication
H_mat = SMatrix{3,3}(HomographyMat(camera))
Q_transformed = inv(H_mat)' * SMatrix{3,3}(Q) * inv(H_mat)Ellipses
# Create ellipse
center = Point2(100.0, 150.0)
a = 30.0 # Semi-major axis
b = 20.0 # Semi-minor axis
θ = π/4 # Rotation angle
ellipse = Ellipse(center, a, b, θ)
# From a homogeneous matrix of unknown class: a Conic (no class check), then
# classify — HomEllipseMat(M) itself throws for anything but a real ellipse
Q = Conic(M)
if is_ellipse(Q)
ellipse = Ellipse(Q)
end
# Dilate ellipse
larger_ellipse = dilate(ellipse, 2.0) # 2× larger, same centerEllipse Properties
c = centroid(ellipse) # Center point
gradient(ellipse, point) # Gradient at a point on the ellipseGeometric Queries
Containment and Intersection
# Check if point is inside a shape
point ∈ circle # Returns true/false
point in ellipse # Same using 'in' operator
# Check intersection between shapes
intersects(circle1, circle2)
intersects(ellipse, rect)
intersects(rect1, rect2)Conic Classification
# Check if a conic matrix represents an ellipse (a Conic: any class; a
# HomEllipseMat is one by construction, its checked constructor refuses the rest)
Q = Conic(M)
is_ellipse(Q) # a real, non-degenerate ellipse?
# Classify the conic
trait = classify_conic(Q)
# For a conic matrix: EllipseTrait(), ParabolaTrait(), HyperbolaTrait() or
# DegenerateTrait(); CircleTrait() comes from classify_conic(::Circle)Transformations
Homogeneous Representations
All primitives can be converted to homogeneous matrix form:
# Circles → 3×3 symmetric matrix
circle = Circle(Point2(0.0, 0.0), 10.0)
Q_circle = HomCircleMat(circle)
# Ellipses → 3×3 symmetric matrix
ellipse = Ellipse(Point2(0.0, 0.0), 20.0, 10.0, 0.0)
Q_ellipse = HomEllipseMat(ellipse)Transforming Shapes
Use HomographyMap to transform shapes:
# Create homography and wrap for callable syntax
H_mat = HomographyMat(camera)
H = HomographyMap(H_mat)
# Transform circles. A general homography returns a `Conic` — an ellipse
# for a circle in view, a hyperbola for one crossing the line at infinity.
Q = H(circle)
if classify_conic(Q) isa EllipseTrait
ellipse = Ellipse(Q) # valid ellipse in view
endAffine Transforms
using Rotations: RotMatrix
using StaticArrays: SVector
# A similarity: 2× scaling, a 45° rotation, a translation (x ↦ s·R·x + t)
S = SimilarityMap(2.0, RotMatrix{2}(π/4), SVector(10.0, 20.0))
# Apply to shapes - a similarity preserves circles
transformed_circle = S(circle) # Returns Circle (radius doubled)Working with Units
Unit constants (mm, μm, px, dpi, …) and the quantity machinery are exported from the main module (FlexUnits-based; see Getting Started). Geometric storage is unitless (lengths in mm, pixels in px); units are enforced at API boundaries (e.g. sensor pitches, focal lengths, metric tolerances) by stripping in a named unit (ustrip(mm, q)) or comparing dimension(q) == dimension(mm). A pixel is dimensionless, so a pixel-sized parameter can refuse a length but not an angle.
Feature Frames
The transformation-based feature primitives — Disc (center + σ), OrientedDisc (+ orientation), EllipticFrame (+ aspect/shape), AffineFrame — represent detections geometrically; each defines AffineMap(frame) mapping canonical coordinates to its image-space support. Paraboloid3D is the quadratic surface used for refinement fits. The detectors that produce them live in VisualGeometryToolkitFeatures.
See Also
- Primitives API Reference
- Transforms Guide - Transforming primitives
- Cameras Guide - Projecting primitives with cameras