GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PECOMATO (1)

NAME

pecomato - a portable picture-embedded metadata processor

CONTENTS

Synopsis
Description
Options
Possible Ops
Dump-value Expressions
Filter Include/exclude Expressions
Filter Edit Expressions
Supported Metadata For Extraction
Possible Log Levels
Supported Input Files
Exit Codes
Examples
Author
Copyright

SYNOPSIS

pecomato [OPTION...] OP [EXPR] FILE [FILE...]

pecomato [OPTION...] OP [EXPR] @FILE

usage of form OP EXPR only concerns OP mode dump-value, see below.

use @file to read a list of files from that file. the file must contain exactly one filename to process per line (don’t escape anything, filenames are taken as-is).

DESCRIPTION

pecomato is basically designed to display any kind of information embedded in picture files, as well as checking, filtering, extracting, removing, adding and fixing such information. In other words, it’s a metadata processor.

It supports the following file formats: JPEG/JFIF, Adobe PSD and FFO, raw IPTC. And it knows about the following metadata formats: JFIF, IPTC, Exif, Adobe and Fotostation. More file and metadata formats might be supported later: TIFF, etc.

One of its main goals is to check the validity of parsed metadata as well as optionally check the strict compliance to official standards. On another hand, it aims to provide ways of fixing broken or not compliant chunks as well as providing general basic functions to manipulate the metadata.

Please visit the program homepage at http://www.mollux.org/projects/pecomato/. Thanks for reporting issues at https://www.mollux.org/services/bugzilla/.

OPTIONS

general options:

-v, --version
  show version number then exit
-h, --help
  show this usage help then exit
--list
  list all supported embedded data structures
-l, --log-level NUM
  define verbosity (see possible values below)
-c, --check-compliance
  perform full checks to test the strict validity and compliance of structures to official formats

filtering and extracting options:

-b, --backup
  create backup files of (re)written files if necessary
-d, --target-dir DIRNAME
  target directory for all written files
-f, --fix fix metadata inconsistencies when possible

extracting options:

-x, --extract TYPE
  extract and save metadata to a standalone file (see below for a list of metadata types that can be extracted)
-t, --ext EXTENSION
  define what filename extension to use when writing metadata that is extracted (default: .iptc)
-a, --append-ext
  append extension to original filename when saving the extracted metadata (default: replace original file extension)

filtering options:

-i, --include EXPR
  a filter expression describing the datasets to keep
-i, --include @FILE
  or a file containing a list of datasets to keep, all other datasets will be filtered out. if not used, all datasets will be kept
-e, --exclude EXPR
  a filter expression describing the datasets to filter out
-e, --exclude @FILE
  a file containing a list of datasets to filter out, all other datasets will be kept. if not used all datasets will be kept
--edit EXPR
  a filter edit expression describing the datasets to add
--edit @FILE
  or a file containing a list of datasets to add. datasets won’t be inserted if that breaks compliance to the standards
--test don’t override original file, create *.rewrite file. this option only affects rewriting of source files

dump options:

-w, --wrap NUM
  max column for wrapping (num must be in range [8-1024]). default is to dump unwrapped

POSSIBLE OPS

check just check embedded data structures
dump show embedded data (headers only)
dump-full
  show all embedded data (including values)
dump-value
  show requested value (headers only)
filter
  filter embedded data (see -i, -e and --edit)

DUMP-VALUE EXPRESSIONS

IPTC.<record>
 

same as filter include/exclude expression, see below:

FILTER INCLUDE/EXCLUDE EXPRESSIONS

IPTC.<record>
 

where <record> can be either:

all: *
hexadecimal unary: 0xhhhh
hexadecimal range: 0xhhhh-0xhhhh
decimal unary: nnn:nnn
decimal ranges: nnn:nnn-nnn
nnn:*
 

examples:

IPTC.0x0219
IPTC.0x0300-0x0364
IPTC.3:0-100
 

FILTER EDIT EXPRESSIONS

IPTC.<record>=<type>:<value>
 

where <record> can be either:

hexadecimal unary: 0xhhhh
decimal unary: nnn:nnn
 

where <type> can be either:

hex
text

and <value> is:

hex: [a-zA-Z0-9] pairs
text: any char (even widechars) on the line is taken as text, until
a newline is found
 

examples:

IPTC.0x0200=hex:0002
IPTC.0x0219=text:this is a keyword
 

SUPPORTED METADATA FOR EXTRACTION

iptc IPTC datasets

POSSIBLE LOG LEVELS

0 quiet, no output at all
1 error messages only (default)
2 warning and error messages
3 informative, warning and error messages
4 all messages including debug ones

SUPPORTED INPUT FILES

JPEG files (commonly .jpeg, .jpg, .jpe, .jfif, .jif)
Adobe Photoshop files (commonly .psd, .pdd, .ffo)
FotoStation files (commonly .fdp, .ipt)
standalone IPTC metadata (commonly .iptc)
 

EXIT CODES

0 normal exit
1 usage error
2 asynchronous signal termination
3 normal exit, with warning(s)
4 normal exit, with error(s)
5 fatal error encountered

EXAMPLES

Check metadata structures of a JPEG file, only report errors
  $ pecomato check file.jpg

AUTHOR

Written by Tristan Chabredier "wwp" <subscript@free.fr>.

COPYRIGHT

Copyright (C) 2005-2007 Tristan Chabredier.

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 3 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, see <http://www.gnu.org/licenses/>.

Search for    or go to Top of page |  Section 1 |  Main Index


(1)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.