Image processing

Image processing is an image processing service provided to external users by OSS featuring massive processing, security, low costs, and high reliability.

By uploading and storing source images in OSS, you can process images anytime, anywhere, and on any Internet device through a simple RESTful interface.

The Image Service offers image processing interfaces. For image uploads, use the OSS upload interfaces. You can build your own image processing service based on OSS Image Service.

Image Service basic features

Image processing provides the following features:

• Getting Retrieve dominant image tones
• Image Format conversion
• Image Resize images, Incircle and Adaptive orientation
• Image Brightness
• Adding image, text, and text-and-image Add watermarks to images
• Customizing image processing styles which are defined in the console Image Processing > Manage Styles
• Calling multiple Image Service features through Image Service access rules

Usage of Image Service

Image processing uses the standard HTTP GET request for access. All processing parameters are encoded in the QueyString in the URL.

Anonymous access

If the access permission of the image object is public read, as shown in the following table, you can access Image Service anonymously.

Access Image Service anonymously using the third-level domain in the following format:

http://bucket.<endpoint>/object?x-oss-process=image/action,parame_value

• Bucket: Name of the user’s bucket
• Endpoint: The access domain name for the data center of the user’s bucket
• Object: The image object uploaded by the user to OSS
• Image: The identifier reserved by the Image Service
• Action: Operations by the user on images, such as scaling, cropping, and rotating
• Parameter: Parameters corresponding to the operations by the user on the image

For example,

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100

Custom style. Access Image Service anonymously using the third-level domain in the following format:

http://bucket.<endpoint>/object?x-oss-process=x-oss-process=style/name

• Style: The identifier reserved by the stem for the user’s custom style
• Name: Name of the custom style, that is, the rule name of the console-defined style

For example,

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=style/oss-pic-style-w-100

Through cascading process, you can implement multiple operations on an image. The format is as follows:

http://bucket.<endpoint>/object?x-oss-process=image/action,parame_value/action,parame_value/...

For example,

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100/rotate,90

Image Service also supports HTTPS access. For example,

https://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100

Authorized access

For objects with private permissions, as shown in the following table, you must be authorized to access Image Service.

The Image Service URL code generated with signature is as follows:

<?php
require_once __DIR__ . '/vendor/autoload.php';
use OSS\OssClient;
$endpoint = "<endpoint, such as http://oss-cn-hangzhou.aliyuncs.com>";
$accessKeyId = "<access_key_id>";
$accessKeySecret = "<access_key_secret>";
$bucket = "<bucket_name>";
$object = "example.jpg";
$ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
/**
 * Generate a signed URL that can open in the browser directly. The validity period of the URL is 3,600 seconds. 
 */
$timeout = 3600;
$options = array(
    OssClient::OSS_PROCESS => "image/resize,m_lfit,h_100,w_100" );
$signedUrl = $ossClient->signUrl($bucket, $object, $timeout, "GET", $options);
Common::println("rtmp url: \n" . $signedUrl);

Note:

• Authorized access supports custom styles, HTTPS, and cascading processing.
• Unit of the signedUrl time-out value is seconds.

SDK access

You can directly use SDK to access and process image objects with any permissions.

Note:

• For complete code, see GitHub.
• Image object processing by using SDK supports custom styles, HTTPS, and cascading processing.

Basic operations

Basic Image Service operations include Retrieve dominant image tones, Format conversion, Resize images, Incircle, Adaptive orientation, Brightness and Add watermarks.

<?php
require_once __DIR__ . '/vendor/autoload.php';
use OSS\OssClient;
$endpoint = "<endpoint, such as http://oss-cn-hangzhou.aliyuncs.com>";
$accessKeyId = "<access_key_id>";
$accessKeySecret = "<access_key_secret>";
$bucket = "<bucket_name>";
$object = "example.jpg";
$download_file = "download.jpg";
$ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
// First upload the local example.jpg to the specified $bucket and name it $object
$ossClient->uploadFile($bucket, $object, "example.jpg");
// Scaling
$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => "image/resize,m_fixed,h_100,w_100" );
$ossClient->getObject($bucket, $object, $options);
// Cropping
$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => "image/crop,w_100,h_100,x_100,y_100,r_1" );
$ossClient->getObject($bucket, $object, $options);
// Rotating
$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => "image/rotate,90" );
$ossClient->getObject($bucket, $object, $options);
// Sharpening
$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => "image/sharpen,100" );
$ossClient->getObject($bucket, $object, $options);
// Image watermarks
$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => "image/watermark,text_SGVsbG8g5Zu-54mH5pyN5YqhIQ" );
$ossClient->getObject($bucket, $object, $options);
// Converting formats
$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => "image/format,png" );
$ossClient->getObject($bucket, $object, $options);
// Get image information
$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => "image/info" );
$ossClient->getObject($bucket, $object, $options);
// Delete the uploaded $object
$ossClient->deleteObject($bucket, $object);

Custom styles

<?php
require_once __DIR__ . '/vendor/autoload.php';
use OSS\OssClient;
$endpoint = "<endpoint, such as http://oss-cn-hangzhou.aliyuncs.com>";
$accessKeyId = "<access_key_id>";
$accessKeySecret = "<access_key_secret>";
$bucket = "<bucket_name>";
$object = "example.jpg";
$download_file = "download.jpg";
$ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
// First upload the local example.jpg to the specified $bucket and name it $object
$ossClient->uploadFile($bucket, $object, "example.jpg");
$style = "style/oss-pic-style-w-300";
$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => $style);
$ossClient->getObject($bucket, $object, $options);
// Delete the uploaded $object
$ossClient->deleteObject($bucket, $object);

Cascading processing

<?php
require_once __DIR__ . '/vendor/autoload.php';
use OSS\OssClient;
$endpoint = "<endpoint, such as http://oss-cn-hangzhou.aliyuncs.com>";
$accessKeyId = "<access_key_id>";
$accessKeySecret = "<access_key_secret>";
$bucket = "<bucket_name>";
$object = "example.jpg";
$download_file = "download.jpg";
$ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint, false);
// First upload the local example.jpg to the specified $bucket and name it $object
$ossClient->uploadFile($bucket, $object, "example.jpg");
$style = "image/resize,m_fixed,w_100,h_100/rotate,90";
$options = array(
    OssClient::OSS_FILE_DOWNLOAD => $download_file,
    OssClient::OSS_PROCESS => $style);
$ossClient->getObject($bucket, $object, $options);
// Delete the uploaded $object
$ossClient->deleteObject($bucket, $object);

Image processing tools

• Visualized image processing tool ImageStyleViewver can help you see the OSS image processing result intuitively.

• Demonstration Pages of OSS Image Service features and usage.