Додавання тексту до файлів 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) — мова опису сторінки, що об’єднує текст і графіку в одному файлі. Широко підтримується графічними редакторами та принтерами, містить інструкції для рендерингу сторінки.