Управление объектами чернил презентации в .NET
Введение
PowerPoint предоставляет функцию чернил, позволяющую рисовать свободные штрихи. Чернила можно использовать для выделения других объектов, отображения связей и процессов, а также привлечения внимания к определённым элементам на слайде.
Пространство имён Aspose.Slides.Ink содержит классы и интерфейсы, необходимые для работы с объектами чернил. Например, интерфейс IInk представляет объект чернил на слайде.
Различия между обычными объектами и объектами чернил
Объекты на слайде PowerPoint обычно представлены объектами формы. В самой простой форме форма — это контейнер, определяющий область самого объекта (его рамку) вместе с такими свойствами, как размер контейнера, форма и фон. Для получения дополнительной информации смотрите Shape Layout Format.
Однако когда PowerPoint обрабатывает объект чернил, он игнорирует все свойства рамки объекта (контейнера), за исключением его размеров. Размер области контейнера определяется стандартными свойствами IShape.Width и IShape.Height:

Траекты чернил
Траект — это базовый элемент, используемый для записи траектории пера, когда пользователь пишет цифровые чернила. Траект хранит последовательность соединённых точек.
Самая простая форма кодирования указывает координаты X и Y каждой точки‑образца. Когда все соединённые точки отрисовываются, они образуют изображение, подобное этому:

Свойства кисти для рисования
Кисть используется для рисования линий, соединяющих точки траекта чернил. Кисть имеет собственный цвет и размер, представленные свойствами IInkBrush.Color и IInkBrush.Size.
Установка цвета кисти чернил
Этот код C# демонстрирует, как установить цвет кисти чернил:
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Ink;
using var presentation = new Presentation("pres.pptx");
var ink = (IInk)presentation.Slides[0].Shapes[0];
var brush = ink.Traces[0].Brush;
brush.Color = Color.Red;
Установка размера кисти чернил
Этот код C# демонстрирует, как установить размер кисти чернил:
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Ink;
using var presentation = new Presentation("pres.pptx");
var ink = (IInk)presentation.Slides[0].Shapes[0];
var brush = ink.Traces[0].Brush;
brush.Size = new SizeF(5f, 10f);
Как правило, ширина и высота кисти не совпадают, поэтому PowerPoint не отображает размер кисти (соответствующий раздел данных затемнён). Когда ширина и высота кисти совпадают, PowerPoint отображает её размер так:

Для наглядности увеличим высоту объекта чернил и рассмотрим важные размеры:

Контейнер (рамка) не учитывает размер кистей — он всегда предполагает, что толщина линии равна нулю (см. предыдущее изображение).
Следовательно, чтобы определить видимую область всего объекта чернил, необходимо учитывать размер кисти его траектов. Здесь целевой объект (трасса рукописного текста) масштабирован до размеров контейнера (рамки). При изменении размеров контейнера размер кисти остаётся постоянным и наоборот.

PowerPoint использует аналогичное поведение для текстовых объектов:

Управление внешним видом чернил при экспорте и рендеринге
Aspose.Slides предоставляет интерфейс IInkOptions для управления тем, как объекты чернил отображаются в экспортированных или отрендеренных результатах. С помощью его свойств можно полностью скрыть чернила или изменить способ интерпретации операций маски кисти чернил.
Параметры чернил доступны через параметры экспорта или рендеринга для нескольких типов вывода:
| Вывод | Свойство параметров чернил |
|---|---|
PdfOptions.InkOptions |
|
| HTML | HtmlOptions.InkOptions |
| SVG | SVGOptions.InkOptions |
| TIFF | TiffOptions.InkOptions |
| Изображение слайда | RenderingOptions.InkOptions |
Через эти свойства доступны два одинаковых параметра:
HideInkопределяет, включать ли объекты чернил в вывод. Значение по умолчанию —false.InterpretMaskOpAsOpacityопределяет, интерпретировать ли операцию маски как непрозрачность при рендеринге кисти чернил. Значение по умолчанию —true; установитеfalse, чтобы использовать операцию ROP вместо неё.
Скрытие объектов чернил в выводе PDF
По умолчанию объекты чернил остаются видимыми при экспорте. Установите IInkOptions.HideInk в true, когда требуется чистый вывод без рукописных аннотаций или другого контента чернил.
Следующий пример C# экспортирует презентацию в PDF, скрывая все объекты чернил:
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("presentation.pptx");
var pdfOptions = new PdfOptions();
pdfOptions.InkOptions.HideInk = true;
presentation.Save("presentation_without_ink.pdf", SaveFormat.Pdf, pdfOptions);
Скрытие объектов чернил при рендеринге слайда в изображение
Чтобы скрыть объекты чернил при рендеринге слайдов в растровые изображения, настройте RenderingOptions.InkOptions и передайте параметры рендеринга методу ISlide.GetImage.
Следующий пример C# рендерит первый слайд в PNG‑изображение без объектов чернил:
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("presentation.pptx");
var renderingOptions = new RenderingOptions();
renderingOptions.InkOptions.HideInk = true;
using var image = presentation.Slides[0].GetImage(renderingOptions);
image.Save("slide_without_ink.png", ImageFormat.Png);
Управление рендерингом маски чернил
Свойство IInkOptions.InterpretMaskOpAsOpacity управляет тем, как операции маски интерпретируются при рендеринге кистей чернил. Значение по умолчанию — true, что использует непрозрачность. Установите свойство в false, чтобы вместо этого использовать операцию ROP.
Следующий пример C# экспортирует слайд в SVG и использует рендеринг на основе ROP для операций маски чернил:
using System.IO;
using Aspose.Slides;
using Aspose.Slides.Export;
using var presentation = new Presentation("presentation.pptx");
var svgOptions = new SVGOptions();
svgOptions.InkOptions.InterpretMaskOpAsOpacity = false;
using var stream = File.Create("slide.svg");
presentation.Slides[0].WriteAsSvg(stream, svgOptions);
То же самое можно применить через TiffOptions.InkOptions при экспорте презентации или рендеринге слайда в TIFF.
Выбор: скрывать или сохранять чернила
Используйте IInkOptions.HideInk со значением true, когда экспортируемый файл должен быть чистой версией аннотированной презентации, например, финальной копией, предназначенной для распространения без меток рецензирования.
Оставьте IInkOptions.HideInk со значением по умолчанию false, когда аннотации чернилом являются частью предполагаемого содержания, например, комментарии рецензирования, рукописные заметки, выделения или рисунки, которые должны оставаться видимыми в экспортированном результате. Это позволяет приложениям генерировать отдельные версии для рецензирования и финального результата из одной и той же презентации без изменения исходных объектов чернил.
FAQ
Можно ли изменить цвет или размер существующего штриха чернил?
Да. Получите траект из IInk.Traces, затем измените его IInkTrace.Brush. Вы можете задать свойства IInkBrush.Color и IInkBrush.Size.
Меняется ли исходная презентация при скрытии чернил?
Нет. IInkOptions.HideInk влияет только на отрендеренный или экспортированный результат; он не удаляет и не изменяет объекты чернил в исходной презентации.
Для каких форматов экспорта поддерживаются параметры чернил?
Вы можете настроить параметры чернил для PDF, HTML, SVG, TIFF и растровых изображений слайдов через соответствующие параметры экспорта или рендеринга, указанные выше.
Дополнительные материалы
- Чтобы узнать больше о формах в целом, см. раздел PowerPoint Shapes.
- Для получения информации об эффективных значениях см. Shape Effective Properties.
- Подробности экспорта в PDF — Convert PPT and PPTX to PDF.
- Подробности экспорта в HTML — Convert PowerPoint Presentations to HTML.
- Подробности экспорта в SVG — Render Presentation Slides as SVG Images.
- Подробности экспорта в TIFF — Convert PowerPoint Presentations to TIFF.
- Подробности рендеринга слайда в изображение — Convert Presentation Slides to Images.