New [Term Entry] Python Pillow - Image: .getbbox()

content/pillow/concepts/image/terms/getbbox/getbbox.md

@@ -0,0 +1,73 @@
+---
+Title: '.getbbox()'
+Description: 'Returns the bounding box of the non-zero regions in the image.'
+Subjects:
+  - 'Computer Science'
+  - 'Data Visualization'
+Tags:
+  - 'Images'
+  - 'Methods'
+  - 'Pillow'
+CatalogContent:
+  - 'learn-python-3'
+  - 'paths/computer-science'
+---
+
+In the Pillow library, the **`.getbbox()`** method returns the bounding box of all non-zero (non-background) regions in an image. It is a feature for cropping or focusing on the area of interest within an image.
+
+If the image is empty (all pixels are zero), `.getbbox()` returns `None`.
+
+## Common Use Cases
+
+The `.getbbox()` method is particularly useful for:
+
+- **Automatic cropping**: Remove unnecessary blank borders around images to focus on the actual content
+- **Content detection**: Identify where the meaningful content is located within an image
+- **Optimization**: Reduce file size by trimming away empty space before saving
+- **Layout analysis**: Determine the boundaries of content regions for further processing
+- **Document scanning**: Detect and extract the actual document area from a scanned image
+
+## Syntax
+
+```pseudo
+Image.getbbox()
+```
+
+**Parameters:**
+
+The `.getbbox()` methods takes no parameters.
+
+**Return Value:**
+
+Returns a 4-[tuple](https://www.codecademy.com/resources/docs/python/tuples) (left, upper, right, lower) that defines the rectangular bounding box containing all non-zero pixels.
+
+Returns `None` if the image is completely zero-valued.
+
+## Example
+
+The image to be used for this example is:
+
+![Input image to perform the .getbbox() operation](https://onetreeplanted.org/cdn/shop/articles/nature_facts_1788x.jpg?v=1705008496)
+
+In this example, the `.getbbox()` method returns the non-zero region of an image:
+
+```py
+from PIL import Image
+
+# Open the image file
+img = Image.open("nature.png")
+
+# Get the bounding box of the non-zero areas
+bbox = img.getbbox()
+
+print(bbox)
+```
+
+If the image has content, the above code produces the following output:
+
+```
+shell
+(0, 0, 1788, 850)
+```
+
+The output indicates that the non-zero (non-backround) area of the image starts at (0, 0) and extends to (1788, 850).