################################################### # # Copyright (C) 2008-2013 Mario Kemper # # 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;