mirror of
https://github.com/retroSoC/retroSoC.git
synced 2026-11-04 22:32:36 +00:00
maksyuki
491d38fd0e
- Introduced scoped typography rules for compact cells and emphasized labels in the SoC functional overview. - Updated the diagram to utilize new typography settings, including size adjustments for CDC and Gateway labels. - Implemented geometry validation for SoC diagrams to ensure proper routing and clearance between elements. - Added comprehensive tests for geometry validation, PDF typography checks, and compact text handling. - Created new Python modules for shared geometry and PDF-bound typography checks to streamline validation processes. - Enhanced documentation to clarify typography requirements and routing styles for SoC diagrams.
81 lines
3.0 KiB
Python
81 lines
3.0 KiB
Python
"""Small-type exceptions stay inside their renderer-bound layout regions."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
import pytest
|
|
|
|
sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
|
|
from publications.build_datasheet import validate_character_size # noqa: E402
|
|
|
|
|
|
REGION = {"kind": "table-continuation", "page": 2,
|
|
"x": 54, "y": 60, "width": 300, "height": 20}
|
|
|
|
|
|
def character(**overrides):
|
|
return {"text": "x", "size": 8.5, "x0": 55, "x1": 60,
|
|
"top": 61, "bottom": 69.5, **overrides}
|
|
|
|
|
|
def test_continuation_size_allowed_only_inside_its_region():
|
|
validate_character_size(character(), 2, [REGION])
|
|
validate_character_size(character(size=9), 1, [])
|
|
|
|
|
|
@pytest.mark.parametrize("overrides,page,regions", [
|
|
({}, 2, []),
|
|
({}, 1, [REGION]),
|
|
({"x0": 53}, 2, [REGION]),
|
|
({"x1": 355}, 2, [REGION]),
|
|
({"top": 59}, 2, [REGION]),
|
|
({"bottom": 81}, 2, [REGION]),
|
|
({}, 2, [{**REGION, "kind": "ordinary-caption"}]),
|
|
])
|
|
def test_unmarked_or_partly_outside_text_keeps_nine_point_minimum(overrides, page, regions):
|
|
with pytest.raises(ValueError, match="smaller than 9 pt"):
|
|
validate_character_size(character(**overrides), page, regions)
|
|
|
|
|
|
def test_even_marked_continuation_text_cannot_shrink_below_eight_point_five():
|
|
with pytest.raises(ValueError, match="smaller than 8.5 pt"):
|
|
validate_character_size(character(size=8), 2, [REGION])
|
|
|
|
|
|
def test_quarter_turn_uses_rendered_font_height_not_glyph_advance():
|
|
validate_character_size(character(size=2.2, width=9, matrix=(0, 1, -1, 0, 0, 0)), 1, [])
|
|
with pytest.raises(ValueError, match="smaller than 9 pt"):
|
|
validate_character_size(character(size=12, width=8, matrix=(0, -1, 1, 0, 0, 0)), 1, [])
|
|
|
|
|
|
def test_wide_upright_or_slanted_glyph_does_not_bypass_type_minimum():
|
|
for matrix in [(1, 0, 0, 1, 0, 0), (.7, .7, -.7, .7, 0, 0)]:
|
|
with pytest.raises(ValueError, match="smaller than 9 pt"):
|
|
validate_character_size(character(size=8, width=12, matrix=matrix), 1, [])
|
|
|
|
|
|
COMPACT = {**REGION, "kind": "soc-compact", "id": "gca"}
|
|
|
|
|
|
def test_eight_point_type_is_allowed_in_approved_cdc_or_gateway_cell():
|
|
validate_character_size(character(size=8), 2, [COMPACT])
|
|
validate_character_size(character(size=3, width=8, matrix=(0, 1, -1, 0, 0, 0)), 2, [COMPACT])
|
|
validate_character_size(character(size=8), 2, [{**COMPACT, "id": "gwa"}])
|
|
|
|
|
|
@pytest.mark.parametrize("changes,region", [
|
|
({"x0": 53.9}, COMPACT), ({"top": 59.9}, COMPACT),
|
|
({}, {**COMPACT, "page": 1}), ({}, {**COMPACT, "id": "ordinary-ip"}),
|
|
({}, {**COMPACT, "kind": "soc-bus"}), ({}, {**COMPACT, "kind": "soc-emphasis-region"}),
|
|
])
|
|
def test_compact_exception_does_not_leak_into_other_text(changes, region):
|
|
with pytest.raises(ValueError, match="smaller than 9 pt"):
|
|
validate_character_size(character(size=8, **changes), 2, [region])
|
|
|
|
|
|
def test_compact_text_still_has_eight_point_floor():
|
|
with pytest.raises(ValueError, match="smaller than 8 pt"):
|
|
validate_character_size(character(size=7.8), 2, [COMPACT])
|