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

Comparing CV/README (file contents):
Revision 1.7 by root, Sun Jan 27 16:49:40 2008 UTC vs.
Revision 1.14 by root, Fri Aug 26 21:58:02 2022 UTC

1NAME 1NAME
2 cv - a fast gtk+ image viewer loosely modeled after XV 2 cv - a fast gtk+ image viewer loosely modeled after XV
3 3
4SYNOPSIS 4SYNOPSIS
5 cv [file...] 5 cv
6
7 cv directory
8
9 cv path...
10
11 cv -g <glob expression...>
12
13 find .. -print0 | cv -0r
14
15 cv --sort ...
6 16
7FEATURES 17FEATURES
8 CV is supposed to work similar to the venerable XV image viewer, just 18 CV is supposed to work similar to the venerable XV image viewer, just
9 faster. Why faster? 19 faster. Why faster?
10 20
… …
97 You can use the following keys in the image window: 107 You can use the following keys in the image window:
98 108
99 q quit the program 109 q quit the program
100 < half the image size 110 < half the image size
101 > double the image size 111 > double the image size
102 , shrink the image by 10% 112 , shrink the image by ~9% (opposite of .)
103 . enlarge the image by 10% 113 . enlarge the image by 10%
104 n reset to normal size 114 n reset to normal size
105 m maximize to screensize 115 m maximize to screensize
106 M maximize to screensize, respecting image aspect 116 M maximize to screensize, respecting image aspect
107 ctrl-m toggle maxpect-always mode 117 ctrl-m toggle maxpect-always mode
108 ctrl-sift-m toggle using current image size as max image size 118 ctrl-sift-m toggle using current image size as max image size
109 u uncrop 119 u uncrop
110 r set scaling mode to 'nearest' (fastest) 120 r set scaling mode to 'nearest' (fastest)
111 s set scaling mode to 'bilinear' (default) 121 s set scaling mode to 'bilinear' (default)
112 shift-s set scaling mode to 'hyper' (slowest)
113 t rotate clockwise 90° 122 t rotate clockwise 90°
114 T rotate counterclockwise° 123 T rotate counterclockwise°
115 a apply all rotations loslessly to a jpeg file (using exiftran) 124 a apply all rotations loslessly to a jpeg file (using exiftran)
125 ctrl-shift-t apply current rotation for future image loads
116 ctrl-v open a new visual schnauzer window for the current dir 126 ctrl-v open a new visual schnauzer window for the current dir
117 ctrl-c clone the current image window 127 ctrl-c clone the current image window
118 ctrl-e run an editor ($CV_EDITOR or "gimp") on the current image 128 ctrl-e run an editor ($CV_EDITOR or "gimp") on the current image
119 ctrl-p fire up the print dialog 129 ctrl-p fire up the print dialog
130 ctrl-shift-p same as ctrl-p, but automatically selects "ok"
120 escape cancel a crop action 131 escape cancel a crop action
121 132
122 And when playing movies, these additional keys are active: 133 And when playing movies, these additional keys are active:
123 134
124 left rewind by 10 seconds 135 left rewind by 10 seconds
… …
160 end move to last file 171 end move to last file
161 172
162 ctrl-a select all files 173 ctrl-a select all files
163 ctrl-shift-a select all files currently displayed in the schnauzer window 174 ctrl-shift-a select all files currently displayed in the schnauzer window
164 ctrl-d delete selected files WITHOUT ASKING AGAIN 175 ctrl-d delete selected files WITHOUT ASKING AGAIN
165 ctrl-g force generation of thumbnais for the selected files 176 ctrl-g force generation of thumbnails for the selected files
177 ctrl-shift-g remove thumbnails for the selected files
166 ctrl-s rescan current direcory or files updates/deletes etc. 178 ctrl-s rescan current direcory or files updates/deletes etc.
167 ctrl-u update selected (or all) icons if neccessary 179 ctrl-u update selected (or all) icons if neccessary
168 ctrl-l don't use, will become a plug-in eventually 180 ctrl-- unselected thumbnailed images
181 ctrl-+ keep only thumbnailed images, deselect others
169 182
170 ^ go to parent directory (caret). 183 ^ go to parent directory (caret).
171 184
172 0-9, 185 0-9,
173 a-z find the first filename beginning with this letter 186 a-z find the first filename beginning with this letter
… …
214 or require "/fs/cv/cvplugin.pl"; 227 or require "/fs/cv/cvplugin.pl";
215 228
216 This will load a plug-in, but only if the machine *ether* is reachable 229 This will load a plug-in, but only if the machine *ether* is reachable
217 (supposedly the plug-in is networked in some way :). 230 (supposedly the plug-in is networked in some way :).
218 231
219ENVIRONMENT 232ENVIRONMENT VARIABLES
220 CV_EDITOR 233 CV_EDITOR
221 The program that gets executed when the user presses "CTRL-e" in the 234 The program that gets executed when the user presses "CTRL-e" in the
222 Schnauzer or image window. The default is "gimp". 235 Schnauzer or image window. The default is "gimp".
223 236
224 CV_AUDIO_PLAYER 237 CV_AUDIO_PLAYER
238 EXPERIMENTAL: audio playback is now via mpv, this variable is
239 currently ignored.
240
225 Program used to play all sorts of audio (wav, aif, mp3, ogg...), 241 Program used to play all sorts of audio (wav, aif, mp3, ogg...),
226 default "play". Will be called like "$CV_AUDIO_PLAYER -- <path>". 242 default "play". Will be called like "$CV_AUDIO_PLAYER -- <path>".
227 243
244 CV_MPLAYER
245 Program used to play all sorts of video files. Unlike
246 "CV_AUDIO_PLAYER", this really must be some version of the "mpv"
247 programs, or something that is very command-line compatible to them.
248
249 Note: for video-thumbnailing, mplayer is still used (and hardcoded).
250
228 CV_PRINT_DESTINATION 251 CV_PRINT_DESTINATION
229 The default (perl-style) destination to use in the print dialog. 252 The default (perl-style) destination to use in the print dialog.
230 253
231 CV_TRASHCAN 254 CV_TRASHCAN
232 When set, must point to a directory where all files that are deleted 255 When set, must point to a directory where all files that are deleted
233 are moved to. If unset, files that are deleted are really being 256 by the "Delete Physically" (ctrl-d) action are moved to (other
234 deleted. 257 deletion actions still delete!). If unset, files that are deleted
258 are really being deleted.
259
260SIGNALS
261 Sending CV a SIGUSR1 signal will cause all image viewers to reload the
262 currently loaded image. This is useful if you use CV as a viewer for
263 changing data - just run it in the background with some path and each
264 time the image changes, send it a SIGUSR1.
235 265
236SECURITY CONSIDERATIONS 266SECURITY CONSIDERATIONS
237 CV uses Pixbuf to load non-JPEG images. Pixbuf is not considered safe 267 CV uses Pixbuf to load non-JPEG images. Pixbuf is not considered safe
238 for this purpose, though (from the gtk-2.2 release notes): 268 for this purpose, though (from the gtk-2.2 release notes):
239 269

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines