JPG、PNG などの一般的な形式の画像をクラウド上でプログラム的に PDF ドキュメントに変換できます。 Node.js 開発者は、Node.js アプリケーションで画像を PDF ファイルに簡単に変換できます。この記事では、Node.js の REST API を使用して JPG を PDF に変換する方法に焦点を当てます。
この記事では次のトピックについて説明します。
- ドキュメント変換 REST API と Node.js SDK
- Node.js の REST API を使用して画像を PDF に変換する
- 高度なオプションを使用した JPG から PDF への変換
- クラウドストレージを使用せずにJPGをPDFに変換
- JPG を PDF に変換し、透かしを追加する
ドキュメント変換 REST API と Node.js SDK
JPG を PDF に変換するには、GroupDocs.Conversion Cloud の Node.js SDK API を使用します。 API を使用すると、ドキュメントを必要な形式に変換できます。 Word、Excel、PowerPoint, PDF、HTML、JPG、PNG、CADなど50種類以上の文書や画像の変換に対応しています。また、クラウド API の ドキュメント変換ファミリー メンバー として、.NET、Java、PHP、Ruby、Android、および Python SDK も提供します。
コンソールで次のコマンドを使用して、GroupDocs.Conversion Cloud を Node.js アプリケーションにインストールできます。
npm install groupdocs-conversion-cloud --save
手順と利用可能なコード例を開始する前に、ダッシュボード からクライアント ID とクライアント シークレットを取得してください。 ID とシークレットを取得したら、以下に示すようにコードを追加します。
global.clientId = "659fe7da-715b-4744-a0f7-cf469a392b73";
global.clientSecret = "b377c36cfa28fa69960ebac6b6e36421";
global.myStorage = "";
const config = new groupdocs_conversion_cloud.Configuration(clientId, clientSecret);
config.apiBaseUrl = "https://api.groupdocs.cloud";
Node.js の REST API を使用して画像を PDF に変換する
以下の簡単な手順に従って、画像を PDF ドキュメントに変換できます。
- JPG画像ファイルをクラウドにアップロード
- Node.js を使用して JPG を PDF に変換
- ダウンロード変換されたPDFファイル
画像をアップロードする
まず、次のコードサンプルを使用して、JPG ファイルをクラウドにアップロードします。
// ローカル/ディスクからIOStreamでファイルを開きます。
let resourcesFolder = 'C:\\Files\\sample.jpg';
fs.readFile(resourcesFolder, (err, fileStream) => {
// FileApi を構築する
let fileApi = groupdocs_conversion_cloud.FileApi.fromConfig(config);
// アップロードリクエストを作成する
let request = new groupdocs_conversion_cloud.UploadFileRequest("sample.jpg", fileStream, myStorage);
fileApi.uploadFile(request);
});
その結果、アップロードされた JPG ファイルは、クラウド上のダッシュボードの ファイル セクション で利用できるようになります。
Node.jsを使用してJPGをPDFに変換する
プログラムで JPG を PDF ドキュメントに変換するには、以下の手順に従ってください。
- ConvertApi のインスタンスを作成する
- ConvertSettings インスタンスを作成する
- JPGファイルのパスを設定する
- 形式に「pdf」を割り当てる
- 出力ファイルのパスを指定します
- ConvertDocumentRequest の作成
- ConvertApi.convertDocument() メソッドを呼び出して結果を取得します
次のコード例は、Node.js の REST API を使用して JPG 画像を PDF ドキュメントに変換する方法を示しています。
// APIの初期化
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);
// 変換設定を定義する
let settings = new groupdocs_conversion_cloud.ConvertSettings();
settings.filePath = "sample.jpg";
settings.format = "pdf";
settings.outputPath = "output";
// ドキュメントリクエストを変換する
let request = new groupdocs_conversion_cloud.ConvertDocumentRequest(settings);
let result = await convertApi.convertDocument(request);
console.log("Document converted successfully: " + result[0].url);
変換されたファイルをダウンロードする
上記のコードサンプルは、変換された PDF ファイルをクラウド上に保存します。次のコードサンプルを使用してダウンロードできます。
// FileApi を構築する
let fileApi = groupdocs_conversion_cloud.FileApi.fromConfig(config);
// ファイルのダウンロードリクエスト
let request = new groupdocs_conversion_cloud.DownloadFileRequest("output\\sample.pdf", myStorage);
let response = await fileApi.downloadFile(request);
fs.writeFile("C:\\Files\\sample.pdf", response, "binary", function (err) { });
高度なオプションを使用した JPG から PDF への変換
高度な設定を使用して JPG を PDF ドキュメントに変換するには、以下の手順に従ってください。
- ConvertApi のインスタンスを作成する
- ConvertSettings インスタンスを作成する
- JPGファイルのパスを設定する
- 形式に「pdf」を割り当てる
- 出力ファイルのパスを指定します
- PdfConvertOptions を定義する
- dpi、画質、高さ、余白(上、左、右、下)などのさまざまな変換設定を設定します。
- ConvertDocumentRequest の作成
- ConvertApi.convertDocument() メソッドを呼び出して結果を取得します
次のコード例は、高度な変換オプションを使用して JPG を PDF ドキュメントに変換する方法を示しています。
// APIの初期化
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);
// 変換設定を定義する
let settings = new groupdocs_conversion_cloud.ConvertSettings();
settings.storageName = myStorage;
settings.filePath = "sample.jpg";
settings.format = "pdf";
// PDF 変換オプションを定義する
let convertOptions = new groupdocs_conversion_cloud.PdfConvertOptions();
convertOptions.centerWindow = true;
convertOptions.compressImages = false;
convertOptions.dpi = 1024;
convertOptions.fitWindow = false;
convertOptions.grayscale = true;
convertOptions.imageQuality = 100;
convertOptions.marginTop = 5;
convertOptions.marginLeft = 5;
convertOptions.height = 4096;
settings.convertOptions = convertOptions;
settings.outputPath = "output";
// ドキュメント変換リクエストの作成
let request = new groupdocs_conversion_cloud.ConvertDocumentRequest(settings);
let result = await convertApi.convertDocument(request);
クラウドストレージを使用せずにJPGをPDFに変換
クラウド ストレージを使用せずに JPG を PDF ドキュメントに変換するには、以下の手順に従ってください。
- ConvertApi のインスタンスを作成する
- ConvertDocumentDirectRequest を作成する
- 入力ファイルのパスとターゲット形式を入力パラメータとして指定します。
- convertDocumentDirect() メソッドを呼び出して結果を取得します
- FileStream.writeFile() メソッドを使用して出力ファイルをローカル パスに保存します。
次のコード例は、クラウド ストレージを使用せずに JPG を PDF ドキュメントに変換する方法を示しています。これは、リクエスト本文で入力ファイルを渡し、API レスポンスで出力ファイルを受け取ることを意味します。
// APIの初期化
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);
// 入力ファイル
let file = fs.readFileSync('C:\\Files\\sample.jpg');
// ドキュメントの直接リクエストを変換する
let request = new groupdocs_conversion_cloud.ConvertDocumentDirectRequest("pdf", file);
// ドキュメントを変換する
let result = await convertApi.convertDocumentDirect(request);
// ローカルパスに保存
fs.writeFile("C:\\Files\\sample.pdf", result, "binary", function (err) { });
JPG を PDF に変換し、透かしを追加する
以下の手順に従って JPG を PDF ドキュメントに変換し、変換された PDF に透かしを追加してください。
- ConvertApi のインスタンスを作成する
- ConvertSettings インスタンスを作成する
- JPGファイルのパスを設定する
- 形式に「pdf」を割り当てる
- 出力ファイルのパスを指定します
- ウォーターマークオプションの定義
- 透かしのテキスト、色、幅、高さなどを設定します。
- PdfConvertOptions を定義する and assign WatermarkOptions
- ConvertDocumentRequest の作成
- ConvertApi.convertDocument() メソッドを呼び出して結果を取得します
次のコード例は、Node.js の REST API を使用して JPG を PDF ドキュメントに変換し、変換された PDF ドキュメントにウォーターマークを追加する方法を示しています。
// APIの初期化
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);
// 変換設定を定義する
let settings = new groupdocs_conversion_cloud.ConvertSettings();
settings.filePath = "sample.jpg";
settings.format = "pdf";
settings.outputPath = "output";
// 透かしオプションを定義する
let watermark = new groupdocs_conversion_cloud.WatermarkOptions();
watermark.text = "This is a Sample watermark";
watermark.color = "White";
watermark.width = 250;
watermark.height = 100;
watermark.background = false;
// PDF 変換オプションを定義する
let convertOptions = new groupdocs_conversion_cloud.PdfConvertOptions();
convertOptions.watermarkOptions = watermark;
settings.convertOptions = convertOptions
// ドキュメント変換リクエストの作成
let request = new groupdocs_conversion_cloud.ConvertDocumentRequest(settings);
let result = await convertApi.convertDocument(request);
console.log("Document converted successfully: " + result[0].url);
オンラインで試す
上記の API を使用して開発された、次の無料のオンライン JPG 変換ツールをお試しください。 https://products.groupdocs.app/conversion/
結論
この記事では、クラウド上で JPG を PDF ドキュメントに変換する方法を学習しました。 Node.js を使用して、変換された PDF ドキュメントにウォーターマークを追加する方法も学習しました。さらに、プログラムによって JPG ファイルをクラウドにアップロードし、変換されたファイルをクラウドからダウンロードする方法を学習しました。 GroupDocs.Conversion Cloud API の詳細については、ドキュメント を使用して学習できます。また、ブラウザーを通じて API を直接視覚化して操作できる API リファレンス セクションも提供しています。不明な点がある場合は、フォーラム でお気軽にお問い合わせください。