Adjusting Brightness

Last updated: 2021-08-12 10:11:06

    Overview

    COS uses the imageMogr2 API provided by CI to adjust the brightness of an image.

    API Format

    download_url?imageMogr2/bright/<value>
    

    Parameters

    Operation: bright

    Parameter Description
    download_url URL of the input image, formatted as &amp;dxlt;BucketName-APPID>.cos.&amp;dxlt;Region>.myqcloud.com/&amp;dxlt;picture name>
    Example: examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/picture.jpeg
    bright/&dxlt;value> Adjusts the brightness of an image. The value must be an integer in the range of [−100, 100].
  • value < 0: reduces the brightness.
  • value = 0: does not adjust the brightness.
  • value > 0: increases the brightness.
  • /ignore-error/1 If this parameter is carried and the image failed to be processed because it is too large, the input image will be returned with no error reported.

    Examples

    Sample request 1: adjusting brightness

    This example increases the brightness of an image by 70:

    http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?imageMogr2/bright/70
    

    Output image:

    Sample request 2: adjusting brightness with a signature carried

    This example processes the image in the same way as in the example above except that a signature is added. The signature is joined with other processing parameters using an ampersand (&):

    http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=<signature>&imageMogr2/bright/70
    
    Note:

    You can obtain the value of <signature> by referring to Request Signature.