ODG ファイルは、Apache OpenOffice スイートで利用可能なベクター グラフィック編集アプリケーションである Draw によって作成された図面です。線、図形、記号、テキストを含む 1 つ以上のページが含まれます。ODG ファイルは、XML ベースの形式である OASIS OpenDocument 仕様で保存されます。ODG ファイルは、オープン ソース プログラム OpenOffice.org Draw とその派生である LibreOffice Draw で開くことができます。ただし、ODG ファイルを PSD に変換すると、レイヤーも保存できるため、後で簡単にファイルを編集できます。この記事では、REST API を使用して ODG 形式を PSD に変換する方法について説明します。
画像処理API
市場には多種多様な画像フォーマットが存在し、それらを処理するためのAPIも数多く存在します。しかし、当社のRESTベースのAPIは、JPEG、BMP、TIFF、GIF、PNG、PSD、SVG、DjVu、DICOM、DNGなどの主要な画像フォーマットを単一のAPIで処理できる独自の機能を提供します。さらに、当社のAPIの顕著な特徴の1つは、サードパーティに依存せずにこれらすべてのフォーマットを処理できることです。クラウドAPIを使用して、すべての画像処理タスクを実行します。追加のソフトウェアのダウンロードやインストールは必要ありません。APIはRESTアーキテクチャに従って開発されているため、デスクトップ、モバイル、Web、ハイブリッドアプリなど、あらゆるプラットフォームやアプリケーションタイプでアクセスできます。
お客様の利便性をさらに高めるために、クラウド API の ラッパー SDK を作成しました。これにより、すべての機能を任意の言語で利用できるようになります。この記事では、Aspose.Imaging Cloud SDK for .NET の機能について説明します。
インストール
プログラミング SDK を使用する最初のステップはインストールです。これは NuGet および GitHub からダウンロードできます。したがって、NuGet 経由で SDK をインストールするには、ターミナル ウィンドウで次のコマンドを実行してください。
nuget install Aspose.Imaging-Cloud
または、NuGet パッケージ マネージャーで次のコマンドを実行することも検討してください。
PM> Install-Package Aspose.Imaging-Cloud
Visual Studio のインストール
Visual Studio ソリューション内に Cloud SDK 参照を直接追加することもできます。
- ソリューション エクスプローラーを開きます。
- プロジェクトを展開し、ソリューション内のパッケージ フォルダーを右クリックします。
- NuGetパッケージの管理オプションを選択します
- [参照] タブをクリックし、「Aspose.Imaging-Cloud」を検索します。
- Aspose.Imaging-Cloudパッケージをクリックし、右側のタブで適切なバージョンを選択して、パッケージの追加ボタンをクリックします。
無料のクラウドサブスクリプション
現在、データの整合性とプライバシーを維持するために、セキュリティ レイヤーを追加し、許可されたユーザーのみがシステムにアクセスできるようにしています。そのため、Aspose.Cloud ダッシュボード にアクセスして、無料のサブスクリプション アカウントを作成する必要があります。クレジットカードやその他の支払いの詳細は不要で、最大 150 件の無料のドキュメント処理リクエストを実行できます。
GitHub または Google アカウントを使用してサインアップするか、新しいアカウントの作成 ボタンをクリックして必要な情報を入力します。資格情報を使用してダッシュボードにログインし、ダッシュボードからアプリケーション セクションを展開して、クライアント資格情報セクションまで下にスクロールして、クライアント ID とクライアント シークレットの詳細を確認します。
C# で ODG を PSD に変換する
C# .NET を使用して変換を実行するには、以下の手順に従ってください。
- まず、クライアント ID とクライアント シークレットの詳細を引数として渡しながら、ImagingApi オブジェクトを作成します。
- 次に、ローカル ドライブから ODG イメージを読み取り、それを引数として UploadFileRequest オブジェクトに渡します。
- 3 番目に、ImagingApi の UploadFile(…) メソッドを呼び出して、ファイルをクラウド ストレージにアップロードします。
- ここで、画像名と結果の出力形式を引数として受け取る ConvertImageRequest クラスのインスタンスを作成する必要があります。
- 次に、ImagingApi クラスの ConvertImage(…) メソッドを呼び出して、変換操作を開始します。
- 最後に、File.Create を使用してストリームからの出力をローカル ドライブに保存します (カスタム メソッドは以下で共有されます)。
// https://dashboard.aspose.cloud/ から ClientID を取得します。
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// ImagingApiインスタンスを作成する
ImagingApi imagingApi= new ImagingApi( clientSecret,clientID,"https://api.aspose.cloud/");
// 入力ODGイメージのパス
string imageFile = "file-example_PDF.odg";
// 出力ファイル形式
string format = "PSD";
// 結果のファイル名
string resultantFile = "Converted.psd";
try
{
// ローカルドライブからファイルを読み込む
using (var file = System.IO.File.OpenRead(@"C:\Users\shahbnay\Desktop\" + imageFile))
{
// FileUploadRequestインスタンスを作成する
var uploadFileRequest = new UploadFileRequest(imageFile, file);
// 画像をクラウドストレージにアップロードする
imagingApi.UploadFile(uploadFileRequest);
}
// ConvertImageRequest を作成する
var response = new ConvertImageRequest(imageFile, format, null, null);
// 変換操作を開始する
Stream updatedImage = imagingApi.ConvertImage(response);
// 変換が成功した場合は成功メッセージを出力します
if (response != null && response.Equals("OK"))
{
Console.WriteLine("ODG successfully converted to PSD !");
Console.ReadKey();
}
// 結果ファイルをローカルシステムドライブに保存するカスタムメソッド
saveToDisk(updatedImage, @"C:\Users\shahbnay\Desktop\" + resultantFile);
}catch (Exception ex)
{
Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
// ストリームをFileインスタンスとして保存するカスタムメソッド
static void saveToDisk(Stream responseStream, String resultantFile)
{
var fileStream = File.Create(resultantFile);
responseStream.Seek(0, SeekOrigin.Begin);
responseStream.CopyTo(fileStream);
fileStream.Close();
}
cURL コマンドを使用して ODG から PSD に変換する
前述のとおり、クラウド API は REST アーキテクチャに従って開発されているため、cURL コマンドを使用してアクセスすることもできます。ただし、ファイル変換操作を実行する前に、クライアント資格情報に基づいて JWT アクセス トークンを作成してみてください。次の cURL コマンドを実行して、JWT アクセス トークンを生成してください。
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=4db2f826-bf9c-42e7-8b2a-8cbca2d15553&client_secret=d757548a9f2558c39c2feebdf85b4c44" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
API を使用するため、入力 ODG ファイルがクラウド ストレージで既に利用可能であることが想定されます。したがって、次の cURL コマンドを使用して、ファイルをクラウド ストレージにアップロードします。
curl -X PUT "https://api.aspose.cloud/v3.0/imaging/storage/file/file-example_PDF.odg" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: multipart/form-data" \
-d {"File":{}}
ODG ファイルをクラウド ストレージにアップロードしたので、次のコマンドを使用してファイルを PSD 形式に変換してみてください。
curl -v -X GET "https://api.aspose.cloud/v3.0/imaging/file-example_PDF.odg/convert?format=PSD" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-o Converted.psd
テスト目的で、上記の例で使用したサンプルODGファイルはfile-examplePDF.odgからダウンロードできます。
結論
この記事では、一般的な画像形式に対する Aspose.Imaging Cloud の機能について説明しました。さらに、C# .NET コード スニペットを使用して ODG 画像ファイルを PSD 形式に変換する方法について詳しく説明しました。次のセクションでは、cURL コマンドを使用して同じ変換を実行する方法について詳しく説明しました。また、Cloud SDK は MIT ライセンスの下で開発されているため、完全なソース コードは GitHub で入手できることに注意してください。
APIの使用中に問題が発生した場合、またはその他の質問がある場合は、無料製品サポートフォーラムからお気軽にお問い合わせください。
関連記事
詳細については、次のリンクにアクセスすることをお勧めします。