1 | #!/opt/bin/perl |
1 | #!/opt/bin/perl |
|
|
2 | |
|
|
3 | use Cwd (); |
|
|
4 | use Encode (); |
2 | |
5 | |
3 | use Gtk2 -init; |
6 | use Gtk2 -init; |
4 | use Gtk2::Gdk::Keysyms; |
7 | use Gtk2::Gdk::Keysyms; |
5 | |
8 | |
|
|
9 | use Gtk2::CV; |
|
|
10 | |
6 | use Gtk2::CV::ImageWindow; |
11 | use Gtk2::CV::ImageWindow; |
7 | use Gtk2::CV::Schnauzer; |
12 | use Gtk2::CV::Schnauzer; |
8 | |
13 | |
9 | use Gtk2::CV; |
14 | BEGIN { |
|
|
15 | require Gtk2::CV::Plugin; |
|
|
16 | require "$ENV{HOME}/.cvrc" if -r "$ENV{HOME}/.cvrc"; |
|
|
17 | } |
|
|
18 | |
|
|
19 | use Gtk2::CV::Plugin::NameCluster; |
|
|
20 | use Gtk2::CV::Plugin::RCluster; |
10 | |
21 | |
11 | Gtk2::Rc->parse (Gtk2::CV::find_rcfile "gtkrc"); |
22 | Gtk2::Rc->parse (Gtk2::CV::find_rcfile "gtkrc"); |
12 | |
23 | |
13 | use File::Spec; |
24 | use File::Spec; |
14 | |
25 | |
15 | my $mainwin; |
26 | my $mainwin; |
16 | my $viewer; |
27 | my $viewer; |
|
|
28 | my $viewer_count; |
17 | my $schnauzer; |
29 | my $schnauzer; |
18 | my $info; |
30 | my $info; |
19 | my $help; |
31 | my $help; |
20 | |
32 | |
21 | my $schnauzer_idx = 0; |
33 | my $schnauzer_idx = 0; |
… | |
… | |
27 | $s->signal_connect (activate => sub { |
39 | $s->signal_connect (activate => sub { |
28 | my $label = sprintf "%s (%d)", |
40 | my $label = sprintf "%s (%d)", |
29 | (File::Spec->splitpath ($_[1]))[2], |
41 | (File::Spec->splitpath ($_[1]))[2], |
30 | -s $_[1]; |
42 | -s $_[1]; |
31 | $info->set_label ($label); |
43 | $info->set_label ($label); |
32 | $viewer->load_image ($_[1]); |
44 | $viewer->load_image ($_[1]) if $viewer; # TODO: error, or chose ANY viewer |
33 | }); |
45 | }); |
34 | |
46 | |
|
|
47 | Gtk2::CV::Plugin->call (new_schnauzer => $s); |
|
|
48 | |
35 | $s; |
49 | $s |
|
|
50 | } |
|
|
51 | |
|
|
52 | sub new_viewer { |
|
|
53 | my $self = new Gtk2::CV::ImageWindow; |
|
|
54 | |
|
|
55 | $viewer_count++; |
|
|
56 | |
|
|
57 | $self->set_title ("CV: Image"); |
|
|
58 | |
|
|
59 | $self->signal_connect (key_press_event => sub { |
|
|
60 | $viewer = $_[0]; |
|
|
61 | |
|
|
62 | my $key = $_[1]->keyval; |
|
|
63 | my $state = $_[1]->state; |
|
|
64 | |
|
|
65 | if ($state * "control-mask" && $key == $Gtk2::Gdk::Keysyms{c}) { |
|
|
66 | my $viewer = new_viewer (); |
|
|
67 | $viewer->set_image ($_[0]->{image}); |
|
|
68 | $viewer->show_all; |
|
|
69 | 1 |
|
|
70 | } else { |
|
|
71 | &std_keys |
|
|
72 | or $schnauzer->signal_emit (key_press_event => $_[1]) |
|
|
73 | } |
|
|
74 | }); |
|
|
75 | $self->signal_connect (delete_event => sub { $_[0]->destroy; 0 }); |
|
|
76 | $self->signal_connect (destroy => sub { |
|
|
77 | $viewer = undef if $viewer == $_[0]; |
|
|
78 | |
|
|
79 | main_quit Gtk2 unless --$viewer_count; |
|
|
80 | |
|
|
81 | 0 |
|
|
82 | }); |
|
|
83 | |
|
|
84 | $self->signal_connect (button3_press_event => sub { |
|
|
85 | $mainwin->visible |
|
|
86 | ? $mainwin->hide |
|
|
87 | : $mainwin->show_all; |
|
|
88 | |
|
|
89 | 1 |
|
|
90 | }); |
|
|
91 | |
|
|
92 | Gtk2::CV::Plugin->call (new_imagewindow => $self); |
|
|
93 | |
|
|
94 | $self |
36 | } |
95 | } |
37 | |
96 | |
38 | sub std_keys { |
97 | sub std_keys { |
39 | my $key = $_[1]->keyval; |
98 | my $key = $_[1]->keyval; |
40 | my $state = $_[1]->state; |
99 | my $state = $_[1]->state; |
41 | |
100 | |
42 | my $ctrl = $state * "control-mask"; |
101 | my $ctrl = $state * "control-mask"; |
43 | |
102 | |
44 | if ($key == $Gtk2::Gdk::Keysyms{q}) { |
103 | if ($key == $Gtk2::Gdk::Keysyms{q}) { |
45 | main_quit Gtk2; |
104 | $viewer->destroy; |
46 | } elsif ($ctrl && $key == $Gtk2::Gdk::Keysyms{v}) { |
105 | } elsif ($ctrl && $key == $Gtk2::Gdk::Keysyms{v}) { |
47 | my $w = new Gtk2::Window; |
106 | my $w = new Gtk2::Window; |
48 | |
107 | |
|
|
108 | $w->set_role ("schnauzer"); |
49 | $w->set_title ("CV: Schnauzer"); |
109 | $w->set_title ("CV: Schnauzer"); |
50 | $w->add (my $s = new_schnauzer); |
110 | $w->add (my $s = new_schnauzer); |
51 | $s->set_dir (File::Spec->curdir); |
111 | $s->set_dir (File::Spec->curdir); |
52 | $s->set_geometry_hints; |
112 | $s->set_geometry_hints; |
53 | $w->show_all; |
113 | $w->show_all; |
… | |
… | |
55 | } elsif ($ctrl && $key == $Gtk2::Gdk::Keysyms{h}) { |
115 | } elsif ($ctrl && $key == $Gtk2::Gdk::Keysyms{h}) { |
56 | unless ($help) { |
116 | unless ($help) { |
57 | require Gtk2::PodViewer; |
117 | require Gtk2::PodViewer; |
58 | |
118 | |
59 | $help = new Gtk2::Window; |
119 | $help = new Gtk2::Window; |
|
|
120 | $help->set_role ("help"); |
60 | $help->set_title ("CV: Help"); |
121 | $help->set_title ("CV: Help"); |
61 | $help->set_default_size (500, 300); |
122 | $help->set_default_size (500, 300); |
62 | $help->signal_connect (delete_event => sub { $help->hide; 1 }); |
123 | $help->signal_connect (delete_event => sub { $help->hide; 1 }); |
63 | |
124 | |
64 | $help->add (my $sw = new Gtk2::ScrolledWindow); |
125 | $help->add (my $sw = new Gtk2::ScrolledWindow); |
… | |
… | |
68 | $h->load_string (do { local $/; <DATA> }); |
129 | $h->load_string (do { local $/; <DATA> }); |
69 | } |
130 | } |
70 | |
131 | |
71 | $help->show_all; |
132 | $help->show_all; |
72 | } else { |
133 | } else { |
73 | #$mainwin->show_all; |
134 | return 0; |
74 | $schnauzer->handle_key ($key, $state); |
|
|
75 | } |
135 | } |
76 | |
136 | |
77 | 1; |
137 | 1 |
78 | } |
138 | } |
79 | |
139 | |
80 | { |
140 | { |
81 | $viewer = new Gtk2::CV::ImageWindow; |
141 | $viewer = new_viewer; |
82 | |
142 | $::cur_viewer = $viewer; |
83 | $viewer->set_title ("CV: Image"); |
|
|
84 | |
|
|
85 | $viewer->signal_connect (key_press_event => \&std_keys); |
|
|
86 | $viewer->signal_connect (delete_event => sub { main_quit Gtk2 }); |
|
|
87 | |
|
|
88 | $viewer->signal_connect (button3_press_event => sub { |
|
|
89 | $mainwin->visible |
|
|
90 | ? $mainwin->hide |
|
|
91 | : $mainwin->show_all; |
|
|
92 | 1; |
|
|
93 | }); |
|
|
94 | |
143 | |
95 | $schnauzer = new_schnauzer; |
144 | $schnauzer = new_schnauzer; |
96 | |
145 | |
97 | $mainwin = new Gtk2::Window; |
146 | $mainwin = new Gtk2::Window; |
|
|
147 | $mainwin->set_role ("main"); |
98 | $mainwin->set_title ("CV"); |
148 | $mainwin->set_title ("CV"); |
99 | $mainwin->add (my $vbox = new Gtk2::VBox); |
149 | $mainwin->add (my $vbox = new Gtk2::VBox); |
100 | $mainwin->signal_connect (delete_event => sub { $mainwin->hide; 1; }); |
150 | $mainwin->signal_connect (delete_event => sub { $mainwin->hide; 1 }); |
101 | |
151 | |
102 | $vbox->add ($schnauzer); |
152 | $vbox->add ($schnauzer); |
103 | $vbox->pack_end (my $frame = new Gtk2::Frame, 0, 0, 0); |
153 | $vbox->pack_end (my $frame = new Gtk2::Frame, 0, 0, 0); |
104 | $frame->add (my $hbox = new Gtk2::HBox 0, 0); |
154 | $frame->add (my $hbox = new Gtk2::HBox 0, 0); |
105 | $hbox->pack_start ((new Gtk2::Label "Info"), 0, 0, 0); |
155 | $hbox->pack_start ((new Gtk2::Label "Info: "), 0, 0, 0); |
106 | $hbox->pack_start (($info = new Gtk2::Label), 1, 1, 0); |
156 | $hbox->pack_end (my $labelwindow = new Gtk2::EventBox, 1, 1, 0); |
|
|
157 | $labelwindow->add ($info = new Gtk2::Label); |
|
|
158 | $labelwindow->signal_connect_after (size_request => sub { $_[1]->width (0); 0 }); |
|
|
159 | $info->set (selectable => 1, xalign => 0, justify => "left"); |
107 | |
160 | |
108 | $schnauzer->set_geometry_hints; |
161 | $schnauzer->set_geometry_hints; |
109 | } |
162 | } |
110 | |
163 | |
111 | if (@ARGV) { |
164 | if (@ARGV) { |
112 | $_ = Glib::filename_to_unicode $_ for @ARGV; |
165 | my $show_first = sub { |
113 | $schnauzer->set_paths (\@ARGV); |
|
|
114 | $schnauzer->show_all; |
166 | $schnauzer->show_all; |
115 | $schnauzer->handle_key ($Gtk2::Gdk::Keysyms{space}, []); |
167 | $schnauzer->handle_key ($Gtk2::Gdk::Keysyms{space}, []); |
|
|
168 | $viewer->show_all; |
|
|
169 | }; |
|
|
170 | |
|
|
171 | @ARGV == 1 && -d $ARGV[0] |
|
|
172 | ? $schnauzer->set_dir (Glib::filename_to_unicode shift, $show_first) |
|
|
173 | : $schnauzer->set_paths ([map Glib::filename_to_unicode $_, @ARGV], 1, $show_first); |
116 | } else { |
174 | } else { |
117 | $schnauzer->set_dir (File::Spec->curdir); |
175 | $schnauzer->set_dir (File::Spec->curdir, sub { |
118 | $mainwin->show_all; |
176 | $mainwin->show_all; |
119 | $viewer->show_all; |
177 | $viewer->show_all; |
|
|
178 | }); |
120 | } |
179 | } |
121 | |
|
|
122 | $viewer->show_all; |
|
|
123 | |
180 | |
124 | main Gtk2; |
181 | main Gtk2; |
125 | |
182 | |
|
|
183 | Gtk2::CV::flush_aio; |
|
|
184 | |
126 | __DATA__ |
185 | __DATA__ |
127 | |
186 | |
|
|
187 | =encoding utf-8 |
|
|
188 | |
128 | =head1 NAME |
189 | =head1 NAME |
129 | |
190 | |
130 | cv - a fast gtk+ image viewer modeled after xv |
191 | cv - a fast gtk+ image viewer loosely modeled after XV |
131 | |
192 | |
132 | =head1 SYNOPSIS |
193 | =head1 SYNOPSIS |
133 | |
194 | |
134 | cv [file...] |
195 | cv [file...] |
135 | |
196 | |
|
|
197 | =head1 FEATURES |
|
|
198 | |
|
|
199 | CV is supposed to work similar to the venerable XV image viewer, just |
|
|
200 | faster. Why faster? |
|
|
201 | |
|
|
202 | =over 4 |
|
|
203 | |
|
|
204 | =item * optimized directory scanning algorithm |
|
|
205 | |
|
|
206 | The directory scanning in CV uses some tricks that - on most modern |
|
|
207 | filesystems - makes it possible to detect filetypes faster than stat()'ing |
|
|
208 | every file. This makes CV suitable for directories with lots of files |
|
|
209 | (10000+). |
|
|
210 | |
|
|
211 | This algorithm is quite unprecise - it doesn't make a difference between |
|
|
212 | files, device nodes, symlinks and the like, and filetype detection is done |
|
|
213 | using the file extension only. |
|
|
214 | |
|
|
215 | On the positive side, it is usually many orders of magnitude faster than |
|
|
216 | traditional scanning techniques (good for directories with 10000 or |
|
|
217 | 100000+ files). |
|
|
218 | |
|
|
219 | =item * queuing for all time-consuming background tasks |
|
|
220 | |
|
|
221 | All tasks, such as unlinking files or generating thumbnails, that can be |
|
|
222 | done in the background will be done so - no waiting required, even when |
|
|
223 | changing directories. |
|
|
224 | |
|
|
225 | =item * use of asynchronous I/O |
|
|
226 | |
|
|
227 | CV tries to use asynchronous I/O whereever it makes sense, for example |
|
|
228 | while scanning directories, waiting for stat data, unlinking files or |
|
|
229 | generating thumbnails. This usually decreases scanning times for large |
|
|
230 | directories a bit (especially on RAID devices and over NFS) and makes CV |
|
|
231 | much more interactive. |
|
|
232 | |
|
|
233 | =item * fast image loading |
|
|
234 | |
|
|
235 | The time span between the user issuing a command and displaying the new |
|
|
236 | image should be as small as possible. CV uses optimized (especially |
|
|
237 | for JPEG) loading functions and sacrifices some quality (e.g no gamma |
|
|
238 | correction, although this might change) to achieve this speed. |
|
|
239 | |
|
|
240 | =item * fast thumbnail creation |
|
|
241 | |
|
|
242 | Thumbnail creation uses both CPU and Disk-I/O. CV interleaves both, so |
|
|
243 | on modern CPUs, thumbnailing is usually limited by I/O speed. Thumbnail |
|
|
244 | creation for JPEGs has been specially optimized and can even take |
|
|
245 | advantage of multiple CPUs. |
|
|
246 | |
|
|
247 | =item * minimum optical clutter |
|
|
248 | |
|
|
249 | CV has no menus or other user interface elements that take up a lot of |
|
|
250 | screen space (or are useful for beginning users). The schnauzer windows |
|
|
251 | can also be somewhat crowded. |
|
|
252 | |
|
|
253 | The point of an image viewer is viewing images, not a nice GUI. This is |
|
|
254 | similar to XV's behaviour. |
|
|
255 | |
|
|
256 | =item * efficient (and hard to learn) user interface |
|
|
257 | |
|
|
258 | CV uses key combinations. A lot. If you are an experienced XV user, you |
|
|
259 | will find most of these keys familiar. If not, CV might be hard to use at |
|
|
260 | first, but will be an efficient tool later. |
|
|
261 | |
|
|
262 | =item * multi-window GUI |
|
|
263 | |
|
|
264 | CV doesn't force you to use a specific layout, instead it relies on your |
|
|
265 | window manager, thus enabling you to chose whatever layout that suits you |
|
|
266 | most. |
|
|
267 | |
|
|
268 | =item * i18n'ed filename handling throughout |
|
|
269 | |
|
|
270 | As long as glib can recognize your filename encoding (either UTF-8 or |
|
|
271 | locale-specific, depending on the setting of G_BROKEN_FILENAMES) and you |
|
|
272 | have the relevant fonts, CV will display your filenames correctly. |
|
|
273 | |
|
|
274 | =item * extensible through plug-ins |
|
|
275 | |
|
|
276 | I have weird plug-ins that access remote databases to find a |
|
|
277 | directory. This is not likely to be of any use to other people. Likewise, |
|
|
278 | others might have weird requirements I cannot dream of. |
|
|
279 | |
|
|
280 | =item * filename clustering |
|
|
281 | |
|
|
282 | Among the standard plug-ins is a filename clustering plug-in, that (in |
|
|
283 | case of tens of thousands images in one directory) might be able to |
|
|
284 | cluster similar names together. |
|
|
285 | |
|
|
286 | =back |
|
|
287 | |
136 | =head1 DESCRIPTION |
288 | =head1 DESCRIPTION |
137 | |
289 | |
138 | None yet. |
|
|
139 | |
|
|
140 | =head2 THE IMAGE WINDOW |
290 | =head2 THE IMAGE WINDOW |
141 | |
291 | |
142 | You can use the following keys in the image window: |
292 | You can use the following keys in the image window: |
143 | |
293 | |
144 | q quit the program |
294 | q quit the program |
145 | < half the image size |
295 | < half the image size |
146 | > double the image size |
296 | > double the image size |
147 | , shrink the image by 10% |
297 | , shrink the image by 10% |
148 | . enlarge the image by 10% |
298 | . enlarge the image by 10% |
149 | n reset to normal size |
299 | n reset to normal size |
150 | m maximize to screensize |
300 | m maximize to screensize |
151 | M maxime to screensize, respecting image aspect |
301 | M maximize to screensize, respecting image aspect |
152 | ctrl-m toggle maxpect-always mode |
302 | ctrl-m toggle maxpect-always mode |
|
|
303 | ctrl-sift-m toggle using current image size as max image size |
153 | u uncrop |
304 | u uncrop |
154 | r set scaling mode to 'nearest' (fastest) |
305 | r set scaling mode to 'nearest' (fastest) |
155 | s set scaling mode to 'bilinear' (default) |
306 | s set scaling mode to 'bilinear' (default) |
156 | S set scaling mode to 'hyper' (slowest) |
307 | shift-s set scaling mode to 'hyper' (slowest) |
157 | t rotate clockwise 90° |
308 | t rotate clockwise 90° |
158 | T rotate counterclockwise° |
309 | T rotate counterclockwise° |
|
|
310 | a apply all rotations loslessly to a jpeg file (using exiftran) |
159 | ctrl-v open a new visual schnauzer window for the current dir |
311 | ctrl-v open a new visual schnauzer window for the current dir |
160 | ctrl-s rescan visual schnauzer files for updates/deletes etc. |
312 | ctrl-c clone the current image window |
161 | ctrl-e run an editor ($CV_EDITOR or "gimp") on the current image. |
313 | ctrl-e run an editor ($CV_EDITOR or "gimp") on the current image |
|
|
314 | ctrl-p fire up the print dialog |
|
|
315 | escape cancel a crop action |
162 | |
316 | |
163 | And when playing movies, these additional keys are active: |
317 | And when playing movies, these additional keys are active: |
164 | |
318 | |
165 | left rewind by 10 seconds |
319 | left rewind by 10 seconds |
166 | right forward by 10 seconds |
320 | right forward by 10 seconds |
167 | down rewind by 60 seconds |
321 | down rewind by 60 seconds |
168 | up forward by 60 seconds |
322 | up forward by 60 seconds |
169 | pg_up rewind by 600 seconds |
323 | pg_up rewind by 600 seconds |
170 | pg_down forward by 600 seconds |
324 | pg_down forward by 600 seconds |
171 | o toggle on-screen display |
325 | o toggle on-screen display |
172 | p pause/unpause |
326 | p pause/unpause |
173 | escape stop playing |
327 | escape stop playing |
174 | 9 turn volume down |
328 | 9 turn volume down |
175 | 0 turn volume up |
329 | 0 turn volume up |
176 | |
330 | |
177 | The following keys are redirected to the default visual schnauzer window: |
331 | Any other keys will be sent to the default schnauzer window, which can be |
|
|
332 | toggled on and off by right-clicking into the image window. |
178 | |
333 | |
179 | space next image |
334 | Left-clicking into the image window will let you crop the image (usually |
180 | backspace last image |
335 | to zoom into large images that CV scales down). |
181 | |
336 | |
182 | =head2 THE VISUAL SCHNAUZER |
337 | =head2 THE VISUAL SCHNAUZER |
183 | |
338 | |
|
|
339 | Any image-loading action in a schnauzer window acts on the |
|
|
340 | "last-recently-activated" imagewindow, which currently is simply the last |
|
|
341 | image window that received a keypress. |
|
|
342 | |
184 | You can use the following keys in the schnauzer window: |
343 | You can use the following keys in the schnauzer window: |
185 | |
344 | |
|
|
345 | ctrl-space, |
186 | space move to and display next image |
346 | space move to and display next image |
|
|
347 | ctrl-backspace, |
187 | backspace move to and display previous image |
348 | backspace move to and display previous image |
|
|
349 | ctrl-return, |
188 | return display selected picture |
350 | return display selected picture, or enter directory |
189 | |
351 | |
190 | cursor keys move selection |
352 | cursor keys move selection |
191 | page-up move one page up |
353 | page-up move one page up |
192 | page-down move one page down |
354 | page-down move one page down |
193 | home move to first file |
355 | home move to first file |
194 | end move to last file |
356 | end move to last file |
195 | |
357 | |
|
|
358 | ctrl-a select all files |
|
|
359 | ctrl-shift-a select all files currently displayed in the schnauzer window |
196 | ctrl-d delete selected files WITHOUT ASKING AGAIN |
360 | ctrl-d delete selected files WITHOUT ASKING AGAIN |
197 | ctrl-g generate icons for the selected files |
361 | ctrl-g force generation of thumbnais for the selected files |
|
|
362 | ctrl-s rescan current direcory or files updates/deletes etc. |
198 | ctrl-u update selected (or all) icons if neccessary |
363 | ctrl-u update selected (or all) icons if neccessary |
199 | ctrl-a select all files |
364 | ctrl-l don't use, will become a plug-in eventually |
|
|
365 | |
|
|
366 | ^ go to parent directory (caret). |
|
|
367 | |
|
|
368 | 0-9, |
|
|
369 | a-z find the first filename beginning with this letter |
|
|
370 | |
|
|
371 | Right-clicking into the schnauzer window displays a pop-up menu with |
|
|
372 | additional actions. |
|
|
373 | |
|
|
374 | =head3 SELECTION |
|
|
375 | |
|
|
376 | You can select entries in the Schnauzer in a variety of ways: |
|
|
377 | |
|
|
378 | =over 4 |
|
|
379 | |
|
|
380 | =item Keyboard |
|
|
381 | |
|
|
382 | Moving the cursor with the keyboard will first deselect all files and then |
|
|
383 | select the file you moved to. |
|
|
384 | |
|
|
385 | =item Clicking |
|
|
386 | |
|
|
387 | Clicking on an entry will select the one you clicked and deselect all |
|
|
388 | others. |
|
|
389 | |
|
|
390 | =item Shift-Clicking |
|
|
391 | |
|
|
392 | Shift-clicking will toggle the selection on the entry under the mouse. |
|
|
393 | |
|
|
394 | =item Dragging |
|
|
395 | |
|
|
396 | Dragging will select all entries between the one selected when pushing the |
|
|
397 | button and the one selected when releasing the button. If you move above |
|
|
398 | or below the schnauzer area while drag-selecting, the schnauzer will move |
|
|
399 | up/down one row twice per second. In addition, horizontal mouse movement |
|
|
400 | acts as a kind of invisible horizontal scrollbar. |
|
|
401 | |
|
|
402 | =item Hint: double-click works while click-selecting |
|
|
403 | |
|
|
404 | You can double-click any image while click-selecting to display it |
|
|
405 | without stopping the selection process. This will act as if you normally |
|
|
406 | double-clicked the image to display it, and will toggle the selection |
|
|
407 | twice, resulting in no change. |
|
|
408 | |
|
|
409 | =back |
|
|
410 | |
|
|
411 | =head1 FILES |
|
|
412 | |
|
|
413 | When starting, CV runs the F<.cvrc> file in your F<$HOME> directory as if |
|
|
414 | it were a perl script. in that, you will mostly load plug-ins. |
|
|
415 | |
|
|
416 | Example: |
|
|
417 | |
|
|
418 | system "fping -q -t 10 ether" |
|
|
419 | or require "/fs/cv/cvplugin.pl"; |
|
|
420 | |
|
|
421 | This will load a plug-in, but only if the machine I<ether> is reachable |
|
|
422 | (supposedly the plug-in is networked in some way :). |
200 | |
423 | |
201 | =head1 ENVIRONMENT |
424 | =head1 ENVIRONMENT |
202 | |
425 | |
203 | =over 4 |
426 | =over 4 |
204 | |
427 | |
|
|
428 | =item CV_EDITOR |
|
|
429 | |
|
|
430 | The program that gets executed when the user presses C<CTRL-e> in the |
|
|
431 | Schnauzer or image window. The default is C<gimp>. |
|
|
432 | |
205 | =item CV_PRINT_DESTINATION |
433 | =item CV_PRINT_DESTINATION |
206 | |
434 | |
207 | The default (perl-style) destination to use in the print dialog. |
435 | The default (perl-style) destination to use in the print dialog. |
208 | |
436 | |
|
|
437 | =item CV_TRASHCAN |
|
|
438 | |
|
|
439 | When set, must point to a directory where all files that are deleted are |
|
|
440 | moved to. If unset, files that are deleted are really being deleted. |
|
|
441 | |
209 | =back |
442 | =back |
210 | |
443 | |
211 | =head1 SECURITY CONSIDERATIONS |
444 | =head1 SECURITY CONSIDERATIONS |
212 | |
445 | |
213 | CV uses Pixbuf to load images. Pixbuf is not considered safe for this |
446 | CV uses Pixbuf to load non-JPEG images. Pixbuf is not considered safe for |
214 | purpose, though (from the gtk-2.2 release notes): |
447 | this purpose, though (from the gtk-2.2 release notes): |
215 | |
448 | |
216 | "While efforts have been made to make gdk-pixbuf robust against invalid |
449 | "While efforts have been made to make gdk-pixbuf robust against invalid |
217 | images, using gdk-pixbuf to load untrusted data is not recommended, due to |
450 | images, using gdk-pixbuf to load untrusted data is not recommended, due to |
218 | the likelyhood that there are additional problems where an invalid image |
451 | the likelyhood that there are additional problems where an invalid image |
219 | could cause gdk-pixbuf to crash or worse." |
452 | could cause gdk-pixbuf to crash or worse." |
220 | |
453 | |
221 | =head1 BUGS/TODO |
454 | =head1 BUGS/TODO |
222 | |
455 | |
|
|
456 | Lots of functionality is missing. |
|
|
457 | |
223 | Pixbuf doesn't honor G_BROKEN_FILENAMES, so accessing files with names |
458 | Pixbuf doesn't always honor G_BROKEN_FILENAMES, so accessing files with |
224 | incompatible with utf-8 fails. |
459 | names incompatible with utf-8 might fail. |
225 | |
460 | |
226 | rotate on disk |
461 | rotate on disk |
227 | print |
|
|
228 | lots of ui issues |
462 | lots of ui issues |
229 | save(?) |
463 | save(?) |
230 | preferences |
464 | preferences |
231 | ctrl-u in schnauzer |
|
|
232 | shift-cursor in schnauzer |
|
|
233 | |
465 | |
234 | =head1 AUTHOR |
466 | =head1 AUTHOR |
235 | |
467 | |
236 | Marc Lehmann <cv@plan9.de>. |
468 | Marc Lehmann <cv@plan9.de>. |
237 | |
469 | |