ArtSee 1.97f
Copyright (c) 2009 Rick Xavier
All Rights Reserved

ArtSee is a small graphics viewer. It displays the image files in a folder tree.
ArtSee is free for personal non-commercial use. All donations appreciated.


Add & Remove
------------
To install: Place in a folder in your user area (eg ...\Xworks\ArtSee).
To remove: Delete the program files.


Features and options
--------------------
- Slideshow (slideshow, timer)
- Sort (forward/reverse/random, name/created/modified/accessed)
- Layer (normal, fullscreen, wallpaper, stay on top, blend, opacity)
- Loop (loop, pause, exit, reshuffle)
- Navigate (next/previous w/gears, first, last, current)
- Scroll (mouse, arrow keys w/gears, autoscroll)

- Folder (browse, current, refresh, subfolders, hidden folders, peek, autorefresh)
- Find (find/filter/exclude, find next, landscape/portrait, bookmark, goto)
- Formats (bmp, emf, gif, ico, jpg, png, tif)
- Favorites (send shortcut, send to desktop, send copy, copy to desktop,
  view favorites/desktop/target, folder)

- Wrap (resize window to wrap around each image)
- Crop (remove borders and unused background)
- Squeeze (scale down to fit window/desktop)
- Shrink (scale down to fit one side)
- Stretch (scale up to window/desktop)
- Zoom (in, out, 100%, 1% gear, zoom lock, zoom step, zoom/scale quality)
- Rotate (rotate, rotate left, rotate lock, aspect filter, flip horizontal)
- Layout (centered, corners, roaming)
- Collage (fixed-size roaming images)
- Transitions (select effects, overlap/wipe)

- Window (caption, status, taskbar/tray, icon, decor, white, center/roam, corral,
  draggable, 5 presets, show/hide, single instance)
- Fullscreen (caption, cursor, centered/roaming image)
- Wallpaper (center, tile, stretch, clear, restore)
- Shell (view, explore, open with, copy file, move/rename, save as, copy image,
  copy view, paste, recycle, confirm)
- Shell++ (archive, view with, explore with, Blackbox)
- Settings (save, save now, bookmark on exit)

- Drag and Drop (folders/files/shortcuts), Shift appends
- Menu pins (keep menus open while adjusting options)
- F1 menu at corner/cursor
- Command line options
- Tray icon controls and mouse wheel support
- Can be run as a screensaver
- Can be run as a wallpaper changer
- Needs no installation
- Saves settings file in program folder
- Unicode enabled


Operation
---------
1) Right-click the window or tray icon for ArtSee's menu, or press F1
   - Keyboard shortcuts are listed on the menu
   - Additional keys: Slideshow (Enter), Next (Spacebar), Previous (Backspace)

2) Window:
   a) Sizing:
      - Wrap (W) resizes the window to the image, within the desktop
      - Wrap also enables the window autocenter/roam options
      - Window presets and manual resizing automatically turn off Wrap
      - Wrap restores wrapping from collage and presets
      - Wrap off in fullscreen preserves the original window size

   b) Cropping:
      - Cropping removes everything but the image
      - Turn cropping off to expose the window frame and caption
      - For a fixed (unwrapped) window, cropping removes the unused background

3) Image:
   a) Scaling (% in status bar):
      - Squeeze, shrink and stretch are variable zoom settings
        . Squeeze scales the image down to fit the window/desktop
        . Shrink scales the image down to fit one side to the window/desktop
          - Squeeze takes precedence over shrink
        . Stretch scales the image up to the window/desktop
          - With squeeze it stretches to fit, otherwise it stretches to fill
      - Zoom Lock is a fixed zoom
        . Zoom Lock and squeeze/shrink/stretch disable each other
        . Zoom Lock can also be cleared by locking at 100%
   b) Scrolling (H:n V:n):
      - The horizontal & vertical scrollable area (arrow keys to scroll)
      - Use Shift/Ctrl/Alt keys to alter keyboard scrolling speed
      - Left-click mouse to scroll large images
      - Left-click and mousewheel scrolls vertically
   c) Rotate rotates the image 90 degrees clockwise
      - Rotate lock locks the rotation for the slideshow
      - Aspect filter only rotates to match the window/desktop aspect ratio
   d) Layout positions the image in a fixed window or desktop
      - Used to align cropped images in screen corners
   e) Collage overlaps fixed-size roaming position images
      - Collage temporarily disables Wrap
   f) Crossfade transitions are restricted to fixed size, uncropped windows
      - fullscreen, collage and wrap off without crop, are supported
      - a random transition will be substituted otherwise

4) Exhibit:
   a) The root exhibit folder can be set in several ways:
      - With the folder browser (Folder->Browse)
      - With the Folder->Current option
      - By dropping a folder onto ArtSee
      - By dropping a single file in the folder onto ArtSee

   b) Temporary exhibits can be set in several ways:
      - With the Find->Filter function
      - With the Favorites->View(Favorites/Desktop/Target) options
      - With Shell->Archive->View Archive option
      - By dropping a group of files/folders onto ArtSee
      - By appending images (SHIFT+drop/select)

   c) Folder->Refresh (Ctrl+R) reloads the main (root) exhibit
      - Any appended images are released
      - Auto Refresh refreshes on any external file/folder change under the root

   d) Shortcuts (shell links) can be used in place of files/folders
      - Shortcuts can be created using Favorites->Send(Shortcut/To Desktop)
      - Shortcut names are prepended with an asterisk (*filename.lnk)
      - File operations (eg Delete) on shortcuts affect the shortcut only

   e) Find/Filter and Find Next search within the current exhibit
      - To begin a new search, first reload the main exhibit

   f) File search (Peek):
      - The Peek option is for incremental search and display

5) Window Management:
   a) Show/Hide applies to the first (or single) instance
   b) Single Instance restricts ArtSee to a single instance

6) Shell:
   a) Copy, Paste and Save: all use the current image settings (zoom etc)
      - Copy Image includes the offscreen portion
      - Copy View copies only the visible portion (crops the image)
   b) Wallpaper uses the current image settings (optional with Blackbox)
   c) Archive: quietly moves the image to the archive folder
      - Archived filenames can be written to "archived.log"
   d) Blackbox: ArtSee detects if Blackbox is the shell
      - The Desktop/Window adjustments are for bbLeanSkin
      - Smart Wallpaper lets Blackbox handle backgrounds
      - Unscaled smart wallpaper does not write to artpaper.bmp

7) Misc:
   a) File read errors are logged to "errors.log"
      - Usually due to a corrupted file header that GDI+ can't handle
      - Loading and saving with a graphics editor usually fixes this
      - May also be due to a stale shortcut
   b) ArtSee as wallpaper changer: use the tray icon controls
   c) ArtSee as a screensaver: use the ArtSaver screensaver driver
      - "Safe mode": use (-noshell/-nomenu) with screensaver password


Command Line / Shortcut
-----------------------
Usage: artsee [options] [path]

  The command line takes precedence over the settings file.

  options:     -slide          Slideshow on
               -noslide        Slideshow off
               -sortforward    Sort forward
               -sortreverse    Sort reverse
               -sortrandom     Sort random
               -sortname       Sort on file name
               -sortcreated    Sort on file creation date/time
               -sortmodified   Sort on file modification date/time
               -sortaccessed   Sort on file accessed date/time
               -tnnnn          Set timer to nnnn millisecs
               -normal         Layer normal
               -fullscreen     Layer fullscreen
               -wallpaper      Layer wallpaper
               -ontop          Stay on top
               -notop          Don't stay on top
               -blend          Blend with background (transparency)
               -noblend        Don't blend (no transparency)
               -bnnn           Set blend opacity to nnn (0-255)
               -loop           Loop slideshow
               -loopause       Pause after slideshow
               -loopexit       Exit after slideshow
               -loopshuffle    Reshuffle when random slideshow loops
               -noloopshuffle  Don't reshuffle when slideshow loops
               -autoscroll     Autoscroll large images to center
               -noautoscroll   Don't autoscroll to center

               -browse         Open folder browser
               -subfolders     Include subfolders
               -nosubfolders   Exclude subfolders
               -hidden         Include hidden subfolders
               -nohidden       Exclude hidden subfolders
               -peek           Show while searching
               -nopeek         Don't show while searching
               -peeksort       Sort while peeking
               -nopeeksort     Don't sort while peeking
               -peekcount      Show count while peeking
               -nopeekcount    Don't show count while peeking
               -autorefresh    Refresh on new files
               -noautorefresh  Don't refresh on new files
               -autofindcreate Find last created on autorefresh
               -autofindmodify Find last modified on autorefresh
               -noautofind     Don't find after autorefresh

               -landscape      Show landscape images only
               -portrait       Show portrait images only

               -bmp            Read .bmp files
               -nobmp          Don't read .bmp files
               -emf            Read .emf files
               -noemf          Don't read .emf files
               -gif            Read .gif files
               -nogif          Don't read .gif files
               -ico            Read .ico files
               -noico          Don't read .ico files
               -jpg            Read .jpg and .jpeg files
               -nojpg          Don't read .jpg and .jpeg files
               -png            Read .png files
               -nopng          Don't read .png files
               -tif            Read .tif and .tiff files
               -notif          Don't read .tif and .tiff files

               -wrap           Wrap window around the image (resize window)
               -nowrap         Don't wrap window (fixed window)
               -crop           Remove borders and unused background
               -nocrop         Leave borders and unused background
               -squeeze        Scale down to fit
               -nosqueeze      Don't scale down to fit
               -shrink         Scale down to fit one side
               -noshrink       Don't scale down to fit one side
               -stretch        Scale up (fit/fill depends on shrink)
               -nostretch      Don't scale up

               -znn            Set zoom lock to nn%
               -zoomdef        Set zoom/scale quality to default
               -zoomhigh       Set zoom/scale quality to high
               -zoombest       Set zoom/scale quality to best
               -rnn            Set rotate lock to (0/90/180/270) deg
               -aspect         Filter rotations to match aspect ratio
               -noaspect       Don't filter rotations
               -centered       Layout centered
               -topleft        Layout top left
               -topright       Layout top right
               -bottomleft     Layout bottom left
               -bottomright    Layout bottom right
               -collage        Collage on (fixed-size roaming)
               -nocollage      Collage off
               -transitions    Use transitions
               -notransitions  Don't use transitions
               -overlap        Overlap images
               -nooverlap      Wipe between images

               -title          Show file name in title bar
               -notitle        Don't show file name
               -fullname       Show full path for file name
               -shortname      Don't show full path
               -statusbar      Show the status bar
               -nostatusbar    Remove the status bar
               -taskbar        Use taskbar instead of tray icon
               -trayicon       Use tray icon instead of taskbar
               -winicon        Show icon in the titlebar
               -nowinicon      Don't show icon in the titlebar
               -decor          Decorate window
               -nodecor        Don't decorate window
               -whitebg        White background
               -blackbg        Black background
               -autocenter     Autocenter window on wrap
               -noautocenter   Don't autocenter window
               -roam           Window roams desktop when wrapped
               -noroam         Window doesn't roam
               -corral         Force window within screen boundaries
               -nocorral       Don't force window within screen boundaries
               -draggable      Drag with any part of the window
               -nodraggable    Drag with the title bar only
               -center         Center window in desktop
               -preset1        Restore window preset 1
               -preset2        Restore window preset 2
               -preset3        Restore window preset 3
               -preset4        Restore window preset 4
               -preset5        Restore window preset 5
               -single         Close other instances of ArtSee
               -nosingle       Don't close other instances of ArtSee

               -screenname     Show file name when fullscreen
               -noscreenname   Don't show file name when fullscreen
               -screencursor   Show cursor when fullscreen
               -noscreencursor Hide cursor when fullscreen
               -screencenter   Centered image when fullscreen
               -screenroam     Roaming image when fullscreen
               -centerwall     Center wallpaper
               -tilewall       Tile wallpaper
               -stretchwall    Stretch wallpaper
               -clearwall      Clear wallpaper

               -archive        Archiving enabled
               -noarchive      Archiving disabled
               -arclog         Log archived images
               -noarclog       Don't log archived images
               -save           Save settings on exit
               -nosave         Don't save settings on exit
               -markexit       Bookmark at exit
               -nomarkexit     Don't bookmark at exit

               -showerrors     Show file-read error messages*
               -nologerrors    Don't log file-read errors in "errors.log"*
               -noshell        Disable all shell operations*
               -nomenu         Disable all operations*

  path:        If a folder, it is the root exhibit folder
               If a file, the parent folder is the root exhibit folder

* Option available from command line only

Examples:
  artsee -slide -crop -normal -t2000 "C:\Documents and Settings"
  artsee -fullscreen -noscreenname -z50 -screenroam .\
  artsee -nosqueeze -shrink -stretch -r90 -aspect


Autorun CD/USB Drive
--------------------
To make an autorun CD, create the file "autorun.inf" containing these 3 lines:

[autorun]
open=artsee.exe -slide .\
icon=artsee.exe

Copy autorun.inf to the CD root directory, together with artsee.exe. Your photos can be in the root directory or in subfolders. You can use command line options. You should also copy this (ReadMe.txt) file to the CD.


File Associations
-----------------
ArtSee does not associate JPG files with itself. You can do this manually by right-clicking a .jpg and using the "Open With" option: select "Choose Program..." and browse to ArtSee. If you check the "Always use the selected program [etc....]" box, ArtSee will become the default viewer, otherwise it will simply remain in the "Open With" list. (You can control any file extension this way.) You can also place a shortcut to ArtSee in the "Send To" menu for easy access.


Warranty Disclaimer
-------------------
THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.

THE AUTHOR DISCLAIMS ALL WARRANTIES, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

THE ENTIRE RISK AS TO THE USE AND PERFORMANCE OF THE SOFTWARE REMAINS WITH YOU. IN NO EVENT WILL THE AUTHOR BE LIABLE TO YOU OR ANY OTHER PARTY FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.


Contact the Author
------------------
Rick Xavier
www.xworks.ca
