tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
数据万象
    文档
    Download PDF

    基础图片处理

    最后更新时间：2024-03-13 15:17:16
    下载PDF

      简介

      本文档提供关于基础图片处理的 API 概览以及 SDK 示例代码。
      API
      操作描述
      对图片进行缩小或放大
      对图片进行裁剪，包括普通裁剪、缩放裁剪、内切圆裁剪、圆角裁剪和人脸智能裁剪
      对图片进行旋转，包括普通旋转和自适应旋转
      对图片进行格式转换、gif 格式优化、渐进显示
      对图片质量进行调节
      对图片进行模糊处理
      对图片进行锐化
      对图片进行水印处理
      对图片进行实时文字水印处理
      查询图片基本信息，包括格式、长、宽等
      查询 EXIF 信息
      查询图片主色调信息
      去除图片元信息，包括 exif 信息
      通过图片处理模板，生成相应的缩略图
      实现对图片按顺序进行多种处理

      缩放

      功能说明

      腾讯云数据万象通过 imageMogr2 接口提供图片缩放功能。

      请求示例

      #include "cos_http_io.h"
      #include "cos_api.h"
      #include "cos_log.h"
      #include <unistd.h>
      
      // endpoint 是 COS 访问域名信息，详情请参见 https://www.tencentcloud.com/document/product/436/6224?from_cn_redirect=1 文档
      static char TEST_COS_ENDPOINT[] = "cos.ap-guangzhou.myqcloud.com";
      // 开发者拥有的项目身份ID/密钥，可在 https://console.tencentcloud.com/cam/capi 页面获取
      static char *TEST_ACCESS_KEY_ID;                //your secret_id
      static char *TEST_ACCESS_KEY_SECRET;            //your secret_key
      // 开发者访问 COS 服务时拥有的用户维度唯一资源标识，用以标识资源，可在 https://console.tencentcloud.com/cam/capi 页面获取
      static char TEST_APPID[] = "<APPID>";    //your appid
      //the cos bucket name, syntax: [bucket]-[appid], for example: mybucket-1253666666，可在 https://console.tencentcloud.com/cos5/bucket 查看
      static char TEST_BUCKET_NAME[] = "<bucketname-appid>"; 
      
      void log_status(cos_status_t *s)
      {
          cos_warn_log("status->code: %d", s->code);
          if (s->error_code) cos_warn_log("status->error_code: %s", s->error_code);
          if (s->error_msg) cos_warn_log("status->error_msg: %s", s->error_msg);
          if (s->req_id) cos_warn_log("status->req_id: %s", s->req_id);
      }
      
      void init_test_config(cos_config_t *config, int is_cname)
      {
          cos_str_set(&config->endpoint, TEST_COS_ENDPOINT);
          cos_str_set(&config->access_key_id, TEST_ACCESS_KEY_ID);
          cos_str_set(&config->access_key_secret, TEST_ACCESS_KEY_SECRET);
          cos_str_set(&config->appid, TEST_APPID);
          config->is_cname = is_cname;
      }
      
      void init_test_request_options(cos_request_options_t *options, int is_cname)
      {
          options->config = cos_config_create(options->pool);
          init_test_config(options->config, is_cname);
          options->ctl = cos_http_controller_create(options->pool, 0);
      }
      
      void test_image_scale()
      {
          cos_pool_t *p = NULL;
          int is_cname = 0; 
          cos_status_t *s = NULL;
          cos_request_options_t *options = NULL;
          cos_string_t bucket;
          cos_string_t object;
          cos_string_t file;
          cos_table_t *resp_headers;
          cos_table_t *params = NULL;
      
          cos_pool_create(&p, NULL);
          options = cos_request_options_create(p);
          init_test_request_options(options, is_cname);
          cos_str_set(&bucket, TEST_BUCKET_NAME);
      
          params = cos_table_make(p, 1);
          apr_table_addn(params, "imageMogr2/thumbnail/!50p", "");
          cos_str_set(&file, "test.jpg");
          cos_str_set(&object, "test.jpg");
          s = cos_get_object_to_file(options, &bucket, &object, NULL, params, &file, &resp_headers);
          log_status(s);
          if (!cos_status_is_ok(s)) {
              printf("cos_get_object_to_file fail, req_id:%s\\n", s->req_id);
          }
          cos_pool_destroy(p);
      }
      
      int main(int argc, char *argv[])
      {
          // 通过环境变量获取 SECRETID 和 SECRETKEY
          TEST_ACCESS_KEY_ID     = getenv("COS_SECRETID");
          TEST_ACCESS_KEY_SECRET = getenv("COS_SECRETKEY");
      
          if (cos_http_io_initialize(NULL, 0) != COSE_OK) {
             exit(1);
          }
      
          //set log level, default COS_LOG_WARN
          cos_log_set_level(COS_LOG_WARN);
      
          //set log output, default stderr
          cos_log_set_output(NULL);
      
          test_image_scale();
      
          cos_http_io_deinitialize();
      
          return 0;
      }

      裁剪

      功能说明

      腾讯云数据万象通过 imageMogr2 接口提供裁剪功能，包括普通裁剪、缩放裁剪、内切圆裁剪、圆角裁剪和人脸智能裁剪。

      请求示例

      #include "cos_http_io.h"
      #include "cos_api.h"
      #include "cos_log.h"
      #include <unistd.h>
      
      // endpoint 是 COS 访问域名信息，详情请参见 https://www.tencentcloud.com/document/product/436/6224?from_cn_redirect=1 文档
      static char TEST_COS_ENDPOINT[] = "cos.ap-guangzhou.myqcloud.com";
      // 开发者拥有的项目身份ID/密钥，可在 https://console.tencentcloud.com/cam/capi 页面获取
      static char *TEST_ACCESS_KEY_ID;                //your secret_id
      static char *TEST_ACCESS_KEY_SECRET;            //your secret_key
      // 开发者访问 COS 服务时拥有的用户维度唯一资源标识，用以标识资源，可在 https://console.tencentcloud.com/cam/capi 页面获取
      static char TEST_APPID[] = "<APPID>";    //your appid
      //the cos bucket name, syntax: [bucket]-[appid], for example: mybucket-1253666666，可在 https://console.tencentcloud.com/cos5/bucket 查看
      static char TEST_BUCKET_NAME[] = "<bucketname-appid>"; 
      
      void log_status(cos_status_t *s)
      {
          cos_warn_log("status->code: %d", s->code);
          if (s->error_code) cos_warn_log("status->error_code: %s", s->error_code);
          if (s->error_msg) cos_warn_log("status->error_msg: %s", s->error_msg);
          if (s->req_id) cos_warn_log("status->req_id: %s", s->req_id);
      }
      
      void init_test_config(cos_config_t *config, int is_cname)
      {
          cos_str_set(&config->endpoint, TEST_COS_ENDPOINT);
          cos_str_set(&config->access_key_id, TEST_ACCESS_KEY_ID);
          cos_str_set(&config->access_key_secret, TEST_ACCESS_KEY_SECRET);
          cos_str_set(&config->appid, TEST_APPID);
          config->is_cname = is_cname;
      }
      
      void init_test_request_options(cos_request_options_t *options, int is_cname)
      {
          options->config = cos_config_create(options->pool);
          init_test_config(options->config, is_cname);
          options->ctl = cos_http_controller_create(options->pool, 0);
      }
      
      void test_image_cut()
      {
          cos_pool_t *p = NULL;
          int is_cname = 0; 
          cos_status_t *s = NULL;
          cos_request_options_t *options = NULL;
          cos_string_t bucket;
          cos_string_t object;
          cos_string_t file;
          cos_table_t *resp_headers;
          cos_table_t *params = NULL;
      
          cos_pool_create(&p, NULL);
          options = cos_request_options_create(p);
          init_test_request_options(options, is_cname);
          cos_str_set(&bucket, TEST_BUCKET_NAME);
      
          params = cos_table_make(p, 1);
          apr_table_addn(params, "imageMogr2/cut/600x600x100x10", "");
          cos_str_set(&file, "test.jpg");
          cos_str_set(&object, "test.jpg");
          s = cos_get_object_to_file(options, &bucket, &object, NULL, params, &file, &resp_headers);
          log_status(s);
          if (!cos_status_is_ok(s)) {
              printf("cos_get_object_to_file fail, req_id:%s\\n", s->req_id);
          }
          cos_pool_destroy(p);
      }
      
      int main(int argc, char *argv[])
      {
          // 通过环境变量获取 SECRETID 和 SECRETKEY
          TEST_ACCESS_KEY_ID     = getenv("COS_SECRETID");
          TEST_ACCESS_KEY_SECRET = getenv("COS_SECRETKEY");
      
          if (cos_http_io_initialize(NULL, 0) != COSE_OK) {
             exit(1);
          }
      
          //set log level, default COS_LOG_WARN
          cos_log_set_level(COS_LOG_WARN);
      
          //set log output, default stderr
          cos_log_set_output(NULL);
      
          test_image_cut();
      
          cos_http_io_deinitialize();
      
          return 0;
      }

      其他基础图片处理

      功能说明

      基础图片处理统一使用上述方法完成，其他基础图片处理只需要修改 operation 参数的值即可。例如，如下样例：将图片顺时针旋转90度。
      #include "cos_http_io.h"
      #include "cos_api.h"
      #include "cos_log.h"
      #include <unistd.h>
      
      // endpoint 是 COS 访问域名信息，详情请参见 https://www.tencentcloud.com/document/product/436/6224?from_cn_redirect=1 文档
      static char TEST_COS_ENDPOINT[] = "cos.ap-guangzhou.myqcloud.com";
      // 开发者拥有的项目身份ID/密钥，可在 https://console.tencentcloud.com/cam/capi 页面获取
      static char *TEST_ACCESS_KEY_ID;                //your secret_id
      static char *TEST_ACCESS_KEY_SECRET;            //your secret_key
      // 开发者访问 COS 服务时拥有的用户维度唯一资源标识，用以标识资源，可在 https://console.tencentcloud.com/cam/capi 页面获取
      static char TEST_APPID[] = "<APPID>";    //your appid
      //the cos bucket name, syntax: [bucket]-[appid], for example: mybucket-1253666666，可在 https://console.tencentcloud.com/cos5/bucket 查看
      static char TEST_BUCKET_NAME[] = "<bucketname-appid>"; 
      
      void log_status(cos_status_t *s)
      {
          cos_warn_log("status->code: %d", s->code);
          if (s->error_code) cos_warn_log("status->error_code: %s", s->error_code);
          if (s->error_msg) cos_warn_log("status->error_msg: %s", s->error_msg);
          if (s->req_id) cos_warn_log("status->req_id: %s", s->req_id);
      }
      
      void init_test_config(cos_config_t *config, int is_cname)
      {
          cos_str_set(&config->endpoint, TEST_COS_ENDPOINT);
          cos_str_set(&config->access_key_id, TEST_ACCESS_KEY_ID);
          cos_str_set(&config->access_key_secret, TEST_ACCESS_KEY_SECRET);
          cos_str_set(&config->appid, TEST_APPID);
          config->is_cname = is_cname;
      }
      
      void init_test_request_options(cos_request_options_t *options, int is_cname)
      {
          options->config = cos_config_create(options->pool);
          init_test_config(options->config, is_cname);
          options->ctl = cos_http_controller_create(options->pool, 0);
      }
      
      void test_image_rotate()
      {
          cos_pool_t *p = NULL;
          int is_cname = 0; 
          cos_status_t *s = NULL;
          cos_request_options_t *options = NULL;
          cos_string_t bucket;
          cos_string_t object;
          cos_string_t file;
          cos_table_t *resp_headers;
          cos_table_t *params = NULL;
      
          cos_pool_create(&p, NULL);
          options = cos_request_options_create(p);
          init_test_request_options(options, is_cname);
          cos_str_set(&bucket, TEST_BUCKET_NAME);
      
          params = cos_table_make(p, 1);
          apr_table_addn(params, "imageMogr2/rotate/90", "");
          cos_str_set(&file, "test.jpg");
          cos_str_set(&object, "test.jpg");
          s = cos_get_object_to_file(options, &bucket, &object, NULL, params, &file, &resp_headers);
          log_status(s);
          if (!cos_status_is_ok(s)) {
              printf("cos_get_object_to_file fail, req_id:%s\\n", s->req_id);
          }
          cos_pool_destroy(p);
      }
      
      int main(int argc, char *argv[])
      {
          // 通过环境变量获取 SECRETID 和 SECRETKEY
          TEST_ACCESS_KEY_ID     = getenv("COS_SECRETID");
          TEST_ACCESS_KEY_SECRET = getenv("COS_SECRETKEY");
      
          if (cos_http_io_initialize(NULL, 0) != COSE_OK) {
             exit(1);
          }
      
          //set log level, default COS_LOG_WARN
          cos_log_set_level(COS_LOG_WARN);
      
          //set log output, default stderr
          cos_log_set_output(NULL);
      
          test_image_rotate();
      
          cos_http_io_deinitialize();
      
          return 0;
      }
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款