/multiviewer-2

Another basic multi-image viewer, intended for displaying art references. Made with Love2D.

Primary LanguageLuaMIT LicenseMIT

MultiViewer 2

A very basic multi-image viewer intended for displaying art references. Made with Love2D.

A rewrite of my Defold Multiviewer in Love2D.

Demo .gif of the Defold version

Getting started

  1. Download and install OpenAL from https://www.openal.org/downloads/
  2. Download and run MultiViewer 2 from https://github.com/rgrams/multiviewer-2/releases

Missing features from Defold version:

  • No native file dialogs (which only worked on Windows and MacOS anyway).

Added features from Defold version:

  • No CPU cost at rest
    • The window is only redrawn when you interact with it, so the CPU load should be pretty much zero when the program is just sitting there.
  • Can accept a command-line argument to open a project file on startup.
    • Therefore you can associate the ".multiview" file type with the executable and then double-click on those files to open them.
  • Zoom to the mouse cursor position.
  • Ctrl-Middle-Mouse drag to zoom precisely.
  • Show asterisk in window title when project has unsaved changes.
    • Panning or zooming the camera counts as a change and is saved in file.

Controls

  • Drag and drop images or folders-of-images onto the window to add them.
  • Delete -- Removes hovered image.
  • Ctrl-S -- Save project
    • Saves the project file opened at startup, OR saves as "_project.multiview" in the executable's folder (will overwrite).
  • Left-Click-Drag -- Move image
  • Right-Click OR Mouse-Button-4 & Drag -- Scale image
  • Middle-Click-Drag -- Pan Viewport
  • Ctrl-Middle-Click-Drag -- Zoom viewport.
  • Mouse Wheel -- Zoom Viewport
  • Page Up -- Move image under cursor up in draw order
    • Hold Ctrl to move all the way to the top.
  • Page Down -- Move image under cursor down in draw order
    • Hold Ctrl to move all the way to the bottom.
  • Alt-Enter -- Toggle borderless window mode.

Notes on Saving & Loading Projects

  • Opening a .multiview file just adds in the saved images to your viewport, it won't remove any images you've already loaded.
  • Saving a project will record all the images you have open.