tencent cloud

All product documents
Cloud Object Storage
DocumentationCloud Object StorageSDK DocumentationGo SDKImage ProcessingImage Processing
Image Processing
Download PDF
Last updated: 2024-02-02 15:51:37
Image Processing
Last updated: 2024-02-02 15:51:37
Download PDF

Overview

This document provides an overview of APIs and SDK code samples for basic image processing.
API
Description
Scales up/down an image.
Crops an image, including regular cropping, scaling and cropping, cropping to circle, rounded corner cropping, and smart face cropping.
Rotates an image, including regular rotation and adaptive rotation.
Converts the format of an image, optimizes the GIF format, and performs progressive display.
Adjusts the quality of an image.
Blurs an image by a Gaussian function.
Sharpens an image.
Adds a watermark to an image.
Adds a real-time text watermark to an image.
Queries the basic information of an image, such as format, width, and height.
Queries the EXIF data of an image.
Queries the average hue of an image.
Removes the image metadata, including the EXIF data.
Generates a thumbnail through an image processing template.
Performs multiple operations on an image in sequence.

Scaling

Feature description

CI uses the imageMogr2 API to scale images.

Method prototype

func (s *CIService) Get(ctx context.Context, key string, operation string, opt *ObjectGetOptions, id ...string) (*Response, error)

func (s *CIService) GetToFile(ctx context.Context, key, localpath, operation string, opt *ObjectGetOptions, id ...string) (*Response, error)

Sample request

name := "test.jpg"
// Sample 1. Get an object from the response body
resp, err := c.CI.Get(context.Background(), name, "imageMogr2/thumbnail/!50px", nil)
if err != nil {
    //ERROR
}
defer resp.Body.Close()
ioutil.ReadAll(resp.Body)

// Sample 2. Download an object
filepath := "test.jpg"
_, err = c.CI.GetToFile(context.Background(), name, filepath, "imageMogr2/thumbnail/!50px", nil)

Parameter description

Parameter
Description
Type
Required
key
Unique identifier of the object in the bucket. For example, if an object's access endpoint is examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/doc/pic.jpg, its key is doc/pic.jpg.
string
Yes
operation
Image processing operation, such as scaling, cropping, rotation, format conversion, and quality change.
string
Yes
ObjectGetOptions
Object download parameters. For more information, see Object Operations.
string
No
id
Object VersionId
string
No

Cropping

Feature description

CI uses the imageMogr2 API to crop images, including regular cropping, scaling and cropping, cropping to circle, rounded corner cropping, and smart face cropping.

Sample request

name := "test.jpg"
filepath := "test.jpg"
_, err = c.CI.GetToFile(context.Background(), name, filepath, "imageMogr2/cut/600x600x100x10", nil)

Other Basic Image Processing Operations

Feature description

You can perform other basic processing operations on images by changing the value of the operation parameter. For example, you can rotate the image clockwise by 90 degrees as follows:
name := "test.jpg"
filepath := "test.jpg"
_, err = c.CI.GetToFile(context.Background(), name, filepath, "imageMogr2/rotate/90", nil)

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon