tf.image.adjust_brightness
Stay organized with collections
Save and categorize content based on your preferences.
Adjust the brightness of RGB or Grayscale images.
tf.image.adjust_brightness(
image, delta
)
Used in the notebooks
This is a convenience method that converts RGB images to float
representation, adjusts their brightness, and then converts them back to the
original data type. If several adjustments are chained, it is advisable to
minimize the number of redundant conversions.
The value delta
is added to all components of the tensor image
. image
is
converted to float
and scaled appropriately if it is in fixed-point
representation, and delta
is converted to the same data type. For regular
images, delta
should be in the range (-1,1)
, as it is added to the image
in floating point representation, where pixel values are in the [0,1)
range.
Usage Example:
x = [[[1.0, 2.0, 3.0],
[4.0, 5.0, 6.0]],
[[7.0, 8.0, 9.0],
[10.0, 11.0, 12.0]]]
tf.image.adjust_brightness(x, delta=0.1)
<tf.Tensor: shape=(2, 2, 3), dtype=float32, numpy=
array([[[ 1.1, 2.1, 3.1],
[ 4.1, 5.1, 6.1]],
[[ 7.1, 8.1, 9.1],
[10.1, 11.1, 12.1]]], dtype=float32)>
Args |
image
|
RGB image or images to adjust.
|
delta
|
A scalar. Amount to add to the pixel values.
|
Returns |
A brightness-adjusted tensor of the same shape and type as image .
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates. Some content is licensed under the numpy license.
Last updated 2024-04-26 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-04-26 UTC."],[],[],null,["# tf.image.adjust_brightness\n\n\u003cbr /\u003e\n\n|------------------------------------------------------------------------------------------------------------------------------------|\n| [View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.16.1/tensorflow/python/ops/image_ops_impl.py#L2200-L2250) |\n\nAdjust the brightness of RGB or Grayscale images.\n\n#### View aliases\n\n\n**Compat aliases for migration**\n\nSee\n[Migration guide](https://www.tensorflow.org/guide/migrate) for\nmore details.\n\n[`tf.compat.v1.image.adjust_brightness`](https://www.tensorflow.org/api_docs/python/tf/image/adjust_brightness)\n\n\u003cbr /\u003e\n\n tf.image.adjust_brightness(\n image, delta\n )\n\n### Used in the notebooks\n\n| Used in the tutorials |\n|--------------------------------------------------------------------------------------|\n| - [Data augmentation](https://www.tensorflow.org/tutorials/images/data_augmentation) |\n\nThis is a convenience method that converts RGB images to float\nrepresentation, adjusts their brightness, and then converts them back to the\noriginal data type. If several adjustments are chained, it is advisable to\nminimize the number of redundant conversions.\n\nThe value `delta` is added to all components of the tensor `image`. `image` is\nconverted to `float` and scaled appropriately if it is in fixed-point\nrepresentation, and `delta` is converted to the same data type. For regular\nimages, `delta` should be in the range `(-1,1)`, as it is added to the image\nin floating point representation, where pixel values are in the `[0,1)` range.\n\n#### Usage Example:\n\n x = [[[1.0, 2.0, 3.0],\n [4.0, 5.0, 6.0]],\n [[7.0, 8.0, 9.0],\n [10.0, 11.0, 12.0]]]\n tf.image.adjust_brightness(x, delta=0.1)\n \u003ctf.Tensor: shape=(2, 2, 3), dtype=float32, numpy=\n array([[[ 1.1, 2.1, 3.1],\n [ 4.1, 5.1, 6.1]],\n [[ 7.1, 8.1, 9.1],\n [10.1, 11.1, 12.1]]], dtype=float32)\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|---------|----------------------------------------------|\n| `image` | RGB image or images to adjust. |\n| `delta` | A scalar. Amount to add to the pixel values. |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ------- ||\n|---|---|\n| A brightness-adjusted tensor of the same shape and type as `image`. ||\n\n\u003cbr /\u003e"]]