Adjusting Brightness

Last updated: 2021-07-20 16:41:19

    Overview

    CI uses the imageMogr2 API 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 <bucketname-appid>.cos.<picture region="">.<domain>.com/<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

    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:

    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 carried. 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.