dymokomi/luce-cad
Source of release 0.9.2
0.9.2 / tests / contracts / sketch_shapes_contract.lucb
## The sketch's free-form curves (sketch/shapes.lucb): a control point
## spline from its first point to its last, a fit point spline through its
## points, an ellipse's samples on it, a rho 0.5 conic a parabola; their
## text read back; Curvature holding a spline's end as curved as an arc,
## Tangent along a line, a point solved onto an ellipse; removing a
## spline's point takes the spline and its points; a text set at its
## height, reading back.
from luce_std import math
from luce_geocore.geocore import Vector3
from solids import CadSolids
from modeling import CadModeling
from luce_geocore.geocore import invalid
from luce_geocore.core.growing import Growing
from sketch import break_curve, remove_entity, Sketch, Net, CadProjection, add_shadow, relink_sketch, projection_samples, projection_per_edge, Lettering, new_lettering, letter, new_sketch, solve_sketch, ConstraintKind, EntityKind, write_sketch, read_sketch, new_net, net_of, end_curvature_factor, spline_degree
pub func sketch_shapes_contracts() -> !:
try nets()
try constraints()
try removal()
try lettering()
try projection()
func nets() -> !:
var s = new_sketch()
defer s.close()
var points = Growing[i64]()
defer points.close()
for (x, y) in [(0.0, 0.0), (10.0, 5.0), (20.0, -5.0), (30.0, 5.0), (40.0, 0.0), (50.0, 3.0)]:
try points.push(try s.add_point(x, y))
let control = try s.add_spline(points.view(), false)
var net = new_net()
defer net.close()
try net_of(&s, s.entity(control), &net)
if net.degree != 5 or net.count() != 6: error(invalid, "six control points do not make a quintic")
let (low, high) = net.range()
try at_point(&net, low, 0.0, 0.0)
try at_point(&net, high, 50.0, 3.0)
# Through four points: at each point's chord-length parameter.
let fit = try s.add_spline(points.view()[..<4], true)
try net_of(&s, s.entity(fit), &net)
if net.degree != 3: error(invalid, "four fit points do not make a cubic")
var total = 0.0
var lengths: f64[4] = [0.0, 0.0, 0.0, 0.0]
for at in 1..<(usize)4:
total += math.hypot(s.x(points.items[at]) - s.x(points.items[at - 1]), s.y(points.items[at]) - s.y(points.items[at - 1]))
lengths[at] = total
for at in 0..<(usize)4:
try at_point(&net, lengths[at] / total, s.x(points.items[at]), s.y(points.items[at]))
# An ellipse about (5, 5), its major axis 4 along x, minor 2.
let ellipse = try s.add_ellipse(try s.add_point(5.0, 5.0), try s.add_point(9.0, 5.0), 2.0)
try net_of(&s, s.entity(ellipse), &net)
var samples = Growing[f64]()
defer samples.close()
try net.sample(60, &samples)
for k in 0..<samples.count // 2:
let x = (samples.items[2 * k] - 5.0) / 4.0
let y = (samples.items[2 * k + 1] - 5.0) / 2.0
try near(x * x + y * y, 1.0)
# A parabola (rho 0.5): its middle a quarter of the way to the apex.
let conic = try s.add_conic(try s.add_point(0.0, 0.0), try s.add_point(10.0, 0.0), try s.add_point(5.0, 10.0), 0.5)
try net_of(&s, s.entity(conic), &net)
try at_point(&net, 0.5, 5.0, 5.0)
# Their text reads back the same.
var text = Growing[u8]()
defer text.close()
try write_sketch(&s, &text)
var back = try read_sketch((str)text.view())
defer back.close()
var again = Growing[u8]()
defer again.close()
try write_sketch(&back, &again)
if (str)text.view() != (str)again.view(): error(invalid, "free-form curves do not read back from their text")
## A spline starting at an arc's end, held as curved as it; a spline's end
## along a line; a point onto an ellipse.
func constraints() -> !:
var s = new_sketch()
defer s.close()
let center = try s.add_point(0.0, 0.0)
let start = try s.add_point(10.0, 0.0)
let end = try s.add_point(0.0, 10.0)
let arc = try s.add_arc(center, start, end)
_ = try s.constrain(ConstraintKind.fix, arc)
var points = Growing[i64]()
defer points.close()
try points.push(end)
for (x, y) in [(-3.0, 11.0), (-6.0, 11.0), (-10.0, 9.0), (-14.0, 9.0)]:
try points.push(try s.add_point(x, y))
let spline = try s.add_spline(points.view(), false)
# The arc turns counterclockwise (positive curvature) leaving its end
# toward -x: the spline carries on the same way.
_ = try s.constrain(ConstraintKind.curvature, spline, arc, value = 1.0, side = 1.0)
let solved = try solve_sketch(&s)
if not solved.converged: error(invalid, "a spline curving with an arc does not solve")
let e = s.entity(spline)
let p0 = s.spline_point(e, 0)
let p1 = s.spline_point(e, 1)
let p2 = s.spline_point(e, 2)
let d1x = s.x(p1) - s.x(p0)
let d1y = s.y(p1) - s.y(p0)
try near((d1x * s.x(p0) + d1y * s.y(p0)) / math.hypot(d1x, d1y), 0.0)
let cross = d1x * (s.y(p2) - s.y(p1)) - d1y * (s.x(p2) - s.x(p1))
let length = math.hypot(d1x, d1y)
try near(end_curvature_factor(e.second, spline_degree(e)) * cross / (length * length * length), 0.1)
# Along a line: its last control point's direction.
let line = try s.add_line(try s.add_point(-20.0, -5.0), try s.add_point(-10.0, -5.0))
_ = try s.constrain(ConstraintKind.tangent, spline, line, side = -1.0)
if not (try solve_sketch(&s)).converged: error(invalid, "a spline's end along a line does not solve")
let n = e.second
try near(s.y(s.spline_point(e, n - 1)) - s.y(s.spline_point(e, n - 2)), 0.0)
# A point onto an ellipse.
let ellipse = try s.add_ellipse(try s.add_point(40.0, 0.0), try s.add_point(46.0, 0.0), 3.0)
let loose = try s.add_point(45.0, 4.0)
_ = try s.constrain(ConstraintKind.on_curve, loose, ellipse)
if not (try solve_sketch(&s)).converged: error(invalid, "a point onto an ellipse does not solve")
# (The ellipse moves too: least motion.)
let o = s.entity(ellipse)
let ux = s.x(o.third) - s.x(o.first)
let uy = s.y(o.third) - s.y(o.first)
let a = math.hypot(ux, uy)
let wx = s.x(loose) - s.x(o.first)
let wy = s.y(loose) - s.y(o.first)
let x = (wx * ux + wy * uy) / (a * a)
let y = (ux * wy - uy * wx) / (a * s.radius_of(ellipse))
try near(x * x + y * y, 1.0)
## Removing a spline's point takes the spline; what is left reads back.
func removal() -> !:
var s = new_sketch()
defer s.close()
var points = Growing[i64]()
defer points.close()
for at in 0..<(usize)4: try points.push(try s.add_point((f64)at, (f64)(at % 2)))
let line = try s.add_line(try s.add_point(0.0, 5.0), try s.add_point(5.0, 5.0))
_ = try s.add_spline(points.view(), true)
try remove_entity(&s, points.items[2])
for e in s.entities.view():
if e.kind == EntityKind.spline: error(invalid, "a spline without one of its points stays")
# Its other points went with it (nothing else used them): the line's
# two points and the line are left.
_ = line
if s.entities.count != 3 or s.entity(2).kind != EntityKind.line or s.lists.count != 0: error(invalid, "removing a spline's point renumbers badly")
func at_point(net: const Net*, t: f64, x: f64, y: f64) -> !:
let (px, py) = net.at(t)
if math.hypot(px - x, py - y) > 1e-7 * math.max(1.0, math.hypot(x, y)):
error(invalid, "a net is not where it should be")
func near(value: f64, expected: f64) -> !:
if math.abs(value - expected) > 1e-6 * math.max(1.0, math.abs(expected)):
error(invalid, "a solved free-form curve is not where it should be")
## "Hi" 10 tall in the system's sans: its H from the baseline to 10 up;
## text with a space and a newline reads back from its text.
func lettering() -> !:
var s = new_sketch()
defer s.close()
let text = try s.add_text(try s.add_point(0.0, 0.0), 10.0, "Hi", "")
var letters = new_lettering()
defer letters.close()
try letter(&s, s.entity(text), &letters)
if letters.count() < 8: error(invalid, "a text has too few outline pieces")
var low = 1e300
var high = -1e300
for y in letters.ys.view():
low = math.min(low, y)
high = math.max(high, y)
if math.abs(low) > 0.05 or math.abs(high - 10.0) > 0.5: error(invalid, "a text's capitals are not its height")
_ = try s.add_text(try s.add_point(0.0, -20.0), 5.0, "two words\n100% sure", "")
var written = Growing[u8]()
defer written.close()
try write_sketch(&s, &written)
var back = try read_sketch((str)written.view())
defer back.close()
var again = Growing[u8]()
defer again.close()
try write_sketch(&back, &again)
if (str)written.view() != (str)again.view() or back.text_content(back.entity((i64)back.entities.count - 1)) != "two words\n100% sure":
error(invalid, "a text does not read back from its text")
## A 20 mm box's edges cast onto the plane 30 above it (XZ seen from
## above): its four top edges and four bottom edges land on one square,
## its upright edges are points; a top edge projected is a fixed line,
## linked; the box made taller and relinked, the line stays (it is the
## same square), and the text reads the link back.
func projection() -> !:
let box = try CadModeling.tagged(try CadSolids.box(20.0, 20.0, 20.0), "#1")
defer box.release()
let origin = Vector3(0.0, 30.0, 0.0)
let u = Vector3(1.0, 0.0, 0.0)
let v = Vector3(0.0, 0.0, -1.0)
let cast = try CadProjection.of(box, origin, u, v)
defer cast.release()
let p = try cast.get()
if p.edge_count() != 12: error(invalid, "a box does not cast twelve edges")
# A top or bottom edge passes (10, 0) on the plane.
let edge = p.nearest(10.0, 0.0, 0.5)
if edge < 0: error(invalid, "no edge's shadow passes the box's side")
var s = new_sketch()
defer s.close()
var reference = try p.reference(edge)
defer reference.release()
let per = projection_per_edge()
let line = try add_shadow(&s, projection_samples(p)[(usize)edge * 2 * per..<((usize)edge + 1) * 2 * per], reference.value)
let e = s.entity(line)
if e.kind != EntityKind.line or s.links.count != 1: error(invalid, "a box's edge does not cast a linked line")
try near(math.abs(s.x(e.first)), 10.0)
try near(math.abs(s.x(e.second)), 10.0)
if (try relink_sketch(&s, box.value(), origin, u, v)) != 0: error(invalid, "a box's edge is not found again")
var text = Growing[u8]()
defer text.close()
try write_sketch(&s, &text)
var back = try read_sketch((str)text.view())
defer back.close()
if back.links.count != 1 or back.link_reference(back.links.items[0]) != reference.value: error(invalid, "a projected curve's link does not read back")
# A shadow broken at a crossing is its own curve now: it no longer
# follows its edge.
let x = s.x(e.first)
let y = (s.y(e.first) + s.y(e.second)) * 0.5
_ = try s.add_line(try s.add_point(x - 5.0, y), try s.add_point(x + 5.0, y))
try break_curve(&s, line, x, y + 1.0)
if s.links.count != 0: error(invalid, "a broken shadow still follows its edge")