§6 · Подписи и автораскладка

Подпись в AnimaGeo — отдельный TeX-объект, не часть элемента. Позиция задаётся парой: 9-точечный якорь + pixel-offset. Для сложных сцен работает автоматическая раскладка: жадный решатель минимизирует перекрытия, углы размещаются аналитически по биссектрисе.

Базовое управление

9-точечный якорь

• BL — GeoGebra-default. Подпись справа-сверху от точки (базовая линия заглавных лежит на y).
• MC — центр bbox. Используется для подписей углов и для canonicalize_anchor=true-режима автораскладки.
• TC / BC — подпись сверху/снизу от точки.
• ML / MR — слева/справа от точки.

Как смотрится каждый якорь

BL (справа-сверху)

BC (сверху)

TC (снизу)

MR (слева)

MC (поверх)

Offset — сдвиг подписи

offset=[dx, dy] — в пикселях, после якорения. По конвенции математических координат: положительный y направлен вверх. При смене px_size offset остаётся pixel-invariant (делится на ptUnit_ggb, зафиксированный на момент импорта).

offset · правьте координаты; смещения подписей — через overrides

P = Point(-2, 0)
Q = Point(2, 0)

style(P, Q, label_visible=True)
P.style.label_offset_px = [0, 0]
Q.style.label_offset_px = [14, 16]

Скачать: 16-label-offsets.py

TeX и Unicode

Подписи компилируются через pdfLaTeX с шаблоном RusTex (T2A + babel russian + utf8). В ui.py есть кастомная обработка дробей, уменьшенные \angle и \triangle, и словарь автозамен Unicode → TeX.

шесть типичных TeX-подписей

Автозамена Unicode

В ui.py::correctedLabel() прописан словарь из 96 замен:

·   → \cdot         α → \alpha      △ → \triangle
×   → \times        β → \beta       ∠ → \angle
∈   → \in           π → \pi         ±  → \pm
⇔   → \Leftrightarrow                ∞  → \infty
...

Следствие: можно писать label = 'α + β = γ' обычным Unicode — TeX получит корректное $\alpha + \beta = \gamma$. Удобно, если источник подписей — таблица, CSV или GGB-файл с Unicode-текстом.

Автораскладка

Когда подписей много, они начинают перекрывать друг друга и сами элементы. AnimaGeo решает это автоматически: вызовите scene.autoPlaceLabels() перед exportSVG.

Алгоритм — жадный решатель с приоритетом:

1. Для каждой подписи генерируется 8 кандидатов (E, NE, N, NW, W, SW, S, SE) на базовом расстоянии distance_px.
2. Каждому кандидату назначается штраф: за направление относительно «идеального», за пересечение с другими подписями, за пересечение с геометрией.
3. Подписи сортируются по «сложности» (мало свободных позиций → первыми) и размещаются жадно.
4. Если все 8 кандидатов имеют штраф — радиус ступенчато увеличивается (до +10 px) пока не найдётся чистая позиция.

Для углов — аналитика вместо 8 вариантов: подпись садится на биссектрису, отодвигается на arc_r + half_label_size + gap_arc_px.

До и после

до: offset из GGB или дефолты

после autoPlaceLabels()

autoPlaceLabels · попробуйте сдвинуть точку C и пересчитать

A = Point(-2, 1.5)
B = Point(2, 1.5)
C = Point(0, -1.5)
s1 = Segment(A, C)
s2 = Segment(B, C)
s3 = Segment(A, B)
M = Midpoint(A, B)
D = Midpoint(A, C)
E = Midpoint(B, C)

style(A, B, C, D, E, M, label_visible=True)

Скачать: guide_style.json

Углы: два независимых зазора

Подпись угла садится на биссектрисе снаружи дуги. Две независимые величины определяют, насколько далеко:

• angle_gap_arc_px — расстояние от внешней дуги до ближайшей стороны bbox подписи. Базово: dist = arc_r + max(hw, hh) + gap_arc_px.
• angle_gap_sides_px — зазор от сторон угла до bbox (narrow-angle clamp). Для острых углов bbox «зажимается в воронку»; clamp отодвигает подпись дальше по биссектрисе: dist ≥ (half_diag + gap_sides_px) / sin(half_angle).

arc_r — это эффективный внешний радиус: для одной дуги равен arc_size_px; при lines ≥ 2 — arc_size_px + (lines − 1) × ang_rshift. Подпись автоматически уходит за самую внешнюю дугу, не налезая.

Ручная блокировка

scene.element('A').style['label_placement_locked'] = True
scene.element('A').style['label_offset_px'] = [10, -5]
# autoPlaceLabels обойдёт A стороной; ручной offset останется.

Конфигурация автораскладки

Все параметры — в overlay.label_placement в JSON-стиле:

Подписи в анимации

Три режима работы в анимации:

Рекомендуемая конфигурация для keyframes

"rendering": {
    "label_placement": {
        "enabled":              true,
        "keyframe_snapshots":   true,
        "dynamic_angles":       true,
        "canonicalize_anchor":  true,
        "interpolation":        "smooth"
    }
}

Что получается: на каждом keyframe solver находит лучшую раскладку, все подписи приводятся к якорю MC (исключает скачки между кадрами), offset-ы плавно интерполируются smoothstep-ом, биссектрисы углов обновляются аналитически каждый кадр.

Живые примеры — в §8 (Анимации).