Використання графічних утиліт XPS | Java

Як легко створювати основні форми в XPS

Специфікація XPS визначає графічні примітивні елементи, які можна використовувати для створення будь-яких складних форм. Aspose.Page для Java надає класи, що інкапсулюють ці елементи. Однак створення навіть відносно простих фігур, таких як круговий сектор чи сегмент, або правильний n-кутник, вписаний у коло або описаний навколо нього, може бути трохи виснажливим. Навіть намалювати коло чи еліпс не так просто, як могло б бути. Ось чому Aspose.Page також пропонує набір службових методів, які допоможуть заощадити час під час роботи над цими завданнями.

У прикладі нижче ми використовуємо всі доступні утиліти форми. Важливо зазначити, що кожен із цих методів утиліти повертає об’єкт XpsPathGeometry, який потім можна використовувати для створення шляхів XPS. І для цих контурів ви можете вказати властивості зовнішнього вигляду - пензлі, візерунок обведення, непрозорість тощо.

// For complete examples and data files, please go to https://github.com/aspose-page/Aspose.Page-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir();
// Create new XPS Document
final XpsDocument doc = new XpsDocument();
try {
    // Set first page's size.
    doc.getPage().setWidth(650f);
    doc.getPage().setHeight(240f);

    // Draw a circle with center (120, 120) and radius 100.
    XpsPath path = doc.createPath(doc.getUtils().createCircle(new Point2D.Float(120f, 120f), 100f));
    path.setFill(doc.createSolidColorBrush(Color.GREEN));
    doc.add(path);

    // Inscribe a regular pentagon in the circle.
    path = doc.createPath(doc.getUtils().createRegularInscribedNGon(5, new Point2D.Float(120f, 120f), 100f));
    path.setFill(doc.createSolidColorBrush(Color.RED));
    doc.add(path);

    // Circumscribe a regular hexagon around the circle.
    path = doc.createPath(doc.getUtils().createRegularCircumscribedNGon(6, new Point2D.Float(120f, 120f), 100f));
    path.setStroke(doc.createSolidColorBrush(Color.MAGENTA));
    path.setStrokeThickness(3f);
    doc.add(path);

    // Draw a sector of the circle centered at (340, 120), starting at -45 degrees and ending at +45 degrees.
    path = doc.createPath(doc.getUtils().createPieSlice(new Point2D.Float(340f, 120f), 100f, -45f, 45f));
    path.setStroke(doc.createSolidColorBrush(Color.RED));
    path.setStrokeThickness(5f);
    doc.add(path);

    // Draw a segment of the circle centered at (340, 120), starting at -45 degrees and ending at +45 degrees.
    path = doc.createPath(doc.getUtils().createCircularSegment(new Point2D.Float(340f, 120f), 100f, -45f, 45f));
    path.setFill(doc.createSolidColorBrush(Color.BLACK));
    doc.add(path);

    // Draw a rectangle with the top left vertex (530, 20), width 100 units and height 200 units.
    path = doc.createPath(doc.getUtils().createRectangle(new Rectangle2D.Float(530f, 20f, 100f, 200f)));
    path.setStroke(doc.createSolidColorBrush(Color.RED));
    doc.add(path);

    // Draw an ellipse with center (580, 120) and radii 50 and 100.
    path = doc.createPath(doc.getUtils().createEllipse(new Point2D.Float(580f, 120f), 50f, 100f));
    path.setFill(doc.createSolidColorBrush(Color.YELLOW));
    doc.add(path);

    doc.save(dataDir + "UseShapeUtilsXPS_out.xps");
} finally {
  if (doc != null)
    doc.close();
}

Ми починаємо зі створення нового документа XPS, а потім регулюємо розмір першої сторінки. Перша фігура, яку ми додаємо на сторінку, — суцільний зелений круг, визначений його центром і радіусом. Далі ми малюємо незафарбований червоним правильний п’ятикутник, вписаний у це коло. Потім йде правильний шестикутник, обведений пурпуровим кольором і описаний навколо кола.

Праворуч ми малюємо червоний круговий сектор (або «скибочку пирога») між -45 і +45 градусами, а потім чорний круговий сегмент з такими ж параметрами поверх сектора.

Остання частина креслення містить червоний прямокутник (зазначений верхнім лівим кутом і розмірами) і жовтий еліпс (зазначений його центром і радіусами), вписаний у прямокутник. В даному випадку обробляємо напис «від руки».

Ось очікуваний вихід у збереженому файлі XPS:

Як легко розмістити зображення на сторінці XPS

При використанні примітивів, визначених специфікацією XPS, розміщення зображення на сторінці включає два кроки:

• Додавання прямокутного контуру (поля зображення) для заповнення зображенням;
• Застосування пензля зображення до поля зображення, де вам потрібно вказати поле перегляду та вікно перегляду. Як правило, вам потрібно знати роздільну здатність і розмір у пікселях вашого зображення, щоб точно надати ці параметри.

Але, на щастя, серед графічних утиліт XPS в API Aspose.Page для Java є зручний метод, який може впоратися з більшою частиною роботи за вас. Він також пропонує стандартні режими підгонки. Давайте розглянемо наступний приклад:

// For complete examples and data files, please go to https://github.com/aspose-page/Aspose.Page-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir();
// Create new XPS Document
final XpsDocument doc = new XpsDocument();
try {
    // Set first page's size.
    doc.getPage().setWidth(540f);
    doc.getPage().setHeight(220f);

    // Draw the image box.
    Rectangle2D imageBox = new Rectangle2D.Float(10f, 10f, 200f, 200f);
    XpsPath path = doc.addPath(doc.getUtils().createRectangle(imageBox));
    path.setStroke(doc.createSolidColorBrush(Color.BLACK));
    // Add an image to fit width.
    path = doc.getUtils().createImage(dataDir + "R08LN_NN.jpg", imageBox, ImageMode.FitToWidth);
    // Prevent tiling.
    ((XpsImageBrush)path.getFill()).setTileMode(XpsTileMode.None);
    doc.add(path);

    // Add an image to fit width.
    doc.add(doc.getUtils().createImage(
        dataDir + "R08LN_NN.jpg", new Rectangle2D.Float(220f, 10f, 200f, 100f), ImageMode.FitToHeight));

    // Add an image to fit width.
    doc.add(doc.getUtils().createImage(
        dataDir + "R08LN_NN.jpg", new Rectangle2D.Float(430f, 10f, 100f, 200f), ImageMode.FitToBox));

    // Save resultant XPS document 
    doc.save(dataDir + "UseImageUtilsXPS_out.xps");
} finally {
  if (doc != null)
    doc.close();
}

Знову ми починаємо з нового документа XPS і змінюємо розмір першої сторінки. Варто зазначити, що за замовчуванням ваше зображення, яке використовується як пензель, розміщуватиметься по полі зображення так само, як якщо б воно використовувалося в режимі XpsTileMode.Tile. Однак у першій частині прикладу ми показуємо, як запобігти цій мозаїці. Отже, спочатку ми хочемо, щоб зображення відображалося в координатах (10, 10) і відповідало ширині прямокутної рамки, яка становить 200 одиниць завширшки та 200 одиниць заввишки. Щоб краще уявити результат, спочатку малюємо саму коробку. Потім ми переходимо до створення зображення (яке, по суті, є заповненим контуром). Нарешті, після отримання заливки шляху та його приведення до XpsImageBrush, ми встановлюємо для властивості TileMode значення XpsTileMode.None.

Праворуч ми розміщуємо те саме зображення, що відповідає висоті вікна зображення. Зверніть увагу на ефект плитки.

Нарешті, ми знову розміщуємо те саме зображення праворуч і регулюємо його, щоб відповідати висоті та ширині рамки зображення, що призводить до деякого спотворення зображення.

А ось результат у збереженому файлі XPS: