PostScript での透明部分の操作 | C++

PSドキュメントに透明度を追加する

PostScriptは、ベクターグラフィックオブジェクトの描画において透明度をサポートしていません。ただし、半透明（半透明）画像は、完全に透明なピクセルと完全に不透明なピクセルのセットとしてレンダリングできます。このような画像はマスクと呼ばれます。

Aspose.Page for C++ライブラリは、PSドキュメントに透明画像を追加するメソッドを提供しています。ベクターグラフィック（図形やテキスト）の描画には、**「擬似透明」**を使用できます。

**「擬似透明」**とは、アルファ値が255未満の色を淡くする処理です。これは、アルファ値が1の赤、緑、青の成分を特定の割合で混合することで実現されます。

「疑似透明」 とは、もちろん、上の透明レイヤーの下にある下の色のレイヤーが見えるわけではありませんが、下のレイヤーが白であれば透明であるような錯覚を生み出します。

PS ドキュメントに透明画像を追加する

前述のように、透明画像は マスク として PS ドキュメントに追加できます。Aspose.Page for C++ ライブラリには、この目的のために AddTransparentImage() メソッドが用意されています。 このメソッドは、画像が完全に不透明か、完全に透明か、あるいは半透明かを認識します。完全に不透明な場合は AddImage() メソッドで不透明画像として追加され、完全に透明な場合はドキュメントに追加されません。半透明画像の場合は、PostScript 画像 マスク として追加されます。

以下の例では、AddImage() と AddTransparentImage() を使用して PS ドキュメントに透明画像を追加する場合の違いを示します。白い半透明画像を表示するには、ページの背景色を白以外に設定しています。

この例では、Aspose.Page for C++ ライブラリを使用して新しい PsDocument に任意の画像を追加するために、以下の手順を実行します。

1. 生成される PS ファイルの出力ストリームを作成します。
2. デフォルトのオプションを使用して PsSaveOptions オブジェクトを作成します。必要に応じて背景色を変更します。
3. 既に作成済みの出力ストリームと保存オプションを使用して、1 ページの PsDocument を作成します。
4. 新しいグラフィックス状態を作成します。
5. 画像ファイルから ビットマップ を作成します。
6. 画像に必要な変換を作成します。
7. 画像が不透明であることが確実な場合は、完全に不透明な画像として PsDocument に追加します (AddImage() メソッドを使用)。不透明であることが確実でない場合は、透明な画像として追加します (AddTransparentImage() メソッドを使用)。
8. 現在のグラフィック状態から上位レベル 1 に移行します。
9. ページを閉じます。
10. ドキュメントを保存します。

    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithTransparency();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"AddTransparentImage_outPS.ps", System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_2({ outPsStream});
        // ------------------------------------------
        
        try
        {
            //Create save options with A4 size
            System::SharedPtr<PsSaveOptions> options = System::MakeObject<PsSaveOptions>();
            //Set page's background color to see white image on it's own transparent background
            options->set_BackgroundColor(System::Drawing::Color::FromArgb(211, 8, 48));
            
            // Create new 1-paged PS Document
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, false);
            
            
            document->WriteGraphicsSave();
            document->Translate(20.0f, 100.0f);
            
            //Create bitmap from translucent image file
            {
                System::SharedPtr<System::Drawing::Bitmap> image = System::MakeObject<System::Drawing::Bitmap>(dataDir + u"mask1.png");
                // Clearing resources under 'using' statement
                System::Details::DisposeGuard<1> __dispose_guard_0({ image});
                // ------------------------------------------
                
                try
                {
                    //Add this image to document as usual opaque RGB image
                    document->DrawImage(image, System::MakeObject<System::Drawing::Drawing2D::Matrix>(1.0f, 0.0f, 0.0f, 1.0f, 100.0f, 0.0f), System::Drawing::Color::Empty);
                }
                catch(...)
                {
                    __dispose_guard_0.SetCurrentException(std::current_exception());
                }
            }
            
            //Again create bitmap from the same image file
            {
                System::SharedPtr<System::Drawing::Bitmap> image = System::MakeObject<System::Drawing::Bitmap>(dataDir + u"mask1.png");
                // Clearing resources under 'using' statement
                System::Details::DisposeGuard<1> __dispose_guard_1({ image});
                // ------------------------------------------
                
                try
                {
                    //Add this image to document as transparent image image
                    document->DrawTransparentImage(image, System::MakeObject<System::Drawing::Drawing2D::Matrix>(1.0f, 0.0f, 0.0f, 1.0f, 350.0f, 0.0f), 255);
                }
                catch(...)
                {
                    __dispose_guard_1.SetCurrentException(std::current_exception());
                }
            }
            
            document->WriteGraphicsRestore();
            
            //Close current page
            document->ClosePage();
            
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_2.SetCurrentException(std::current_exception());
        }
    }

.NET または Java の PS ドキュメントでの透明性の操作を参照してください。

このコードを実行した結果は次のようになります

透明なベクターグラフィックオブジェクトの追加

Aspose.Page for C++ ライブラリは、透明な図形とテキストに「疑似透明」と呼ばれる淡色化アルゴリズムを使用することを先ほど説明しました。 以下の例では、同じ色で塗りつぶされた 2 つの図形の違いを示しています。ただし、最初の図形はアルファ要素なし、2 番目の図形はアルファ要素ありです。

    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithTransparency();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"ShowPseudoTransparency_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 = 50.0f;
            float offsetY = 100.0f;
            float width = 200.0f;
            float height = 100.0f;
            
            ///////////////////////////////// Create rectangle with opaque gradient fill /////////////////////////////////////////////////////////
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> path = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            path->AddRectangle(System::Drawing::RectangleF(offsetX, offsetY, width, height));
            
            System::SharedPtr<System::Drawing::Drawing2D::LinearGradientBrush> opaqueBrush = System::MakeObject<System::Drawing::Drawing2D::LinearGradientBrush>(System::Drawing::RectangleF(0.0f, 0.0f, 200.0f, 100.0f), System::Drawing::Color::FromArgb(0, 0, 0), System::Drawing::Color::FromArgb(40, 128, 70), 0.f);
            System::SharedPtr<System::Drawing::Drawing2D::Matrix> brushTransform = System::MakeObject<System::Drawing::Drawing2D::Matrix>(width, 0.0f, 0.0f, height, offsetX, offsetY);
            opaqueBrush->set_Transform(brushTransform);
            System::SharedPtr<GradientBrush> gradientBrush = System::MakeObject<GradientBrush>(opaqueBrush);
            gradientBrush->set_WrapMode(System::Drawing::Drawing2D::WrapMode::Clamp);
            
            document->SetPaint(gradientBrush);
            document->Fill(path);
            /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
            
            offsetX = 350.0f;
            
            ///////////////////////////////// Create rectangle with translucent gradient fill ///////////////////////////////////////////////////
            //Create graphics path from the first rectangle
            path = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            path->AddRectangle(System::Drawing::RectangleF(offsetX, offsetY, width, height));
            
            //Create linear gradient brush colors which transparency are not 255, but 150 and 50. So it are translucent.
            System::SharedPtr<System::Drawing::Drawing2D::LinearGradientBrush> translucentBrush = 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.
            brushTransform = System::MakeObject<System::Drawing::Drawing2D::Matrix>(width, 0.0f, 0.0f, height, offsetX, offsetY);
            //Set transform
            translucentBrush->set_Transform(brushTransform);
            //Create GradientBrush object containing the linear gradient brush
            gradientBrush = System::MakeObject<GradientBrush>(translucentBrush);
            gradientBrush->set_WrapMode(System::Drawing::Drawing2D::WrapMode::Clamp);
            //Set paint
            document->SetPaint(gradientBrush);
            //Fill the rectangle
            document->Fill(path);
            /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
            
            //Close current page
            document->ClosePage();
            
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

.NET または Java の PS ドキュメントでの透明性の操作を参照してください。

このコードを実行した結果は次のように表示されます。

サンプルとデータ ファイルは GitHub からダウンロードできます。