Image::MetaData::GQview
=======================

SYNOPSIS

         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']});
         $md->load("test.jpg");
         my $comment = $md->comment;
         my @keywords = $md->keywords;
         my $raw = $md->raw;
         $md->comment("This is a comment");
         $md->keywords(@keywords);
         $md->save("test.jpg");

DESCRIPTION

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

All internal errors will trow an error!

METHODS

    new 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.

    load
        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.

    comment
        Get or set the comment.

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

    raw Get the raw data

    save
        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.

    get_field
        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!

    set_field
        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.

INSTALLATION

To install this module, run the following commands:

   perl Makefile.PL
   make
   make test
   make install

BUGS

Please report any bugs or feature requests to "bug-image-metadata-gqview at
rt.cpan.org", or through the web interface at
<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Image-MetaData-GQview>. I will
be notified, and then you'll automatically be notified of progress on your bug
as I make changes.

INCOMPATIBILITIES

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.

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the perldoc command.

    perldoc Image::MetaData::GQview

You can also look for information at:

    Search CPAN
        http://search.cpan.org/dist/Image-MetaData-GQview

    CPAN Request Tracker:
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Image-MetaData-GQview

    AnnoCPAN, annotated CPAN documentation:
        http://annocpan.org/dist/Image-MetaData-GQview

    CPAN Ratings:
        http://cpanratings.perl.org/d/Image-MetaData-GQview

COPYRIGHT AND LICENCE

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.