//For the old Python version, see [[projects:cgview-python|this page]]//.

----

==== CGView ====

CGView is an image archive file viewer specifically designed for browsing
CG archives, as well as to reading manga & comic. Unlike many readers out there, it doesn't extract images to the filesystem, which helps a lot with the speed and prevents fragmentation in the filesystem. It is fast, light and efficient. It is written in Go programming language, and uses the [[http://www.libsdl.org|SDL]] library. And for anyone who might be interested, yes, it can be used under [[wp>Linux framebuffer]].

I originally wrote this as a replacement for [[http://comix.sf.net|Comix]] (or [[http://mcomix.sf.net|MComix]])
on my GNU/Linux machine, so the basic functionality may resemble it.


=====Why?=====
  * AFAIK, there are no CG-targeted archive viewers.
  * Comic readers, which would do the job without the fancies, are slow and cause fragmentation in the disk. A work-around is to mount the temp directory as tmpfs, assuming that the comic reader deletes unused image files right away (which is not the case for MComix or [[http://qcomicbook.org/|QComicBook]] anyway).
  * Works under framebuffer.

=====Features=====
  * Standard features: fullscreen mode, doublepage mode, manga mode, fit to width and/or height.
  * Mirroring & flipping.
  * Transition effects. (not done yet)
  * Loads image formats supported by [[http://www.libsdl.org/projects/SDL_image/|SDL_image]]
  * Opens zip, 7z, tar, tar.gz, tar.bz2 archives, as well as ordinary image files.
  * Conservative filesystem usage: never extracts images.

=====Installation=====
Get the sources [[http://freeconsole.org/crew/salviati/software/cgview/|here]].
To compile CGView, you will first need [[http://golang.org/doc/install|a sane Go development enviroment]] along with
SDL, SDL_ttf, SDL_gfx, SDL_image, and sqlite3 installed.
Go side dependencies will automatically be fetched by the go command.
Just type

    go get

in the source directory and all should be set!

=====TODO=====
  * Transitions.
  * Better concurrency.
  * Fix the issues with the OpenGL renderer.
  * Archive definition format
  * Bookmarks

=====Planned Features=====
  * Although not a priority, RAR and LZMA support.
  * Better 7z support. Current implementation causes an annoying hang-up when
opening solid archives.
  * Customization of controls.
  * GTK support through [[http://sdl.beuc.net/sdl.wiki/FAQ_GUI|SDL_WINDOWID hack]] (not a priority). Should default to pure-SDL under framebuffer.
  * Correct display of non-UTF8 filenames (of files within the archive). This will require 2 more dependencies (libguess and iconv), so I'm quite relucatant to implement this.

=====License=====
CGView is free software; you may redistribute it under the terms of
the GNU General Public License version 3 or (at your option) a later version.
This program has absolutely no warranty.
See the file named COPYING for details.
Report bugs to <bug@freeconsole.org>.