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

Comparing CV/bin/cv (file contents):
Revision 1.53 by root, Tue Aug 16 02:46:58 2005 UTC vs.
Revision 1.58 by root, Wed Sep 7 20:17:25 2005 UTC

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.
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).
173 179
174=item * queuing for all time-consuming background tasks 180=item * queuing for all time-consuming background tasks
175 181
176All tasks, such as unlinking files or generating thumbnails, that can be 182All tasks, such as unlinking files or generating thumbnails, that can be
177done in the background will be done so - no waiting required, even when 183done in the background will be done so - no waiting required, even when
188=item * fast image loading 194=item * fast image loading
189 195
190The 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
191image should be as small as possible. CV uses optimized (especially 197image should be as small as possible. CV uses optimized (especially
192for JPEG) loading functions and sacrifices some quality (e.g no gamma 198for JPEG) loading functions and sacrifices some quality (e.g no gamma
193correction) to achieve this speed. 199correction, although this might change) to achieve this speed.
194 200
195=item * fast thumbnail creation 201=item * fast thumbnail creation
196 202
197Thumbnail 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
198creation for JPEGs has been specially optimized. 205creation for JPEGs has been specially optimized and can even take
206advantage of multiple CPUs.
199 207
200=item * minimum optical clutter 208=item * minimum optical clutter
201 209
202CV 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
203screen 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.
204 213
205The 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
206similar to XV's behaviour. 215similar to XV's behaviour.
207 216
208=item * efficient (and hard to learn) user interface 217=item * efficient (and hard to learn) user interface
209 218
210CV 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
211will 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
212first, but will be an efficient tool later. 221first, but will be an efficient tool later.
213 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
214=item * i18n'ed filename handling throughout 229=item * i18n'ed filename handling throughout
215 230
216As 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
217locale-specific, depending on your settings) and you have the relevant 232locale-specific, depending on the setting of G_BROKEN_FILENAMES) and you
218fonts, CV will display your filenames correctly. 233have the relevant fonts, CV will display your filenames correctly.
219 234
220=item * extensible through plug-ins 235=item * extensible through plug-ins
221 236
222I have weird plug-ins that access remote databases to find a 237I have weird plug-ins that access remote databases to find a
223directory. 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,
252 shift-s set scaling mode to 'hyper' (slowest) 267 shift-s set scaling mode to 'hyper' (slowest)
253 t rotate clockwise 90° 268 t rotate clockwise 90°
254 T rotate counterclockwise° 269 T rotate counterclockwise°
255 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
256 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
257 ctrl-p fire up the print fialog 272 ctrl-p fire up the print dialog
258 escape cancel a crop action 273 escape cancel a crop action
259 274
260And when playing movies, these additional keys are active: 275And when playing movies, these additional keys are active:
261 276
262 left rewind by 10 seconds 277 left rewind by 10 seconds
300 ctrl-g force generation of thumbnais for the selected files 315 ctrl-g force generation of thumbnais for the selected files
301 ctrl-s rescan current direcory or files updates/deletes etc. 316 ctrl-s rescan current direcory or files updates/deletes etc.
302 ctrl-u update selected (or all) icons if neccessary 317 ctrl-u update selected (or all) icons if neccessary
303 ctrl-l don't use, will become a plug-in eventually 318 ctrl-l don't use, will become a plug-in eventually
304 319
320 ^ go to parent directory (caret).
321
305 0-9, 322 0-9,
306 a-z find the first filename beginning with this letter 323 a-z find the first filename beginning with this letter
307 324
308Right-clicking into the schnauzer window displays a pop-up menu with 325Right-clicking into the schnauzer window displays a pop-up menu with
309additional actions. 326additional actions.
341 358
342=back 359=back
343 360
344=head1 SECURITY CONSIDERATIONS 361=head1 SECURITY CONSIDERATIONS
345 362
346CV 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
347purpose, though (from the gtk-2.2 release notes): 364this purpose, though (from the gtk-2.2 release notes):
348 365
349"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
350images, 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
351the likelyhood that there are additional problems where an invalid image 368the likelyhood that there are additional problems where an invalid image
352could cause gdk-pixbuf to crash or worse." 369could cause gdk-pixbuf to crash or worse."
354=head1 BUGS/TODO 371=head1 BUGS/TODO
355 372
356 Lots of functionality is missing. 373 Lots of functionality is missing.
357 374
358 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
359 names incompatible might utf-8 fail. 376 names incompatible with utf-8 might fail.
360 377
361 rotate on disk 378 rotate on disk
362 lots of ui issues 379 lots of ui issues
363 save(?) 380 save(?)
364 preferences 381 preferences
365 shift-cursor in schnauzer
366 382
367=head1 AUTHOR 383=head1 AUTHOR
368 384
369Marc Lehmann <cv@plan9.de>. 385Marc Lehmann <cv@plan9.de>.
370 386

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines