ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/CV/bin/cv
(Generate patch)

Comparing CV/bin/cv (file contents):
Revision 1.52 by root, Sun Aug 14 19:07:15 2005 UTC vs.
Revision 1.58 by root, Wed Sep 7 20:17:25 2005 UTC

43 $viewer->load_image ($_[1]); 43 $viewer->load_image ($_[1]);
44 }); 44 });
45 45
46 Gtk2::CV::Plugin->call (new_schnauzer => $s); 46 Gtk2::CV::Plugin->call (new_schnauzer => $s);
47 47
48 $s; 48 $s
49} 49}
50 50
51sub std_keys { 51sub std_keys {
52 my $key = $_[1]->keyval; 52 my $key = $_[1]->keyval;
53 my $state = $_[1]->state; 53 my $state = $_[1]->state;
102 102
103 $viewer->signal_connect (button3_press_event => sub { 103 $viewer->signal_connect (button3_press_event => sub {
104 $mainwin->visible 104 $mainwin->visible
105 ? $mainwin->hide 105 ? $mainwin->hide
106 : $mainwin->show_all; 106 : $mainwin->show_all;
107 1; 107 1
108 }); 108 });
109 109
110 Gtk2::CV::Plugin->call (new_imagewindow => $viewer); 110 Gtk2::CV::Plugin->call (new_imagewindow => $viewer);
111 111
112 $schnauzer = new_schnauzer; 112 $schnauzer = new_schnauzer;
113 113
114 $mainwin = new Gtk2::Window; 114 $mainwin = new Gtk2::Window;
115 $mainwin->set_title ("CV"); 115 $mainwin->set_title ("CV");
116 $mainwin->add (my $vbox = new Gtk2::VBox); 116 $mainwin->add (my $vbox = new Gtk2::VBox);
117 $mainwin->signal_connect (delete_event => sub { $mainwin->hide; 1; }); 117 $mainwin->signal_connect (delete_event => sub { $mainwin->hide; 1 });
118 118
119 $vbox->add ($schnauzer); 119 $vbox->add ($schnauzer);
120 $vbox->pack_end (my $frame = new Gtk2::Frame, 0, 0, 0); 120 $vbox->pack_end (my $frame = new Gtk2::Frame, 0, 0, 0);
121 $frame->add (my $hbox = new Gtk2::HBox 0, 0); 121 $frame->add (my $hbox = new Gtk2::HBox 0, 0);
122 $hbox->pack_start ((new Gtk2::Label "Info: "), 0, 0, 0); 122 $hbox->pack_start ((new Gtk2::Label "Info: "), 0, 0, 0);
143 143
144main Gtk2; 144main Gtk2;
145 145
146__DATA__ 146__DATA__
147 147
148=encoding utf-8
149
148=head1 NAME 150=head1 NAME
149 151
150cv - a fast gtk+ image viewer loosely modeled after XV 152cv - a fast gtk+ image viewer loosely modeled after XV
151 153
152=head1 SYNOPSIS 154=head1 SYNOPSIS
160 162
161=over 4 163=over 4
162 164
163=item * optimized directory scanning algorithm 165=item * optimized directory scanning algorithm
164 166
165The directory scanning in CV plays some tricks that - on most modern 167The directory scanning in CV uses some tricks that - on most modern
166filesystems - makes it possible to detect filetypes faster than stat()'ing 168filesystems - makes it possible to detect filetypes faster than stat()'ing
167every file. This makes CV suitable for directories with lots of files 169every file. This makes CV suitable for directories with lots of files
168(10000+). 170(10000+).
169 171
170This algorithm is quite unprecise - it doesn't make a difference between 172This algorithm is quite unprecise - it doesn't make a difference between
171files, device nodes, symlinks and the like, and filetype detection is done 173files, device nodes, symlinks and the like, and filetype detection is done
172using the file extension only. 174using the file extension only.
173 175
176On the positive side, it is usually many orders of magnitude faster than
177traditional scanning techniques (good for directories with 10000 or
178100000+ files).
179
180=item * queuing for all time-consuming background tasks
181
182All tasks, such as unlinking files or generating thumbnails, that can be
183done in the background will be done so - no waiting required, even when
184changing directories.
185
174=item * use of asynchronous I/O 186=item * use of asynchronous I/O
175 187
176CV tries to use asynchronous I/O whereever it makes sense, for example 188CV tries to use asynchronous I/O whereever it makes sense, for example
177while scanning directories, waiting for stat data or unlinking files. This 189while scanning directories, waiting for stat data, unlinking files or
178usually decreases scanning times for large directories a bit (especially 190generating thumbnails. This usually decreases scanning times for large
179on RAID devices and over NFS). 191directories a bit (especially on RAID devices and over NFS) and makes CV
192much more interactive.
180 193
181=item * fast image loading 194=item * fast image loading
182 195
183The time span between the user issuing a command and displaying the new 196The time span between the user issuing a command and displaying the new
184image should be as small as possible. CV uses optimized (especially 197image should be as small as possible. CV uses optimized (especially
185for JPEG) loading functions and sacrifices some quality (e.g no gamma 198for JPEG) loading functions and sacrifices some quality (e.g no gamma
186correction) to achieve this speed. 199correction, although this might change) to achieve this speed.
187 200
188=item * fast thumbnail creation 201=item * fast thumbnail creation
189 202
190Thumbnail creation is crucial for me, so it's better be fast. Thumbnail 203Thumbnail creation uses both CPU and Disk-I/O. CV interleaves both, so
204on modern CPUs, thumbnailing is usually limited by I/O speed. Thumbnail
191creation for JPEGs has been specially optimized. 205creation for JPEGs has been specially optimized and can even take
206advantage of multiple CPUs.
192 207
193=item * minimum optical clutter 208=item * minimum optical clutter
194 209
195CV has no menus or other user interface elements that take up a lot of 210CV has no menus or other user interface elements that take up a lot of
196screen space. The schnauzer windows can also be somewhat crowded. 211screen space (or are useful for beginning users). The schnauzer windows
212can also be somewhat crowded.
197 213
198The point of an image viewer is viewing images, not a nice GUI. This is 214The point of an image viewer is viewing images, not a nice GUI. This is
199similar to XV's behaviour. 215similar to XV's behaviour.
200 216
201=item * efficient (and hard to learn) user interface 217=item * efficient (and hard to learn) user interface
202 218
203CV uses key combinations. A lot. If you are an experienced XV user, you 219CV uses key combinations. A lot. If you are an experienced XV user, you
204will find most of these keys familiar. If not, CV might be hard to use at 220will find most of these keys familiar. If not, CV might be hard to use at
205first, but will be an efficient tool later. 221first, but will be an efficient tool later.
206 222
223=item * multi-window GUI
224
225CV doesn't force you to use a specific layout, instead it relies on your
226window manager, thus enabling you to chose whatever layout that suits you
227most.
228
207=item * i18n'ed filename handling throughout 229=item * i18n'ed filename handling throughout
208 230
209As long as glib can recognize your filename encoding (either UTF-8 or 231As long as glib can recognize your filename encoding (either UTF-8 or
210locale-specific, depending on your settings) and you have the relevant 232locale-specific, depending on the setting of G_BROKEN_FILENAMES) and you
211fonts, CV will display your filenames correctly. 233have the relevant fonts, CV will display your filenames correctly.
212 234
213=item * extensible through plug-ins 235=item * extensible through plug-ins
214 236
215I have weird plug-ins that access remote databases to find a 237I have weird plug-ins that access remote databases to find a
216directory. This is not likely to be of any use to other people. Likewise, 238directory. This is not likely to be of any use to other people. Likewise,
245 shift-s set scaling mode to 'hyper' (slowest) 267 shift-s set scaling mode to 'hyper' (slowest)
246 t rotate clockwise 90° 268 t rotate clockwise 90°
247 T rotate counterclockwise° 269 T rotate counterclockwise°
248 ctrl-v open a new visual schnauzer window for the current dir 270 ctrl-v open a new visual schnauzer window for the current dir
249 ctrl-e run an editor ($CV_EDITOR or "gimp") on the current image 271 ctrl-e run an editor ($CV_EDITOR or "gimp") on the current image
250 ctrl-p fire up the print fialog 272 ctrl-p fire up the print dialog
251 escape cancel a crop action 273 escape cancel a crop action
252 274
253And when playing movies, these additional keys are active: 275And when playing movies, these additional keys are active:
254 276
255 left rewind by 10 seconds 277 left rewind by 10 seconds
293 ctrl-g force generation of thumbnais for the selected files 315 ctrl-g force generation of thumbnais for the selected files
294 ctrl-s rescan current direcory or files updates/deletes etc. 316 ctrl-s rescan current direcory or files updates/deletes etc.
295 ctrl-u update selected (or all) icons if neccessary 317 ctrl-u update selected (or all) icons if neccessary
296 ctrl-l don't use, will become a plug-in eventually 318 ctrl-l don't use, will become a plug-in eventually
297 319
320 ^ go to parent directory (caret).
321
298 0-9, 322 0-9,
299 a-z find the first filename beginning with this letter 323 a-z find the first filename beginning with this letter
300 324
301Right-clicking into the schnauzer window displays a pop-up menu with 325Right-clicking into the schnauzer window displays a pop-up menu with
302additional actions. 326additional actions.
334 358
335=back 359=back
336 360
337=head1 SECURITY CONSIDERATIONS 361=head1 SECURITY CONSIDERATIONS
338 362
339CV uses Pixbuf to load images. Pixbuf is not considered safe for this 363CV uses Pixbuf to load non-JPEG images. Pixbuf is not considered safe for
340purpose, though (from the gtk-2.2 release notes): 364this purpose, though (from the gtk-2.2 release notes):
341 365
342"While efforts have been made to make gdk-pixbuf robust against invalid 366"While efforts have been made to make gdk-pixbuf robust against invalid
343images, using gdk-pixbuf to load untrusted data is not recommended, due to 367images, using gdk-pixbuf to load untrusted data is not recommended, due to
344the likelyhood that there are additional problems where an invalid image 368the likelyhood that there are additional problems where an invalid image
345could cause gdk-pixbuf to crash or worse." 369could cause gdk-pixbuf to crash or worse."
347=head1 BUGS/TODO 371=head1 BUGS/TODO
348 372
349 Lots of functionality is missing. 373 Lots of functionality is missing.
350 374
351 Pixbuf doesn't always honor G_BROKEN_FILENAMES, so accessing files with 375 Pixbuf doesn't always honor G_BROKEN_FILENAMES, so accessing files with
352 names incompatible might utf-8 fail. 376 names incompatible with utf-8 might fail.
353 377
354 rotate on disk 378 rotate on disk
355 lots of ui issues 379 lots of ui issues
356 save(?) 380 save(?)
357 preferences 381 preferences
358 shift-cursor in schnauzer
359 382
360=head1 AUTHOR 383=head1 AUTHOR
361 384
362Marc Lehmann <cv@plan9.de>. 385Marc Lehmann <cv@plan9.de>.
363 386

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines