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

Comparing CV/bin/cv (file contents):
Revision 1.15 by root, Wed Nov 5 02:07:00 2003 UTC vs.
Revision 1.49 by root, Sun Jul 31 07:01:31 2005 UTC

…		…
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
		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;
		21
		22	Gtk2::Rc->parse (Gtk2::CV::find_rcfile "gtkrc");
		23
		24	use File::Spec;
		25
		26	my $mainwin;
9	my $viewer;	27	my $viewer;
10	my $schnauzer;	28	my $schnauzer;
		29	my $info;
		30	my $help;
		31
		32	my $schnauzer_idx = 0;
11		33
12	sub new_schnauzer {	34	sub new_schnauzer {
13	my $w = new Gtk2::Window;
14	$w->add (my $s = new Gtk2::CV::Schnauzer);	35	my $s = new Gtk2::CV::Schnauzer;
15		36
16	$s->signal_connect (activate => sub { $viewer->load_image ($_[1]) });
17	$s->signal_connect_after (key_press_event => \&std_keys);	37	$s->signal_connect_after (key_press_event => \&std_keys);
		38	$s->signal_connect (activate => sub {
		39	my $label = sprintf "%s (%d)",
		40	(File::Spec->splitpath ($_[1]))[2],
		41	-s $_[1];
		42	$info->set_label ($label);
		43	$viewer->load_image ($_[1]);
		44	});
18		45
19	$s->set_dir (".");	46	Gtk2::CV::Plugin->call (new_schnauzer => $s);
20		47
21	$s;	48	$s;
22	}	49	}
23		50
24	sub std_keys {	51	sub std_keys {
25	my $key = $_[1]->keyval;	52	my $key = $_[1]->keyval;
26	my $state = $_[1]->state;	53	my $state = $_[1]->state;
27		54
28	my $ctrl = grep $_ eq "control-mask", @$state;	55	my $ctrl = $state * "control-mask";
29		56
30	if ($key == $Gtk2::Gdk::Keysyms{q}) {	57	if ($key == $Gtk2::Gdk::Keysyms{q}) {
31	main_quit Gtk2;	58	main_quit Gtk2;
32	} elsif ($ctrl && $key == $Gtk2::Gdk::Keysyms{v}) {	59	} elsif ($ctrl && $key == $Gtk2::Gdk::Keysyms{v}) {
33	new_schnauzer->get_toplevel->show_all;	60	my $w = new Gtk2::Window;
		61
		62	$w->set_title ("CV: Schnauzer");
		63	$w->add (my $s = new_schnauzer);
		64	$s->set_dir (File::Spec->curdir);
		65	$s->set_geometry_hints;
		66	$w->show_all;
		67
		68	} elsif ($ctrl && $key == $Gtk2::Gdk::Keysyms{h}) {
		69	unless ($help) {
		70	require Gtk2::PodViewer;
		71
		72	$help = new Gtk2::Window;
		73	$help->set_title ("CV: Help");
		74	$help->set_default_size (500, 300);
		75	$help->signal_connect (delete_event => sub { $help->hide; 1 });
		76
		77	$help->add (my $sw = new Gtk2::ScrolledWindow);
		78	$sw->add (my $h = new Gtk2::PodViewer);
		79
		80	#binmode DATA, ":utf8";
		81	$h->load_string (do { local $/; <DATA> });
		82	}
		83
		84	$help->show_all;
34	} else {	85	} else {
35	$schnauzer->handle_key ($key, $state);	86	return 0;
36	}	87	}
37		88
38	1;	89	1
39	}	90	}
40		91
		92	{
41	$viewer = new Gtk2::CV::ImageWindow;	93	$viewer = new Gtk2::CV::ImageWindow;
42		94
43	$viewer->set_title ("CV");	95	$viewer->set_title ("CV: Image");
44		96
45	$viewer->signal_connect (key_press_event => \&std_keys);	97	$viewer->signal_connect (key_press_event => sub {
		98	&std_keys
		99	or $schnauzer->signal_emit (key_press_event => $_[1])
		100	});
46	$viewer->signal_connect (delete_event => sub { main_quit Gtk2 });	101	$viewer->signal_connect (delete_event => sub { main_quit Gtk2 });
47		102
48	$schnauzer = new_schnauzer;
49
50	my $mainwin = $schnauzer->get_toplevel;
51
52	$viewer->signal_connect (button3_press_event => sub {	103	$viewer->signal_connect (button3_press_event => sub {
53	$mainwin->visible	104	$mainwin->visible
54	? $mainwin->hide	105	? $mainwin->hide
55	: $mainwin->show_all;	106	: $mainwin->show_all;
56	});	107	1;
		108	});
		109
		110	Gtk2::CV::Plugin->call (new_imagewindow => $viewer);
		111
		112	$schnauzer = new_schnauzer;
		113
		114	$mainwin = new Gtk2::Window;
		115	$mainwin->set_title ("CV");
		116	$mainwin->add (my $vbox = new Gtk2::VBox);
		117	$mainwin->signal_connect (delete_event => sub { $mainwin->hide; 1; });
		118
		119	$vbox->add ($schnauzer);
		120	$vbox->pack_end (my $frame = new Gtk2::Frame, 0, 0, 0);
		121	$frame->add (my $hbox = new Gtk2::HBox 0, 0);
		122	$hbox->pack_start ((new Gtk2::Label "Info: "), 0, 0, 0);
		123	$hbox->pack_end (my $labelwindow = new Gtk2::EventBox, 1, 1, 0);
		124	$labelwindow->add ($info = new Gtk2::Label);
		125	$labelwindow->signal_connect_after (size_request => sub { $_[1]->width (0); 0 });
		126	$info->set (selectable => 1, xalign => 0, justify => "left");
		127
		128	$schnauzer->set_geometry_hints;
		129	}
57		130
58	if (@ARGV) {	131	if (@ARGV) {
59	$viewer->load_image ($ARGV[0]);	132	$schnauzer->set_paths ([map Glib::filename_to_unicode $_, @ARGV]);
60		133	$schnauzer->show_all;
61	if (@ARGV > 1) {	134	$schnauzer->handle_key ($Gtk2::Gdk::Keysyms{space}, []);
62	$schnauzer->set_paths (\@ARGV);	135	$viewer->show_all;
63	}	136	} else {
		137	$schnauzer->set_dir (File::Spec->curdir);
		138	$mainwin->show_all;
		139	$viewer->show_all;
64	}	140	}
65		141
66	$viewer->show_all;	142	$viewer->show_all;
67		143
68	main Gtk2;	144	main Gtk2;
69		145
		146	__DATA__
		147
70	=head1 NAME	148	=head1 NAME
71		149
72	cv - a fast gtk+ image viewer modeled after xv	150	cv - a fast gtk+ image viewer loosely modeled after XV
73		151
74	=head1 SYNOPSIS	152	=head1 SYNOPSIS
75		153
76	cv [file...]	154	cv [file...]
77		155
		156	=head1 FEATURES
		157
		158	CV is supposed to work similar to the venerable XV image viewer, just
		159	faster. Why faster?
		160
		161	=over 4
		162
		163	=item * optimized directory scanning algorithm
		164
		165	The directory scanning in CV plays some tricks that - on most modern
		166	filesystems - makes it possible to detect filetypes faster than stat()'ing
		167	every file. This makes CV suitable for directories with lots of files
		168	(10000+).
		169
		170	This algorithm is quite unprecise - it doesn't make a difference between
		171	files, device nodes, symlinks and the like, and filetype detection is done
		172	using the file extension only.
		173
		174	=item * use of asynchronous I/O
		175
		176	CV tries to use asynchronous I/O whereever it makes sense, for example
		177	while scanning directories, waiting for stat data or unlinking files. This
		178	usually decreases scanning times for large directories a bit (especially
		179	on RAID devices and over NFS).
		180
		181	=item * fast image loading
		182
		183	The time span between the user issuing a command and displaying the new
		184	image should be as small as possible. CV uses optimized (especially
		185	for JPEG) loading functions and sacrifices some quality (e.g no gamma
		186	correction) to achieve this speed.
		187
		188	=item * fast thumbnail creation
		189
		190	Thumbnail creation is crucial for me, so it's better be fast. Thumbnail
		191	creation for JPEGs has been specially optimized.
		192
		193	=item * minimum optical clutter
		194
		195	CV has no menus or other user interface elements that take up a lot of
		196	screen space. The schnauzer windows can also be somewhat crowded.
		197
		198	The point of an image viewer is viewing images, not a nice GUI. This is
		199	similar to XV's behaviour.
		200
		201	=item * efficient (and hard to learn) user interface
		202
		203	CV uses key combinations. A lot. If you are an experienced XV user, you
		204	will find most of these keys familiar. If not, CV might be hard to use at
		205	first, but will be an efficient tool later.
		206
		207	=item * i18n'ed filename handling throughout
		208
		209	As long as glib can recognize your filename encoding (either UTF-8 or
		210	locale-specific, depending on your settings) and you have the relevant
		211	fonts, CV will display your filenames correctly.
		212
		213	=item * extensible through plug-ins
		214
		215	I have weird plug-ins that access remote databases to find a
		216	directory. This is not likely to be of any use to other people. Likewise,
		217	others might have weird requirements I cannot dream of.
		218
		219	=item * filename clustering
		220
		221	Among the standard plug-ins is a filename clustering plug-in, that (in
		222	case of tens of thousands images in one directory) might be able to
		223	cluster similar names together.
		224
		225	=back
		226
78	=head1 DESCRIPTION	227	=head1 DESCRIPTION
79
80	None yet.
81		228
82	=head2 THE IMAGE WINDOW	229	=head2 THE IMAGE WINDOW
83		230
84	You can use the following keys in the image window:	231	You can use the following keys in the image window:
85		232
88	> double the image size	235	> double the image size
89	, shrink the image by 10%	236	, shrink the image by 10%
90	. enlarge the image by 10%	237	. enlarge the image by 10%
91	n reset to normal size	238	n reset to normal size
92	m maximize to screensize	239	m maximize to screensize
93	M maxime to screensize, respecting image aspect	240	M maximize to screensize, respecting image aspect
		241	ctrl-m toggle maxpect-always mode
94	u uncrop	242	u uncrop
95	r set scaling mode to 'nearest' (fastest)	243	r set scaling mode to 'nearest' (fastest)
96	s set scaling mode to 'bilinear' (default)	244	s set scaling mode to 'bilinear' (default)
97	S set scaling mode to 'hyper' (slowest)	245	shift-s set scaling mode to 'hyper' (slowest)
98	t rotate clockwise 90°	246	t rotate clockwise 90°
99	T rotate counterclockwise°	247	T rotate counterclockwise°
100	ctrl-v open a new visual schnauzer window for the current dir	248	ctrl-v open a new visual schnauzer window for the current dir
		249	ctrl-e run an editor ($CV_EDITOR or "gimp") on the current image
		250	ctrl-p fire up the print fialog
		251	escape cancel a crop action
101		252
102	The following keys are redirected to the default visual schnauzer window:	253	And when playing movies, these additional keys are active:
103		254
104	space next image	255	left rewind by 10 seconds
105	backspace last image	256	right forward by 10 seconds
		257	down rewind by 60 seconds
		258	up forward by 60 seconds
		259	pg_up rewind by 600 seconds
		260	pg_down forward by 600 seconds
		261	o toggle on-screen display
		262	p pause/unpause
		263	escape stop playing
		264	9 turn volume down
		265	0 turn volume up
		266
		267	Any other keys will be sent to the default schnauzer window, which can be
		268	toggled on and off by right-clicking into the image window.
		269
		270	Left-clicking into the image window will let you crop the image (usually
		271	to zoom into large images that CV scales down).
106		272
107	=head2 THE VISUAL SCHNAUZER	273	=head2 THE VISUAL SCHNAUZER
108		274
109	You can use the following keys in the schnauzer window:	275	You can use the following keys in the schnauzer window:
110		276
		277	ctrl-space,
111	space move to and display next image	278	space move to and display next image
		279	ctrl-backspace,
112	backspace move to and display previous image	280	backspace move to and display previous image
		281	ctrl-return,
113	return display selected picture	282	return display selected picture, or enter directory
114		283
115	cursor keys move selection	284	cursor keys move selection
116	page-up move one page up	285	page-up move one page up
117	page-down move one page down	286	page-down move one page down
118	home move to first file	287	home move to first file
119	end move to last file	288	end move to last file
120		289
121	ctrl-g generate icons for the selected files	290	ctrl-a select all files
122	ctrl-d delete selected files WITHOUT ASKING AGAIN	291	ctrl-d delete selected files WITHOUT ASKING AGAIN
		292	ctrl-g force generation of thumbnais for the selected files
		293	ctrl-s rescan current direcory or files updates/deletes etc.
		294	ctrl-u update selected (or all) icons if neccessary
		295	ctrl-l don't use, will become a plug-in eventually
		296
		297	0-9,
		298	a-z find the first filename beginning with this letter
		299
		300	Right-clicking into the schnauzer window displays a pop-up menu with
		301	additional actions.
		302
		303	=head1 FILES
		304
		305	When starting, CV runs the F<.cvrc> file in your F<$HOME> directory as if
		306	it were a perl script. in that, you will mostly load plug-ins.
		307
		308	Example:
		309
		310	system "fping -q -t 10 ether"
		311	or require "/fs/cv/cvplugin.pl";
		312
		313	This will load a plug-in, but only if the machine I<ether> is reachable
		314	(supposedly the plug-in is networked in some way :).
		315
		316	=head1 ENVIRONMENT
		317
		318	=over 4
		319
		320	=item CV_EDITOR
		321
		322	The program that gets executed when the user presses C<CTRL-e> in the
		323	Schnauzer or image window. The default is C<gimp>.
		324
		325	=item CV_PRINT_DESTINATION
		326
		327	The default (perl-style) destination to use in the print dialog.
		328
		329	=item CV_TRASHCAN
		330
		331	When set, must point to a directory where all files that are deleted are
		332	moved to. If unset, files that are deleted are really being deleted.
		333
		334	=back
		335
		336	=head1 SECURITY CONSIDERATIONS
		337
		338	CV uses Pixbuf to load images. Pixbuf is not considered safe for this
		339	purpose, though (from the gtk-2.2 release notes):
		340
		341	"While efforts have been made to make gdk-pixbuf robust against invalid
		342	images, using gdk-pixbuf to load untrusted data is not recommended, due to
		343	the likelyhood that there are additional problems where an invalid image
		344	could cause gdk-pixbuf to crash or worse."
123		345
124	=head1 BUGS/TODO	346	=head1 BUGS/TODO
125		347
		348	Lots of functionality is missing.
		349
		350	Pixbuf doesn't always honor G_BROKEN_FILENAMES, so accessing files with
		351	names incompatible might utf-8 fail.
		352
126	rotate on disk	353	rotate on disk
127	print
128	lots of ui issues	354	lots of ui issues
129	save(?)	355	save(?)
130	preferences	356	preferences
131	ctrl-u in schnauzer
132	shift-cursor in schnauzer	357	shift-cursor in schnauzer
133		358
134	=head1 AUTHOR	359	=head1 AUTHOR
135		360
136	Marc Lehmann <cv@plan9.de>.	361	Marc Lehmann <cv@plan9.de>.

Diff Legend

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

Comparing CV/bin/cv (file contents): Revision 1.15 by root, Wed Nov 5 02:07:00 2003 UTC vs. Revision 1.49 by root, Sun Jul 31 07:01:31 2005 UTC

Diff Legend

Comparing CV/bin/cv (file contents):
Revision 1.15 by root, Wed Nov 5 02:07:00 2003 UTC vs.
Revision 1.49 by root, Sun Jul 31 07:01:31 2005 UTC