+-------------+ | mViewer 3.1 | +-------------+ Introduction: ------------ mViewer is an image (bitmap only for now) reader to be used with Ndless 1.7/2.0 or compatible on a TI-Nspire or TI-Nspire CAS. Features: -------- - browsing the whole Nspire file system - scrolling - zoom out/in - setting contrast - 16 & 32 colors mode - emergency power off screen Browser controls: ---------------- - change selected file/folder: * arrow up/down keys * numeric 8/2 keys * touchpad up/down zones (pressing the touchpad key is not required) - validate selection (browse selected folder or open selected file): * enter key * return key * click key * arrow right key * numeric 5/6 keys * touchpad right zone (pressing the touchpad key is not required) - browse parent folder: * arrow left key * numeric 4 key * touchpad left zone (pressing the touchpad key is not required) - exit the browser and return to the OS: * esc key Viewer controls: --------------- - progressive scroll of image: * arrow up/down/right/left keys * numeric 1/2/3/4/6/7/8/9 keys - immediate scroll of the full screen width/height: * numeric 5 key + arrow up/down/right/left keys * click key + arrow up/down/right/left keys * click key + numeric 1/2/3/4/6/7/8/9 keys * numeric 5 key + numeric 1/2/3/4/6/7/8/9 keys - touchpad scroll: * drag & drop on the touchpad (without pressing the touchpad key) - exit the viewer and return to the browser: * esc key - increase contrast: * "+" key - decrease contrast: * "-" key - emergency power off screen: * ctrl key - power back on screen: * ctrl key * esc key - switch between 16 (default) & 32 colors modes: * C key - progressive zoom in: * "*" key * numeric 5 key * click key - progressive zoom out: * "/" key Installation: ------------ Send the appropriate "mviewer(ndless__).tns" document to your TI-Nspire. Any folder is ok. Usage: ----- You need to send some images in any folder. Prior to sending the images, you'll have to change their file extension to "tns" (Nspire document). For exemple, a "home.bmp" file can be renamed to "home.tns" or "home.bmp.tns". You may have to change some folder setting on your computer, to make your OS fully display the file extensions. Supported image formats: ----------------------- * Type: BMP - Bits: 1-bit (up to 2 colors + transparency levels) 2-bits (up to 4 colors + transparency levels) 4-bits (up to 16 colors + transparency levels) 8-bits (up to 256 colors + transparency levels) 16-bits (up to 16384 colors + transparency levels) 24-bits (up to 4194304 colors + transparency levels) 32-bits - Pixels: raw indexed (palette) - Color format: default RGB default RGBA (yes 'A': transparency is supported) default RGBAX ('X' is ignored) any specified RGBAX encoding (BITFIELD mode) - Compression: none RLE All formats (more than a dozen) I've been able to generate with different image softwares have been tested successfully. The BMP support is very complete and should open and display any BitMap file. If you manage to find/generate a BitMap which is not displayed correctly, please send it to me. Recommanded format: ------------------ 8-bits, grayscaled, RLE compressed. Although all above formats are supported, it is totally useless: - to have more than 16-bits for a color image - to have more than 8-bits for a greyscaled image - to have a color image Such files will be opened of course, but you'll just be wasting memory space with partially useless data. Not all image softwares let you compress a bitmap with RLE. Microsoft Paint doesn't. But GIMP does for exemple. Licence: ------- GPL v2.0 Authors: ------- Xavier Andreani: main code with the help of: * Levak: zoom in/out code * JayTe: initial display code Future versions: --------------- * Support for other image formats: - PNG - JPEG - GIF - PDF * Use interrupts for 32 colors mode, to make intermediate colors optimal on all hardwares. * Use 8-bits screen mode instead of 16-bits screen mode (less RAM used). A palette will have to be used. * Add 48 & 64 colors mode (very limit but might be possible - 128 colors won't be possible because of the blinking delay being superior to 1/10th of seconds, eye remanence) * Optimize image colors according to displayable colors. Thanks: ------ - TI-Planet for data hosting and encouragements - Omnimaga or testing and encouragements Known bugs: ---------- The 32 colors mode seems to be very dependant upon the screen refreshing delay. Versions history: ---------------- 3.1 (11/12/2011): * fixed a bug which prevented some RLE compressed BMP images to be displayed, when the last CR was omitted 3.0(RC2) (10/03/2010): * fixed a bug which prevented some RLE compressed BMP images to be displayed, when a new fake (useless) line was created just before the end of file * fixed a minor display bug in the browser 3.0RC1 (09/03/2010): * added touchpad controls and alternative controls (as the touchpad has some sensibility problems) 2.1b (06/03/2010) * changed clickpad controls to be compatible with future touchpad controls * added icons in the browser * removed "." and ".." folders in the browser 2.0 (06/01/2010): * added a 32 colors mode * added a progress during image loading * you can now scroll of a full screen width/height * more realistic greyscale convertion for color images, based on luminescance 1.0b3 (13/12/2010): * fixed a bug if the 00FF escape code was found in an RLE compressed image * fixed a lost character bug when the text console was reaching the the bottom of the screen * fixed a bug with the browser when there was more than 2 pages of files 1.0b2 (12/12/2010): * code for supporting uncompressed BMP which set a null data size in the header 1.0 (12/12/2010): * initial release Xavier Andréani andreanx@hotmail.com