Meridian Slides — спецификация приложения

Документ приложения по разделу 8 библии (docs/00-foundation.md). Версия 0.1 · 2026-10-03. Собственный формат: .mpx (шаблон .mpt, плоский XML .mpxf), пространство имён urn:meridian:office:slides:1, MIME application/vnd.meridian.slides. Цвет приложения --app-slides #E25C3D, значок — прямоугольник с треугольником «play». Крейты ядра: kernel/crates/meridian-slides (модель презентации, пакет .mpx), meridian-scene (общая графика сцены: фигуры, геометрия, стили, группы — делится с Draw/Write/Sheets), meridian-anim (таймлайн и планировщик анимаций), meridian-show (сеанс показа, режим докладчика, перо/лазер), meridian-transitions (переходы, шейдеры SkSL), meridian-diagram (диаграммы-схемы), meridian-video (экспорт видео, запись), meridian-chart (диаграммы), meridian-codecs-{pptx,ppt,odp,iwork}; оболочка — shell/src/slides/ (QML/C++); скрипты — meridian-script. Фаза по библии: 3 (12–22 мес от старта). Редакция: Slides входит в Free (Feature::CoreSlides); экспорт видео — Feature::SlidesVideoExport, пульт докладчика — Feature::SlidesPresenterRemote, скрипты — Feature::ScriptsRun/ScriptsEdit, совместная работа — Feature::CloudCollab (фаза 6).

Содержание

1. Назначение и аналоги
2. Функции (по группам, P0/P1/P2)
3. Экраны
4. Модель данных
5. Алгоритмы
6. MeridianScript API для Slides
7. Форматы
8. Горячие клавиши
9. Критерии готовности 1.0
10. Риски
11. Вопросы к библии

1. Назначение и аналоги

Meridian Slides — редактор презентаций: слайды с заполнителями, образцами и темами, анимации и переходы, показ с режимом докладчика на втором экране, запись показа с голосом, экспорт в видео и PDF. Точно открывает .pptx вместе с анимациями, переходами и образцами, пишет .pptx без потерь для всего, что умеет сам.

1.1 Аналоги

1.2 Чем Slides будет лучше — конкретно

1.3 Границы версии 1.0

В 1.0 (конец фазы 3) входят все P0 ниже. 3D-сцена фигур (a:scene3d, a:sp3d), морфинг, запись с камеры, сравнение презентаций, авто-субтитры и совместная работа появляются в 1.x/2.0 по приоритетам P1/P2 и фазам 6–7.

2. Функции

Приоритеты: P0 — без этого нельзя выпустить 1.0, P1 — в 1.x, P2 — позже. Пометки редакций — [Pro] и т.п. по docs/10-licensing-accounts.md; без пометки — Free.

2.1 Слайды и структура презентации

2.2 Макеты, образцы, темы

2.3 Заполнители

2.4 Текст (движок Write)

2.5 Фигуры

Геометрия — общая библиотека meridian-scene, та же, что в Write/Sheets/Draw: 187 предустановленных фигур OOXML (a:prstGeom), вычисляемых по формулам направляющих (§5.1). Группы галереи «Фигуры» (всего 187):

2.6 Рисунки

2.7 Значки и SVG

2.8 Таблицы

2.9 Диаграммы (Meridian Chart)

2.10 Диаграммы-схемы (аналог SmartArt)

Модуль meridian-diagram: дерево узлов с текстом → автоматическая раскладка по выбранному макету → фигуры, стилизованные темой. Доступен в Slides, Write, Sheets (один код). Категории и макеты:

2.11 Видео и аудио

2.12 Переходы

Каталог переходов (имя, категория по PowerPoint, OOXML-элемент, параметры «Параметры эффекта», способ отрисовки):

2.13 Анимации

2.14 Показ слайдов

2.15 Репетиция и хронометраж

2.16 Запись показа

2.17 Экспорт видео [Pro: Feature::SlidesVideoExport]

2.18 Раздаточные материалы, печать, PDF

2.19 Заметки докладчика

2.20 Разделы

См. §2.1. В сортировщике разделы — заголовки с кнопками сворачивания; перетаскивание раздела переносит его слайды; печать и экспорт «только раздел»; «Масштаб раздела» (section zoom) — P2.

2.21 Сравнение и рецензирование

2.22 Совместная работа (фаза 6) [Pro: CloudCollab]

CRDT (Yrs) на уровне дерева слайдов и фигур и текста в фигурах; присутствие (цветные рамки выделений других авторов, аватары на миниатюрах), «следовать за автором», история версий из history/, общий доступ по ссылке, комментарии с упоминаниями и уведомлениями. Показ по сети («зрители следуют за докладчиком») — P2.

2.23 Доступность

2.24 Прочее

3. Экраны

Идентификаторы: SL-01…SL-09 — виды и окна; SL-10…SL-19 — боковые и нижние панели; SL-20…SL-59 — диалоги; SL-60…SL-69 — контекстные меню; SL-70+ — всплывающие элементы. Макет — mockups/slides.html, по одному <section class="screen"> на идентификатор.

3.1 SL-01 Обычный вид (Normal)

Каркас — по §5.3 библии. Слева — панель миниатюр (SL-10) шириной 160–320 px с разделами; в центре — холст слайда с полями 24 px, линейками (опц.) и направляющими; под холстом — панель заметок (SL-13, сворачиваемая); справа — боковая панель с вкладками (SL-11, SL-12, SL-14…). Строка состояния: «Слайд 3 из 24 · Раздел „Введение" · Тема „Меридиан" · Русский · [Заметки] [Комментарии] · режимы · масштаб · [Вписать]».

┌──────────────────────────────────────────────────────────────────────────────────────┐
│ [▶] Отчёт Q3.mpx — Meridian Slides                 [⌘K Поиск команд]  [☁ Сохранено] [👤] │
├──────────────────────────────────────────────────────────────────────────────────────┤
│ Файл  Главная  Вставка  Дизайн  Переходы  Анимации  Показ  Рецензирование  Вид  Скрипты │ Формат фигуры │
│ [Слайды][Буфер][Шрифт][Абзац][Рисование][Редактирование]                       [⌄]   │
├────────────┬──────────────────────────────────────────────────────┬──────────────────┤
│ ▾ Введение │  ┌────────────────────────────────────────────────┐  │ Формат фигуры    │
│ ┌────────┐ │  │                                                │  │ ◇ Заливка        │
│ │ 1  ▣   │ │  │     Итоги квартала                             │  │   ● Сплошная     │
│ └────────┘ │  │     ─────────────────────                      │  │   ○ Градиент     │
│ ┌────────┐ │  │     • Выручка +12 %                            │  │ ◇ Линия          │
│ │ 2  ▣ ★ │ │  │     • Новые регионы: 3                         │  │ ◇ Эффекты        │
│ └────────┘ │  │                                   [диаграмма]  │  │ ◇ Размер и полож.│
│ ▾ Финансы  │  │                                                │  │ ◇ Текст          │
│ ┌────────┐ │  └────────────────────────────────────────────────┘  │                  │
│ │ 3  ▣   │ │  Заметки: Напомнить про сроки аудита…        [▲]     │                  │
├────────────┴──────────────────────────────────────────────────────┴──────────────────┤
│ Слайд 2 из 24 · Финансы · Русский     [Заметки] [Комментарии]   ▦ ▤ ▥ ▶   ─●─ 85 % ⤢ │
└──────────────────────────────────────────────────────────────────────────────────────┘

Элементы холста: рамка выделения с 8 маркерами размера, маркером поворота (сверху), жёлтыми регуляторами формы, нумерованные метки анимаций слева от фигур (при открытой панели «Анимация»), умные направляющие (цвет --m-sun), направляющие слайда (перетаскиваемые, с подписью координаты), сетка, рамки заполнителей пунктиром, значок «автоподбор» у переполненной фигуры, мини-панель форматирования при выделении текста, значки комментариев в углах фигур.

3.2 Остальные виды и окна

3.3 Ribbon — вкладки и группы

Компактный режим и командная палитра — по §5.3 библии. Палитра в Slides дополнительно ищет слайды по заголовку («перейти к слайду „Бюджет"»), фигуры по имени и анимации.

3.4 Панели

3.5 Диалоги

4. Модель данных

4.1 Пакет .mpx

mimetype                       application/vnd.meridian.slides (без сжатия, первым)
manifest.xml                   список частей, версия формата, роль (document|template), наличие скриптов/подписей
meta.xml                       Dublin Core + статистика (слайды, слова, медиа), приложение-создатель
presentation.xml               корень: размер слайда, порядок слайдов, разделы, произвольные показы, настройки показа,
                               стиль текста по умолчанию, ссылки на образцы и темы
masters/master-<ulid>.xml      образец слайдов (фон, заполнители, стили текста, карта цветов, список макетов)
layouts/layout-<ulid>.xml      макет (ссылка на образец, тип, заполнители)
slides/slide-<ulid>.xml        слайд (ссылка на макет, дерево фигур, фон, переход, таймлайн анимаций, заметки, комментарии)
themes/theme-<ulid>.xml        тема DrawingML-подобной структуры (цвета, шрифты, эффекты)
notes-master.xml, handout-master.xml
styles.xml                     стили таблиц, стили фигур по умолчанию, именованные стили текста
settings.xml                   вид, масштаб, последний слайд, параметры сетки, кэш репетиции
media/<sha256>.<ext>           изображения, видео, аудио (большие — stored, без deflate)
objects/chart-<ulid>.msx       данные диаграмм, objects/table-<ulid>.msx — связанные таблицы, objects/*.meq — формулы
diagrams/diagram-<ulid>.xml    модель диаграммы-схемы (узлы + макет + стиль)
thumbnails/slide-<ulid>.png    кэш миниатюр (опционально), thumbnail.png — первый слайд 256 px
history/                       журнал CRDT-операций (опционально)
scripts/, signatures/, fonts/  скрипты, подписи, встроенные подмножества шрифтов (WOFF2)

Идентификаторы — ULID (сортируемые, уникальные между документами) для слайдов/образцов/макетов и u32 для фигур внутри слайда (как p:cNvPr/@id, сохраняются при round-trip pptx). Пример слайда:

<slide xmlns="urn:meridian:office:slides:1" id="01J9QZ3M7P6V8R2TQX4W5Y6Z7A" layout="01J9QZ…" hidden="false">
  <background><solidFill color="scheme:bg1"/></background>
  <shapes>
    <sp id="2" name="Заголовок 1" ph="title">
      <xfrm x="838200" y="365125" w="10515600" h="1325563"/>
      <txBody><bodyPr anchor="b" autofit="shrink"/><p><r rPr.sz="4400">Итоги квартала</r></p></txBody>
    </sp>
    <sp id="3" name="Текст 2" ph="body" phIdx="1">
      <xfrm x="838200" y="1825625" w="10515600" h="4351338"/>
      <txBody><p lvl="0"><r>Выручка +12 %</r></p><p lvl="0"><r>Новые регионы: 3</r></p></txBody>
    </sp>
    <graphicFrame id="4" name="Диаграмма 3"><xfrm …/><chart ref="objects/chart-01J9…msx" model="charts/chart-01J9….xml"/></graphicFrame>
  </shapes>
  <transition kind="push" dir="l" dur="700" advClick="true" advTm="5000"/>
  <timing>…(§4.6)…</timing>
  <notes><p><r>Напомнить про сроки аудита</r></p></notes>
</slide>

4.2 Структуры ядра (Rust, meridian-slides)

// kernel/crates/meridian-slides/src/model.rs
use meridian_scene::{Shape, ShapeId, ShapeTree, Fill, Theme, ColorMap, TextStyleLevels};

/// Презентация — корень документа / Presentation document root.
pub struct Presentation {
    pub id: Ulid,
    pub size: SlideSize,                       // ширина/высота в EMU, тип пресета / width/height in EMU
    pub masters: IndexMap<Ulid, SlideMaster>,
    pub layouts: IndexMap<Ulid, SlideLayout>,
    pub slides: Vec<Ulid>,                     // порядок слайдов / slide order
    pub slide_store: IndexMap<Ulid, Slide>,
    pub sections: Vec<Section>,                // раздел = имя + диапазон слайдов / name + slide range
    pub custom_shows: Vec<CustomShow>,
    pub notes_master: NotesMaster,
    pub handout_master: HandoutMaster,
    pub themes: IndexMap<Ulid, Theme>,
    pub default_text_style: TextStyleLevels,
    pub show_settings: ShowSettings,           // тип показа, цикл, экраны / show type, loop, screens
    pub media: MediaStore,                     // sha256 → MediaEntry (путь, mime, размер, длительность)
    pub comments: CommentStore,                // комментарии по слайдам / per-slide comments
    pub meta: DocMeta,
}

pub struct SlideMaster {
    pub id: Ulid,
    pub theme: Ulid,
    pub color_map: ColorMap,                   // bg1→lt1, tx1→dk1, … / scheme-to-theme mapping
    pub background: Background,
    pub shapes: ShapeTree,                     // общие фигуры + заполнители с полным форматированием
    pub text_styles: MasterTextStyles,         // title, body (9 уровней), other
    pub layouts: Vec<Ulid>,
    pub transition: Option<Transition>,
    pub timing: Option<AnimTimeline>,
    pub header_footer: HeaderFooter,
}

pub struct SlideLayout {
    pub id: Ulid,
    pub master: Ulid,
    pub kind: LayoutKind,                      // 36 типов ST_SlideLayoutType + Custom
    pub name: String,
    pub shapes: ShapeTree,                     // заполнители макета (ph type/idx) и фоновые фигуры
    pub show_master_shapes: bool,
    pub background: Option<Background>,
    pub preserve: bool,                        // не удалять при неиспользовании / keep when unused
}

pub struct Slide {
    pub id: Ulid,
    pub layout: Ulid,
    pub shapes: ShapeTree,                     // дерево фигур в z-порядке / shape tree in z-order
    pub background: Option<Background>,
    pub show_master_shapes: bool,
    pub transition: Option<Transition>,
    pub timing: Option<AnimTimeline>,          // §4.6
    pub notes: Option<NotesSlide>,
    pub hidden: bool,
    pub advance_ms: Option<u32>,               // хронометраж репетиции / rehearsed advance time
    pub narration: Option<MediaRef>,           // закадровый голос / recorded narration
    pub revision: u64,                         // для инвалидации миниатюр / thumbnail invalidation
}

/// Дерево фигур: плоское хранилище + порядок детей; группы — узлы с детьми.
pub struct ShapeTree {
    pub nodes: SlotMap<ShapeId, ShapeNode>,
    pub roots: Vec<ShapeId>,                   // z-порядок: первый — самый нижний / first = bottom-most
}
pub struct ShapeNode { pub shape: Shape, pub parent: Option<ShapeId>, pub children: Vec<ShapeId> }

pub enum ShapeKind {
    Sp { geom: Geometry, text: Option<TextBody> },             // фигура с текстом / shape with text
    Pic { media: MediaRef, crop: SrcRect, effects: PicEffects },
    GraphicFrame(GraphicContent),                               // Table | Chart | Diagram | Ole | Math
    Cxn { geom: Geometry, start: Option<CxnEnd>, end: Option<CxnEnd> },
    Grp { child_xfrm: ChildTransform },                         // группа: своя система координат
    Media { media: MediaRef, poster: Option<MediaRef>, playback: Playback },
}

pub struct Shape {
    pub id: ShapeId,                           // = p:cNvPr/@id при round-trip
    pub name: String,
    pub kind: ShapeKind,
    pub xfrm: Transform2D,                     // off, ext, rot (1/60000°), flipH, flipV
    pub placeholder: Option<Placeholder>,      // type, idx, orient, size
    pub style: ShapeStyleRefs,                 // lnRef/fillRef/effectRef/fontRef (idx + цвет)
    pub props: ShapeProps,                     // fill, line, effects, scene3d/sp3d (P2)
    pub hyperlink: Option<Action>,
    pub hover: Option<Action>,
    pub locks: Locks,                          // noGrp, noMove, noResize, noSelect, noTextEdit, …
    pub alt_text: AltText,
    pub hidden: bool,
    pub ext: Vec<ExtensionBlob>,               // неизвестные расширения — round-trip / unknown extensions
}

pub struct Placeholder { pub kind: PlaceholderType, pub idx: Option<u32>, pub orient: Orient, pub size: PhSize, pub has_custom_prompt: bool }

4.3 Текстовое тело

TextBody — тот же тип, что в Write (text-model): BodyProps (вставки, привязка, перенос, направление, колонки, автоподбор, деформация), ListStyle (9 уровней ParaProps), Vec<Paragraph>; Paragraph { props, runs }, Run { text, props: RunProps } | Field { kind: SlideNum | DateTime(fmt), props } | LineBreak | MathInline(ref). Единицы: размер шрифта в 1/100 pt, отступы и интервалы в EMU или процентах — как в DrawingML, чтобы round-trip был без округлений.

4.4 Геометрия и стили (из meridian-scene)

pub enum Geometry {
    Preset { kind: PresetShape /* 187 вариантов */, adj: SmallVec<[(AdjName, i64); 8]> },
    Custom { paths: Vec<GeomPath>, guides: Vec<Guide>, adj: Vec<(AdjName, i64)>, cxn: Vec<CxnSite>, text_rect: Option<GuideRect> },
}
pub enum Fill { None, Solid(Color), Gradient(Gradient), Blip(BlipFill), Pattern { preset: PatternPreset, fg: Color, bg: Color }, Group /* наследовать от группы */ }
pub enum Color { Srgb(u32), Scheme { name: SchemeColor, mods: Vec<ColorMod> }, Preset(PresetColor), Hsl(..), System(..) }
pub struct Line { pub width_emu: i64, pub fill: Fill, pub dash: DashPreset | Custom(Vec<(u32,u32)>), pub cap: Cap, pub join: Join, pub compound: Compound, pub head: Arrow, pub tail: Arrow }
pub struct Effects { pub shadow: Option<Shadow>, pub reflection: Option<Reflection>, pub glow: Option<Glow>, pub soft_edge: Option<i64>, pub blur: Option<Blur> }

Цвета разрешаются в sRGB только при рендере: Color::resolve(theme, color_map); модификаторы (lumMod, lumOff, tint, shade, alpha, satMod, hueOff …) применяются в порядке записи, как в DrawingML.

4.5 Наследование свойств заполнителей (master → layout → slide)

Поиск «родителя» заполнителя:

1. Фигура слайда с placeholder{kind, idx} ищет в макете заполнитель с тем же idx; если idx нет — с тем же kind (для kind ∈ {title, ctrTitle} ищется title/ctrTitle; для body/obj/tbl/chart/dgm/media/pic/clipArt — body).
2. Заполнитель макета ищет в образце по kind (все «телесные» типы → body; dt, ftr, sldNum — по своему типу).
3. Для текста к цепочке добавляются стили образца (titleStyle / bodyStyle / otherStyle по уровню абзаца), затем default_text_style презентации, затем тема (шрифты +mj-lt/+mn-lt, цвета схемы), затем встроенные значения (размер 18 pt, выравнивание влево, чёрный tx1).

/// Разрешение свойств абзаца/символов по цепочке наследования /
/// Resolve paragraph/run properties along the inheritance chain.
pub fn resolve_run_props(ctx: &ResolveCtx, slide: &Slide, shape: &Shape, para: &Paragraph, run: &Run) -> ResolvedRunProps {
    let lvl = para.props.level.unwrap_or(0) as usize;
    // Цепочка от самого конкретного к общему / chain from most specific to most generic
    let mut chain: SmallVec<[&RunProps; 8]> = smallvec![&run.props];
    if let Some(pr) = para.props.default_run.as_ref() { chain.push(pr); }          // a:pPr/a:defRPr
    if let Some(list) = shape.text_list_style() { chain.extend(list.level(lvl).map(|l| &l.run)); }
    for owner in ctx.placeholder_chain(slide, shape) {                               // layout ph → master ph
        if let Some(list) = owner.text_list_style() { chain.extend(list.level(lvl).map(|l| &l.run)); }
    }
    chain.extend(ctx.master_text_style(slide, shape).level(lvl).map(|l| &l.run));   // titleStyle/bodyStyle/otherStyle
    chain.extend(ctx.presentation.default_text_style.level(lvl).map(|l| &l.run));
    let mut out = ResolvedRunProps::builtin();                                       // 18 pt, tx1, +mn-lt
    for props in chain.iter().rev() { out.apply(props); }                            // общие → конкретные / generic → specific
    out.resolve_colors(ctx.theme(slide), ctx.color_map(slide));
    out
}

Геометрия заполнителя (xfrm) наследуется так же: если у фигуры слайда нет xfrm, берётся из макета, затем из образца. «Сбросить слайд» удаляет на слайде всё, что совпадает с унаследованным, сохраняя текст.

4.6 Таймлайн анимаций (meridian-anim)

Структура повторяет дерево p:timing, чтобы импорт/экспорт pptx был изоморфным; «плоские» списки для панели SL-11 вычисляются из дерева.

// kernel/crates/meridian-anim/src/timeline.rs
pub struct AnimTimeline { pub root: TimeNode /* nodeType=tmRoot, par */, pub builds: Vec<Build> /* bldP, bldChart, bldDgm */ }

pub struct TimeNode {
    pub id: u32,
    pub kind: NodeKind,                      // Par | Seq { concurrent, next_action, prev_action } | Behavior(Behavior)
    pub node_type: NodeType,                 // TmRoot | MainSeq | ClickEffect | WithEffect | AfterEffect | ClickPar | WithGroup | AfterGroup | Interactive
    pub start: Vec<Condition>,               // stCondLst: Delay(ms) | Indefinite | OnClick(ShapeId) | OnBegin(NodeId) | OnEnd(NodeId) | OnNext | OnPrev | Bookmark(media, name)
    pub end: Vec<Condition>,
    pub duration: Duration,                  // Ms(u32) | Indefinite | Media
    pub repeat: Repeat,                      // Count(f32) | Indefinite | UntilNextClick | UntilEndOfSlide
    pub autoreverse: bool,
    pub fill: FillMode,                      // Hold | Freeze | Remove | Transition
    pub accel: u16, pub decel: u16,          // 0..100000 (доли длительности) / fractions of duration
    pub restart: Restart,                    // Always | WhenNotActive | Never
    pub preset: Option<Preset>,              // { class: Entr|Emph|Exit|Path|Verb|MediaCall, id: u16, subtype: u16 }
    pub group_id: Option<u32>,               // grpId — связь с bldP / link to text build
    pub target: Option<Target>,              // фигура / абзац / фон / звук / видео
    pub children: Vec<TimeNode>,
    pub next_cond: Vec<Condition>, pub prev_cond: Vec<Condition>,   // для Seq
}

pub enum Behavior {
    Set   { attr: AnimAttr, value: AnimValue },                                        // p:set
    Anim  { attr: AnimAttr, calc: CalcMode /* Discrete|Lin|Fmla */, keys: Vec<KeyFrame /* tm 0..100000, val|formula */>, by: Option<AnimValue>, from: Option<AnimValue>, to: Option<AnimValue> },
    Effect { transition: InOut, filter: String /* "fade", "wipe(left)", "wheel(4)" … */, progress: Option<Vec<KeyFrame>> }, // p:animEffect
    Motion { path: MotionPath /* M L C Z E в долях слайда */, origin: Origin, rotate_along: bool, path_edit_mode: EditMode, by_x: f32, by_y: f32 },
    Rotate { by: Option<i32>, from: Option<i32>, to: Option<i32> },                   // 1/60000°
    Scale  { by: Option<(f32,f32)>, from: Option<(f32,f32)>, to: Option<(f32,f32)>, zoom_contents: bool },
    Color  { space: ColorSpace /* rgb|hsl */, dir: HueDir, by: Option<ColorDelta>, from: Option<Color>, to: Option<Color> },
    Command { kind: CmdKind /* Call|Evt|Verb */, cmd: String /* playFrom(0.0), togglePause, stop */ },
    Audio  { media: MediaRef, is_narration: bool },
    Video  { media: MediaRef, full_screen: bool },
}

pub enum AnimAttr { PptX, PptY, PptW, PptH, PptR, Visibility, FillColor, FillOn, LineColor, LineOn, Opacity, TextFontSize, TextBold, TextItalic, TextUnderline, TextColor, Custom(SmolStr) }

Соответствие с панелью SL-11: один «эффект» = поддерево ClickEffect|WithEffect|AfterEffect с preset; его «щелчок» = индекс ClickPar-предка в MainSeq; «начало» вычисляется из node_type; задержка/длительность — из start/duration.

4.7 Переходы, показ, запись

pub struct Transition { pub kind: TransitionKind /* 51 вариант §2.12 */, pub params: TransitionParams /* dir, orient, spokes, thru_black, pattern, … */, pub duration_ms: u32, pub sound: Option<TransitionSound>, pub advance_on_click: bool, pub advance_after_ms: Option<u32> }
pub struct ShowSettings { pub kind: ShowKind /* Presenter | Window | Kiosk */, pub loop_: bool, pub show_narration: bool, pub show_animation: bool, pub use_timings: bool, pub range: ShowRange /* All | Range(a,b) | Custom(Ulid) */, pub pen_color: Color, pub laser_color: Color, pub gpu_transitions: bool, pub screen_policy: ScreenPolicy }
pub struct Narration { pub audio: MediaRef, pub ink: Vec<TimedStroke>, pub laser: Vec<TimedPoint>, pub clicks: Vec<(u32 /*ms*/, ClickKind)> }

5. Алгоритмы

5.1 Вычисление геометрии prstGeom по формулам направляющих

Источник — presetShapeDefinitions.xml (ECMA-376, часть 1, приложение). При сборке build.rs крейта meridian-scene разбирает его в статические таблицы (PRESETS: [PresetGeom; 187]), поэтому в рантайме XML не читается.

// kernel/crates/meridian-scene/src/preset_geom.rs
pub struct PresetGeom {
    pub name: &'static str,
    pub adj_defaults: &'static [(&'static str, i64)],  // avLst
    pub guides: &'static [Guide],                       // gdLst — уже в порядке вычисления / in evaluation order
    pub adj_handles: &'static [AdjHandle],              // ahLst: XY | Polar, диапазоны min/max
    pub cxn_sites: &'static [CxnSite],                  // cxnLst: угол + точка (ссылки на направляющие)
    pub text_rect: Option<GuideRect>,                   // rect: l, t, r, b
    pub paths: &'static [PresetPath],                   // pathLst
}
pub struct Guide { pub name: &'static str, pub op: Op, pub a: Operand, pub b: Operand, pub c: Operand }
pub enum Op { MulDiv, AddSub, AddDiv, IfElse, Abs, At2, Cat2, Cos, Max, Min, Mod, Pin, Sat2, Sin, Sqrt, Tan, Val }
pub enum Operand { Lit(i64), Ref(u16) /* индекс в таблице значений */ }
pub struct PresetPath { pub w: Option<i64>, pub h: Option<i64>, pub fill: PathFill /* Norm|None|Lighten|LightenLess|Darken|DarkenLess */, pub stroke: bool, pub extrusion_ok: bool, pub cmds: &'static [PathCmd] }
pub enum PathCmd { MoveTo(Operand, Operand), LineTo(Operand, Operand), ArcTo { w_r: Operand, h_r: Operand, st_ang: Operand, sw_ang: Operand }, QuadTo([Operand; 4]), CubicTo([Operand; 6]), Close }

Порядок вычисления значений (все — i64 в EMU; углы — в 1/60000 градуса, cd4 = 5400000):

1. Встроенные: w, h, l=0, t=0, r=w, b=h, hc=w/2, vc=h/2, ss=min(w,h), ls=max(w,h), доли wd2 … wd32, hd2 … hd32, ssd2 … ssd32, углы cd2=10800000, cd4, cd8, 3cd4, 3cd8, 5cd8, 7cd8.
2. Регуляторы adj из фигуры, иначе adj_defaults.
3. Направляющие gdLst последовательно (формулы ссылаются только на ранее определённые — спецификация это гарантирует).

fn eval(op: Op, a: i64, b: i64, c: i64) -> i64 {
    use Op::*;
    match op {
        MulDiv => mul_div(a, b, c),                  // a*b/c с i128 без переполнения / overflow-safe
        AddSub => a + b - c,
        AddDiv => (a + b) / c.max(1),
        IfElse => if a > 0 { b } else { c },
        Abs => a.abs(), Max => a.max(b), Min => a.min(b), Mod => (a*a + b*b + c*c).isqrt(),
        Pin => b.clamp(a, c),
        Sqrt => (a.max(0) as f64).sqrt() as i64,
        Val => a,
        Sin => (a as f64 * deg(b).sin()).round() as i64,   // a·sin(b)
        Cos => (a as f64 * deg(b).cos()).round() as i64,
        Tan => (a as f64 * deg(b).tan()).round() as i64,
        At2 => to_ang((b as f64).atan2(a as f64)),           // atan2(b, a) в 1/60000°
        Cat2 => (a as f64 * (c as f64).atan2(b as f64).cos()).round() as i64,  // a·cos(atan2(c,b))
        Sat2 => (a as f64 * (c as f64).atan2(b as f64).sin()).round() as i64,  // a·sin(atan2(c,b))
    }
}

/// Построение контура в системе координат фигуры (EMU) / Build outline in shape coordinates.
pub fn build_paths(geom: &PresetGeom, w: i64, h: i64, adj: &[(AdjName, i64)]) -> Vec<(kurbo::BezPath, PathStyle)> {
    let vals = eval_guides(geom, w, h, adj);
    geom.paths.iter().map(|p| {
        // Масштаб из пространства пути в размер фигуры / scale path space to shape size
        let sx = p.w.map_or(1.0, |pw| w as f64 / pw as f64);
        let sy = p.h.map_or(1.0, |ph| h as f64 / ph as f64);
        let mut out = kurbo::BezPath::new();
        let mut cur = kurbo::Point::ZERO;
        for cmd in p.cmds {
            match *cmd {
                PathCmd::MoveTo(x, y) => { cur = pt(&vals, x, y, sx, sy); out.move_to(cur); }
                PathCmd::LineTo(x, y) => { cur = pt(&vals, x, y, sx, sy); out.line_to(cur); }
                PathCmd::ArcTo { w_r, h_r, st_ang, sw_ang } => {
                    // Дуга эллипса от текущей точки: центр вычисляется так, чтобы текущая точка лежала на эллипсе
                    // под углом st_ang. Углы DrawingML — геометрические («по транспортиру»), переводим в параметрические:
                    // t = atan2(wR·sin θ, hR·cos θ). / DrawingML angles are geometric, convert to parametric.
                    let (rx, ry) = (vals.get(w_r) as f64 * sx, vals.get(h_r) as f64 * sy);
                    let (st, sw) = (deg(vals.get(st_ang)), deg(vals.get(sw_ang)));
                    let t0 = param_angle(st, rx, ry);
                    let center = kurbo::Point::new(cur.x - rx * t0.cos(), cur.y - ry * t0.sin());
                    let t1 = param_angle(st + sw, rx, ry) + if sw < 0.0 && param_angle(st+sw,rx,ry) > t0 { -std::f64::consts::TAU } else { 0.0 };
                    let arc = kurbo::Arc { center, radii: kurbo::Vec2::new(rx, ry), start_angle: t0, sweep_angle: t1 - t0, x_rotation: 0.0 };
                    arc.append_iter(0.1).for_each(|el| out.push(el));   // кубики Безье по четвертям / cubic segments
                    cur = arc.end();   // конечная точка дуги / arc end point
                }
                PathCmd::QuadTo([x1,y1,x,y]) => { let p1 = pt(&vals,x1,y1,sx,sy); cur = pt(&vals,x,y,sx,sy); out.quad_to(p1, cur); }
                PathCmd::CubicTo([x1,y1,x2,y2,x,y]) => { let p1 = pt(&vals,x1,y1,sx,sy); let p2 = pt(&vals,x2,y2,sx,sy); cur = pt(&vals,x,y,sx,sy); out.curve_to(p1,p2,cur); }
                PathCmd::Close => out.close_path(),
            }
        }
        (out, PathStyle { fill: p.fill, stroke: p.stroke })
    }).collect()
}

Регуляторы (ahLst) дают маркеры на холсте: позиция маркера вычисляется по направляющим, перетаскивание решает обратную задачу (линейная для XY, через atan2/расстояние для Polar) с ограничением min/max. Точки соединения cxnLst используются коннекторами (Draw/Slides) — тот же код. Текстовый прямоугольник rect ограничивает раскладку текста. Результат build_paths кэшируется по ключу (preset, w, h, adj) (LRU 4 096 записей на документ). Проверка: снимочные тесты всех 187 фигур при трёх размерах против эталонов PowerPoint (SSIM ≥ 0,99).

5.2 Автоподбор текста (shrink-on-overflow)

Режимы bodyPr/autofit: none, spAutoFit (фигура растёт/сжимается по тексту — высота = высота раскладки + вставки), normAutofit { font_scale: %, ln_spc_reduction: % }. Для normAutofit масштаб ищется по «лестнице» PowerPoint, чтобы значения совпадали с теми, что пишет PowerPoint (иначе при round-trip текст «прыгает»):

const LADDER: &[(u16 /*fontScale %*/, u16 /*lnSpcReduction %*/)] = &[
    (100,0), (100,10), (100,20), (92,20), (85,20), (77,20), (70,20), (62,20), (55,20), (47,20), (40,20), (32,20), (25,20),
];
/// Подбор масштаба: первый шаг лестницы, при котором текст помещается / first ladder step that fits.
pub fn autofit(body: &TextBody, rect: Rect, ctx: &LayoutCtx) -> (u16, u16) {
    for &(fs, lr) in LADDER {
        let layout = ctx.layout(body, rect.width(), FontScale(fs), LineSpacingReduction(lr));
        if layout.height() <= rect.height() { return (fs, lr); }
    }
    *LADDER.last().unwrap()   // не помещается даже при 25 % — остаётся переполнение / overflow remains
}

Оптимизация: раскладка с масштабом 100 % — обычная; затем бинарный поиск по индексу лестницы (монотонность высоты по масштабу выполняется), т.е. ≤ 4 раскладки вместо 13. Пересчёт — при изменении текста/размера/шрифта, с задержкой 50 мс при наборе. spAutoFit при вертикальном тексте меняет ширину. Деформации (prstTxWarp) P1: текст раскладывается в прямоугольник, затем глифы отображаются через огибающую (верхняя/нижняя кривые Безье из пресета) — та же техника, что у WordArt в Write.

5.3 Умные направляющие, привязки, равномерное распределение

Кандидаты привязки собираются при начале перетаскивания (и кэшируются до его конца):

pub struct SnapIndex { xs: Vec<(f64 /*x слайда*/, SnapSrc)>, ys: Vec<(f64, SnapSrc)>, gaps_x: Vec<Gap>, gaps_y: Vec<Gap> }
// xs/ys отсортированы; SnapSrc = Edge(ShapeId, Left|CenterX|Right) | SlideEdge | SlideCenter | Guide(id) | Grid
// Gap — расстояние между соседними (по проекции) фигурами: (a, b, size) для «равных интервалов»

При движении: для перетаскиваемого прямоугольника берём 3 вертикальные линии (левая/центр/правая) и 3 горизонтальные; для каждой — бинарный поиск ближайшего кандидата; выбираем минимальную дельту |Δ| ≤ tol, где tol = 6 px / zoom; применяем смещение, рисуем направляющую через обе фигуры (цвет --m-sun, 1 px, с размерными засечками). Равные интервалы: для пары соседей A, B на той же оси проверяем, образует ли перетаскиваемая фигура интервал, равный gap(A,B) слева или справа — при совпадении рисуем две скобки с подписью. Приоритет: центр слайда > край слайда > направляющие > фигуры > равные интервалы > сетка. При зажатом Alt привязка отключается. При изменении размера — те же кандидаты для перемещаемого края. Поворот привязывается к 0/15/…° при Shift. Распределение (команда «Распределить по горизонтали»): сортировка по x, gap = (span − Σw) / (n − 1), при n = 2 — относительно слайда. Выравнивание относительно слайда или выделения — по bounding box с учётом поворота (ось-ориентированный прямоугольник повёрнутой фигуры).

5.4 Планировщик анимаций (60 кадров/с)

Дерево AnimTimeline при входе на слайд компилируется в план: список треков с абсолютным временем относительно «шага» (щелчка).

pub struct Track { pub target: Target, pub attr: AnimAttr, pub start_ms: f64, pub dur_ms: f64, pub repeat: Repeat, pub autoreverse: bool,
                   pub fill: FillMode, pub ease: Ease /* accel/decel → кусочно-квадратичная */, pub keys: Vec<KeyFrame>, pub calc: CalcMode }
pub struct Step { pub index: u32, pub tracks: Vec<Track>, pub total_ms: f64, pub media_cmds: Vec<(f64, MediaCmd)>, pub interactive: Option<ShapeId> }
pub struct Plan { pub steps: Vec<Step>, pub initial_state: SceneState /* фигуры с эффектом входа скрыты */ }

/// Компиляция: обход дерева, накопление задержек / compile tree into steps with absolute times.
fn compile(node: &TimeNode, t0: f64, step: &mut Step, plan: &mut Plan) {
    let start = t0 + node.start.iter().filter_map(Condition::delay_ms).sum::<f64>();
    match &node.kind {
        NodeKind::Par => { for c in &node.children { compile(c, start, step, plan); } }
        NodeKind::Seq { .. } => {
            let mut t = start;
            for c in &node.children {
                if c.node_type == NodeType::ClickPar || c.start.iter().any(Condition::is_indefinite) {
                    plan.push_step(std::mem::take(step));           // новый щелчок / new click step
                    t = 0.0;
                }
                compile(c, t, step, plan);
                t += c.total_duration();                            // «после предыдущего» / "after previous"
            }
        }
        NodeKind::Behavior(b) => step.tracks.push(Track::from_behavior(node, b, start)),
    }
    if let Some(sh) = node.interactive_trigger() { step.interactive = Some(sh); }
}

Воспроизведение: ShowClock — монотонное время с момента начала шага; кадр по vsync QQuickWindow::beforeRendering:

pub fn sample(plan: &Plan, step: usize, t_ms: f64, base: &SceneState) -> SceneState {
    let mut st = base.clone_shallow();                       // COW: меняем только анимируемые атрибуты
    for tr in &plan.steps[step].tracks {
        let Some(local) = tr.local_time(t_ms) else { continue };   // учитывает repeat/autoreverse/fill
        let u = tr.ease.apply(local / tr.dur_ms);                  // 0..1 с accel/decel
        let v = match tr.calc { CalcMode::Discrete => tr.keys.step(u), CalcMode::Lin => tr.keys.lerp(u), CalcMode::Fmla => tr.keys.eval_formula(u, &st) };
        st.apply(tr.target, tr.attr, v);                           // ppt_x/ppt_y — доли ширины/высоты слайда
    }
    st
}

Ease: accel/decel в долях длительности — кусочная функция (квадратичный разгон, линейная середина, квадратичное торможение, площадь нормирована на 1); для «отскока» и пружины — пресеты Bounce, Elastic, для плавных путей — EaseInOutCubic. Пропуск кадров: состояние — функция времени, поэтому задержки не накапливаются. Завершение шага — когда t ≥ total_ms и нет бесконечных повторов; «после предыдущего» между щелчками реализовано компиляцией. Тексты «по абзацам/словам/буквам» разворачиваются при компиляции в N треков с задержкой (bldP/@advAuto или % от длительности). Пути движения: MotionPath → kurbo::BezPath в долях слайда, точка по t — через параметризацию по длине дуги (ParamCurveArclen), rotate_along — касательная. Предпросмотр в редакторе — тот же планировщик с виртуальными часами.

5.5 Переходы на GPU (Skia)

Каждый переход — Transition трейт: prepare(from: &SkImage, to: &SkImage, params) -> Box<dyn TransitionFrame>, draw(canvas, progress 0..1). Три семейства реализации:

1. Шейдерные (p:fade, wipe, push, split, blinds, checker, wheel, dissolve, randomBar, фигуры, glitter, ripple, warp, reveal, flash) — SkRuntimeEffect на SkSL с униформами progress, size, dir, двумя дочерними шейдерами from/to (текстуры слайдов):

// meridian-transitions/shaders/wipe.sksl — появление / wipe
uniform shader from; uniform shader to; uniform float progress; uniform float2 size; uniform int dir; // 0 l,1 r,2 u,3 d
half4 main(float2 p) {
    float u = dir == 0 ? p.x / size.x : dir == 1 ? 1.0 - p.x / size.x : dir == 2 ? p.y / size.y : 1.0 - p.y / size.y;
    float edge = smoothstep(progress - 0.01, progress + 0.01, u);   // мягкая кромка 1 % / 1 % soft edge
    return mix(to.eval(p), from.eval(p), edge);
}

Растворение: hash(floor(p / cell)) сравнивается с progress; шашки/жалюзи — по fract координат ячеек с чередованием; часы — по углу atan2; фигуры — знаковые функции расстояния (круг, ромб, плюс). 2. 3D (cube/prism, flip, doors, switch, gallery, ferris, conveyor, window, fallOver, airplane, origami, flythrough, prestige) — две (или больше) плоскости с текстурами, рисуются через canvas.concat(SkM44::perspective(...) * rotate * translate); Skia поддерживает перспективные матрицы для drawImageRect; порядок отрисовки — по глубине центра плоскости (painter's algorithm, достаточно для 2–6 плоскостей); освещение — множитель яркости по косинусу угла. 3. Сетки вершин (drape, curtains, crush, peelOff, pageCurl*) — canvas.draw_vertices с сеткой 64×36, UV в текстуру слайда, вершины смещаются аналитически (скручивание — цилиндр радиуса r(t), занавес — синусоида с затуханием). fracture/shred/vortex/honeycomb — предрассчитанные тайлы/осколки (Вороной из 60–120 точек), каждый рисуется с собственной трансформацией.

Производительность: текстуры from/to рендерятся заранее (при входе в слайд — следующий слайд уже отрисован), переход занимает ≤ 2 draw-вызовов на кадр для шейдеров и ≤ 150 для тайлов; целевое 60 к/с при 4K на интегрированной графике (Iris Xe/Apple M1). Без GPU (Skia CPU): шейдерные переходы работают (медленнее, при 1080p ~ 25–40 к/с), 3D и сетки заменяются на fade. Политика выбора: ShowSettings.gpu_transitions && backend.is_gpu().

5.6 Раскладка диаграмм-схем

Модель: Diagram { kind: DiagramKind, root: DNode, style: DiagramStyle, dir: Ltr|Rtl, font_scale: u16 }, DNode { id, text: TextBody, children: Vec<DNode>, role: Normal|Assistant, image: Option<MediaRef> }. Раскладчик — функция layout(kind, &root, bounds) -> Vec<DShape> (фигуры + коннекторы + текстовые прямоугольники):

fn layout_process(nodes: &[DNode], b: Rect, o: &ProcessOpts) -> Vec<DShape> {
    // Горизонтальный процесс: n блоков + (n−1) стрелок; ширина блока : стрелка = 1 : 0.35
    let n = nodes.len() as f64; let gap = 0.35;
    let unit = b.width() / (n + (n - 1.0) * gap);
    let h = (b.height() * 0.6).min(unit * 0.8);
    let y = b.center().y - h / 2.0;
    let mut out = vec![];
    for (i, node) in nodes.iter().enumerate() {
        let x = b.x0 + i as f64 * unit * (1.0 + gap);
        out.push(DShape::block(node.id, Rect::new(x, y, x + unit, y + h), PresetShape::RoundRect, &node.text));
        if i + 1 < nodes.len() { out.push(DShape::arrow(Rect::new(x + unit, y + h*0.3, x + unit*(1.0+gap), y + h*0.7), PresetShape::RightArrow)); }
    }
    out
}

fn layout_hierarchy(root: &DNode, b: Rect) -> Vec<DShape> {
    // Reingold–Tilford / Walker: ширины поддеревьев, затем центрирование родителя над детьми; помощники — в отдельной колонке
    let mut widths = HashMap::new();
    fn measure(n: &DNode, w: &mut HashMap<NodeId, f64>) -> f64 {
        let kids: f64 = n.children.iter().filter(|c| c.role != Role::Assistant).map(|c| measure(c, w)).sum::<f64>();
        let me = kids.max(1.0) + n.children.iter().filter(|c| c.role != Role::Assistant).count().saturating_sub(1) as f64 * 0.25;
        w.insert(n.id, me); me
    }
    let total = measure(root, &mut widths);
    let depth = root.depth();
    let cell_w = b.width() / total; let cell_h = b.height() / (depth as f64 * 1.6 - 0.6);
    let mut out = vec![];
    fn place(n: &DNode, x0: f64, level: usize, w: &HashMap<NodeId, f64>, cw: f64, ch: f64, b: Rect, out: &mut Vec<DShape>) {
        let cx = x0 + w[&n.id] * cw / 2.0;
        let r = Rect::from_center_size((cx, b.y0 + level as f64 * ch * 1.6 + ch / 2.0), (cw.min(2.5*ch) * 0.9, ch));
        out.push(DShape::block(n.id, r, PresetShape::Rect, &n.text));
        let mut x = x0;
        for c in n.children.iter().filter(|c| c.role != Role::Assistant) {
            place(c, x, level + 1, w, cw, ch, b, out);
            out.push(DShape::elbow_connector(n.id, c.id));             // ортогональный коннектор «локтем»
            x += (w[&c.id] + 0.25) * cw;
        }
    }
    place(root, b.x0, 0, &widths, cell_w, cell_h, b, &mut out);
    out
}

Цикл: n узлов по окружности радиуса min(w,h)/2 − r_node, угол 2π/n, стрелки — дуги между соседями (blockArc с adj углов). Пирамида: n трапеций равной высоты, ширина линейно от 100 % к 30 %. Венн: окружности с перекрытием 40 % радиуса, прозрачность заливки 50 %. Матрица: 2×2 с общим центром. Воронка: сегменты с уменьшением ширины по кубической кривой. Общий масштаб шрифта: для каждого узла — максимальный fontScale из лестницы §5.2, по диаграмме — минимум из них (как dgm:… autofit), чтобы все узлы имели один размер. Направление RTL — зеркалирование x. Результат — обычные фигуры слайда в группе с меткой diagram (редактирование фигур вручную помечает диаграмму «ручная», автораскладка выключается до «Восстановить»).

5.7 Генерация миниатюр

ThumbnailService (поток пула rayon, приоритетная очередь): задание (slide_id, revision, width_px); рендер слайда в offscreen SkSurface (GPU, если доступен, иначе CPU) в масштабе width_px / slide_w, финальное состояние анимаций (все объекты видимы), без переходов; результат — SkImage в LRU-кэше (лимит 256 МБ), ключ (slide_id, revision, width). Приоритет: видимые миниатюры > соседние (±5) > остальные; при прокрутке — перезапрос с отменой устаревших. Инвалидация — по Slide.revision (инкремент при любой операции undo-журнала, затрагивающей слайд, макет, образец или тему — изменение образца инвалидирует все слайды его макетов). Размеры: 96, 160, 240, 320 px для панели, 15–100 % для сортировщика (рендер по требованию с кэшем уровня). thumbnail.png пакета — первый слайд 256×144 при сохранении. Диаграммы, таблицы и видео (постер) рисуются тем же списком отображения, что и холст.

5.8 Экспорт видео

Конвейер meridian-video:

ShowSession (виртуальные часы, детерминированные шаги) → ShowRenderer (offscreen Skia GPU, N×M) → кадр (SkImage, BGRA/NV12)
    → VideoEncoder (платформенный) ─┐
Аудиомикшер (закадровый голос + медиа слайдов + звуки переходов, 48 кГц стерео) → AudioEncoder ─┤→ Muxer (mp4 / webm) → файл

pub trait VideoEncoder: Send { fn new(cfg: &VideoCfg) -> Result<Self> where Self: Sized; fn encode(&mut self, frame: &Frame, pts_ns: i64) -> Result<Vec<Packet>>; fn finish(&mut self) -> Result<Vec<Packet>>; }
pub trait AudioEncoder: Send { fn encode(&mut self, pcm: &[f32], pts_ns: i64) -> Result<Vec<Packet>>; fn finish(&mut self) -> Result<Vec<Packet>>; }
pub trait Muxer { fn add_video(&mut self, codec: CodecParams) -> TrackId; fn add_audio(&mut self, codec: CodecParams) -> TrackId; fn write(&mut self, track: TrackId, pkt: Packet) -> Result<()>; fn finish(self) -> Result<()>; }

Мультиплексоры — собственные писатели в Rust: MP4 (ISO BMFF: ftyp/moov/mdat, avc1+avcC, mp4a/Opus, таблицы stts/stsc/stsz/stco, moov в конце с последующим «faststart»-переносом) и WebM (EBML/Matroska: Segment/Info/Tracks/Cluster/SimpleBlock, Cues). Кадры: время кадра t = i / fps, ShowSession.seek_virtual(t) выбирает слайд/шаг/переход по хронометражу; рендер — те же sample() и Transition::draw, что при показе, поэтому видео совпадает с показом по кадрам. Чтение кадра с GPU — SkSurface::readPixels в NV12 (конверсия на GPU шейдером) либо нулевая копия (D3D11-текстура → MF, CVPixelBuffer → VideoToolbox) — P1. Медиа слайдов декодируются платформенным декодером в тот же виртуальный таймлайн (видео — кадр по t − t_start, аудио — в микшер). Производительность: 1080p30 быстрее реального времени ≥ 2× на ноутбуке 2020 года. Прогресс по кадрам, отмена — мгновенная (частичный файл удаляется).

5.9 Режим докладчика: два окна и синхронизация

┌──────────────┐   команды (Next/Prev/GoTo/Pen/Laser/Black/…)   ┌──────────────────────┐
│ ShowWindow   │ ───────────────────────────────────────────────▶│ ShowSession (Rust)   │
│ (экран 2)    │◀──── watch::Receiver<ShowState> (снимок) ────── │  state: ShowState    │
└──────────────┘                                                  │  plan: Plan          │
┌──────────────┐ ───────────────────────────────────────────────▶│  clock: ShowClock    │
│ Presenter    │◀──── watch::Receiver<ShowState> ─────────────── │  ink/laser буферы    │
│ Window (1)   │                                                  └──────────────────────┘
└──────────────┘

• ShowState { slide_idx, step, step_started_at, transition: Option<(from, to, started_at, kind)>, mode: Normal|Black|White|Grid|Zoom(rect), pointer: Arrow|Laser(p)|Pen|Marker|Eraser, ink: Vec<Stroke>, paused, elapsed } — единственный источник истины; изменения — только через ShowSession::apply(cmd) (один поток-владелец, команды из обоих окон по каналу). Оба окна подписаны (watch) и перерисовываются по своему vsync, беря состояние и своё время кадра у общих часов (ShowClock — Instant-монотонные), поэтому анимации идут синхронно независимо от частот экранов (60/120 Гц).
• ShowWindow рендерит полный кадр ShowRenderer::render(state, t); PresenterWindow — тот же рендер в меньшем размере (своя GPU-поверхность; кэш слайда-текстуры общий через SkImage только при одном контексте — иначе рендерится повторно, это дёшево) плюс «следующий шаг»: plan.final_state(step+1) или первый кадр следующего слайда; заметки — text-layout.
• Лазер/перо: координаты в долях слайда, штрихи сглаживаются (Catmull-Rom + упрощение RDP), сохраняются в ink.
• Экраны: QGuiApplication::screens(); политика по умолчанию: показ — на экране, не содержащем окно редактора; swap — обмен; на Wayland — QWindow::setScreen(screen); showFullScreen() (xdg_toplevel.set_fullscreen(output)); при одном экране докладчик — окно поверх с уменьшенным показом или только показ. Горячее подключение экрана во время показа — пересчёт.
• Клавиатура и кликеры (USB-HID «PageUp/PageDown», Bluetooth-пульты) приходят в любое окно → apply.
• Пульт на телефоне [Pro] — локальный HTTP/WebSocket-сервер в процессе показа с кодом подключения; команды — тот же apply.

5.10 Морфинг (P1)

Сопоставление фигур между слайдами A и B: явное по имени !!ключ, затем по ShapeId (дубликат слайда сохраняет id), затем эвристика (одинаковый тип + близкие размеры/текст). Для пар: интерполяция xfrm (положение, размер, поворот по кратчайшей дуге), цветов (в OKLab), прозрачности; геометрии — если обе Preset одного типа → интерполяция adj, иначе — контуры приводятся к одинаковому числу сегментов (ресэмплинг по длине дуги) и интерполируются поточечно; текст — по словам/символам (позиции глифов из раскладки). Непарные фигуры — выцветание. Ease — EaseInOutCubic, длительность по умолчанию 2 с.

5.11 Текст по абзацам при импорте и «уровни» pptx

Для bldP build="p" каждый абзац получает собственный поднабор треков с grpId; при advAuto задержка между абзацами берётся из атрибута, иначе — из структуры дерева (отдельные par на абзац с p:txEl/p:pRg). Экспорт — обратное преобразование.

6. MeridianScript API для Slides

Пространство имён meridian.slides (TypeScript-типы поставляются с редактором скриптов; выполнение — QuickJS-ng в песочнице). Все изменения через API идут через undo-журнал (одна скриптовая транзакция = один шаг отмены).

Примеры:

// Слайды из таблицы Sheets: по строке на слайд / One slide per row of a Sheets range
import { sheets, slides } from "meridian";
const wb = await sheets.open("Проекты.msx");
const rows = wb.sheet("Проекты").range("A2:C20").values as [string, string, number][];
const pres = slides.activePresentation;
const layout = pres.layouts.byName("Заголовок и объект");
for (const [name, owner, budget] of rows) {
  const s = pres.slides.add(layout);
  s.shapes.placeholders.title.textFrame.text = name;
  s.shapes.placeholders.body.textFrame.text = `Ответственный: ${owner}\nБюджет: ${budget.toLocaleString("ru-RU")} ₽`;
  s.transition.kind = "push"; s.transition.params = { dir: "left" }; s.transition.duration = 0.5;
}

// Единые переходы и анимация заголовков во всей презентации / Uniform transitions and title animation
const pres = slides.activePresentation;
for (const s of pres.slides) {
  s.transition.kind = "fade"; s.transition.duration = 0.7;
  const title = s.shapes.placeholders.title;
  if (title) s.timeline.add(title, "entrance.fade", { start: "with", duration: 0.5 });
}

// Замена текста везде, включая заметки, с отчётом / Replace text everywhere incl. notes
let n = 0;
for (const s of slides.activePresentation.slides) {
  for (const sh of s.shapes) if (sh.textFrame) n += sh.textFrame.replace("ООО «Старое»", "ООО «Новое»", { wholeWord: true });
  n += s.notes.replace("ООО «Старое»", "ООО «Новое»");
}
slides.ui.toast(`Заменено: ${n}`);

// Таймер показа и событие смены слайда: пишем в лог продолжительность каждого слайда / Log time per slide during show
const t: Record<number, number> = {}; let last = Date.now(), cur = 0;
slides.show.on("slideChange", (e) => { t[cur] = (t[cur] ?? 0) + (Date.now() - last); last = Date.now(); cur = e.index; });
slides.show.on("end", () => console.table(t));

// Экспорт: PDF с заметками и видео 1080p / Export PDF with notes and 1080p video
await slides.activePresentation.exportPdf({ path: "отчёт.pdf", notes: true, bookmarks: "sections" });
await slides.activePresentation.exportVideo({ path: "отчёт.mp4", format: "mp4", height: 1080, fps: 30, useTimings: true });

7. Форматы

7.1 Сводка

7.2 PPTX — особенности

Структура: ppt/presentation.xml (sldMasterIdLst, sldIdLst, sldSz, notesSz, defaultTextStyle, custShowLst, extLst/p14:sectionLst), ppt/slides/slideN.xml (+ _rels: макет, медиа, диаграммы, схемы, заметки, комментарии), ppt/slideLayouts/, ppt/slideMasters/, ppt/theme/, ppt/notesSlides/, ppt/notesMasters/, ppt/handoutMasters/, ppt/comments/ (+ modernComment_*.xml, authors.xml), ppt/presProps.xml (showPr), ppt/viewProps.xml, ppt/tableStyles.xml, ppt/media/, ppt/embeddings/, ppt/charts/, ppt/diagrams/, ppt/fonts/, ppt/vbaProject.bin.

Известные трудности: авто-вычисление геометрии групп (chOff/chExt масштабирование детей), p:ph без idx, пустые spPr, порядок rels, кодировка идентификаторов комментариев, mc:AlternateContent с несколькими вариантами (берём Requires из известных нам пространств имён, иначе Fallback).

7.3 PPT (бинарный)

OLE2-контейнер: потоки PowerPoint Document, Pictures, Current User, Summary Information, VBA. Записи (RecordHeader: recVer/recInstance/recType/recLen) → контейнеры DocumentContainer, MainMasterContainer, SlideContainer, NotesContainer; графика — OfficeArt (Escher): OfficeArtDgContainer → OfficeArtSpContainer → OfficeArtFSP (тип msospt* → таблица соответствия 202 типов с prstGeom) + OfficeArtFOPT (свойства: геометрия pVertices/pSegmentInfo для произвольных форм, заливки, линии, текст). Текст: TextHeaderAtom, TextCharsAtom (UTF-16) / TextBytesAtom (ANSI, кодовая страница по языку — для русских файлов cp1251), StyleTextPropAtom, TextRulerAtom; «внешние» вставки TextSpecialInfoAtom. Анимации 2002+: PP10SlideBinaryTagExtension с TimeNodeContainer — отображаются в наше дерево; старые AnimationInfoAtom — простые эффекты. Переходы — SlideShowSlideInfoAtom. Шифрование RC4 CryptoAPI — чтение P1. Запись P1: текст, фигуры, рисунки, образцы, переходы, заметки; анимации — только появление/выцветание/вылет; остальное — предупреждение «не сохраняется в этом формате».

7.4 ODP

ODF 1.3: office:presentation → draw:page (presentation:class у рамок: title, outline, subtitle, notes, graphic, object, chart, table, page-number, date-time, footer, header), draw:custom-shape + draw:enhanced-geometry (draw:type="ooxml-…", формулы draw:formula эквивалентны направляющим — один вычислитель с таблицей функций), style:master-page + presentation:page-layout + draw:layer-set, presentation:settings, presentation:show, presentation:header-decl/footer-decl/date-time-decl. Анимации — SMIL (anim:par/seq/iterate/animate/ set/animateMotion/animateColor/animateTransform/transitionFilter/audio/command) с presentation:node-type и presentation:preset-class/preset-id/preset-sub-type — те же пресеты, что в PowerPoint, поэтому дерево переносится почти без потерь. Переходы — smil:type/subtype в style:drawing-page-properties (barWipe, fade, pushWipe, …) + presentation:transition-speed, presentation:duration.

Потери при записи в ODP: темы (ODF без тем — LibreOffice 7.6+ понимает loext:theme, пишем её и явные стили), стили таблиц (пишем явные стили ячеек), эффекты свечения/отражения (loext:glow, loext:softedge для LibreOffice, иначе отбрасываются), современные переходы без SMIL-аналога (fracture, morph → fade), триггеры по закладкам медиа, комментарии с ответами (officeooo:annotation — плоские), встроенные шрифты (P2), диаграммы-схемы — группа фигур (так же делает LibreOffice).

7.5 Keynote

.key — пакет (zip или папка): Index/*.iwa (snappy-сжатые блоки Protobuf, типы сообщений TSP/TSK/TSWP/TSD/TST/TSCH/KN — схема восстановлена сообществом; свои .proto поддерживаем в meridian-codecs-iwork), Data/ (медиа), Metadata/, preview.jpg. Читаем: слайды, мастера, фон, текст со стилями, фигуры (пути Безье → custGeom; стандартные Keynote-формы → prstGeom), рисунки с масками, таблицы (TST), диаграммы (TSCH, основные типы), переходы и построения (таблица соответствий: Magic Move → морфинг P1, Dissolve → fade, Push/Wipe/Cube/Flip/Doorway → наши, прочие (Anvil, Sparkle…) → ближайший + предупреждение), заметки докладчика. Шрифты Apple заменяются метрически близкими. Keynote '09 (index.apxl XML) — отдельный разбор, тот же результат. Запись .key не планируется.

8. Горячие клавиши

Схема по умолчанию — Microsoft Office (Windows/Linux: Ctrl, macOS: ⌘). Схема LibreOffice и своя — в настройках.

8.1 Редактор

8.2 Показ слайдов

9. Критерии готовности 1.0

10. Риски

11. Вопросы к библии

1. Ctrl+K. Библия назначает Ctrl/⌘+K командной палитре, но в Microsoft Office это «Гиперссылка» — привычка, которую принцип «не ломать привычки» велит сохранить. Предложение: палитра — Ctrl+Shift+P (как в VS Code) с дублем F1, гиперссылка — Ctrl+K; либо оставить палитру на Ctrl+K, а гиперссылку перенести на Ctrl+Shift+K (так принято в этом документе до решения).
2. Общий модуль «диаграммы-схемы». SmartArt есть в Word/Excel/PowerPoint; предлагается добавить в §2.2 библии модуль ядра Meridian Diagram (meridian-diagram), как Meridian Chart.
3. Общая сцена фигур. Write (§2.8) и Slides опираются на один крейт геометрии/стилей фигур; предлагается явно назвать его в §2.2 (Meridian Scene, meridian-scene) и завести docs/algorithms/scene.md (prstGeom, стили, рендер).
4. Видеокодеки. Нужна политика по лицензиям кодеров (платформенные API vs. бандл OpenH264/libvpx) в разделе стека; здесь принято: Windows/macOS — системные кодеры, Linux — WebM по умолчанию.
5. Редакция для экспорта видео. docs/10-licensing-accounts.md относит slides_video_export к Pro; библия §9.1 для Free говорит «все форматы чтения/записи». Нужно решить, считается ли видео «форматом записи» (тогда Free) или функцией Pro.
6. Путь спецификации Chart. docs/apps/sheets.md ссылается на docs/kernel/chart.md, а документ движка написан как docs/algorithms/chart-engine.md — выбрать одно расположение и исправить ссылку.