View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Klaus Ethgen > Image-MetaData-GQview-v2.0.0 > Image::MetaData::GQview



Annotate this POD


Open  0
View/Report Bugs
Module Version: 2.0.0   Source  


Image::MetaData::GQview - Perl extension for GQview image metadata


   use Image::MetaData::GQview;

   my $md = Image::MetaData::GQview->new("test.jpg");
   my $md2 = Image::MetaData::GQview->new("test2.jpg", {fields => ['keywords', 'comment', 'picture info']});
   my $md3 = Image::MetaData::GQview->new({file => "test2.jpg", fields => ['keywords', 'comment', 'picture info']});
   my $comment = $md->comment;
   my @keywords = $md->keywords;
   my $raw = $md->raw;
   $md->comment("This is a comment");


This module is a abstraction to the image meta data of GQview.

All internal errors will trow an error!



This is a class method and the only one. It is used to get a object of Image::MetaData::GQview. It can be called without parameter or with the image as only option in witch case it try to load the meta data.

You can provide a hash reference as second or as only parameter which specify file and/or fields. The fields are default "keywords" and "comment" in this order.


If you didn't load the data with new you can do that with this method. If the parameter is left out the one setted before is used.

You can also specify the location for the meta file as second parameter.


Get or set the comment.


Get or set the keywords. This is the preferred method for the keywords as it shift out empty keywords.


Get the raw data


Save the data to disk. This will read the location from the gqview configuration. If there is none, the info will be saved in local directory.

You can also specify the location for the meta file as second parameter.


This will extract the information of one field and return it as single sting (in scalar context) or as array splitted in lines.

Please note, it array context also empty lines can be returned!


Well, of cause if you can get a field you have to be able to set it.

The arguments are the field name and the data.

The data can be a single value or a array.


Please report any bugs or feature requests to bug-image-metadata-gqview at, or through the web interface at I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.


The module cannot be used under non unixoid systems like windows. But there is no need for this module anyway as the tool gqview is only available on unixoid systems.


You can find documentation for this module with the perldoc command.

   perldoc Image::MetaData::GQview

You can also look for information at:


   man qview


Klaus Ethgen <>


Copyright (c) 2006-2009 by Klaus Ethgen. All rights reserved.

This program 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 2 of the License, or (at your option) any later version.

This program 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 this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

syntax highlighting: