Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
src
tests
COPYING
Makefile.am
README
autogen.sh
configure.in
gtkdoc.py
gtkimageview.doap
gtkimageview.pc.in
waf
wscript

README

============
GtkImageView
============

Copyright © 2007-2008 Björn Lindqvist <bjourne@gmail.com>

This is the README file for the GtkImageView widget.

GtkImageView is a widget that provides a zoomable and panable view of
a GdkPixbuf. It is intended to be usable in most types of image
viewing applications.

Compilation
===========
The usual business:

    $ ./configure --prefix=/some/prefix
    $ make
    $ make install

You can also use the --enable-gtk-doc configure argument to enable
building of API documentation.

Alternatively, GtkImageView can be built with waf:

    $ ./waf configure
    $ ./waf build
    $ ./waf install

Because GtkImageView uses c99, you must use a version of gcc newer
than 2.96. The gnome-common module must also be installed.

Todo
====

* Maybe make rotations work correctly.
* Implement shifted selection rectangle moving and resizing.

Announcement
============

(To be posted to the following mailing lists periodically:
* gnome-announce-list@gnome.org
* gnome-list@gnome.org

Subject: [ANN] GtkImageView 1.6.4 - Image viewer widget for GTK+
)

I'm pleased to finally announce GtkImageView 1.6.4!

Description
-----------
GtkImageView is a simple image viewer widget for GTK+. Similar to the
image viewer panes in gThumb or Eye of Gnome. It makes writing image
viewing and editing applications easy. Among its features are:

* Mouse and keyboard zooming.
* Scrolling and dragging.
* Adjustable interpolation.
* Fullscreen mode.
* GIF animation support.
* Ability to make selections.
* Extensible using a tool system.

Bindings exists for Perl and Python.

Download
--------
Check it out from Subversion:

    svn co http://publicsvn.bjourne.webfactional.com/gtkimageview

Or download the latest release tarball:

    http://trac.bjourne.webfactional.com/chrome/common/releases/gtkimageview-1.6.4.tar.gz

API documentation can be found online:

    http://trac.bjourne.webfactional.com/chrome/common/gtkimageview-docs/

Or by browsing to the ./docs/reference/html/index.html file.

Project website: http://trac.bjourne.webfactional.com

Examples
--------
Here is the canonical example for using the widget::

    #include <gtkimageview/gtkimagescrollwin.h>
    #include <gtkimageview/gtkimageview.h>
    ...
    GtkWidget *view = gtk_image_view_new ();
    GtkWidget *scroll = gtk_image_scroll_win_new (GTK_IMAGE_VIEW (view));
    
    /* Where "box" is a GtkBox already part of your layout. */
    gtk_box_pack_start (GTK_BOX (box), scroll, TRUE, TRUE, 0);
    
    GdkPixbuf *pixbuf = gdk_pixbuf_new_from_file ("someimage.png", NULL);
    gtk_image_view_set_pixbuf (GTK_IMAGE_VIEW (view), pixbuf, TRUE);

Future
------
* Gtk# bindings.
* Haskell bindings.