RetroPie/omxiv
0
0
Fork 0
mirror of https://github.com/RetroPie/omxiv.git synced 2026-08-07 01:15:51 -06:00
Code Issues Projects Releases Packages Wiki Activity
OpenMax image viewer for the Raspberry Pi
72 commits 1 branch 0 tags 169 KiB
  • C 99.3%
  • Makefile 0.7%
Find a file
Exact
cmitu 131d5ce2f8 Fix "file-list" argument
2019-09-20 04:48:08 +01:00
libnsbmp Add bmp support via libnsbmp 2015-07-31 02:11:30 +02:00
libnsgif Add GIF support via libnsgif 2015-08-24 18:46:47 +02:00
.gitignore Add synopsis and generate usage print from README 2018-11-25 19:36:39 +01:00
image_def.h Change datatype to uint8 2017-12-26 19:09:14 +01:00
LICENSE Initial commit 2015-07-05 18:29:57 +02:00
Makefile Preserve the upstream repeat behavior, add a parameter to exit after showing the image(s) once 2019-09-20 04:07:34 +01:00
Makefile.include Add synopsis and generate usage print from README 2018-11-25 19:36:39 +01:00
omx_image.c Remove unused import 2018-09-11 00:28:30 +02:00
omx_image.h Remove unused part 2017-03-24 17:50:55 +01:00
omx_render.c Fix blend transition by using new alpha flag 2018-11-16 17:14:17 +01:00
omx_render.h Use tunnel between resize and render component 2017-03-14 20:32:58 +01:00
omxiv.c Fix "file-list" argument 2019-09-20 04:48:08 +01:00
README.md Preserve the upstream repeat behavior, add a parameter to exit after showing the image(s) once 2019-09-20 04:07:34 +01:00
soft_image.c Respect exif orientation 2018-02-05 22:18:07 +01:00
soft_image.h Respect exif orientation 2018-02-05 22:18:07 +01:00

README.md

OMX image viewer

A GPU accelerated image viewer for the Raspberry Pi.

Building

You will need the development header for libjpeg and libpng (Debian: libjpeg8-dev, libpng12-dev). Then build it on the Pi with:

make ilclient
make

And install with:

sudo make install

Synopsis

USAGE:

omxiv [OPTIONS] image1 [image2] ...
omxiv [OPTIONS] directory

Without any input it will cycle through all
supported images in the current directory.

OPTIONS:

-h  --help                   Print this help
-v  --version                Show version info
-t                  n        Time in s between 2 images in a slide show
-b  --blank                  Set background to black
-T  --transition   type      type: none(default), blend
    --duration      n        Transition duration in ms
    --win     'x1 y1 x2 y2'  Position of image window
    --win      x1,y1,x2,y2   Position of image window
-m  --mirror                 Mirror image
-a  --aspect       type      type: letterbox(default), fill, center
-o  --orientation   n        Orientation of the image (0, 90, 180, 270)
-l  --layer         n        Render layer number
-d  --display       n        Display number
-i  --info                   Print some additional infos
-k  --no-keys                Disable keyboard input
-s  --soft                   Force software decoding
    --ignore-exif            Ignore exif orientation
-f  --file-list              Read a list of images from a text file
-r  --randomize              Randomize the list of images
    --once                   Only show the image(s) once, exit after the last

KEY CONFIGURATION:

ESC, q  :   Quit
LEFT    :   Previous image
RIGHT   :   Next image
UP      :   Rotate right
DOWN    :   Rotate left
m       :   Mirror image
p       :   Pause slide show

Supported images

  • JPEGs

    • non-progressive: OMX.broadcom.image_decode
    • progressive: libjpeg

  • PNGs

    • libpng

  • BMPs

    • libnsbmp

  • GIFs

    • libnsgif

  • TIFFs

    • libtiff

Credits

Thanks to:

  • Matt Ownby, Anthong Sale for their hello_jpeg example
  • Jan Newmarch for his blog: Programming AudioVideo on the Raspberry Pi GPU
  • Various authors of example code and other parts (marked in the source files)