Добавление текста в файлы PS

C++ API-решение для работы с текстом в файлах PS

 

PostScript — это мощный язык описания страниц, который обеспечивает детальный контроль над размещением и форматированием текста. Вот несколько ключевых нюансов, которые следует учитывать при работе с текстом в PostScript:

  • PostScript позволяет выбирать шрифты, используя их имена в формате PostScript. Распространенные шрифты, такие как Times Roman, Helvetica и Courier, часто доступны по умолчанию. Чтобы обеспечить согласованный рендеринг на разных системах, вы можете встраивать шрифты непосредственно в свой файл PostScript. Это особенно важно для пользовательских шрифтов или менее распространенных семейств шрифтов.
  • Размер и стиль шрифта — Оператор fontsize задает размер шрифта в пунктах. Чтобы изменить стили шрифта, используйте такие операторы, как setfont, который определяет жирный шрифт, курсив или другие варианты.
  • Позиционирование текста — Оператор moveto помещает текстовый курсор в определенную точку на странице. Хотя в PostScript нет прямых операторов выравнивания, его можно добиться путем тщательных вычислений.
  • Поворот и масштабирование текста — Оператор rotate можно использовать для поворота текста на определенный угол, а оператор scale — для увеличения или уменьшения размера текста.
  • Рендеринг текста — PostScript поддерживает антиалиасинг (сглаживание), который смягчает края текста для лучшей читаемости. Вы также можете управлять расстоянием между символами (кернинг) и строками (интерлиньяж), чтобы точно настроить внешний вид текста.

Понимание этих аспектов поможет обеспечить правильное использование шрифтов и согласованный рендеринг в рабочих процессах на базе PostScript. В любом случае Aspose.Page предоставляет функционал для легкого управления шрифтами в файлах PS. С помощью этого API вы можете добавлять текст различных цветов и кистей, используя пользовательские или системные шрифты. Чтобы узнать больше о том, как работать с файлами PS и, в частности, о том, как работать с текстом в файлах PS , обратитесь к документации.

Чтобы вставить текст в документы PS, нам потребуется:

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

  • Откройте менеджер пакетов NuGet, найдите Aspose.Page.Cpp и установите. Вы также можете использовать следующую команду в консоли менеджера пакетов.

Package Manager Console Command

    PM> Install-Package Aspose.Page.Cpp

Шаги по добавлению текста в файл PS.

Приведенный ниже фрагмент кода демонстрирует, как добавить текст с использованием строки Unicode в документ PostScript (PS) с помощью библиотеки Aspose.Page на C++. Чтобы увидеть более полную версию примера и другие примеры, перейдите в проект Aspose.Page-for-C++ на GitHub .

  1. Инициализируйте переменную dataDir путем к каталогу, содержащему документы.
  2. Установите в переменной FONTS_FOLDER путь к папке, содержащей необходимые шрифты.
  3. Создайте поток вывода для документа PostScript, используя класс FileStream.
  4. Укажите параметры сохранения для документа PostScript, используя объект PsSaveOptions .
  5. Свойство AdditionalFontsFolders объекта параметров устанавливается как массив, содержащий путь к FONTS_FOLDER. Это позволяет системе находить любые необходимые шрифты в этой папке.
  6. Укажите текст и его размер.
  7. Создайте новый экземпляр PsDocument с потоком вывода, параметрами и значением false. Это инициализирует новый документ PostScript с указанными параметрами.
  8. Вызовите метод ClosePage() у объекта документа, указывая, что текущая страница завершена.
  9. Используйте метод Save(), чтобы сохранить изменения, внесенные в документ PS.
C++ код для добавления текста в файл PS
    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithText();
    
    System::String FONTS_FOLDER = RunExamples::GetDataDir_Data() + u"necessary_fonts/";
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"AddText_outPS.ps", System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_0({ outPsStream});
        // ------------------------------------------
        
        try
        {
            //Create save options with A4 size
            System::SharedPtr<PsSaveOptions> options = System::MakeObject<PsSaveOptions>();
            // Set custom fonts folder. It will be added to system fonts folders for finding needed font.
            options->set_AdditionalFontsFolders(System::MakeArray<System::String>({FONTS_FOLDER}));
            //A text to write to PS file
            System::String str = u"ABCDEFGHIJKLMNO";
            int32_t fontSize = 48;
            
            // Create new 1-paged PS Document
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, false);
            
            ////////////////////////////////////// Using sysem font (located in system fonts folders) for filling text //////////////////
            System::SharedPtr<System::Drawing::Font> font = System::MakeObject<System::Drawing::Font>(u"Times New Roman", static_cast<float>(fontSize), System::Drawing::FontStyle::Bold);
            //Fill text with default or already defined color. In given case it is black.
            document->FillText(str, font, 50.0f, 100.0f);
            //Fill text with Blue color.
            document->FillText(str, font, 50.0f, 150.0f, System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Blue()));
            /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
            
            ////////////////////////////////////// Using custom font (located in custom fonts folders) for filling text /////////////////
            System::SharedPtr<DrFont> drFont = ExternalFontCache::FetchDrFont(u"Palatino Linotype", static_cast<float>(fontSize), System::Drawing::FontStyle::Regular);
            //Fill text with default or already defined color. In given case it is black.
            document->FillText(str, drFont, 50.0f, 200.0f);
            //Fill text with Blue color.
            document->FillText(str, drFont, 50.0f, 250.0f, System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Blue()));
            /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
            
            ////////////////////////////////////// Using sysem font (located in system fonts folders) for outlining text ////////////////
            //Outline text with default or already defined pen. In given case it is black colored 1-points width pen.
            document->OutlineText(str, font, 50.0f, 300.0f);
            //Outline text with blue-violet colored 2-points width pen.
            document->OutlineText(str, font, 50.0f, 350.0f, System::MakeObject<System::Drawing::Pen>(System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_BlueViolet()), 2.0f));
            //Fill text with orange color and stroke with blue colored 2-points width pen.
            document->FillAndStrokeText(str, font, 50.0f, 400.0f, System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Yellow()), System::MakeObject<System::Drawing::Pen>(System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_BlueViolet()), 2.0f));
            /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
            
            ////////////////////////////////////// Using custom font (located in custom fonts folders) for outlining text /////////////////
            //Outline text with default or already defined pen. In given case it is black colored 1-points width pen.
            document->OutlineText(str, drFont, 50.0f, 450.0f);
            //Outline text with blue-violet colored 2-points width pen.
            document->OutlineText(str, drFont, 50.0f, 500.0f, System::MakeObject<System::Drawing::Pen>(System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_BlueViolet()), 2.0f));
            //Fill text with orange color and stroke with blue colored 2-points width pen.
            document->FillAndStrokeText(str, drFont, 50.0f, 550.0f, System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Orange()), System::MakeObject<System::Drawing::Pen>(System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Blue()), 2.0f));
            ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
            
            /////////////////////////////// Using custom font (located in custom fonts folders) ang glyphs widths for filling text ////////
            drFont = ExternalFontCache::FetchDrFont(u"Palatino Linotype", static_cast<float>(fontSize), System::Drawing::FontStyle::Regular);
            //Glyphs widths
            System::ArrayPtr<float> widths = System::MakeArray<float>({87, 87, 87, 87, 34, 87, 87});
            //Fill ASCII text using with assigning glyphs widths.
            document->FillText(u"BAMBOOK", widths, drFont, 50.0f, 600.0f, System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Blue()));
            ///////////////////////////// Using custom font (located in custom fonts folders) ang glyphs widths for filling unicode text //
            //Glyphs widths
            widths = System::MakeArray<float>({87, 34, 87, 87, 87, 87, 87});
            //Fill Unicode text using with assigning glyphs widths.
            document->FillText(u"ЗООПАРК", widths, drFont, 50.0f, 650.0f, System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Orange()));
            ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
            
            //Close current page
            document->ClosePage();
            
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

PS What is PS File Format

PS (PostScript) — язык описания страниц, объединяющий текст и графику в один файл. Широко поддерживается графическими редакторами и принтерами, содержит инструкции для рендеринга страницы.