imaging/getting-started-with-image-streams.md

@@ -135,15 +135,43 @@ You can run **--help** as following to search it in **less**:
 ```
 
 ## image files and file lists
-single image, from/to ...
 
-supported formats including gz ...
+For the examples in this section, prepare three images. I have prepared mine: cat.jpg, kitty.jpg, and kitten.jpg.
 
-input image lists ...
+### Read and view a single image
+```
+> cv-cat --file kitten.jpg "view=stay;null"
+```
+(**view=stay** means: for each image visualise it until a key press.)
 
-output image lists ...
+Output a single image as png:
+```
+> cv-cat --file kitten.jpg "encode=png" --output no-header > kitten.png
+```
+
+**cv-cat** support most of the common image formats and well as reading gzipped images in **snark** format.
+
+### Read multiple image files
+Run the following command. Press any key to see next image.
+```
+> cv-cat --files list.txt "view=stay;null"
+```
+As mentioned before, note that images do not need to be of the same size and type.
 
-combining both ...
+You also can for image list on the fly:
+```
+> cv-cat --files <( echo cat.jpg; echo kitty.jpg; echo kitten.jpg ) "view=stay;null"
+```
+### Output multiple images to files
+```
+> cv-cat --files input.txt "invert;flip;file=png,filenames:output.txt;null"
+```
+Again, form output image list on the fly, just to demonstrate the point:
+```
+> cv-cat --files <( echo cat.jpg; echo kitty.jpg; echo kitten.jpg ) "file=png,filenames:"<( 
+echo cat.inverted.png; echo kitty.inverted.png; echo kitten.inverted.png )";null"
+```
+You also can pass to **file** filter a list of numbers of the frames you would like to save in the images. See **cv-cat --help --verbose** for details. 
 
 ## videos
 ### convert video into an image stream