[ViewVC] Diff of: cvs/CV/bin/cv

Comparing CV/bin/cv (file contents):
Revision 1.39 by root, Sun May 1 05:53:40 2005 UTC vs.
Revision 1.70 by root, Sat Sep 8 08:20:02 2007 UTC

…		…
4	use Encode ();	4	use Encode ();
5		5
6	use Gtk2 -init;	6	use Gtk2 -init;
7	use Gtk2::Gdk::Keysyms;	7	use Gtk2::Gdk::Keysyms;
8		8
		9	use Gtk2::CV;
		10
9	use Gtk2::CV::ImageWindow;	11	use Gtk2::CV::ImageWindow;
10	use Gtk2::CV::Schnauzer;	12	use Gtk2::CV::Schnauzer;
11		13
12	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;
13		21
14	Gtk2::Rc->parse (Gtk2::CV::find_rcfile "gtkrc");	22	Gtk2::Rc->parse (Gtk2::CV::find_rcfile "gtkrc");
15		23
16	use File::Spec;	24	use File::Spec;
17		25
18	my $mainwin;	26	my $mainwin;
19	my $viewer;	27	my $viewer;
		28	my $viewer_count;
20	my $schnauzer;	29	my $schnauzer;
21	my $info;	30	my $info;
22	my $help;	31	my $help;
23		32
24	my $schnauzer_idx = 0;	33	my $schnauzer_idx = 0;
…		…
30	$s->signal_connect (activate => sub {	39	$s->signal_connect (activate => sub {
31	my $label = sprintf "%s (%d)",	40	my $label = sprintf "%s (%d)",
32	(File::Spec->splitpath ($_[1]))[2],	41	(File::Spec->splitpath ($_[1]))[2],
33	-s $_[1];	42	-s $_[1];
34	$info->set_label ($label);	43	$info->set_label ($label);
35	$viewer->load_image ($_[1]);	44	$viewer->load_image ($_[1]) if $viewer; # TODO: error, or chose ANY viewer
36	});	45	});
		46
		47	Gtk2::CV::Plugin->call (new_schnauzer => $s);
		48
		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
37	$s->signal_connect (chdir => sub {	59	$self->signal_connect (key_press_event => sub {
38	my ($self, $dir) = @_;	60	$viewer = $_[0];
39		61
40	my $path = Cwd::abs_path $dir;	62	my $key = $_[1]->keyval;
		63	my $state = $_[1]->state;
41		64
42	$self->realize;	65	if ($state * "control-mask" && $key == $Gtk2::Gdk::Keysyms{c}) {
43	$self->window->property_change (	66	my $viewer = new_viewer ();
44	Gtk2::Gdk::Atom->intern ("_X_CWD", 0),	67	$viewer->set_image ($_[0]->{image});
45	Gtk2::Gdk::Atom->intern ("UTF8_STRING", 0),	68	$viewer->show_all;
46	Gtk2::Gdk::CHARS, 'replace',	69	1
47	Encode::encode_utf8 $path,	70	} else {
		71	&std_keys
		72	or $schnauzer->signal_emit (key_press_event => $_[1])
48	);	73	}
49	});	74	});
		75	$self->signal_connect (delete_event => sub { $_[0]->destroy; 0 });
		76	$self->signal_connect (destroy => sub {
		77	$viewer = undef if $viewer == $_[0];
50		78
51	$s;	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
52	}	95	}
53		96
54	sub std_keys {	97	sub std_keys {
55	my $key = $_[1]->keyval;	98	my $key = $_[1]->keyval;
56	my $state = $_[1]->state;	99	my $state = $_[1]->state;
57		100
58	my $ctrl = $state * "control-mask";	101	my $ctrl = $state * "control-mask";
59		102
60	if ($key == $Gtk2::Gdk::Keysyms{q}) {	103	if ($key == $Gtk2::Gdk::Keysyms{q}) {
61	main_quit Gtk2;	104	$viewer->destroy;
62	} elsif ($ctrl && $key == $Gtk2::Gdk::Keysyms{v}) {	105	} elsif ($ctrl && $key == $Gtk2::Gdk::Keysyms{v}) {
63	my $w = new Gtk2::Window;	106	my $w = new Gtk2::Window;
64		107
		108	$w->set_role ("schnauzer");
65	$w->set_title ("CV: Schnauzer");	109	$w->set_title ("CV: Schnauzer");
66	$w->add (my $s = new_schnauzer);	110	$w->add (my $s = new_schnauzer);
67	$s->set_dir (File::Spec->curdir);	111	$s->set_dir (File::Spec->curdir);
68	$s->set_geometry_hints;	112	$s->set_geometry_hints;
69	$w->show_all;	113	$w->show_all;
…		…
71	} elsif ($ctrl && $key == $Gtk2::Gdk::Keysyms{h}) {	115	} elsif ($ctrl && $key == $Gtk2::Gdk::Keysyms{h}) {
72	unless ($help) {	116	unless ($help) {
73	require Gtk2::PodViewer;	117	require Gtk2::PodViewer;
74		118
75	$help = new Gtk2::Window;	119	$help = new Gtk2::Window;
		120	$help->set_role ("help");
76	$help->set_title ("CV: Help");	121	$help->set_title ("CV: Help");
77	$help->set_default_size (500, 300);	122	$help->set_default_size (500, 300);
78	$help->signal_connect (delete_event => sub { $help->hide; 1 });	123	$help->signal_connect (delete_event => sub { $help->hide; 1 });
79		124
80	$help->add (my $sw = new Gtk2::ScrolledWindow);	125	$help->add (my $sw = new Gtk2::ScrolledWindow);
…		…
84	$h->load_string (do { local $/; <DATA> });	129	$h->load_string (do { local $/; <DATA> });
85	}	130	}
86		131
87	$help->show_all;	132	$help->show_all;
88	} else {	133	} else {
89	#$mainwin->show_all;	134	return 0;
90	$schnauzer->handle_key ($key, $state);
91	}	135	}
92		136
93	1;	137	1
94	}	138	}
95		139
96	{	140	{
97	$viewer = new Gtk2::CV::ImageWindow;	141	$viewer = new_viewer;
98		142	$::cur_viewer = $viewer;
99	$viewer->set_title ("CV: Image");
100
101	$viewer->signal_connect (key_press_event => \&std_keys);
102	$viewer->signal_connect (delete_event => sub { main_quit Gtk2 });
103
104	$viewer->signal_connect (button3_press_event => sub {
105	$mainwin->visible
106	? $mainwin->hide
107	: $mainwin->show_all;
108	1;
109	});
110		143
111	$schnauzer = new_schnauzer;	144	$schnauzer = new_schnauzer;
112		145
113	$mainwin = new Gtk2::Window;	146	$mainwin = new Gtk2::Window;
		147	$mainwin->set_role ("main");
114	$mainwin->set_title ("CV");	148	$mainwin->set_title ("CV");
115	$mainwin->add (my $vbox = new Gtk2::VBox);	149	$mainwin->add (my $vbox = new Gtk2::VBox);
116	$mainwin->signal_connect (delete_event => sub { $mainwin->hide; 1; });	150	$mainwin->signal_connect (delete_event => sub { $mainwin->hide; 1 });
117		151
118	$vbox->add ($schnauzer);	152	$vbox->add ($schnauzer);
119	$vbox->pack_end (my $frame = new Gtk2::Frame, 0, 0, 0);	153	$vbox->pack_end (my $frame = new Gtk2::Frame, 0, 0, 0);
120	$frame->add (my $hbox = new Gtk2::HBox 0, 0);	154	$frame->add (my $hbox = new Gtk2::HBox 0, 0);
121	$hbox->pack_start ((new Gtk2::Label "Info"), 0, 0, 0);	155	$hbox->pack_start ((new Gtk2::Label "Info: "), 0, 0, 0);
122	$hbox->pack_start (($info = new Gtk2::Label), 1, 1, 0);	156	$hbox->pack_end (my $labelwindow = new Gtk2::EventBox, 1, 1, 0);
123	$info->set (wrap => 1);	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");
124		160
125	$schnauzer->set_geometry_hints;	161	$schnauzer->set_geometry_hints;
126	}	162	}
127		163
128	if (@ARGV) {	164	if (@ARGV) {
129	$schnauzer->set_paths ([map Glib::filename_to_unicode $_, @ARGV]);	165	my $show_first = sub {
130	$schnauzer->show_all;	166	$schnauzer->show_all;
131	$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);
132	} else {	174	} else {
133	$schnauzer->set_dir (File::Spec->curdir);	175	$schnauzer->set_dir (File::Spec->curdir, sub {
134	$mainwin->show_all;	176	$mainwin->show_all;
135	$viewer->show_all;	177	$viewer->show_all;
		178	});
136	}	179	}
137
138	$viewer->show_all;
139		180
140	main Gtk2;	181	main Gtk2;
141		182
		183	Gtk2::CV::flush_aio;
		184
142	__DATA__	185	__DATA__
143		186
		187	=encoding utf-8
		188
144	=head1 NAME	189	=head1 NAME
145		190
146	cv - a fast gtk+ image viewer modeled after xv	191	cv - a fast gtk+ image viewer loosely modeled after XV
147		192
148	=head1 SYNOPSIS	193	=head1 SYNOPSIS
149		194
150	cv [file...]	195	cv [file...]
151		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
152	=head1 DESCRIPTION	288	=head1 DESCRIPTION
153		289
154	None yet.
155
156	=head2 THE IMAGE WINDOW	290	=head2 THE IMAGE WINDOW
157		291
158	You can use the following keys in the image window:	292	You can use the following keys in the image window:
159		293
160	q quit the program	294	q quit the program
161	< half the image size	295	< half the image size
162	> double the image size	296	> double the image size
163	, shrink the image by 10%	297	, shrink the image by 10%
164	. enlarge the image by 10%	298	. enlarge the image by 10%
165	n reset to normal size	299	n reset to normal size
166	m maximize to screensize	300	m maximize to screensize
167	M maxime to screensize, respecting image aspect	301	M maximize to screensize, respecting image aspect
168	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
169	u uncrop	304	u uncrop
170	r set scaling mode to 'nearest' (fastest)	305	r set scaling mode to 'nearest' (fastest)
171	s set scaling mode to 'bilinear' (default)	306	s set scaling mode to 'bilinear' (default)
172	S set scaling mode to 'hyper' (slowest)	307	shift-s set scaling mode to 'hyper' (slowest)
173	t rotate clockwise 90°	308	t rotate clockwise 90°
174	T rotate counterclockwise°	309	T rotate counterclockwise°
		310	a apply all rotations loslessly to a jpeg file (using exiftran)
175	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
176	ctrl-s rescan visual schnauzer files for updates/deletes etc.	312	ctrl-c clone the current image window
177	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
178		316
179	And when playing movies, these additional keys are active:	317	And when playing movies, these additional keys are active:
180		318
181	left rewind by 10 seconds	319	left rewind by 10 seconds
182	right forward by 10 seconds	320	right forward by 10 seconds
183	down rewind by 60 seconds	321	down rewind by 60 seconds
184	up forward by 60 seconds	322	up forward by 60 seconds
185	pg_up rewind by 600 seconds	323	pg_up rewind by 600 seconds
186	pg_down forward by 600 seconds	324	pg_down forward by 600 seconds
187	o toggle on-screen display	325	o toggle on-screen display
188	p pause/unpause	326	p pause/unpause
189	escape stop playing	327	escape stop playing
190	9 turn volume down	328	9 turn volume down
191	0 turn volume up	329	0 turn volume up
192		330
193	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.
194		333
195	space next image	334	Left-clicking into the image window will let you crop the image (usually
196	backspace last image	335	to zoom into large images that CV scales down).
197		336
198	=head2 THE VISUAL SCHNAUZER	337	=head2 THE VISUAL SCHNAUZER
199		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
200	You can use the following keys in the schnauzer window:	343	You can use the following keys in the schnauzer window:
201		344
		345	ctrl-space,
202	space move to and display next image	346	space move to and display next image
		347	ctrl-backspace,
203	backspace move to and display previous image	348	backspace move to and display previous image
		349	ctrl-return,
204	return display selected picture	350	return display selected picture, or enter directory
205		351
206	cursor keys move selection	352	cursor keys move selection
207	page-up move one page up	353	page-up move one page up
208	page-down move one page down	354	page-down move one page down
209	home move to first file	355	home move to first file
210	end move to last file	356	end move to last file
211		357
		358	ctrl-a select all files
		359	ctrl-shift-a select all files currently displayed in the schnauzer window
212	ctrl-d delete selected files WITHOUT ASKING AGAIN	360	ctrl-d delete selected files WITHOUT ASKING AGAIN
213	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.
214	ctrl-u update selected (or all) icons if neccessary	363	ctrl-u update selected (or all) icons if neccessary
215	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 :).
216		423
217	=head1 ENVIRONMENT	424	=head1 ENVIRONMENT
218		425
219	=over 4	426	=over 4
220		427
221	=item CV_EDITOR	428	=item CV_EDITOR
222		429
223	The program that gets executed when the user presses C<CTRL-e> in the	430	The program that gets executed when the user presses C<CTRL-e> in the
224	Schnauzer or image window. The default is C<gimp>.	431	Schnauzer or image window. The default is C<gimp>.
225		432
		433	=item CV_AUDIO_PLAYER
		434
		435	Program used to play all sorts of audio (wav, aif, mp3, ogg...), default "play".
		436	Will be called like C<< $CV_AUDIO_PLAYER -- <path> >>.
		437
226	=item CV_PRINT_DESTINATION	438	=item CV_PRINT_DESTINATION
227		439
228	The default (perl-style) destination to use in the print dialog.	440	The default (perl-style) destination to use in the print dialog.
229		441
230	=item CV_TRASHCAN	442	=item CV_TRASHCAN
…		…
234		446
235	=back	447	=back
236		448
237	=head1 SECURITY CONSIDERATIONS	449	=head1 SECURITY CONSIDERATIONS
238		450
239	CV uses Pixbuf to load images. Pixbuf is not considered safe for this	451	CV uses Pixbuf to load non-JPEG images. Pixbuf is not considered safe for
240	purpose, though (from the gtk-2.2 release notes):	452	this purpose, though (from the gtk-2.2 release notes):
241		453
242	"While efforts have been made to make gdk-pixbuf robust against invalid	454	"While efforts have been made to make gdk-pixbuf robust against invalid
243	images, using gdk-pixbuf to load untrusted data is not recommended, due to	455	images, using gdk-pixbuf to load untrusted data is not recommended, due to
244	the likelyhood that there are additional problems where an invalid image	456	the likelyhood that there are additional problems where an invalid image
245	could cause gdk-pixbuf to crash or worse."	457	could cause gdk-pixbuf to crash or worse."
246		458
247	=head1 BUGS/TODO	459	=head1 BUGS/TODO
248		460
		461	Lots of functionality is missing.
		462
249	Pixbuf doesn't honor G_BROKEN_FILENAMES, so accessing files with names	463	Pixbuf doesn't always honor G_BROKEN_FILENAMES, so accessing files with
250	incompatible with utf-8 fails.	464	names incompatible with utf-8 might fail.
251		465
252	rotate on disk	466	rotate on disk
253	print
254	lots of ui issues	467	lots of ui issues
255	save(?)	468	save(?)
256	preferences	469	preferences
257	ctrl-u in schnauzer
258	shift-cursor in schnauzer
259		470
260	=head1 AUTHOR	471	=head1 AUTHOR
261		472
262	Marc Lehmann <cv@plan9.de>.	473	Marc Lehmann <cv@plan9.de>.
263		474

Diff Legend

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

Comparing CV/bin/cv (file contents): Revision 1.39 by root, Sun May 1 05:53:40 2005 UTC vs. Revision 1.70 by root, Sat Sep 8 08:20:02 2007 UTC

Diff Legend

Comparing CV/bin/cv (file contents):
Revision 1.39 by root, Sun May 1 05:53:40 2005 UTC vs.
Revision 1.70 by root, Sat Sep 8 08:20:02 2007 UTC