shutter / lib /Shutter /App /HelperFunctions.pm
runitx's picture
Claude Opus 5.5
Move modules from share/shutter/resources/modules to lib/
a19d10a unverified
Raw History Blame Contribute Delete
5.51 kB
###################################################
#
# Copyright (C) 2008-2013 Mario Kemper <mario.kemper@gmail.com>
#
# This file is part of Shutter.
#
# Shutter is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# Shutter is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with Shutter; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
#
###################################################
package Shutter::App::HelperFunctions;
#modules
#--------------------------------------
use utf8;
use strict;
use warnings;
use Gtk3;
#Glib
use Glib qw/TRUE FALSE/;
#--------------------------------------
##################public subs##################
sub new {
my $class = shift;
#constructor
my $self = {_common => shift};
#import shutter dialogs
my $current_window = $self->{_common}->get_mainwindow;
$self->{_dialogs} = Shutter::App::SimpleDialogs->new($current_window);
#gettext
$self->{_d} = $self->{_common}->get_gettext;
bless $self, $class;
return $self;
}
sub xdg_open {
my ($self, $dialog, $link, $user_data) = @_;
my @args = ("xdg-open", "$link");
system(@args);
if ($?) {
my $response = $self->{_dialogs}->dlg_error_message(
sprintf($self->{_d}->get("Error while executing %s."), "'xdg-open'"),
sprintf($self->{_d}->get("There was an error executing %s."), "'xdg-open'"),
undef, undef, undef, undef, undef, undef, sprintf($self->{_d}->get("Exit Code: %d."), $? >> 8));
}
}
sub xdg_open_mail {
my ($self, $dialog, $mail, @user_data) = @_;
my @cmd = 'xdg-email';
push @cmd, $mail if $mail;
system(@cmd, @user_data);
if ($?) {
my $response = $self->{_dialogs}->dlg_error_message(
sprintf($self->{_d}->get("Error while executing %s."), "'xdg-email'"),
sprintf($self->{_d}->get("There was an error executing %s."), "'xdg-email'"),
undef, undef, undef, undef, undef, undef, sprintf($self->{_d}->get("Exit Code: %d."), $? >> 8));
}
}
sub nautilus_sendto {
my ($self, $user_data) = @_;
system('nautilus-sendto', $user_data);
if ($?) {
my $response = $self->{_dialogs}->dlg_error_message(
sprintf($self->{_d}->get("Error while executing %s."), "'nautilus-sendto'"),
sprintf($self->{_d}->get("There was an error executing %s."), "'nautilus-sendto'"),
undef, undef, undef, undef, undef, undef, sprintf($self->{_d}->get("Exit Code: %d."), $? >> 8));
}
}
sub file_exists {
my ($self, $filename) = @_;
return FALSE unless $filename;
$filename = $self->switch_home_in_file($filename);
return TRUE if (-f $filename && -r $filename);
return FALSE;
}
sub folder_exists {
my ($self, $folder) = @_;
return FALSE unless $folder;
$folder = $self->switch_home_in_file($folder);
return TRUE if (-d $folder && -r $folder);
return FALSE;
}
sub uri_exists {
my ($self, $filename) = @_;
return FALSE unless $filename;
$filename = $self->switch_home_in_file($filename);
my $new_giofile = Glib::IO::File::new_for_uri($filename);
return TRUE if $new_giofile->query_exists;
return FALSE;
}
sub file_executable {
my ($self, $filename) = @_;
return FALSE unless $filename;
$filename = $self->switch_home_in_file($filename);
return TRUE if (-x $filename);
return FALSE;
}
sub switch_home_in_file {
my ($self, $filename) = @_;
$filename =~ s/^~/$ENV{ HOME }/; #switch ~ in path to /home/username
return $filename;
}
sub utf8_decode {
my $self = shift;
my $string = shift;
#see https://bugs.launchpad.net/shutter/+bug/347821
utf8::decode $string;
return $string;
}
sub usage {
my $self = shift;
print "shutter [options]\n";
print "Available options:\n\n"
. "Capture:\n"
. "--select (starts Shutter in selection mode)\n"
. "--full (starts Shutter and takes a full screen screenshot directly)\n"
. "--window (starts Shutter in window selection mode)\n"
. "--awindow (capture the active window)\n"
. "--section (starts Shutter in section selection mode)\n"
. "--menu (starts Shutter in menu selection mode)\n"
. "--tooltip (starts Shutter in tooltip selection mode)\n"
. "--web (starts Shutter in web capture mode)\n\n"
.
"Application:\n"
. "--min_at_startup (starts Shutter minimized to tray)\n"
. "--clear_cache (clears cache, e.g. installed plugins, at startup)\n"
. "--debug (prints a lot of debugging information to STDOUT)\n"
. "--disable_systray (disable systray icon)\n"
. "--version (displays version information)\n"
. "--help (displays this help)\n";
return TRUE;
}
# to help migration from Gtk2 to Gtk3
# Native Gtk3::IconSize doesn't work for some reason
sub icon_size {
my $self = shift;
my $size = shift;
my @result = Glib::Object::Introspection->invoke('Gtk', undef, 'icon_size_lookup', Glib::Object::Introspection->convert_sv_to_enum('Gtk3::IconSize', $size));
my $one = shift @result;
die "icon_size($size)=$one, @result" if $one != 1;
return @result;
}
# to help migration from Gtk2 to Gtk3
sub accel {
my $self = shift;
my $str = shift;
Glib::Object::Introspection->invoke('Gtk', undef, 'accelerator_parse', $str);
}
1;