Управление объектами чернил презентации в .NET

Введение

PowerPoint предоставляет функцию чернил, позволяющую рисовать свободные штрихи. Чернила можно использовать для выделения других объектов, отображения связей и процессов, а также привлечения внимания к определённым элементам на слайде.

Пространство имён Aspose.Slides.Ink содержит классы и интерфейсы, необходимые для работы с объектами чернил. Например, интерфейс IInk представляет объект чернил на слайде.

Различия между обычными объектами и объектами чернил

Объекты на слайде PowerPoint обычно представлены объектами формы. В самой простой форме форма — это контейнер, определяющий область самого объекта (его рамку) вместе с такими свойствами, как размер контейнера, форма и фон. Для получения дополнительной информации смотрите Shape Layout Format.

Однако когда PowerPoint обрабатывает объект чернил, он игнорирует все свойства рамки объекта (контейнера), за исключением его размеров. Размер области контейнера определяется стандартными свойствами IShape.Width и IShape.Height:

ink_powerpoint1

Траекты чернил

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

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

ink_powerpoint2

Свойства кисти для рисования

Кисть используется для рисования линий, соединяющих точки траекта чернил. Кисть имеет собственный цвет и размер, представленные свойствами 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 отображает её размер так:

ink_powerpoint3

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

ink_powerpoint4

Контейнер (рамка) не учитывает размер кистей — он всегда предполагает, что толщина линии равна нулю (см. предыдущее изображение).

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

ink_powerpoint5

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

ink_powerpoint6

Управление внешним видом чернил при экспорте и рендеринге

Aspose.Slides предоставляет интерфейс IInkOptions для управления тем, как объекты чернил отображаются в экспортированных или отрендеренных результатах. С помощью его свойств можно полностью скрыть чернила или изменить способ интерпретации операций маски кисти чернил.

Параметры чернил доступны через параметры экспорта или рендеринга для нескольких типов вывода:

Вывод Свойство параметров чернил
PDF 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 и растровых изображений слайдов через соответствующие параметры экспорта или рендеринга, указанные выше.

Дополнительные материалы