cv2/README.md

## Image Decode Implementation with CV2

*author: Kaiyuan Hu, Rentong Guo*



### Desription

An image decode operator implementation with OpenCV.



```python
import towhee import ops

img_decode = ops.image_decode.cv2()
img = img_decode('./dog.jpg')
```



### Factory method

Create the operator via the following factory method

***ops.image_decode.cv2()***



### Interface

An image decode operator takes an image path as input. It decodes the image back to ndarray.



**Parameters:**

​    ***img***: *str*

​    Image file path.



**Returns**: *numpy.ndarray*

​    The decoded image data.



### Code Example

Load a image from path './dog.jpg'. 

 *Write the pipeline in simplified style*:

```python
import towhee.DataCollection as dc

dc.glob(./dog.jpg)
  .image_decode.cv2()
  .show()
```

*Write a same pipeline with explicit inputs/outputs name specifications:*

```python
import towhee.DataCollection as dc

dc.glob['path'](./dog.jpg)
  .image_decode.cv2['path', 'img']()
  .select('img')
  .show()
```