root/gtkimageview/README

Revision 289, 2.5 kB (checked in by bjourne, 6 years ago)

Bumping version numbers in preparation for the next release! 1.4.0

Line 
1 ============
2 GtkImageView
3 ============
4
5 Copyright © 2007 Björn Lindqvist <bjourne@gmail.com>
6
7 This is the README file for the GtkImageView widget.
8
9 GtkImageView is a widget that provides a zoomable and panable view of
10 a GdkPixbuf. It is intended to be usable in most types of image
11 viewing applications.
12
13 Compilation
14 ===========
15 The usual business:
16
17     $ ./configure --prefix=/some/prefix
18     $ make
19     $ make install
20
21 You can also use the --enable-gtk-doc configure argument to enable
22 building of API documentation. Because GtkImageView uses c99, you must
23 use a version of gcc newer than 2.96.
24
25 Todo
26 ====
27
28 * Maybe make rotations work correctly.
29 * Implement shifted selection rectangle moving and resizing.
30
31 Announcement
32 ============
33
34 (To be posted to the following mailing lists periodically:
35 * gnome-announce-list@gnome.org
36 * gnome-list@gnome.org
37
38 Subject: [ANN] GtkImageView 1.4.0 - Image viewer widget for GTK
39 )
40
41 I'm pleased to finally announce GtkImageView 1.4.0:
42
43 Description
44 -----------
45 GtkImageView is a simple image viewer widget for GTK. Similar to the
46 image viewer panes in gThumb or Eye of Gnome. It makes writing image
47 viewing and editing applications easy. Among its features are:
48
49 * Mouse and keyboard zooming.
50 * Scrolling and dragging.
51 * Adjustable interpolation.
52 * Fullscreen mode.
53 * GIF animation support.
54 * Ability to make selections.
55 * Extensible using a tool system.
56
57 Download
58 --------
59 Check it out from Subversion:
60
61     svn co http://publicsvn.bjourne.webfactional.com/gtkimageview
62
63 Or download the latest release tarball:
64
65     http://trac.bjourne.webfactional.com/attachment/wiki/WikiStart/gtkimageview-1.4.0.tar.gz
66
67 API documentation can be found online:
68
69     http://trac.bjourne.webfactional.com/chrome/common/gtkimageview-docs/
70
71 Or by browsing to the ./docs/reference/html/index.html file.
72
73 Project website: http://trac.bjourne.webfactional.com
74
75 Examples
76 --------
77 Here is the canonical example for using the widget::
78
79     #include <gtkimageview/gtkimagescrollwin.h>
80     #include <gtkimageview/gtkimageview.h>
81     ...
82     GtkWidget *view = gtk_image_view_new ();
83     GtkWidget *scroll = gtk_image_scroll_win_new (GTK_IMAGE_VIEW (view));
84    
85     /* Where "box" is a GtkBox already part of your layout. */
86     gtk_box_pack_start (GTK_BOX (box), scroll, TRUE, TRUE, 0);
87    
88     GdkPixbuf *pixbuf = gdk_pixbuf_new_from_file ("someimage.png", NULL);
89     gtk_image_view_set_pixbuf (GTK_IMAGE_VIEW (view), pixbuf, TRUE);
90
91 Future
92 ------
93 * Python bindings.
94 * Perl bindings.
95 * Gtk# bindings.
96 * Haskell bindings.
Note: See TracBrowser for help on using the browser.