Update Image docs to improve rendering.

The [API docs](https://developers.google.com/mediapipe/api/solutions/python/mp/Image) have a few rendering issues. e.g., the doc generator will turn
```
This block:
  Anything here
```
Into a table with heading `This block` and `Anything here` as a plain-text cell.

In order to render code as code, it needs to be in backticks. They can also be in `>>> code()` format, and we can try to run them ([doctests](https://docs.python.org/3/library/doctest.html)).

I'll have a dashboard ready soon that shows areas we can improve.

PiperOrigin-RevId: 495715576
This commit is contained in:
Mark McDonald 2022-12-15 15:42:00 -08:00 committed by Copybara-Service
parent 62f0034033
commit 8d2473c751

View File

@ -48,6 +48,8 @@ void ImageSubmodule(pybind11::module* module) {
become immutable after creation.
Creation examples:
```python
import cv2
cv_mat = cv2.imread(input_file)[:, :, ::-1]
rgb_frame = mp.Image(format=ImageFormat.SRGB, data=cv_mat)
@ -58,6 +60,7 @@ void ImageSubmodule(pybind11::module* module) {
pil_img = Image.new('RGB', (60, 30), color = 'red')
image = mp.Image(
format=mp.ImageFormat.SRGB, data=np.asarray(pil_img))
```
The pixel data in an Image can be retrieved as a numpy ndarray by calling
`Image.numpy_view()`. The returned numpy ndarray is a reference to the
@ -65,6 +68,8 @@ void ImageSubmodule(pybind11::module* module) {
numpy ndarray, it's required to obtain a copy of it.
Pixel data retrieval examples:
```python
for channel in range(num_channel):
for col in range(width):
for row in range(height):
@ -74,6 +79,7 @@ void ImageSubmodule(pybind11::module* module) {
print(output_ndarray[0, 0, 0])
copied_ndarray = np.copy(output_ndarray)
copied_ndarray[0,0,0] = 0
```
)doc",
py::dynamic_attr());
@ -156,9 +162,11 @@ void ImageSubmodule(pybind11::module* module) {
An unwritable numpy ndarray.
Examples:
```
output_ndarray = image.numpy_view()
copied_ndarray = np.copy(output_ndarray)
copied_ndarray[0,0,0] = 0
```
)doc");
image.def(
@ -191,10 +199,12 @@ void ImageSubmodule(pybind11::module* module) {
IndexError: If the index is invalid or out of bounds.
Examples:
```
for channel in range(num_channel):
for col in range(width):
for row in range(height):
print(image[row, col, channel])
```
)doc");
image
@ -224,7 +234,9 @@ void ImageSubmodule(pybind11::module* module) {
A boolean.
Examples:
```
image.is_aligned(16)
```
)doc");
image.def_static(