Робота з градієнтом у PostScript | C++

Додайте градієнт у документ PS

У цій статті ми розглянемо способи використання градієнта в документах PS.

Градієнт - це плавний перехід одного кольору в інший. Він використовується для того, щоб зробити намальовані зображення більш реалістичними. Оскільки градієнт є різновидом фарби, очікується, що в C++ він реалізований як підклас System.Drawing.Brush. Насправді на платформі C++ таких пензлів дві:

• System.Drawing.LinearGradientBrush
• System.Drawing.PathGradientBrush

Щоб установити фарбу або обведення в PsDocument, ми повинні передати об’єкт класу System.Drawing.Brush для малювання та об’єкт System.Drawing.Pen для обведення в відповідні методи. Бібліотека Aspose.Page для C++ обробляє всі підкласи System.Drawing.Brush, які пропонуються платформою C++. Це System.Drawing.SolidBrush, System.Drawing.TextureBrush, System.Drawing.LinearGradientBrush, System.Drawing.PathGradientBrush і *System.Drawing.HatchBrush *. Клас System.Drawing.Pen не можна розширити, оскільки він запечатаний, але він містить System.Drawing.Brush як властивість, тому Aspose.Page для бібліотеки C++ також може використовувати повний набір пензлі також для малювання ліній і окреслення форм і тексту.

Щоб малювати графічні об’єкти градієнтом у бібліотеці Aspose.Page для C++, необхідно створити System.Drawing.LinearGradientBrush або System.Drawing.PathGradientBrush і передати його в SetPaint( ) або один із методів FillText() або FillAndStrokeText(), які приймають System.Drawing.Brush як параметр.

Щоб контурувати графічні об’єкти градієнтом у бібліотеці Aspose.Page для C++, хтось має створити System.Drawing.LinearGradientBrush або System.Drawing.PathGradientBrush, а потім створити **System.Drawing.Pen ** цим пензлем і, нарешті, передайте його SetStroke() або одному з методів OutlineText() або FillAndStrokeText(), який приймає System.Drawing.Pen як параметр.

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

Алгоритм розмальовування графічних об’єктів градієнтом у новому документі PS включає наступні кроки:

1. Створіть вихідний потік для отриманого файлу PS.
2. Створіть PsSaveOptions.
3. Створіть PsDocument із уже створеним вихідним потоком і параметрами збереження.
4. Створіть необхідний графічний шлях або шрифт в залежності від того, який об’єкт ми збираємося заповнити або окреслити.
5. Створіть об’єкт System.Drawing.LinearGradientBrush або System.Drawing.PathGradientBrush в залежності від бажаної форми градієнта.
6. Встановіть на цьому пензлі необхідну трансформацію.
7. Встановіть кисть градієнта як поточну фарбу в PsDocument
8. Заповніть графічний контур поточною фарбою або заповніть текст. Якщо ми використовуємо один із методів заповнення тексту, який приймає System.Drawing.Brush як параметр, попередній пункт можна проігнорувати.
9. Закрийте сторінку.
10. Збережіть документ.

Якщо нам потрібно обведення (контур) графічних об’єктів із градієнтом замість останніх 4 точок, наступним буде:8. Створіть об’єкт System.Drawing.Pen за допомогою пензля градієнта.

9. Установіть це перо як поточний штрих у PsDocument.

10. Окресліть контур графіки поточним штрихом або обведіть текст. Якщо ми використовуємо один із методів для контуру тексту, який приймає System.Drawing.Pen як параметр, попередній пункт можна проігнорувати.

11. Закрийте сторінку.

12. Збережіть документ.
    

Ми пропонуємо 5 фрагментів коду, які демонструють використання різних градієнтів.

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

    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithGradient();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"HorizontalGradient_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>();
            
            // Create new 1-paged PS Document
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, false);
            
            float offsetX = 200.0f;
            float offsetY = 100.0f;
            float width = 200.0f;
            float height = 100.0f;
            
            //Create graphics path from the first rectangle
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> path = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            path->AddRectangle(System::Drawing::RectangleF(offsetX, offsetY, width, height));
            
            //Create linear gradient brush with rectangle as a bounds, start and end colors
            System::SharedPtr<System::Drawing::Drawing2D::LinearGradientBrush> brush = System::MakeObject<System::Drawing::Drawing2D::LinearGradientBrush>(System::Drawing::RectangleF(0.0f, 0.0f, width, height), System::Drawing::Color::FromArgb(150, 0, 0, 0), System::Drawing::Color::FromArgb(50, 40, 128, 70), 0.f);
            //Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
            //Translation components are offsets of the rectangle
            System::SharedPtr<System::Drawing::Drawing2D::Matrix> brushTransform = System::MakeObject<System::Drawing::Drawing2D::Matrix>(width, 0.0f, 0.0f, height, offsetX, offsetY);
            //Set transform
            brush->set_Transform(brushTransform);
            
            //Set paint
            document->SetPaint(brush);
            
            //Fill the rectangle
            document->Fill(path);
            
            //Fill text with gradient
            System::SharedPtr<System::Drawing::Font> font = System::MakeObject<System::Drawing::Font>(u"Arial", 96.0f, System::Drawing::FontStyle::Bold);
            document->FillAndStrokeText(u"ABC", font, 200.0f, 300.0f, brush, System::MakeObject<System::Drawing::Pen>(System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Black()), 2.0f));
            
            //Set current stroke
            document->SetStroke(System::MakeObject<System::Drawing::Pen>(brush, 5.0f));
            //Outline text with gradient
            document->OutlineText(u"ABC", font, 200.0f, 400.0f);
            
            //Close current page
            document->ClosePage();
            
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

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

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

    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithGradient();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"VerticalGradient_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>();
            
            // Create new 1-paged PS Document
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, false);
            
            float offsetX = 200.0f;
            float offsetY = 100.0f;
            float width = 200.0f;
            float height = 100.0f;
            
            //Create graphics path from the first rectangle
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> path = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            path->AddRectangle(System::Drawing::RectangleF(offsetX, offsetY, width, height));
            
            //Create an array of interpolation colors
            System::ArrayPtr<System::Drawing::Color> colors = System::MakeArray<System::Drawing::Color>({System::Drawing::Color::get_Red(), System::Drawing::Color::get_Green(), System::Drawing::Color::get_Blue(), System::Drawing::Color::get_Orange(), System::Drawing::Color::get_DarkOliveGreen()});
            System::ArrayPtr<float> positions = System::MakeArray<float>({0.0f, 0.1873f, 0.492f, 0.734f, 1.0f});
            System::SharedPtr<System::Drawing::Drawing2D::ColorBlend> colorBlend = System::MakeObject<System::Drawing::Drawing2D::ColorBlend>();
            colorBlend->set_Colors(colors);
            colorBlend->set_Positions(positions);
            
            //Create linear gradient brush with rectangle as a bounds, start and end colors
            System::SharedPtr<System::Drawing::Drawing2D::LinearGradientBrush> brush = System::MakeObject<System::Drawing::Drawing2D::LinearGradientBrush>(System::Drawing::RectangleF(0.0f, 0.0f, width, height), System::Drawing::Color::get_Beige(), System::Drawing::Color::get_DodgerBlue(), 0.f);
            //Set interpolation colors
            brush->set_InterpolationColors(colorBlend);
            //Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
            //Translation components are offsets of the rectangle
            System::SharedPtr<System::Drawing::Drawing2D::Matrix> brushTransform = System::MakeObject<System::Drawing::Drawing2D::Matrix>(width, 0.0f, 0.0f, height, offsetX, offsetY);
            //Rotate transform to get colors change in vertical direction from up to down
            brushTransform->Rotate(90.0f);
            //Set transform
            brush->set_Transform(brushTransform);
            
            //Set paint
            document->SetPaint(brush);
            
            //Fill the rectangle
            document->Fill(path);
            
            //Close current page
            document->ClosePage();
            
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

Ось результат:

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

    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithGradient();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"DiagonaGradient_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>();
            
            // Create new 1-paged PS Document
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, false);
            
            float offsetX = 200.0f;
            float offsetY = 100.0f;
            float width = 200.0f;
            float height = 100.0f;
            
            //Create graphics path from the first rectangle
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> path = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            path->AddRectangle(System::Drawing::RectangleF(offsetX, offsetY, width, height));
            
            //Create linear gradient brush with rectangle as a bounds, start and end colors
            System::SharedPtr<System::Drawing::Drawing2D::LinearGradientBrush> brush = System::MakeObject<System::Drawing::Drawing2D::LinearGradientBrush>(System::Drawing::RectangleF(0.0f, 0.0f, width, height), System::Drawing::Color::FromArgb(255, 255, 0, 0), System::Drawing::Color::FromArgb(255, 0, 0, 255), 0.f);
            
            //Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
            //Translation components are offsets of the rectangle                
            System::SharedPtr<System::Drawing::Drawing2D::Matrix> brushTransform = System::MakeObject<System::Drawing::Drawing2D::Matrix>(width, 0.0f, 0.0f, height, offsetX, offsetY);
            //Rotate gradient, than scale and translate to get visible color transition in required rectangle
            brushTransform->Rotate(-45.0f);
            float hypotenuse = (float)System::Math::Sqrt(200 * 200 + 100 * 100);
            float ratio = hypotenuse / 200;
            brushTransform->Scale(-ratio, 1.0f);
            brushTransform->Translate(100 / brushTransform->get_Elements()[0], 0.0f);
            
            //Set transform
            brush->set_Transform(brushTransform);
            
            //Set paint
            document->SetPaint(brush);
            
            //Fill the rectangle
            document->Fill(path);
            
            //Close current page
            document->ClosePage();
            
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

Ось результат:

У цьому фрагменті коду ми створюємо радіальний градієнт із 2 кольорів і заповнюємо цим градієнтом коло.

    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithGradient();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"RadialGradient1_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>();
            
            // Create new 1-paged PS Document
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, false);
            
            float offsetX = 200.0f;
            float offsetY = 100.0f;
            float width = 200.0f;
            float height = 200.0f;
            
            //Create graphics path from the rectangle bounds
            System::Drawing::RectangleF bounds(offsetX, offsetY, width, height);
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> path = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            path->AddEllipse(bounds);
            
            //Create and fill color blend object
            System::ArrayPtr<System::Drawing::Color> colors = System::MakeArray<System::Drawing::Color>({System::Drawing::Color::get_White(), System::Drawing::Color::get_White(), System::Drawing::Color::get_Blue()});
            System::ArrayPtr<float> positions = System::MakeArray<float>({0.0f, 0.2f, 1.0f});
            System::SharedPtr<System::Drawing::Drawing2D::ColorBlend> colorBlend = System::MakeObject<System::Drawing::Drawing2D::ColorBlend>();
            colorBlend->set_Colors(colors);
            colorBlend->set_Positions(positions);
            
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> brushRect = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            brushRect->AddRectangle(System::Drawing::RectangleF(0.0f, 0.0f, width, height));
            
            //Create path gradient brush with rectangle as a bounds
            System::SharedPtr<System::Drawing::Drawing2D::PathGradientBrush> brush = System::MakeObject<System::Drawing::Drawing2D::PathGradientBrush>(brushRect);
            //Set interpolation colors
            brush->set_InterpolationColors(colorBlend);
            //Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
            //Translation components are offsets of the rectangle
            System::SharedPtr<System::Drawing::Drawing2D::Matrix> brushTransform = System::MakeObject<System::Drawing::Drawing2D::Matrix>(width, 0.0f, 0.0f, height, offsetX, offsetY);
            //Set transform
            brush->set_Transform(brushTransform);
            
            //Set paint
            document->SetPaint(brush);
            
            //Fill the rectangle
            document->Fill(path);
            
            //Close current page
            document->ClosePage();
            
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }
}

Результат

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

    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithGradient();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"RadialGradient2_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>();
            
            // Create new 1-paged PS Document
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, false);
            
            float offsetX = 200.0f;
            float offsetY = 100.0f;
            float width = 200.0f;
            float height = 200.0f;
            
            //Create graphics path from the rectangle bounds
            System::Drawing::RectangleF bounds(offsetX, offsetY, width, height);
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> path = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            path->AddRectangle(bounds);
            
            //Create and fill color blend object
            System::ArrayPtr<System::Drawing::Color> colors = System::MakeArray<System::Drawing::Color>({System::Drawing::Color::get_Green(), System::Drawing::Color::get_Blue(), System::Drawing::Color::get_Black(), System::Drawing::Color::get_Yellow(), System::Drawing::Color::get_Beige(), System::Drawing::Color::get_Red()});
            System::ArrayPtr<float> positions = System::MakeArray<float>({0.0f, 0.2f, 0.3f, 0.4f, 0.9f, 1.0f});
            System::SharedPtr<System::Drawing::Drawing2D::ColorBlend> colorBlend = System::MakeObject<System::Drawing::Drawing2D::ColorBlend>();
            colorBlend->set_Colors(colors);
            colorBlend->set_Positions(positions);
            
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> brushRect = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            brushRect->AddRectangle(System::Drawing::RectangleF(0.0f, 0.0f, width, height));
            
            //Create path gradient brush with rectangle as a bounds
            System::SharedPtr<System::Drawing::Drawing2D::PathGradientBrush> brush = System::MakeObject<System::Drawing::Drawing2D::PathGradientBrush>(brushRect);
            //Set interpolation colors
            brush->set_InterpolationColors(colorBlend);
            //Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
            //Translation components are offsets of the rectangle
            System::SharedPtr<System::Drawing::Drawing2D::Matrix> brushTransform = System::MakeObject<System::Drawing::Drawing2D::Matrix>(width, 0.0f, 0.0f, height, offsetX, offsetY);
            //Set transform
            brush->set_Transform(brushTransform);
            
            //Set paint
            document->SetPaint(brush);
            
            //Fill the rectangle
            document->Fill(path);
            
            //Close current page
            document->ClosePage();
            
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }
}

Результат

See working with gradient in PS documents in .NET or Java.

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