Кисти кода и градиенты XPS

C++ API решение для работы с кистями и градиентами (gradients) файлов XPS.

 

Решение(Solution) API Aspose.Page для C++ предоставляет возможности для управления векторной графикой файлов XPS. Оно позволяет создавать различные геометрические фигуры разных цветов и текстур (textures). Ознакомьтесь с документацией Aspose.Page о том, как работать с кистями .

Чтобы манипулировать кистями (brushes) и градиентами файлов XPS, нам потребуются:

  • API Aspose.Page для C++, который представляет собой многофункциональный, мощный и простой в использовании API для управления документами и их преобразования для платформы C++.

  • Вы можете загрузить его последнюю версию напрямую: просто откройте диспетчер пакетов NuGet (NuGet package manager), выполните поиск Aspose.Page.Cpp и установите его. Вы также можете использовать следующую команду в консоли диспетчера пакетов (Package Manager Console).

Package Manager Console Command


    PM> Install-Package Aspose.Page.Cpp

Работайте с визуальными кистями (visual brushes) на C++

API Aspose.Page для C++ позволяет добавлять сетку (grid) к файлам XPS с помощью нескольких строк кода. Это может быть реализовано(выполнено) как для новых, так и для существующих документов. Класс XpsVisualBrush используется для установки свойств сетки с использованием объектов XpsPathGeometry и XpsCanvas . Чтобы добавить сетку в документ XPS, вам необходимо будет выполнить следующие действия(шаги):

  1. С помощью класса XpsDocument создайте объект Document
  2. Создайте объект XpsPathGeometry с заданными (определенными) необходимыми сегментами(segments).
  3. Используйте класс XpsCanvas, чтобы задать преобразование рендеринга (rendering transformation).
  4. Отрегулируйте по желанию свойства(от желаемого) заливки(Fill) и непрозрачности(Opacity).
  5. Сохраните документ с помощью вызова Метода Save().
Namespaces in use
using Aspose::Page::XPS;
using Aspose::Page::XPS::XpsModel;
using System::Drawing;
Использование визуальной кисти для создания сетки(grid)
    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithVisualBrush();
    
    System::SharedPtr<XpsDocument> doc = System::MakeObject<XpsDocument>();

	// Geometry for magenta grid VisualBrush
    System::SharedPtr<XpsPathGeometry> pathGeometry = doc->CreatePathGeometry();
    pathGeometry->AddSegment(doc->CreatePolyLineSegment(System::MakeArray<System::Drawing::PointF>({System::Drawing::PointF(240.f, 5.f), System::Drawing::PointF(240.f, 310.f), System::Drawing::PointF(0.f, 310.f)})));
    pathGeometry->idx_get(0)->set_StartPoint(System::Drawing::PointF(0.f, 5.f));
    
    // Canvas for magenta grid VisualBrush
    System::SharedPtr<XpsCanvas> visualCanvas = doc->CreateCanvas();
    
    System::SharedPtr<XpsPath> visualPath = visualCanvas->AddPath(doc->CreatePathGeometry(u"M 0,4 L 4,4 4,0 6,0 6,4 10,4 10,6 6,6 6,10 4,10 4,6 0,6 Z"));
    visualPath->set_Fill(doc->CreateSolidColorBrush(doc->CreateColor(1.f, .61f, 0.1f, 0.61f)));
    
    System::SharedPtr<XpsPath> gridPath = doc->AddPath(pathGeometry);

	//Create Visual Brush, it is specified by some XPS fragment (vector graphics and glyphs)
    gridPath->set_Fill(doc->CreateVisualBrush(visualCanvas, System::Drawing::RectangleF(0.f, 0.f, 10.f, 10.f), System::Drawing::RectangleF(0.f, 0.f, 10.f, 10.f)));
    (System::ExplicitCast<Aspose::Page::XPS::XpsModel::XpsVisualBrush>(gridPath->get_Fill()))->set_TileMode(Aspose::Page::XPS::XpsModel::XpsTileMode::Tile);
    // New canvas
    System::SharedPtr<XpsCanvas> canvas = doc->AddCanvas();
    canvas->set_RenderTransform(doc->CreateMatrix(1.f, 0.f, 0.f, 1.f, 268.f, 70.f));
    // Add grid
    canvas->AddPath(pathGeometry);
    
	// Red transparent rectangle in the middle top
    System::SharedPtr<XpsPath> path = canvas->AddPath(doc->CreatePathGeometry(u"M 30,20 l 258.24,0 0,56.64 -258.24,0 Z"));
    path = canvas->AddPath(doc->CreatePathGeometry(u"M 10,10 L 228,10 228,100 10,100"));
    path->set_Fill(doc->CreateSolidColorBrush(doc->CreateColor(1.0f, 0.0f, 0.0f)));
    path->set_Opacity(0.7f);
    
	// Save resultant XPS document
    doc->Save(dataDir + u"output/" + u"AddGrid_out.xps");

Добавьте горизонтальный градиент (horizontal gradient) с помощью C++.

Решение(Solution) API Aspose.Page для C++ позволяет добавлять различные типы градиентов в документы XPS с помощью класса XpsGradientBrush . Этот класс используется для предоставления информации из XpsGradientStop и XpsPath объекту XpsDocument, кторый представляет файл XPS. Вот пример того, как это сделать:

  1. Инициализируйте(Initialize) объект XpsDocument.
  2. Задайте(Определите) параметры XpsGradientStop и XpsPath для документа XPS.
  3. Задайте(Настройте) параметры (информацию) рендеринга (rendering information).
  4. Сохраните документ, используя Метод Save().
Вставьте горизонтальный градиент в формат XPS
    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithGradient();
    // Create new XPS Document
    System::SharedPtr<XpsDocument> doc = System::MakeObject<XpsDocument>();
    
	// Initialize List of XpsGradentStop
    System::SharedPtr<System::Collections::Generic::List<System::SharedPtr<XpsGradientStop>>> stops = System::MakeObject<System::Collections::Generic::List<System::SharedPtr<XpsGradientStop>>>();
    stops->Add(doc->CreateGradientStop(doc->CreateColor(255, 244, 253, 225), 0.0673828f));
    stops->Add(doc->CreateGradientStop(doc->CreateColor(255, 251, 240, 23), 0.314453f));
    stops->Add(doc->CreateGradientStop(doc->CreateColor(255, 252, 209, 0), 0.482422f));
    stops->Add(doc->CreateGradientStop(doc->CreateColor(255, 241, 254, 161), 0.634766f));
    stops->Add(doc->CreateGradientStop(doc->CreateColor(255, 53, 253, 255), 0.915039f));
    stops->Add(doc->CreateGradientStop(doc->CreateColor(255, 12, 91, 248), 1.f));
    
	// Create new path by defining geometery in abbreviation form
    System::SharedPtr<XpsPath> path = doc->AddPath(doc->CreatePathGeometry(u"M 10,210 L 228,210 228,300 10,300"));
    path->set_RenderTransform(doc->CreateMatrix(1.f, 0.f, 0.f, 1.f, 20.f, 70.f));
    path->set_Fill(doc->CreateLinearGradientBrush(System::Drawing::PointF(10.f, 0.f), System::Drawing::PointF(228.f, 0.f)));
    (System::ExplicitCast<Aspose::Page::XPS::XpsModel::XpsGradientBrush>(path->get_Fill()))->get_GradientStops()->AddRange(stops);
    
	// Save resultant XPS document
    doc->Save(dataDir + u"output/" + u"AddHorizontalGradient_outXPS.xps");

XPS Формат файла XPS

XPS (XML Paper Specification) — альтернативный Microsoft формат PDF, основанный на XML/HTML, сохраняет макет независимо от платформы.