This is a simple image viewer. It allows you to scale and move displayed image, you can browse image list, you can also test is image "tileable" (e.g. to test is it good for a texture or desktop wallpaper). It can handle various image formats:
These are binaries of the program. No special installation is required, just unpack the archive and run glViewImage.
glViewImage remembers image list (i.e., it's actually a filename list) that you can browse using N (next image on the list) and P (previous image on the list) keys. When you run glViewImage you give it as parameters list of images to browse.
Every parameter must be one of:
A directory name — glViewImage will display all images found in this directory.
E.g. run glViewImage ~/my_images/ to display all images in ~/my_images/ directory.
A filename mask — glViewImage will display all images matching given mask, where '?' matches any char and '*' matches any number of any chars. Of course, users of bash and similar non-Windows shells can utilize shell filename expansion instead.
E.g. run glViewImage ~/my_images/*.png to display all PNG images in directory ~/my_images/. Or just run glViewImage ~/my_image.png to display only one image in file ~/my_image.png.
@<filename> — glViewImage will read image filenames from file <filename>, each line is one filename (<filename> "-" means "standard input", as usual; so you can pipe output of e.g. find program to glViewImage).
Running glViewImage with no parameters is equivalent
to running
glViewImage .
so you will view all images (that glViewImage can handle) in current directory.
Oh, and (as usual) all parameters described in those pages: standard options understood by my OpenGL programs and some notes about command-line options understood by my programs are available. If you will not give any parameter that forces some window size (like --geometry) then program will open a window with the same size as the first displayed image.
| Keys not available as menu items: | |
|---|---|
| Arrows | move image |
| Arrows + Ctrl | move image 10 x faster |
| - / + | scale image (smaller / larger) |
| x / X | scale only horizontally (smaller / larger) |
| y / Y | scale only vertically (smaller / larger) |
Notes about opening image: glViewImage guesses image format using file extension (yes, yes, I will change it at some time to recognize image format based on file content), so it's important for files to have good filename extension. JPEG images may have extension jpg or jpeg, RGBE images - rgbe or pic, rest is obvious.
Opened image is also added to image list.
Resulting image format is determined by filename extension, unknown extension will result in BMP format.
Image loaded and displayed by glViewImage is internally always stored in 24-bit RGB format. Any other information (like other pixel format, alpha channel of PNG images, high precision of RGBE images - really any other information) is not saved by glViewImage. It means that if you will load an image to glViewImage and then you will save it (even to the same image format, e.g. load PNG and save as PNG) then you can loose some important information contained in original image.
This is a serious disadvantage of saving images from glViewImage, but I am not planning to improve this - glViewImage was written as a simple image viewer, not as a professional image converter. If you need professional image converter, take a look at GIMP or ImageMagick (both of them free (free in both senses), for various operating systems etc.).
| Copyright Michalis Kamburelis. This page is considered part of documentation of my programs, and you are free to modify and further distribute it on terms of GNU General Public License. |
Services for the vrmlengine project provided by
See also vrmlengine
project page on SourceForge.