[Pkg-phototools-commits] [SCM] openimageio branch, master, updated. debian/1.0.3+dfsg0-1-15-gaf05662

Matteo F. Vescovi mfv.debian at gmail.com
Sat May 19 13:06:37 UTC 2012


The following commit has been merged in the master branch:
commit 7bc8af02383f2a3f8ef0bb2748a8d5940ac717ff
Author: Matteo F. Vescovi <mfv.debian at gmail.com>
Date:   Sat May 19 09:11:52 2012 +0200

    debian/: updated manpages moved to "manpages" sub-dir
    
    Closes: #673504
    Thanks: IRIE Shinsuke for the updated manpages

diff --git a/debian/iconvert.1 b/debian/manpages/iconvert.1
similarity index 96%
rename from debian/iconvert.1
rename to debian/manpages/iconvert.1
index 754c15b..d74164a 100644
--- a/debian/iconvert.1
+++ b/debian/manpages/iconvert.1
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH ICONVERT 1 "November 11, 2011"
+.TH ICONVERT 1 "May 19, 2012"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -63,12 +63,15 @@ For a complete description, see
 .IR /usr/share/doc/libopenimageio-dev/openimageio.pdf.gz .
 .SH OPTIONS
 .TP
-.B \-h, \-\-help
+.B \-\-help
 Print help message
 .TP
 .B \-v
 Verbose status messages
 .TP
+.BI \-\-threads\  %d
+Number of threads (default 0 == #cores)
+.TP
 .BI \-d\  %s
 Set the output data format to one of:
 .br
@@ -139,7 +142,8 @@ Do no overwrite existing files
 .BR iinfo (1),
 .BR iprocess (1),
 .BR iv (1),
-.BR maketx (1).
+.BR maketx (1),
+.BR oiiotool (1).
 .SH AUTHOR
 OpenImageIO was written by Larry Gritz and the other authors and contributors.
 .PP
diff --git a/debian/idiff.1 b/debian/manpages/idiff.1
similarity index 98%
rename from debian/idiff.1
rename to debian/manpages/idiff.1
index 77fb7ff..79c23c1 100644
--- a/debian/idiff.1
+++ b/debian/manpages/idiff.1
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH IDIFF 1 "November 11, 2011"
+.TH IDIFF 1 "May 19, 2012"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -68,7 +68,7 @@ For a complete description, see
 .IR /usr/share/doc/libopenimageio-dev/openimageio.pdf.gz .
 .SH OPTIONS
 .TP
-.B \-h, \-\-help
+.B \-\-help
 Print help message
 .TP
 .B \-v
@@ -117,7 +117,8 @@ Scale the output image by this factor
 .BR iinfo (1),
 .BR iprocess (1),
 .BR iv (1),
-.BR maketx (1).
+.BR maketx (1),
+.BR oiiotool (1).
 .SH AUTHOR
 OpenImageIO was written by Larry Gritz and the other authors and contributors.
 .PP
diff --git a/debian/igrep.1 b/debian/manpages/igrep.1
similarity index 97%
rename from debian/igrep.1
rename to debian/manpages/igrep.1
index 469dc1e..a7a999a 100644
--- a/debian/igrep.1
+++ b/debian/manpages/igrep.1
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH IGREP 1 "November 11, 2011"
+.TH IGREP 1 "May 19, 2012"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -50,7 +50,7 @@ For a complete description, see
 .IR /usr/share/doc/libopenimageio-dev/openimageio.pdf.gz .
 .SH OPTIONS
 .TP
-.B \-h, \-\-help
+.B \-\-help
 Print help message
 .TP
 .B \-i
@@ -83,7 +83,8 @@ Search all subimages of each file
 .BR iinfo (1),
 .BR iprocess (1),
 .BR iv (1),
-.BR maketx (1).
+.BR maketx (1),
+.BR oiiotool (1).
 .SH AUTHOR
 OpenImageIO was written by Larry Gritz and the other authors and contributors.
 .PP
diff --git a/debian/iinfo.1 b/debian/manpages/iinfo.1
similarity index 96%
rename from debian/iinfo.1
rename to debian/manpages/iinfo.1
index f74787a..2820dfa 100644
--- a/debian/iinfo.1
+++ b/debian/manpages/iinfo.1
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH IINFO 1 "November 11, 2011"
+.TH IINFO 1 "May 19, 2012"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -49,7 +49,7 @@ For a complete description, see
 .IR /usr/share/doc/libopenimageio-dev/openimageio.pdf.gz .
 .SH OPTIONS
 .TP
-.B \-h, \-\-help
+.B \-\-help
 Print help message
 .TP
 .B \-v
@@ -78,7 +78,8 @@ Print image pixel statistics (data window)
 .BR igrep (1),
 .BR iprocess (1),
 .BR iv (1),
-.BR maketx (1).
+.BR maketx (1),
+.BR oiiotool (1).
 .SH AUTHOR
 OpenImageIO was written by Larry Gritz and the other authors and contributors.
 .PP
diff --git a/debian/iprocess.1 b/debian/manpages/iprocess.1
similarity index 80%
rename from debian/iprocess.1
rename to debian/manpages/iprocess.1
index c81cd04..0edeb58 100644
--- a/debian/iprocess.1
+++ b/debian/manpages/iprocess.1
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH IPROCESS 1 "November 11, 2011"
+.TH IPROCESS 1 "May 19, 2012"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -27,7 +27,7 @@ iprocess \- simple image processing operations
 \fBiprocess\fP is a program for simple image processing operations.
 .SH OPTIONS
 .TP
-.B \-h, \-\-help
+.B \-\-help
 Print help message
 .TP
 .BI \-o\  %s
@@ -37,10 +37,8 @@ Set output filename
 .BI \-\-add
 Add two images
 .TP
-.BI \-\-crop\  %s\ %d\ %d\ %d\ %d
-Crop an image (type, xmin, xmax, ymin, ymax)
-.br
-type = black|white|trans|window|cut
+.BI \-\-crop\  %d\ %d\ %d\ %d
+Crop an image (xmin, xmax, ymin, ymax)
 .TP
 .BI \-\-flip
 Flip the Image (upside-down)
@@ -49,16 +47,6 @@ Flip the Image (upside-down)
 Flop the Image (left/right mirror)
 .SS Output options:
 .TP
-.BI \-\-transfer\  %s
-Transfer outputfile to another colorspace
-.br
-Linear, Gamma, sRGB, AdobeRGB, Rec709, KodakLog
-.TP
-.BI \-\-colorspace\  %s
-Override colorspace of inputfile
-.br
-Linear, Gamma, sRGB, AdobeRGB, Rec709, KodakLog
-.TP
 .BI \-\-filter\  %s\ %f
 Set the filter to use for resize
 .TP
@@ -70,7 +58,8 @@ Resize the image to x by y pixels
 .BR igrep (1),
 .BR iinfo (1),
 .BR iv (1),
-.BR maketx (1).
+.BR maketx (1),
+.BR oiiotool (1).
 .SH AUTHOR
 OpenImageIO was written by Larry Gritz and the other authors and contributors.
 .PP
diff --git a/debian/iv.1 b/debian/manpages/iv.1
similarity index 95%
rename from debian/iv.1
rename to debian/manpages/iv.1
index fdf6664..39e3946 100644
--- a/debian/iv.1
+++ b/debian/manpages/iv.1
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH IV 1 "November 11, 2011"
+.TH IV 1 "May 19, 2012"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -29,7 +29,7 @@ is built on top on OpenImageIO, it can display images of any formats
 readable by ImageInput plugins on hand.
 .SH OPTIONS
 .TP
-.B \-h, \-\-help
+.B \-\-help
 Print help message
 .TP
 .B \-v
@@ -43,7 +43,8 @@ Foreground mode
 .BR igrep (1),
 .BR iinfo (1),
 .BR iprocess (1),
-.BR maketx (1).
+.BR maketx (1),
+.BR oiiotool (1).
 .SH AUTHOR
 OpenImageIO was written by Larry Gritz and the other authors and contributors.
 .PP
diff --git a/debian/maketx.1 b/debian/manpages/maketx.1
similarity index 82%
rename from debian/maketx.1
rename to debian/manpages/maketx.1
index b4521b8..2633ccb 100644
--- a/debian/maketx.1
+++ b/debian/manpages/maketx.1
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH MAKETX 1 "November 11, 2011"
+.TH MAKETX 1 "May 19, 2012"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -48,13 +48,7 @@ For a complete description, see
 .IR /usr/share/doc/libopenimageio-dev/openimageio.pdf.gz .
 .SH OPTIONS
 .TP
-.B \-h, \-\-help
-Show summary of options.
-.TP
-.B \-v, \-\-version
-Show version of program.
-.TP
-.BI \-\-help
+.B \-\-help
 Print help message
 .TP
 .BI \-v
@@ -63,8 +57,8 @@ Verbose status messages
 .BI \-o\  %s
 Output filename
 .TP
-.BI \-t\  %d
-Number of threads (default: #cores)
+.BI \-\-threads\  %d
+Number of threads (default 0 == #cores)
 .TP
 .BI \-u
 Update mode
@@ -118,6 +112,9 @@ Do not make multiple MIP-map levels
 .BI \-\-checknan
 Check for NaN and Inf values (abort if found)
 .TP
+.BI \-\-fixnan\  %s
+Attempt to fix NaN/Inf values in the image (options: none, black, box3)
+.TP
 .BI \-\-Mcamera\  %f\ %f\ %f\ %f\ %f\ %f\ %f\ %f\ %f\ %f\ %f\ %f\ %f\ %f\ %f\ %f
 Set the camera matrix
 .TP
@@ -136,8 +133,14 @@ Create 1-tile textures from constant color inputs
 .BI \-\-monochrome\-detect
 Create 1-channel textures from monochrome inputs
 .TP
+.B \-\-opaque-detect
+Drop alpha channel that is always 1.0
+.TP
 .BI \-\-stats
 Print runtime statistics
+.TP
+.BI \-\-mipimage\  %s
+Specify an individual MIP level
 .SS Basic modes (default is plain texture):
 .TP
 .BI \-\-shadow
@@ -147,8 +150,17 @@ Create shadow map
 Create lat/long environment map
 .TP
 .BI \-\-envcube
-Create cubic env map (file order: px,nx,py,ny,pz,nz) (UNIMP)
-.SH Configuration Presets
+Create cubic env map (file order: px, nx, py, ny, pz, nz) (UNIMP)
+.SS Color Management Options (OpenColorIO DISABLED)
+.TP
+.BI \-\-colorconvert\  %s\ %s
+Apply a color space conversion to the image. If the output color space is not the same bit depth as input color space, it is your responsibility to set the data format to the proper bit depth using the -d option.
+.br
+(choices: linear, sRGB, Rec709)
+.TP
+.BI \-\-unpremult
+Unpremultiply before color conversion, then premultiply after the color conversion.  You'll probably want to use this flag if your image contains an alpha channel.
+.SS Configuration Presets
 .TP
 .BI \-\-prman
 Use PRMan-safe settings for tile size, planarconfig, and metadata.
@@ -161,7 +173,8 @@ Use OIIO-optimized settings for tile size, planarconfig, metadata, and constant-
 .BR igrep (1),
 .BR iinfo (1),
 .BR iprocess (1),
-.BR iv (1).
+.BR iv (1),
+.BR oiiotool (1).
 .SH AUTHOR
 OpenImageIO was written by Larry Gritz and the other authors and contributors.
 .PP
diff --git a/debian/manpages/oiiotool.1 b/debian/manpages/oiiotool.1
new file mode 100644
index 0000000..f01e7fd
--- /dev/null
+++ b/debian/manpages/oiiotool.1
@@ -0,0 +1,241 @@
+.\"                                      Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH OIIOTOOL 1 "May 19, 2012"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh        disable hyphenation
+.\" .hy        enable hyphenation
+.\" .ad l      left justify
+.\" .ad b      justify to both left and right margins
+.\" .nf        disable filling
+.\" .fi        enable filling
+.\" .br        insert line break
+.\" .sp <n>    insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+oiiotool \- the OIIO Swiss Army Knife
+.SH SYNOPSIS
+.B oiiotool
+.RI [ filename | option | action ]...
+.SH DESCRIPTION
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
+.\" respectively.
+The \fBoiiotool\fP program will read images (from any file format for which an ImageInput plugin
+can be found), perform various operations on them, and write images (in any format for which
+an ImageOutput plugin can be found).
+.PP
+The oiiotool utility is invoked as follows:
+
+.B oiiotool
+.RI args
+
+oiiotool maintains an image stack, with the top image in the stack also called the current
+image. The stack begins containing no images.
+.PP
+oiiotool arguments consist of image names, or commands. When an image name is
+encountered, that image is pushed on the stack and becomes the new current image.
+.PP
+Most other commands either alter the current image (replacing it with the alteration), or in
+some cases will pull more than one image off the stack (such as the current image and the next
+item on the stack) and then push a new image.
+.PP
+For a complete description, see
+.IR /usr/share/doc/libopenimageio-dev/openimageio.pdf.gz .
+.SH OPTIONS
+.SS Options (general):
+.TP
+.B \-\-help
+Print help message
+.TP
+.B \-v
+Verbose status messages
+.TP
+.B \-q
+Quiet mode (turn verbose off)
+.TP
+.B \-a
+Do operations on all subimages/miplevels
+.TP
+.B \-\-info
+Print resolution and metadata on all inputs
+.TP
+.B \-\-stats
+Print pixel statistics on all inputs
+.TP
+.B \-\-hash
+Print SHA-1 hash of each input image
+.TP
+.B \-\-no-clobber
+Do not overwrite existing files
+.TP
+.BI \-\-threads\  %d
+Number of threads (default 0 == #cores)
+.SS Commands that write images:
+.TP
+.BI \-o\  %s
+Output the current image to the named file
+.SS Options that affect subsequent image output:
+.TP
+.BI \-d\  %s
+Set the output data format to one of: uint8, sint8, uint10, uint12, uint16, sint16, half, float, double
+.TP
+.B \-\-scanline
+Output scanline images
+.TP
+.BI \-\-tile\  %d\ %d
+Output tiled images (tilewidth, tileheight)
+.TP
+.BI \-\-compression\  %s
+Set the compression method
+.TP
+.BI \-\-quality\  %d
+Set the compression quality, 1-100
+.TP
+.BI \-\-planarconfig\  %s
+Force planarconfig (contig, separate, default)
+.TP
+.B \-\-adjust-time
+Adjust file times to match DateTime metadata
+.TP
+.B \-\-noautocrop
+Do not automatically crop images whose formats don't support separate pixel data and full/display windows
+.SS Options that change current image metadata (but not pixel values):
+.TP
+.BI \-\-attrib\  %s\ %s
+Sets metadata attribute (name, value)
+.TP
+.BI \-\-sattrib\  %s\ %s
+Sets string metadata attribute (name, value)
+.TP
+.BI \-\-caption\  %s
+Sets caption (ImageDescription metadata)
+.TP
+.BI \-\-keyword\  %s
+Add a keyword
+.TP
+.B \-\-clear-keywords
+Clear all keywords
+.TP
+.BI \-\-orientation\  %d
+Set the assumed orientation
+.TP
+.B \-\-rotcw
+Rotate orientation 90 deg clockwise
+.TP
+.B \-\-rotccw
+Rotate orientation 90 deg counter-clockwise
+.TP
+.B \-\-rot180
+Rotate orientation 180 deg
+.TP
+.BI \-\-origin\  %s
+Set the pixel data window origin (e.g. +20+10)
+.TP
+.BI \-\-fullsize\  %s
+Set the display window (e.g., 1920x1080, 1024x768+100+0, -20-30)
+.TP
+.B \-\-fullpixels
+Set the 'full' image range to be the pixel data window
+.SS Options that affect subsequent actions:
+.TP
+.BI \-\-fail\  %g
+Failure threshold difference (0.000001)
+.TP
+.BI \-\-failpercent\  %g
+Allow this percentage of failures in diff (0)
+.TP
+.BI \-\-hardfail\  %g
+Fail diff if any one pixel exceeds this error (infinity)
+.TP
+.BI \-\-warn\  %g
+Warning threshold difference (0.00001)
+.TP
+.BI \-\-warnpercent\  %g
+Allow this percentage of warnings in diff (0)
+.TP
+.BI \-\-hardwarn\  %g
+Warn if any one pixel difference exceeds this error (infinity)
+.SS Actions:
+.TP
+.BI \-\-create\  %s\ %d
+Create a blank image (args: geom, channels)
+.TP
+.BI \-\-pattern\  %s\ %s\ %d
+Create a patterned image (args: pattern, geom, channels)
+.TP
+.B \-\-unmip
+Discard all but the top level of a MIPmap
+.TP
+.BI \-\-selectmip\  %d
+Select just one MIP level (0 = highest res)
+.TP
+.BI \-\-subimage\  %d
+Select just one subimage
+.TP
+.B \-\-diff
+Print report on the difference of two images (modified by --fail, --failpercent, --hardfail, --warn, --warnpercent --hardwarn)
+.TP
+.B \-\-add
+Add two images
+.TP
+.B \-\-sub
+Subtract two images
+.TP
+.B \-\-abs
+Take the absolute value of the image pixels
+.TP
+.B \-\-flip
+Flip the image vertically (top<->bottom)
+.TP
+.B \-\-flop
+Flop the image horizontally (left<->right)
+.TP
+.B \-\-flipflop
+Flip and flop the image (180 degree rotation)
+.TP
+.BI \-\-crop\  %s
+Set pixel data resolution and offset, cropping or padding if necessary (WxH+X+Y or xmin,ymin,xmax,ymax)
+.TP
+.B \-\-croptofull
+Crop or pad to make pixel data region match the "full" region
+.TP
+.BI \-\-resize\  %s
+Resize (640x480, 50%)
+.TP
+.BI \-\-fixnan\  %s
+Fix NaN/Inf values in the image (options: none, black, box3)
+.TP
+.B \-\-pop
+Throw away the current image
+.TP
+.B \-\-dup
+Duplicate the current image (push a copy onto the stack)
+.SS Color management:
+.TP
+.BI \-\-iscolorspace\  %s
+Set the assumed color space (without altering pixels)
+.TP
+.BI \-\-tocolorspace\  %s
+Convert the current image's pixels to a named color space
+.TP
+.BI \-\-colorconvert\  %s\ %s
+Convert pixels from 'src' to 'dst' color space (without regard to its previous interpretation)
+.PP
+Known color spaces: "linear", "sRGB", "Rec709"
+.SH SEE ALSO
+.BR iconvert (1),
+.BR idiff (1),
+.BR igrep (1),
+.BR iinfo (1),
+.BR iprocess (1),
+.BR iv (1),
+.BR maketx (1).
+.SH AUTHOR
+OpenImageIO was written by Larry Gritz and the other authors and contributors.
+.PP
+This manual page was written by IRIE Shinsuke <irieshinsuke at yahoo.co.jp>,
+for the Debian project (and may be used by others).
diff --git a/debian/openimageio-tools.manpages b/debian/openimageio-tools.manpages
index 0f65186..4cd44fd 100644
--- a/debian/openimageio-tools.manpages
+++ b/debian/openimageio-tools.manpages
@@ -1 +1 @@
-debian/*.1
+debian/manpages/*.1

-- 
OpenImageIO packaging



More information about the Pkg-phototools-commits mailing list