GroupDocs.Signature for Java を使用してカスタマイズされた画像署名を実装する方法

導入

今日のデジタル世界では、電子文書への署名は多くのビジネスプロセスに不可欠です。プロフェッショナルな外観を維持しながら、文書上の希望する場所に正確に署名を配置することは、時に困難を伴います。 Java 用 GroupDocs.Signature 電子署名をアプリケーションにシームレスに統合するための強力なカスタマイズ オプションを提供します。

このチュートリアルでは、GroupDocs.Signature for Javaの設定手順を解説し、画像署名の配置、整列、サイズ、配置、外観調整、枠線のカスタマイズといった様々な設定を使ったスタイル設定といった主要な機能について説明します。この記事を読み終える頃には、以下の方法が理解できるようになります。

  • 署名の位置とサイズを設定する
  • 署名を余白に合わせる
  • 画像の外観設定を調整する
  • 画像の枠線をカスタマイズする

さあ、始めましょう！

前提条件

始める前に、次の前提条件が揃っていることを確認してください。

  1. Java開発キット（JDK）: システムに JDK 8 以上がインストールされていることを確認してください。
  2. 統合開発環境（IDE）: Java 開発には、IntelliJ IDEA や Eclipse などの IDE を使用します。
  3. GroupDocs.Signature ライブラリGroupDocs.Signature をプロジェクトの依存関係として追加します。

必要なライブラリと依存関係

GroupDocs.Signature を含めるには、Maven または Gradle のいずれかを使用できます。

メイヴン

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-signature</artifactId>
    <version>23.12</version>
</dependency>

グラドル

implementation 'com.groupdocs:groupdocs-signature:23.12'

または、最新バージョンを直接ダウンロードしてください。 GroupDocs.Signature for Java リリース.

環境設定

IDE が外部ライブラリを含むように構成されていることを確認し、入力ドキュメント、署名画像、および出力署名ドキュメント用のディレクトリを含むプロジェクトを設定します。

知識の前提条件

  • Java プログラミングに関する基本的な理解。
  • Java アプリケーションでのファイル パスの処理に関する知識。

Java 用 GroupDocs.Signature の設定

GroupDocs.Signature の使用を開始するには、次のセットアップ手順に従ってください。

  1. 依存関係を追加提供されている Maven または Gradle 構成を使用してライブラリを組み込みます。
  2. ライセンス取得まずは無料トライアルをダウンロードしてください グループドキュメント 必要に応じてライセンスの購入を検討してください。

基本的な初期化

Java アプリケーションで GroupDocs.Signature を初期化する方法は次のとおりです。

import com.groupdocs.signature.Signature;

public class Main {
    public static void main(String[] args) throws Exception {
        String filePath = "path/to/your/document.docx";
        Signature signature = new Signature(filePath);
        
        // 追加の設定と使用方法についてはこちらをご覧ください
    }
}

実装ガイド

画像署名をカスタマイズするためのさまざまな機能の実装を見ていきましょう。

署名の位置とサイズを設定する

概要この機能を使用すると、ドキュメント上で署名を表示する場所とサイズを指定できるため、ドキュメント間での一貫性が確保されます。

ステップバイステップの実装

  1. 署名オブジェクトの初期化インスタンスを作成する Signature ドキュメント パスを持つクラス。
  2. ImageSignOptions を構成するサイズや位置など、画像署名のオプションを設定します。
import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.ImageSignOptions;

public class SignWithImagePosition {
    public static void run() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY/document.docx";
        String imagePath = "YOUR_DOCUMENT_DIRECTORY/signature.png";
        String outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignaturePosition.docx";

        Signature signature = new Signature(filePath);
        ImageSignOptions options = new ImageSignOptions(imagePath);

        // 文書上の署名の位置を設定する
        options.setLeft(100);  // ピクセル単位のX座標
        options.setTop(100);   // ピクセル単位のY座標

        // 署名の四角形のサイズを設定する
        options.setWidth(100);  // ピクセル単位の幅
        options.setHeight(30);  // 高さ（ピクセル単位）
        
        // 文書に署名して保存する
        signature.sign(outputFilePath, options);
    }
}

署名の配置と余白を設定する

概要配置を調整することで、ドキュメント内の異なるセクション間で配置の一貫性を保つことができます。余白を設定することで、他のコンテンツとの重なりや欠落を防ぐことができます。

ステップバイステップの実装

  1. 垂直方向と水平方向の配置を定義する必要な配置には列挙値を使用します。
  2. パディングを使用して余白を設定する正確な位置決めのために余白を指定します。
import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.ImageSignOptions;
import com.groupdocs.signature.domain.enums.HorizontalAlignment;
import com.groupdocs.signature.domain.enums.VerticalAlignment;
import com.groupdocs.signature.domain.Padding;

public class SignWithImageAlignment {
    public static void run() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY/document.docx";
        String imagePath = "YOUR_DOCUMENT_DIRECTORY/signature.png";
        String outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignatureAlignment.docx";

        Signature signature = new Signature(filePath);
        ImageSignOptions options = new ImageSignOptions(imagePath);

        // 署名の垂直方向の配置を設定する
        options.setVerticalAlignment(VerticalAlignment.Bottom);
        
        // 署名の水平方向の配置を設定する
        options.setHorizontalAlignment(HorizontalAlignment.Right);
        
        // 署名の配置のための余白パディングを設定する
        Padding padding = new Padding();
        padding.setBottom(20);  // 下余白（ピクセル単位）
        padding.setRight(20);   // 右余白（ピクセル単位）
        options.setMargin(padding);

        // 文書に署名して保存する
        signature.sign(outputFilePath, options);
    }
}

グレースケールと明るさの調整で画像の外観を設定する

概要画像の外観をカスタマイズすることで、見た目の魅力を高めることができます。グレースケールの適用や明るさの調整などのオプションがあります。

ステップバイステップの実装

  1. 画像の外観設定を構成する： 使用 ImageAppearance ドキュメント上での画像の外観を調整します。
import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.ImageSignOptions;
import com.groupdocs.signature.domain.appearances.ImageAppearance;

public class SignWithImageAppearance {
    public static void run() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY/document.docx";
        String imagePath = "YOUR_DOCUMENT_DIRECTORY/signature.png";
        String outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignatureAppearance.docx";

        Signature signature = new Signature(filePath);
        ImageSignOptions options = new ImageSignOptions(imagePath);

        // 画像の外観設定を作成して構成する
        ImageAppearance imageAppearance = new ImageAppearance();
        
        // 画像にグレースケール効果を適用する
        imageAppearance.setGrayscale(true);
        
        // 画像の明るさレベルを調整する
        imageAppearance.setBrightness(0.9f);  // 明るさレベル（範囲：0.0～1.0）
        
        options.setAppearance(imageAppearance);

        // 文書に署名して保存する
        signature.sign(outputFilePath, options);
    }
}

スタイルと透明度を指定して画像の境界線を設定する

概要境界線をカスタマイズすると、署名のプロフェッショナル性を高めることができます。

ステップバイステップの実装

  1. 境界線オプションの設定： 使用 Border スタイルと透明性を定義する設定。
import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.ImageSignOptions;
import com.groupdocs.signature.domain.Border;

public class SignWithImageBorder {
    public static void run() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY/document.docx";
        String imagePath = "YOUR_DOCUMENT_DIRECTORY/signature.png";
        String outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignatureBorder.docx";

        Signature signature = new Signature(filePath);
        ImageSignOptions options = new ImageSignOptions(imagePath);

        // 画像の境界線の設定を作成および構成する
        Border border = new Border();
        border.setColor(java.awt.Color.BLACK);  // 境界線の色を設定する
        border.setWidth(2);                    // 境界線の幅をピクセル単位で設定する
        border.setDashStyle(com.groupdocs.signature.domain.enums.DashStyle.DashDot);
        
        options.setBorder(border);

        // 文書に署名して保存する
        signature.sign(outputFilePath, options);
    }
}