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

Comparing CV/bin/cv (file contents):
Revision 1.54 by root, Fri Aug 19 00:19:52 2005 UTC vs.
Revision 1.61 by root, Sat Sep 24 00:51:28 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.
328
329=head3 SELECTION
330
331You can select entries in the Schnauzer in a variety of ways:
332
333=over 4
334
335=item Keyboard
336
337Moving the cursor with the keyboard will first deselect all files and then
338select the file you moved to.
339
340=item Clicking
341
342Clicking on an entry will select the one you clicked and deselect all
343others.
344
345=item Shift-Clicking
346
347Shift-clicking will toggle the selection on the entry under the mouse.
348
349=item Dragging
350
351Dragging will select all entries between the one selected when pushing the
352button and the one selected when releasing the button. If you move above
353or below the schnauzer area while drag-selecting, the schnauzer will move
354up/down one row twice per second. In addition, horizontal mouse movement
355acts as a kind of invisible horizontal scrollbar.
356
357=item Hint: double-click works while click-selecting
358
359You can double-click any image while click-selecting to display it
360without stopping the selection process. This will act as if you normally
361double-clicked the image to display it, and will toggle the selection
362twice, resulting in no change.
363
364=back
310 365
311=head1 FILES 366=head1 FILES
312 367
313When starting, CV runs the F<.cvrc> file in your F<$HOME> directory as if 368When starting, CV runs the F<.cvrc> file in your F<$HOME> directory as if
314it were a perl script. in that, you will mostly load plug-ins. 369it were a perl script. in that, you will mostly load plug-ins.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines