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

Comparing CV/bin/cv (file contents):
Revision 1.50 by root, Sat Aug 13 15:19:10 2005 UTC vs.
Revision 1.59 by root, Thu Sep 8 00:40:23 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);
127 127
128 $schnauzer->set_geometry_hints; 128 $schnauzer->set_geometry_hints;
129} 129}
130 130
131if (@ARGV) { 131if (@ARGV) {
132 @ARGV == 1 && -d $ARGV[0]
133 ? $schnauzer->set_dir (Glib::filename_to_unicode shift)
132 $schnauzer->set_paths ([map Glib::filename_to_unicode $_, @ARGV]); 134 : $schnauzer->set_paths ([map Glib::filename_to_unicode $_, @ARGV]);
133 $schnauzer->show_all; 135 $schnauzer->show_all;
134 $schnauzer->handle_key ($Gtk2::Gdk::Keysyms{space}, []); 136 $schnauzer->handle_key ($Gtk2::Gdk::Keysyms{space}, []);
135 $viewer->show_all;
136} else { 137} else {
137 $schnauzer->set_dir (File::Spec->curdir); 138 $schnauzer->set_dir (File::Spec->curdir);
138 $mainwin->show_all; 139 $mainwin->show_all;
139 $viewer->show_all;
140} 140}
141 141
142$viewer->show_all; 142$viewer->show_all;
143 143
144main Gtk2; 144main Gtk2;
145 145
146__DATA__ 146__DATA__
147
148=encoding utf-8
147 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
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,
237 . enlarge the image by 10% 259 . enlarge the image by 10%
238 n reset to normal size 260 n reset to normal size
239 m maximize to screensize 261 m maximize to screensize
240 M maximize to screensize, respecting image aspect 262 M maximize to screensize, respecting image aspect
241 ctrl-m toggle maxpect-always mode 263 ctrl-m toggle maxpect-always mode
264 ctrl-sift-m toggle using current image size as max image size
242 u uncrop 265 u uncrop
243 r set scaling mode to 'nearest' (fastest) 266 r set scaling mode to 'nearest' (fastest)
244 s set scaling mode to 'bilinear' (default) 267 s set scaling mode to 'bilinear' (default)
245 shift-s set scaling mode to 'hyper' (slowest) 268 shift-s set scaling mode to 'hyper' (slowest)
246 t rotate clockwise 90° 269 t rotate clockwise 90°
247 T rotate counterclockwise° 270 T rotate counterclockwise°
248 ctrl-v open a new visual schnauzer window for the current dir 271 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 272 ctrl-e run an editor ($CV_EDITOR or "gimp") on the current image
250 ctrl-p fire up the print fialog 273 ctrl-p fire up the print dialog
251 escape cancel a crop action 274 escape cancel a crop action
252 275
253And when playing movies, these additional keys are active: 276And when playing movies, these additional keys are active:
254 277
255 left rewind by 10 seconds 278 left rewind by 10 seconds
293 ctrl-g force generation of thumbnais for the selected files 316 ctrl-g force generation of thumbnais for the selected files
294 ctrl-s rescan current direcory or files updates/deletes etc. 317 ctrl-s rescan current direcory or files updates/deletes etc.
295 ctrl-u update selected (or all) icons if neccessary 318 ctrl-u update selected (or all) icons if neccessary
296 ctrl-l don't use, will become a plug-in eventually 319 ctrl-l don't use, will become a plug-in eventually
297 320
321 ^ go to parent directory (caret).
322
298 0-9, 323 0-9,
299 a-z find the first filename beginning with this letter 324 a-z find the first filename beginning with this letter
300 325
301Right-clicking into the schnauzer window displays a pop-up menu with 326Right-clicking into the schnauzer window displays a pop-up menu with
302additional actions. 327additional actions.
334 359
335=back 360=back
336 361
337=head1 SECURITY CONSIDERATIONS 362=head1 SECURITY CONSIDERATIONS
338 363
339CV uses Pixbuf to load images. Pixbuf is not considered safe for this 364CV uses Pixbuf to load non-JPEG images. Pixbuf is not considered safe for
340purpose, though (from the gtk-2.2 release notes): 365this purpose, though (from the gtk-2.2 release notes):
341 366
342"While efforts have been made to make gdk-pixbuf robust against invalid 367"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 368images, using gdk-pixbuf to load untrusted data is not recommended, due to
344the likelyhood that there are additional problems where an invalid image 369the likelyhood that there are additional problems where an invalid image
345could cause gdk-pixbuf to crash or worse." 370could cause gdk-pixbuf to crash or worse."
347=head1 BUGS/TODO 372=head1 BUGS/TODO
348 373
349 Lots of functionality is missing. 374 Lots of functionality is missing.
350 375
351 Pixbuf doesn't always honor G_BROKEN_FILENAMES, so accessing files with 376 Pixbuf doesn't always honor G_BROKEN_FILENAMES, so accessing files with
352 names incompatible might utf-8 fail. 377 names incompatible with utf-8 might fail.
353 378
354 rotate on disk 379 rotate on disk
355 lots of ui issues 380 lots of ui issues
356 save(?) 381 save(?)
357 preferences 382 preferences
358 shift-cursor in schnauzer
359 383
360=head1 AUTHOR 384=head1 AUTHOR
361 385
362Marc Lehmann <cv@plan9.de>. 386Marc Lehmann <cv@plan9.de>.
363 387

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines