API-контракт
00 / consumes → providesCONSUMES
Canvas.widthPx
Canvas.heightPx
Line.role
Line.subrole?
Line.rigidity?
Line.pathGeometry.pathLengthShortN
Line.strokeWidthPx | targetWidth?
Line.opacity
StylePreset?
DEFERRED:
localContrast
crowding
occlusion
hierarchyTarget
PROVIDES
Line.widthN
Line.widthClass
Line.baseWeight
Line.contextualWeight
Line.weightDelta
Line.recomputeRequired
Line.weightDescriptor
DOES NOT OWN
global_hierarchy_score
negative_space_score
eye_flow_score
color_contrast_model
semantic_importance
balance_score
Модуль использует их только как входные модификаторы или цели.
Ключевое правило: толщина — геометрический параметр. Визуальный вес — оценка заметности. Они связаны, но не равны.
Нормализация толщины
01 / deterministic geometrywPx
physical stroke width
Фактическая толщина в пикселях.
wPx = renderer stroke width
wN
normalized width
Толщина относительно меньшей стороны холста.
wN = wPx / min(W,H)
ρ
width / length ratio
Относительная «массивность» линии.
rho = wPx / max(lengthPx, EPS)
Не использовать только пиксели: линия 8 px на 320×400 и 8 px на 4K-постере — это разные визуальные классы. Все правила генератора должны работать через
wN или через масштабируемый preset.Базовый визуальный вес
02 / intrinsic passBase weight
pathLengthFactor = clamp(
pow(pathLengthShortN, aL),
Lmin, Lmax
)
widthFactor = pow(wN / wRef, aW)
opacityFactor = pow(opacity, aA)
baseWeightMeasured =
widthFactor
* pathLengthFactor
* opacityFactor
// role is NOT part of measured weight
// role only defines targetWeightRange
HEURISTIC MODEL Коэффициенты должны быть калибруемыми. Формула задаёт устойчивый каркас, а не универсальную психофизическую истину.
Почему длина участвует
При одинаковой толщине линия, занимающая 70% поля, создаёт больше визуальной массы, чем штрих длиной 5% поля.
same widthN:
short accent → lower area occupancy
long divider → higher area occupancy
but:
length influence must saturate
so XL line does not grow weight infinitely
Поэтому pathLengthFactor должен иметь saturation/clamp.
Measured ≠ desired
02b / anti-circularityИзмеряем
baseWeightMeasured = f(
width,
pathLength,
opacity
)
Одинаковая физическая линия имеет один и тот же measured weight независимо от названия role.
Сравниваем с целью
targetWeightRange =
profile(role, subrole, hierarchyTarget)
weightFit = distance(
contextualWeight,
targetWeightRange
)
Role влияет на желаемый диапазон, но не переписывает измерение.
Контекстный пересчёт
03 / second passC
contrast modifier
Приходит из цвето-тонального модуля.
I
isolation modifier
Насколько линия окружена свободным пространством.
O
occlusion modifier
Какую долю линии реально видно.
K
crowding modifier
Насколько её окружение уже насыщено деталями.
contextualWeight = baseWeightMeasured
* contrastModifier
* isolationModifier
* visibleFractionModifier
* crowdingModifier
weightDelta = contextualWeight - previousContextualWeight
if abs(weightDelta) > recomputeThreshold:
recomputeRequired = true
Архитектурное разделение: Compo 2.06 не вычисляет контраст, crowding или global hierarchy. Он только принимает их от владельцев и пересчитывает собственную метрику.
Классы толщины
04 / candidate generationXS
hairline
0.0005 ≤ wN < 0.0015
сеточная, конструкционная, фоновая.
S
thin
0.0015 ≤ wN < 0.004
annotation, connector, technical line.
M
medium
0.004 ≤ wN < 0.012
divider, accent, visible trajectory.
L+
heavy / mass
0.012 ≤ wN ≤ 0.060+
линия становится самостоятельной массой.
INITIAL_HEURISTIC Эти границы не являются законом дизайна. Они нужны для candidate generation и должны калиброваться по типу носителя, DPI, дистанции просмотра и стилю.
Role → target weight
05 / role envelope| Role | Base target | Typical width class | Rule |
|---|---|---|---|
baseline | very low | XS | обычно construction-only; не конкурировать с текстом |
texture | low | XS–S | низкий contrast + высокая повторяемость |
annotation | low–mid | S | достаточно видима для связи, но не доминанта |
connector | mid | S–M | видимость зависит от длины и числа пересечений |
divider | mid | S–M | должен читать разделение, не становясь самостоятельным объектом без причины |
axis | low–mid | XS–M | зависит от visibility: construction или visible |
trajectory | mid–high | M | должна удерживать маршрут, но её вес проверяет eye-flow module |
accent | high | M–L+ | может стать локальной доминантой |
Визуальная лаборатория
06 / measurable examplesТонкая линия: низкий
wN, низкий intrinsic mass.Средняя линия: тот же span, но больший baseWeight.
Heavy stroke начинает читаться как геометрическая масса.
Высокая isolation: линия заметна сильнее при той же толщине.
Высокий crowding: та же линия имеет меньшую относительную заметность.
Подбор толщины по целевому весу
07 / inverse solverНе угадывать w
Если role/hierarchy задаёт целевой диапазон веса, solver должен подобрать толщину численно.
targetWeight = [Tmin,Tmax]
for widthCandidate in widthGrid:
base = computeBaseWeightMeasured(widthCandidate, pathLength)
if contextAvailable:
final = applyContext(base)
else:
final = base
choose width that minimizes:
distance(final, targetWeight)
+ rolePenalty
+ collisionPenalty
Corrective pass
if contextualWeight > targetMax:
try:
1 reduce contrast [other owner]
2 reduce widthN
3 shorten span [Compo 2.07]
4 move to less isolated zone
if contextualWeight < targetMin:
reverse strategy
Compo 2.06 предлагает width-correction, но не имеет права самостоятельно менять чужие параметры.
Собственные метрики
08 / ownershipOWNS
width_fit = scoreWidthAgainstRoleEnvelope()
base_weight_fit = scoreBaseWeightTarget()
context_weight_fit = scoreContextualWeightTarget()
weight_stability = 1 - clamp(abs(delta)/deltaMax,0,1)
localWeightScore =
a*width_fit
+ b*base_weight_fit
+ c*context_weight_fit
+ d*weight_stability
DEFERRED
global_hierarchy_score
balance_score
negative_space_score
eye_flow_score
semantic_importance
color_contrast_score
crowding_score
Ни одна из этих метрик не должна дублироваться внутри Compo 2.06.
Context overrides
09 / dependency graph| Source module | Input | Effect on 2.06 |
|---|---|---|
| Color/Tone future | localContrast | модифицирует contextualWeight, но не baseWeight |
| Hierarchy future | targetWeightRange | задаёт цель, под которую 2.06 подбирает width |
| Intersection / tangency future | visibleFraction | уменьшает perceptual contribution |
| Negative-space future | isolationModifier | может повысить вес линии в пустой зоне |
| Texture/rhythm modules | crowdingModifier | уменьшает относительную заметность в плотном поле |
Детерминированные тесты
10 / regressionTEST 01 · normalize
canvas = 1080×1350
wPx = 10
shortSide = 1080
expected widthN =
10 / 1080
≈ 0.00925926
TEST 02 · ordering
same length
same opacity
same role
wA = 0.003
wB = 0.009
expected:
baseWeight(B) > baseWeight(A)
TEST 03 · context
baseWeight = 0.50
contrast = 0.80
isolation = 1.10
visible = 0.75
crowding = 0.90
expected contextual ≈
0.50*0.80*1.10*0.75*0.90
= 0.297
TEST 04 · recompute
previous = 0.41
current = 0.49
threshold = 0.05
delta = 0.08
expected recomputeRequired = true
TEST 05 · no foreign ownership
input hierarchyTarget = 0.70..0.85
2.06 MAY:
change width proposal
2.06 MUST NOT:
recompute hierarchy_score
Data for layout engine
11 / machine contract{
"module": "Compo 2.06",
"name": "line_width_and_visual_weight",
"owner_of": [
"Line.widthN",
"Line.widthClass",
"Line.baseWeight",
"Line.contextualWeight",
"Line.weightDelta",
"Line.weightRecomputeRequired",
"line.width_fit",
"line.base_weight_fit",
"line.context_weight_fit",
"line.weight_stability"
],
"consumes": [
"Compo0.Canvas",
"Compo2.00.Line.role",
"Compo2.00.Line.subrole?",
"Compo2.00.Line.rigidity?",
"Compo2.00.LinePathGeometry.pathLengthShortN",
"Line.strokeWidthPx",
"Line.opacity",
"StylePreset"
],
"deferred_inputs": [
"localContrast",
"isolationModifier",
"visibleFractionModifier",
"crowdingModifier",
"hierarchyTargetWeightRange"
],
"defaults": {
"width_reference_norm": {"value":0.004,"source":"INITIAL_HEURISTIC"},
"width_exponent": {"value":0.85,"source":"INITIAL_HEURISTIC"},
"length_exponent": {"value":0.35,"source":"INITIAL_HEURISTIC"},
"opacity_exponent": {"value":1.0,"source":"INITIAL_HEURISTIC"},
"recompute_threshold": {"value":0.05,"source":"INITIAL_HEURISTIC"}
},
"width_classes": {
"XS": [0.0005,0.0015],
"S": [0.0015,0.0040],
"M": [0.0040,0.0120],
"L_PLUS": [0.0120,0.0600]
},
"pipeline": [
"normalize_width",
"compute_base_weight",
"classify_width",
"receive_context_modifiers_if_available",
"compute_contextual_weight",
"compare_to_target_range",
"propose_width_correction",
"flag_recompute_if_delta_exceeds_threshold"
],
"finality": "LOCAL_AND_CONTEXTUAL_PROPOSAL_ONLY",
"rule": "role/hierarchy set targetWeightRange only; measured weight never contains roleBaseFactor; Compo 2.06 owns width/pathLength/opacity → measuredWeight conversion"
}