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

Введение

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

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

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

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

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

ink_powerpoint1

Следы чернил

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

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

ink_powerpoint2

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

Кисть используется для рисования линий, соединяющих точки следа чернил. Кисть имеет собственный цвет и размер, представленные методами IInkBrush.getColor и IInkBrush.getSize .

Установить цвет кисти чернил

Этот фрагмент кода Java показывает, как установить цвет кисти чернил:

import android.graphics.Color;
import com.aspose.slides.*;

Presentation presentation = new Presentation("pres.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IInk ink = (IInk) slide.getShapes().get_Item(0);
    IInkBrush brush = ink.getTraces()[0].getBrush();
    brush.setColor(Color.RED);
} finally {
    presentation.dispose();
}

Установить размер кисти чернил

Этот фрагмент кода Java показывает, как установить размер кисти чернил:

import com.aspose.slides.*;
import com.aspose.slides.android.SizeF;

Presentation presentation = new Presentation("pres.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IInk ink = (IInk) slide.getShapes().get_Item(0);
    IInkBrush brush = ink.getTraces()[0].getBrush();
    SizeF brushSize = new SizeF(5, 10);
    brush.setSize(brushSize);
} finally {
    presentation.dispose();
}

Как правило, ширина и высота кисти не совпадают, поэтому PowerPoint не отображает размер кисти (соответствующий раздел данных серый). Когда ширина и высота кисти совпадают, PowerPoint отображает её размер следующим образом:

ink_powerpoint3

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

ink_powerpoint4

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

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

ink_powerpoint5

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

ink_powerpoint6

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

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

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

Вывод Свойство параметров чернил
PDF PdfOptions.getInkOptions
HTML HtmlOptions.getInkOptions
SVG SVGOptions.getInkOptions
TIFF TiffOptions.getInkOptions
Изображение слайда RenderingOptions.getInkOptions

Следующие методы IInkOptions предоставляют те же два параметра:

  • IInkOptions.getHideInk определяет, включаются ли объекты чернил в вывод. Значение по умолчанию — false.
  • IInkOptions.getInterpretMaskOpAsOpacity определяет, интерпретируется ли операция маски как непрозрачность при рендеринге кисти чернил. Значение по умолчанию — true; вызовите IInkOptions.setInterpretMaskOpAsOpacity с false, чтобы вместо этого использовать операцию ROP.

Скрыть объекты чернил в выводе PDF

По умолчанию объекты чернил остаются видимыми при экспорте. Чтобы получить чистый вывод без рукописных аннотаций или другого содержимого чернил, вызовите IInkOptions.setHideInk с true.

Следующий пример на Java экспортирует презентацию в PDF, скрывая все объекты чернил:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    PdfOptions pdfOptions = new PdfOptions();
    pdfOptions.getInkOptions().setHideInk(true);

    presentation.save("presentation_without_ink.pdf", SaveFormat.Pdf, pdfOptions);
} finally {
    presentation.dispose();
}

Скрыть объекты чернил при рендеринге слайда как изображения

Чтобы скрыть объекты чернил при рендеринге слайдов как растровых изображений, настройте RenderingOptions.getInkOptions и передайте параметры рендеринга в ISlide.getImage.

Следующий пример на Java рендерит первый слайд как PNG‑изображение без объектов чернил:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    RenderingOptions renderingOptions = new RenderingOptions();
    renderingOptions.getInkOptions().setHideInk(true);

    ISlide slide = presentation.getSlides().get_Item(0);
    IImage image = slide.getImage(renderingOptions);
    try {
        image.save("slide_without_ink.png", ImageFormat.Png);
    } finally {
        image.dispose();
    }
} finally {
    presentation.dispose();
}

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

Параметр IInkOptions.getInterpretMaskOpAsOpacity контролирует, как операции маски интерпретируются при рендеринге кистей чернил. Значение по умолчанию — true, что использует непрозрачность. Чтобы вместо этого использовать операцию ROP, вызовите IInkOptions.setInterpretMaskOpAsOpacity с false.

Следующий пример на Java экспортирует слайд в SVG и использует рендеринг на основе ROP для операций маски чернил:

import com.aspose.slides.*;
import java.io.FileOutputStream;

Presentation presentation = new Presentation("presentation.pptx");
try {
    SVGOptions svgOptions = new SVGOptions();
    svgOptions.getInkOptions().setInterpretMaskOpAsOpacity(false);

    ISlide slide = presentation.getSlides().get_Item(0);
    FileOutputStream stream = new FileOutputStream("slide.svg");
    try {
        slide.writeAsSvg(stream, svgOptions);
    } finally {
        stream.close();
    }
} finally {
    presentation.dispose();
}

То же самое настройку можно применить через TiffOptions.getInkOptions при экспорте презентации или рендеринге слайда в TIFF.

Выберите, скрывать или сохранять чернила

Когда вам нужна чистая версия аннотированной презентации для распространения без отметок рецензии, вызовите IInkOptions.setHideInk с true во время экспорта.

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

Часто задаваемые вопросы

Можно ли изменить цвет или размер существующего штриха чернил?

Да. Получите след через IInk.getTraces, затем измените его IInkTrace.getBrush. Вызовите IInkBrush.setColor или IInkBrush.setSize для изменения кисти.

Изменяет ли скрытие чернил исходную презентацию?

Нет. Вызов IInkOptions.setHideInk влияет только на отрендеренный или экспортированный результат; он не удаляет и не изменяет объекты чернил в исходной презентации.

Какие форматы экспорта поддерживают параметры чернил?

Вы можете настроить параметры чернил для PDF, HTML, SVG, TIFF и растровых изображений слайдов через соответствующие параметры экспорта или рендеринга, указанные выше.

Дополнительные ресурсы

Фигуры PowerPoint SmartArt PowerPoint