IMG - Object Storage Service - Alibaba Cloud ドキュメントセンター

Image Processing (IMG) は、イメージの処理を支援するためにObject Storage service (OSS) によって提供される、効率的で費用対効果の高い信頼性の高いイメージ処理サービスです。ソース画像をOSSにアップロードした後、RESTful APIを呼び出して、いつでもどこでもインターネットに接続されているデバイスで画像を処理できます。

使用上の注意

このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba Cloudサービスを使用してOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSでサポートされているリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。カスタムドメイン名またはSecurity Token Service (STS) を使用してOSSClientインスタンスを作成する場合は、「OSSClientインスタンスの作成」をご参照ください。

IMGパラメータを使用した画像処理

単一のIMGパラメータを使用して画像を処理する

#include <alibabacloud/oss/OssClient.h>
名前空間listaCloud::OSSを使用します。int main(void)
{
    /* OSSへのアクセスに使用されるアカウントに関する情報を初期化します。 */
            
    /* バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 */
    std::string Endpoint = "yourEndpoint";
    /* ソースイメージが保存されているバケットの名前を指定します。 例: examplebucket. */
    std::string BucketName = "examplebucket";
    /* ソースイメージの名前を指定します。 イメージがバケットのルートディレクトリに保存されていない場合は、イメージのフルパスを指定する必要があります。 例: exampledir/example.jpg */
    std::string ObjectName = "exampledir/example.jpg";

     /* ネットワークリソースなどのリソースを初期化します。 */
    InitializeSdk();

    ClientConfiguration conf;
    /* 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClientクライアント (Endpoint, credentialsProvider, conf);

    /* 画像のサイズを100ピクセルの高さと幅に変更し、ローカルコンピューターに保存します。 */
    std::string Process = "image/resize,m_fixed,w_100,h_100";
    GetObjectRequestリクエスト (BucketName, ObjectName);
    request.setProcess (プロセス);
    auto outcome = client.GetObject (リクエスト);
    if (outcome.isSuccess()) {
    std::cout << "画像は正常に処理されました。" << std::endl;
    } else {
    std::cout << "イメージの処理に失敗しました。 エラーコード: " << outcome. Error (). code ()
              << ", Message: " << outcome.error().Message()
              << ", RequestId: " << outcome.error().RequestId() << std::endl;
    }

    /* ネットワークリソースなどのリソースを解放します。 */
    ShutdownSdk();
    0を返します。}

複数のIMGパラメータを使用して画像を処理する

次のコードでは、複数のIMGパラメーターを使用してイメージを処理する方法の例を示します。 IMGパラメータはスラッシュ (/) で区切られます。

#include <alibabacloud/oss/OssClient.h>
名前空間listaCloud::OSSを使用します。int main(void)
{
    /* OSSへのアクセスに使用されるアカウントに関する情報を初期化します。 */
            
    /* バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 */
    std::string Endpoint = "yourEndpoint";
    /* ソースイメージが保存されているバケットの名前を指定します。 例: examplebucket. */
    std::string BucketName = "examplebucket";
    /* ソースイメージの名前を指定します。 イメージがバケットのルートディレクトリに保存されていない場合は、イメージのフルパスを指定する必要があります。 例: exampledir/example.jpg */
    std::string ObjectName = "exampledir/example.jpg";

     /* ネットワークリソースなどのリソースを初期化します。 */
    InitializeSdk();

    ClientConfiguration conf;
    /* 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClientクライアント (Endpoint, credentialsProvider, conf);

    /* 画像のサイズを100ピクセルの高さと幅に変更し、画像を90度回転させて、ローカルコンピューターに保存します。 */
    std::string Process = "image/resize,m_fixed,w_100,h_100/rotate,90";
    GetObjectRequestリクエスト (BucketName, ObjectName);
    request.setProcess (プロセス);
    auto outcome = client.GetObject (リクエスト);
    if (outcome.isSuccess()) {
    std::cout << "画像は正常に処理されました。" << std::endl;
    } else {
    std::cout << "イメージの処理に失敗しました。 エラーコード: " << outcome. Error (). code ()
              << ", Message: " << outcome.error().Message()
              << ", RequestId: " << outcome.error().RequestId() << std::endl;
    }

    /* ネットワークリソースなどのリソースを解放します。 */
    ShutdownSdk();
    0を返します。}

画像スタイルを使用して画像を処理する

イメージスタイルを作成します。
複数のIMGパラメータをイメージスタイルに追加して、バケットに保存されているイメージに対して複雑な操作を実行できます。詳細については、「イメージスタイル」をご参照ください。

イメージスタイルを使用してイメージを処理します。

#include <alibabacloud/oss/OssClient.h>
名前空間listaCloud::OSSを使用します。int main(void)
{
    /* OSSへのアクセスに使用されるアカウントに関する情報を初期化します。 */
    
    /* バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 */
    std::string Endpoint = "yourEndpoint";
    /* ソースイメージが保存されているバケットの名前を指定します。 例: examplebucket. */
    std::string BucketName = "examplebucket";
    /* ソースイメージの名前を指定します。 イメージがバケットのルートディレクトリに保存されていない場合は、イメージのフルパスを指定する必要があります。 例: exampledir/example.jpg */
    std::string ObjectName = "exampledir/example.jpg";

     /* ネットワークリソースなどのリソースを初期化します。 */
    InitializeSdk();

    ClientConfiguration conf;
    /* 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClientクライアント (Endpoint, credentialsProvider, conf);

    /* 画像スタイルを使用して画像を処理します。 yourCustomStyleNameを、手順1で作成したイメージスタイルの名前に置き換えます。 */
    std::string Process = "style/yourCustomStyleName";
    GetObjectRequestリクエスト (BucketName, ObjectName);
    request.setProcess (プロセス);
    auto outcome = client.GetObject (リクエスト);
    if (outcome.isSuccess()) {
    std::cout << "画像は正常に処理されました。" << std::endl;
    } else {
    std::cout << "イメージの処理に失敗しました。 エラーコード: " << outcome. Error (). code ()
              << ", Message: " << outcome.error().Message()
              << ", RequestId: " << outcome.error().RequestId() << std::endl;
    }
  
    /* ネットワークリソースなどのリソースを解放します。 */
    ShutdownSdk();
    0を返します。}

処理された画像を保存する

ImgSaveAs操作を呼び出して、ソースイメージが保存されているバケットに処理されたイメージを保存できます。次のコードは、処理されたイメージを保存する方法の例を示します。

#include <alibabacloud/oss/OssClient.h>
# include <sstream>
名前空間listaCloud::OSSを使用します。int main(void)
{
    /* OSSへのアクセスに使用されるアカウントに関する情報を初期化します。 */
            
    /* バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 */
    std::string Endpoint = "yourEndpoint";
    /* バケットの名前を指定します。 例: examplebucket. */
    std::string BucketName = "examplebucket";
    /* ソースイメージの名前を指定します。 イメージがバケットのルートディレクトリに保存されていない場合は、イメージ名の前にイメージへのパスを追加します。 例: Example /example.jpg */
    std::string SourceObjectName = "example/example.jpg";
    /* 処理されたイメージの名前を指定します。 イメージがバケットのルートディレクトリに保存されていない場合は、イメージ名の前にイメージへのパスを追加します。 例: exampledir/example.jpg */
    std::string TargetObjectName = "exampledir/example.jpg";

    /* ネットワークリソースなどのリソースを初期化します。 */
    InitializeSdk();

    ClientConfiguration conf;
    /* 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClientクライアント (Endpoint, credentialsProvider, conf);

    /* イメージのサイズを100ピクセルの高さと幅に変更し、ソースイメージが保存されているバケットにイメージを保存します。 */
    std::string Process = "image/resize,m_fixed,w_100,h_100";
    std::stringstream ss;
    ss <<プロセス 
    <<"| sys/saveas"
    << ",o_" << Base64EncodeUrlSafe(TargetObjectName)
    << ",b_" << Base64EncodeUrlSafe(BucketName);
    ProcessObjectRequestリクエスト (BucketName, SourceObjectName, ss.str());
    auto outcome = client.ProcessObject (リクエスト);
    if (outcome.isSuccess()) {
    std::cout << "画像は正常に処理されました。" << std::endl;
    } else {
    std::cout << "イメージの処理に失敗しました。 エラーコード: " << outcome. Error (). code ()
              << ", Message: " << outcome.error().Message()
              << ", RequestId: " << outcome.error().RequestId() << std::endl;
    }

    /* ネットワークリソースなどのリソースを解放します。 */
    ShutdownSdk();
    0を返します。}

IMGパラメータを含む署名付きオブジェクトURLを生成する

プライベートオブジェクトのURLに署名する必要があります。署名付きURLの末尾にIMGパラメーターを追加することはできません。プライベートオブジェクトを処理する場合は、署名にIMGパラメーターを追加します。サンプルコード：

#include <alibabacloud/oss/OssClient.h>
名前空間listaCloud::OSSを使用します。int main(void)
{
    /* OSSへのアクセスに使用されるアカウントに関する情報を初期化します。 */
            
    /* バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 */
    std::string Endpoint = "yourEndpoint";
    /* イメージが配置されているバケットの名前を指定します。 例: examplebucket. */
    std::string BucketName = "examplebucket";
    /* イメージの名前を指定します。 イメージがバケットのルートディレクトリに保存されていない場合は、イメージ名の前にイメージへのパスを追加します。 例: exampledir/example.jpg */
    std::string ObjectName = "exampledir/example.jpg";

    /* ネットワークリソースなどのリソースを初期化します。 */
    InitializeSdk();

    ClientConfiguration conf;
    /* 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClientクライアント (Endpoint, credentialsProvider, conf);


    /* オブジェクトのIMGパラメーターを含む署名付きURLを生成します。 */
    std::string Process = "image/resize,m_fixed,w_100,h_100";
    GeneratePresignedUrlRequestリクエスト (BucketName, ObjectName, Http::Get);
    request.setProcess (プロセス);
    auto outcome = client.GeneratePresignedUrl (リクエスト);
	
    if (outcome.isSuccess()) {
    std::cout << "生成された署名済みURL: " << outcome.result() << std::endl;
    } else {
    std::cout << "事前署名付きURLの生成に失敗しました。 エラーコード: " << outcome. Error (). code ()
              << ", Message: " << outcome.error().Message()
              << ", RequestId: " << outcome.error().RequestId() << std::endl;
    }
    
    /* ネットワークリソースなどのリソースを解放します。 */
    ShutdownSdk();
    0を返します。}

参考資料

サポートされているIMGパラメーターの詳細については、「概要」をご参照ください。
画像スタイルの詳細については、「画像スタイル」をご参照ください。