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:
parent
62f0034033
commit
8d2473c751
|
@ -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(
|
||||
|
|
Loading…
Reference in New Issue
Block a user