SHA256
91 lines
9.6 KiB
Markdown
91 lines
9.6 KiB
Markdown
# Связи V4 — статический Canvas 2D
|
||
|
||
Вводится отдельный вариант **V4 · Canvas** в селекторе версий «Связи». V1, V2 и V3 остаются доступны.
|
||
Ни сервер, ни API, ни блокчейн не меняются.
|
||
|
||
## Данные и управление
|
||
|
||
V4 использует ту же страницу `network-explorer/network-view.js` через `renderExplorer(context, { canvas: true })`:
|
||
передача `graph-model.js`, кэш IndexedDB, загрузка X2, глубина 0–4, фильтры «Близкие»/«Сияющие»,
|
||
поиск, сброс кэша и хранение координат являются общими для V3 и V4. Если пользователь перемещает
|
||
узел, координаты сохраняются точно так же, как в V3. Разрешено перерисовать весь граф при приходе
|
||
новых данных; перерасчёт модели не превращается в бесконечную анимацию.
|
||
|
||
V4 поддерживает мышь/сенсорный экран: перетаскивание сцены и узлов, масштабирование колесом
|
||
и щипком, короткое и долгое нажатие, контекстное меню правой кнопкой. Групповое перетаскивание
|
||
исторических центров из общего движка V1 для модели V3 не применяется.
|
||
|
||
`ZOOM_MIN = 0.55`, `ZOOM_MAX = 2.2`, `DIVE_ZOOM = 1.7`. Параметр `DIVE_ZOOM`
|
||
используется в методе `recenter` движка; обычный выбор пользователя, как и V3, обрабатывается
|
||
страницей с обновлением центра исследуемой сети.
|
||
|
||
## Рисование
|
||
|
||
- Слой №1 Canvas — связи; слой №2 — сияние, аватары, значки официальных пользователей, подписи.
|
||
- Для каждой вершины изображение собирается в спрайт: внешняя стеклянная кромка V3
|
||
(`/assets/glass_overlay_faithful.png`) рисуется под круглой **непрозрачной** фотографией/инициалами.
|
||
Дополнительных цветных ободков V2 нет. Непрозрачная подложка под кромкой закрывает концы линий.
|
||
- У сияющих есть **статическая** аура. Фотография остаётся поверх стекла и сияния;
|
||
типы отношений кодируются цветами самих связей.
|
||
- Подписи V2: округлая полупрозрачная плашка, компактное «Имя Ф.» (кроме центра),
|
||
приоритет важных узлов, проверка пересечений и перенос плашки над узлом при необходимости.
|
||
- Взаимная связь со встречными разными типами получает градиент от первого цвета ко второму.
|
||
Для односторонней связи яркость плавно падает в сторону адресата.
|
||
- Между двумя сияющими пользователями рисуется трёхслойный неон V3 на кривой:
|
||
размытое поле, размытая трубка и светлая сердцевина. Для остальных пар — тонкая
|
||
двухпроходная цветная линия. Односторонние сияющие линии сохраняют статичный пунктир V3.
|
||
Пульсация и бегущие штрихи отсутствуют.
|
||
- **Все вершины направляются на отрисовку**, даже если они за кадром. Для читабельности
|
||
пересекающиеся текстовые плашки могут пропускаться. Связи также не отсекаются по viewport.
|
||
- Спрайты повторно используются при движении карты и пересоздаются только при изменении фото,
|
||
вида/разрешения или темы. Размер кэшированных спрайтов подстраивается под zoom и DPR,
|
||
а общий расчётный бюджет изображений ограничен примерно 96 МБ.
|
||
- После завершения ввода, загрузки изображений и пакетного построения спрайтов `requestAnimationFrame`
|
||
больше не запрашивается; в состоянии покоя расхода кадров на эффекты нет.
|
||
- В V4 старый анимированный псевдо-фон `.fg-stage::before` отключён; фон остаётся статичным.
|
||
|
||
## Повторное открытие вкладки «Связи»
|
||
|
||
Каждое нажатие **нижней кнопки «Связи»** сбрасывает исследованный граф V3/V4:
|
||
очищает графы в памяти и в IndexedDB, забывает раскрытые ветви и координаты, возвращает
|
||
к собственному профилю, отключает X2 и дополнительные фильтры. После окончания
|
||
очистки загружаются собственные непосредственные связи. Новый запрос ждёт завершения
|
||
очистки — старые данные не восстанавливаются наперегонки из IndexedDB.
|
||
Переключение версий V1/V2/V3/V4 в селекторе внутри открытого экрана **не** сбрасывает
|
||
исследованный граф. Кэш изображений браузера, фотографии и другие данные приложения не стираются.
|
||
Верхнее меню «Очистить кэш» остаётся отдельным действием внутри уже открытой карты.
|
||
|
||
## Файлы
|
||
|
||
- `shine-UI/js/pages/network-canvas-v4/graph-renderer.js` — рендер и жесты.
|
||
- `shine-UI/js/pages/network-canvas-v4/graph-style.js` — палитры и геометрия направленных линий.
|
||
- `shine-UI/js/pages/network-canvas-v4/network-view.js` — адаптер страницы V4.
|
||
- `shine-UI/js/pages/network-explorer/network-view.js` — общая страница V3/V4.
|
||
- `shine-UI/js/pages/network-version-switcher.js` — выбор V4 и обработчик входа во вкладку.
|
||
- `shine-UI/js/components/toolbar.js` — сигнал повторного входа по нижней кнопке.
|
||
- `shine-UI/index.html` — обновлённый build hash загрузки UI.
|
||
- `shine-UI/styles/features/network.css` — Canvas-слои, выключение старой анимации.
|
||
- `shine-UI/tests/network-explorer-v4.test.mjs` — проверки градиентов, затухания, геометрии и модели.
|
||
|
||
## Проверка и ограничения
|
||
|
||
Команды в корне репозитория:
|
||
|
||
```bash
|
||
node --test shine-UI/tests/network-explorer-v3.test.mjs shine-UI/tests/network-explorer-v4.test.mjs
|
||
```
|
||
|
||
Базовые тесты проверяют градиенты и затухание линий, геометрию и BFS-модель, а также
|
||
инварианты порядка рисования стекла/фото, стиля неона/подписей и механизма сброса вкладки.
|
||
Они не заменяют полноценный браузерный тест страницы с авторизацией и реальными запросами к серверу.
|
||
Для финальной проверки на устройстве стоит сравнить FPS/память V3 и V4 на одном исследованном графе,
|
||
проверить фото из Arweave и R2, долгий тап и пересечения подписей на узком экране.
|
||
|
||
|
||
### Canvas V4c — стекло и неон как в V3 (19.11.2026)
|
||
|
||
- Цветные красно-синие кольца аватаров удалены. Возвращена стеклянная PNG-кромка V3 (`glass_overlay_faithful.png`, 119% размера узла).
|
||
- Фото/инициалы рисуются **после** стекла, непрозрачно, поверх бликов; диск под стеклом закрывает окончания линий нижнего Canvas. Сияющие ауры остались статичными.
|
||
- Сияющие связи рисуются в стиле V3: поле 16px с размытием 6px, трубка 6px с размытием 2px и тонкое светлое ядро 2px, всё с `screen`-композитингом. Blur выполняется один раз для слоя всех связей. Сине-красные градиенты и затухание односторонних связей сохранены.
|
||
- Система подписей V2, масштаб 0.55–2.2 и сброс исследованной карты при входе в «Связи» без изменений. Никаких пульсаций и фоновых циклов рендера.
|