===============================================================================
                          GRAFX VIEWER (Version 1.4)
===============================================================================

Author:     Aaron W. Miles - am21082g@gmail.com
			     

Built With: Python 3 & Google Gemini
Created:    July 2026
===============================================================================

-------------------------------------------------------------------------------
1. OVERVIEW
-------------------------------------------------------------------------------
Grafx Viewer is a portable lightweight, high-performance image viewer application. 
It provides clean list-based file navigation, dynamic auto-resizing, 
comprehensive format filtering, real-time metadata display, and an 
integrated automated slideshow mode.

-------------------------------------------------------------------------------
2. KEY FEATURES
-------------------------------------------------------------------------------
* Dynamic Folder Loading:
  Quickly scan entire directories for supported image formats with automatic
  case-insensitive A-Z alphabetical sorting.

* Real-Time File Filtering:
  Filter visible image files in real time using a dynamic extension drop-down
  selector

* Full-Featured Status Bar:
  Instantly view image index position, original pixel dimensions (width x height),
  calculated zoom scaling percentage, image encoding format, and file size 
  (B, KB, MB).

* Automated Slideshow Mode:
  Toggle automatic image progression with user-selectable display intervals 
  ranging from 2 seconds to 6 seconds per frame, featuring continuous looping.

* Active Directory Path Display:
  Conveniently view and copy the full path of the currently active working 
  directory directly from the top control panel.

* Built-In Format Reference Table:
  An interactive lookup table built into the "About" window describing every
  supported file extension mask and its underlying format background.

* It's portable, no installation required, just copy the program to a folder.

-------------------------------------------------------------------------------
3. INSTALLATION & SYSTEM REQUIREMENTS
-------------------------------------------------------------------------------
Just copy the program to a directory of your choice, then run the program. That's
it. It doesn't mess with your file registrations or change any of your
default Image Viewer settings.

To uninstall this program, delete it.

Tested on my Windows 10 Laptop... so, I assume Windows 11 works as well.

-------------------------------------------------------------------------------
4. SUPPORTED FILE FORMATS REFERENCE
-------------------------------------------------------------------------------
Below is the full list file extensions supported by Grafx Viewer:

Extension  Description
---------  --------------------------------------------------------------------
*.avif     AV1 Image File Format (Modern high-efficiency compression)
*.bmp      Bitmap Image File (Uncompressed raster graphics format)
*.ico      Windows Icon File format
*.jfif	   Jpeg format
*.jpg      Joint Photographic Experts Group (Lossy digital photos)
*.jpeg     Joint Photographic Experts Group (Lossy digital photos)
*.jp2      JPEG 2000 Wavelet-compressed image format
*.pcx      ZSoft PC Paintbrush Bitmap Graphic
*.png      Portable Network Graphics (Lossless raster with alpha transparency)
*.ppm      Portable Pixel Map (Netpbm color image format)
*.tga      Truevision Targa Graphic Format (Popular in 3D/gaming)
*.tif      Tagged Image File Format (High-quality print graphic)
*.tiff     Tagged Image File Format (High-quality print graphic)
*.webp     Web Picture format (Google efficient web image codec)

-------------------------------------------------------------------------------
5. LICENSE

This program is FREEWARE. You can use it for whatever you want.


-------------------------------------------------------------------------------
6. LEGAL DISCLAIMER & LIMITATION OF LIABILITY
-------------------------------------------------------------------------------
THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED 
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.

IN NO EVENT SHALL THE AUTHOR, COPYRIGHT HOLDERS, OR CONTRIBUTORS BE LIABLE FOR 
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON 
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

USE THIS SOFTWARE ENTIRELY AT YOUR OWN RISK.

===============================================================================
                      (C) 2026 Aaron W. Miles. All Rights Reserved.
===============================================================================