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.59 by root, Thu Sep 8 00:40:23 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,
244 . enlarge the image by 10% 259 . enlarge the image by 10%
245 n reset to normal size 260 n reset to normal size
246 m maximize to screensize 261 m maximize to screensize
247 M maximize to screensize, respecting image aspect 262 M maximize to screensize, respecting image aspect
248 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
249 u uncrop 265 u uncrop
250 r set scaling mode to 'nearest' (fastest) 266 r set scaling mode to 'nearest' (fastest)
251 s set scaling mode to 'bilinear' (default) 267 s set scaling mode to 'bilinear' (default)
252 shift-s set scaling mode to 'hyper' (slowest) 268 shift-s set scaling mode to 'hyper' (slowest)
253 t rotate clockwise 90° 269 t rotate clockwise 90°
254 T rotate counterclockwise° 270 T rotate counterclockwise°
255 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
256 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
257 ctrl-p fire up the print fialog 273 ctrl-p fire up the print dialog
258 escape cancel a crop action 274 escape cancel a crop action
259 275
260And when playing movies, these additional keys are active: 276And when playing movies, these additional keys are active:
261 277
262 left rewind by 10 seconds 278 left rewind by 10 seconds
300 ctrl-g force generation of thumbnais for the selected files 316 ctrl-g force generation of thumbnais for the selected files
301 ctrl-s rescan current direcory or files updates/deletes etc. 317 ctrl-s rescan current direcory or files updates/deletes etc.
302 ctrl-u update selected (or all) icons if neccessary 318 ctrl-u update selected (or all) icons if neccessary
303 ctrl-l don't use, will become a plug-in eventually 319 ctrl-l don't use, will become a plug-in eventually
304 320
321 ^ go to parent directory (caret).
322
305 0-9, 323 0-9,
306 a-z find the first filename beginning with this letter 324 a-z find the first filename beginning with this letter
307 325
308Right-clicking into the schnauzer window displays a pop-up menu with 326Right-clicking into the schnauzer window displays a pop-up menu with
309additional actions. 327additional actions.
341 359
342=back 360=back
343 361
344=head1 SECURITY CONSIDERATIONS 362=head1 SECURITY CONSIDERATIONS
345 363
346CV 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
347purpose, though (from the gtk-2.2 release notes): 365this purpose, though (from the gtk-2.2 release notes):
348 366
349"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
350images, 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
351the likelyhood that there are additional problems where an invalid image 369the likelyhood that there are additional problems where an invalid image
352could cause gdk-pixbuf to crash or worse." 370could cause gdk-pixbuf to crash or worse."
354=head1 BUGS/TODO 372=head1 BUGS/TODO
355 373
356 Lots of functionality is missing. 374 Lots of functionality is missing.
357 375
358 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
359 names incompatible might utf-8 fail. 377 names incompatible with utf-8 might fail.
360 378
361 rotate on disk 379 rotate on disk
362 lots of ui issues 380 lots of ui issues
363 save(?) 381 save(?)
364 preferences 382 preferences
365 shift-cursor in schnauzer
366 383
367=head1 AUTHOR 384=head1 AUTHOR
368 385
369Marc Lehmann <cv@plan9.de>. 386Marc Lehmann <cv@plan9.de>.
370 387

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines