raygeo.sketch.constraints.equal_length
EqualLengthConstraint
Enforces equal characteristic lengths, one residual per (base_a, base_b, other_a, other_b) tuple.
The caller expands the entities' characteristic-length pairs (including the shorter-side fallback)
into flat tuples.
pairs
pairs: list[list[int]]
Resolved characteristic-length pairs.
constrains_radius()
constrains_radius(registry: registry.EntityRegistry, entity_id: int) -> bool
Whether this constraint explicitly defines the radius/length of the given entity, matched through the registry by its defining points.
| Parameter | Type | Description |
|---|---|---|
registry | registry.EntityRegistry | |
entity_id | int | |
| Returns | bool |
error()
error(registry: registry.EntityRegistry) -> list[float]
Returns the constraint error at the registry's point positions.
| Parameter | Type | Description |
|---|---|---|
registry | registry.EntityRegistry | |
| Returns | list[float] |
is_hit()
is_hit(
mx: float,
my: float,
threshold: float,
registry: registry.EntityRegistry,
to_screen: Optional[Any] = None,
) -> bool
Whether the constraint's rendered symbol is hit at (mx, my).
| Parameter | Type | Description |
|---|---|---|
mx | float | |
my | float | |
threshold | float | |
registry | registry.EntityRegistry | |
to_screen | Optional[Any] = None | |
| Returns | bool |
set_user_visible()
set_user_visible(value: bool) -> None
Sets the reference user-visibility flag.
| Parameter | Type | Description |
|---|---|---|
value | bool | |
| Returns | None |
targets_segment()
targets_segment(
p1: int,
p2: int,
entity_id: Optional[int],
registry: registry.EntityRegistry,
) -> bool
Whether this constraint restricts the length of the given entity, matched through the registry by its defining points (the point ids are ignored, mirroring the reference).
| Parameter | Type | Description |
|---|---|---|
p1 | int | |
p2 | int | |
entity_id | Optional[int] | |
registry | registry.EntityRegistry | |
| Returns | bool |
to_dict()
to_dict() -> dict
Serializes to the reference constraint dictionary shape.
| Parameter | Type | Description |
|---|---|---|
| Returns | dict |
user_visible()
user_visible() -> bool
Reference user-visibility flag.
| Parameter | Type | Description |
|---|---|---|
| Returns | bool |