Робота з кліпами в PostScript | C++

Додайте кліп у документ PS

Кліп у документі PS — це шлях, який обмежує вміст поточного стану графіки, який буде показано у засобі перегляду або редакторі PS. Вміст, що залишився за межами, буде відрізано.

Відсічний контур у C++ можна призначити трьома способами:

• за System.Drawing.Drawing2D.GraphicsPath, який може містити будь-які закриті форми;
• за планом тексту;
• на 1 bpp (біт на піксель) 2-кольорове зображення як трафаретна маска.

На даний момент бібліотека Aspose.Page для C++ пропонує перший і другий способи відсікання. У наведеному нижче прикладі ми отримуємо коло System.Drawing.Drawing2D.GraphicsPath із прямокутника як відсічного контуру та відрізаємо прямокутник із синьою заливкою в такому самому графічному стані.

Щоб додати кліп до нового PsDocument за допомогою бібліотеки Aspose.Page для C++ у цьому прикладі, ми виконуємо такі дії:

1. Створіть вихідний потік для отриманого файлу PS.
2. Створіть об’єкт PsSaveOptions із параметрами за замовчуванням.
3. Створіть 1-сторінковий PsDocument із уже створеним вихідним потоком і параметрами збереження.
4. Створіть новий графічний стан.
5. Створіть коло System.Drawing.Drawing2D.GraphicsPath із прямокутника.
6. Встановіть кліп із цим шляхом.
7. Установіть фарбу для поточного стану графіки PsDocument.
8. Заповніть контур прямокутника поточною фарбою.
9. Вихід із поточного стану графіки на верхній рівень.
10. Перекладіть на місце зафарбованого прямокутника.
11. Обведіть пунктирною лінією межі того самого прямокутника над зафарбованим, щоб показати межі обрізаного прямокутника з заливкою.
12. Закрийте сторінку.
13. Збережіть документ.

    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithCanvas();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"Clipping_outPS.ps", System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_0({ outPsStream});
        // ------------------------------------------
        
        try
        {
            //Create save options with default values
            System::SharedPtr<PsSaveOptions> options = System::MakeObject<PsSaveOptions>();
            
            // Create new 1-paged PS Document
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, false);
            
            //Create graphics path from the rectangle
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> rectanglePath = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            rectanglePath->AddRectangle(System::Drawing::RectangleF(0.0f, 0.0f, 300.0f, 200.0f));
            
            ////////////////////////////////////// Clipping by shape //////////////////////////////////////////////////////////////////////
            
            //Save graphics state in order to return back to this state after transformation
            document->WriteGraphicsSave();
            
            //Displace current graphics state on 100 points to the right and 100 points to the bottom.
            document->Translate(100.0f, 100.0f);
            
            //Create graphics path from the circle
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> circlePath = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            circlePath->AddEllipse(System::Drawing::RectangleF(50.0f, 0.0f, 200.0f, 200.0f));
            
            //Add clipping by circle to the current graphics state
            document->Clip(circlePath);
            
            //Set paint in the current graphics state
            document->SetPaint(System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Blue()));
            
            //Fill the rectangle in the current graphics state (with clipping)
            document->Fill(rectanglePath);
            
            //Restore graphics state to the previus (upper) level
            document->WriteGraphicsRestore();
            
            //Displace upper level graphics state on 100 points to the right and 100 points to the bottom.
            document->Translate(100.0f, 100.0f);
            
            System::SharedPtr<System::Drawing::Pen> pen = System::MakeObject<System::Drawing::Pen>(System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Blue()), 2.0f);
            pen->set_DashStyle(System::Drawing::Drawing2D::DashStyle::Dash);
            
            document->SetStroke(pen);
            
            //Draw the rectangle in the current graphics state (has no clipping) above clipped rectangle
            document->Draw(rectanglePath);
            
            ////////////////////////////////////// Clipping by text //////////////////////////////////////////////////////////////////////
            
            //Save graphics state in order to return back to this state after transformation
            document->WriteGraphicsSave();
            
            //Displace current graphics state on 100 points to the right and 100 points to the bottom.
            document->Translate(0.0f, 350.0f);
            
            int32_t fontSize = 120;
            System::SharedPtr<System::Drawing::Font> font = System::MakeObject<System::Drawing::Font>(u"Arial", static_cast<float>(fontSize), System::Drawing::FontStyle::Bold);
            
            //Clip rectangle by text's outline
            document->ClipText(u"ABC", font, 20.0f, static_cast<float>(fontSize + 10));
            document->Fill(rectanglePath);
            
            document->WriteGraphicsRestore();
            
            document->Translate(0.0f, 350.0f);
            
            document->SetStroke(pen);
            //Draw the rectangle in the current graphics state (has no clipping) above clipped rectangle
            document->Draw(rectanglePath);
            
            //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
            
            //Close current page
            document->ClosePage();
            
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

Див. роботу з кліпами в документах PS у Java.

Результат виконання цього коду виглядає як

У наступному прикладі ми отримуємо шрифт, який обрізає прямокутник із синьою заливкою контуром тексту.

Щоб додати фрагмент тексту до нового PsDocument за допомогою бібліотеки Aspose.Page для C++ у цьому прикладі, ми виконуємо такі кроки:

1. Створіть вихідний потік для отриманого файлу PS.
2. Створіть об’єкт PsSaveOptions із параметрами за замовчуванням.
3. Створіть 1-сторінковий PsDocument із уже створеним вихідним потоком і параметрами збереження.
4. Створіть новий графічний стан.
5. Створіть шрифт.
6. Встановіть кліп із текстом і шрифтом.
7. Установіть фарбу для поточного стану графіки PsDocument.
8. Заповніть контур прямокутника поточною фарбою.
9. Вихід із поточного стану графіки на верхній рівень.
10. Перекладіть на місце зафарбованого прямокутника.
11. Обведіть пунктирною лінією межі того самого прямокутника над зафарбованим, щоб показати межі обрізаного прямокутника з заливкою.
12. Закрийте сторінку.
13. Збережіть документ.

//Create an output stream for the PostScript document
using (Stream outPsStream = new FileStream(dataDir + "Clipping_outPS.ps", FileMode.Create))
{
    //Create save options with default values
    PsSaveOptions options = new PsSaveOptions();

    // Create a new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, options, false);

    //Create a graphics path from the rectangle
    GraphicsPath rectangePath = new GraphicsPath();
    rectangePath.AddRectangle(new RectangleF(0, 0, 300, 200));

    //Save the graphics state in order to return back to this state after transformation
    document.WriteGraphicsSave();

    //Displace the current graphics state on 100 points to the right and 100 points to the bottom.
    document.Translate(100, 100);
    
    //Set the paint in the current graphics state
    document.SetPaint(new SolidBrush(Color.Blue));

    //Create a font
    int fontSize = 120;
    Font font = new Font("Arial", fontSize, FontStyle.Bold);

    //Clip the rectangle by text's outline
    document.ClipText("ABC", font, 20, fontSize + 10);
    document.Fill(rectanglePath);

    //Restore the graphics state to the previus (upper) level
    document.WriteGraphicsRestore();

		//Displace the upper level graphics state on 100 points to the right and 100 points to the bottom.
    document.Translate(100, 100);

		Pen pen = new Pen(new SolidBrush(Color.Blue), 2);
    pen.DashStyle = DashStyle.Dash;

    document.SetStroke(pen);
    
    //Draw the rectangle in the current graphics state (has no clipping) above the clipped rectangle
    document.Draw(rectanglePath);

    //Close the current page
    document.ClosePage();

    //Save the document
    document.Save();
}

Див. роботу з кліпами в документах PS у .NET або [Java](/page/{{lang.url- фрагмент}}java/ps/working-with-clips/).

Результат виконання цього коду виглядає як

Ви можете завантажити приклади та файли даних із GitHub.