Работа с документом в PostScript | С++

Создать документ PS

Aspose.Page для C++ предлагает два конструктора для создания класса PsDocument. Следующий фрагмент кода создает одностраничный документ PS:

    // The path to the documents directory.
    System::String dir = RunExamples::GetDataDir_WorkingWithDocument();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dir + u"document.ps", System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_0({ outPsStream});
        // ------------------------------------------
        
        try
        {
            //Create save options
            System::SharedPtr<PsSaveOptions> options = System::MakeObject<PsSaveOptions>();
            //If you want to aassign page size other than A4, set page size in options
            options->set_PageSize(PageConstants::GetSize(PageConstants::SIZE_A4(), PageConstants::ORIENTATION_PORTRAIT()));
            //If you want to aassign page margins other empty, set page margins in options
            options->set_Margins(PageConstants::GetMargins(PageConstants::MARGINS_ZERO()));
            //If you plan to use fonts that located in non system folders, set additional fonts folders in options
            options->set_AdditionalFontsFolders(System::MakeArray<System::String>({dir}));
            
            //Set variable that indicates if resulting PostScript document will be multipaged
            bool multiPaged = false;
            
            // Create new multipaged PS Document with one page opened
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, multiPaged);
            
            //Close current page
            document->ClosePage();
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

Если документ PS планируется сделать многостраничным, установите для переменной multiPaged значение true.

Другой конструктор позволяет создать объект PsDocument с определенным количеством страниц:

//Create output stream for PostScript document
using (Stream outPsStream = new FileStream(dir + "document.ps", FileMode.Create))
{
    //Create save options
    PsSaveOptions options = new PsSaveOptions();
    
    // Create new multipaged PS Document with 2 pages. These two pages are not created. It must be added by AddPage() method.
    PsDocument document = new PsDocument(outPsStream, options, 2);
    
    //Adding pages and it's content
    
    //Save the document
    document.Save();
}
    // The path to the documents directory.
    System::String dir = RunExamples::GetDataDir_WorkingWithDocument();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dir + u"document.ps", System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_0({ outPsStream});
        // ------------------------------------------
        
        try
        {
            //Create save options
            System::SharedPtr<PsSaveOptions> options = System::MakeObject<PsSaveOptions>();
            
            // Create new multipaged PS Document with 2 pages. These two pages are not created. It must be added by AddPage() method.
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, 2);
            
            //Adding pages and it's content

            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

See working with PS document in Java.

Давайте посмотрим на класс PsSaveOptions, который инкапсулирует возможные параметры, помогающие создать правильный документ PostScript.

• SaveFormat определяет выходной формат документов. Может быть ПС или ЭПС. В библиотеке Aspose.Page различия между этими двумя форматами отражаются только в комментариях PostScript и расширении файла. Также в соответствии со спецификацией файла EPS файлы EPS должны быть одностраничными. По умолчанию используется формат PS.

• PageSize определяет размер страниц в документе PS. Однако, если необходимо, мы можем назначить разные размеры для каждой страницы. Размер страницы можно получить из класса PageConstants, как показано в следующем примере:

    options->set_PageSize(PageConstants::GetSize(PageConstants::SIZE_International(), PageConstants::ORIENTATION_PORTRAIT()));

Размер страницы по умолчанию — «А4» в «Портретной» ориентации.

• Поля – указывают пустые поля между границами страницы и левым, верхним, правым и нижним краями содержимого страницы. Его можно получить из класса PageConstants.

    options->set_Margins(PageConstants::GetMargins(PageConstants::MARGINS_SMALL())); // 20 points for each margin

Поля по умолчанию — «НОЛЬ» (0, 0, 0, 0).

• BackGroundColor определяет цвет фона страницы. Может быть назначен как:

    options->set_BackgroundColor(Color::FromArgb(211, 8, 48));

или:

    options->set_BackgroundColor(System::Drawing::Color::get_Yellow());

Значение по умолчанию — «ноль», что означает отсутствие фона.

• EmbedFonts управляет поведением PsDocument при сохранении его в файл. Если установлено значение «false», используемые шрифты не будут записываться в PS-файл. В этом случае интерпретатор PostScript выдаст ошибку, если используемый шрифт не может быть найден в системных папках на целевом хосте.

• EmbedFontsAs управляет способом внедрения шрифтов в файл PS. На данный момент два формата шрифтов TrueType и Type3 работают. Значение можно установить с помощью класса FontConstants, как показано ниже:

    options->set_EmbedFontsAs(FontsConstants::EMBED_FONTS_TYPE3);

Значение по умолчанию — «TrueType».

• JpegQualityLevel определяет уровень сжатия/качества изображений в результирующем документе PS. Чем больше качества требуется, тем меньше будет сжатие, и наоборот. Минимальное качество — 0, максимальное — 100. По умолчанию — 75.

• AdditionalFontsFolder указывает места, где можно найти шрифты. Папки системных шрифтов всегда включены по умолчанию.

• Debug позволяет выводить отладочную информацию на консоль. Значение по умолчанию — ложь.

Вы можете загрузить примеры и файлы данных с сайта GitHub.