.\"
.\" OpenSlide, a library for reading whole slide image files
.\"
.\" Copyright (c) 2007-2012 Carnegie Mellon University
.\" All rights reserved.
.\"
.\" OpenSlide is free software: you can redistribute it and/or modify
.\" it under the terms of the GNU Lesser General Public License as
.\" published by the Free Software Foundation, version 2.1.
.\"
.\" OpenSlide 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 Lesser General Public License for more details.
.\"
.\" You should have received a copy of the GNU Lesser General Public
.\" License along with OpenSlide. If not, see
.\" <http://www.gnu.org/licenses/>.
.\"


.\" See man-pages(7) for formatting conventions.


.TH OPENSLIDE-WRITE-PNG 1 2012-02-24 "OpenSlide 3.4.1" "User Commands"

.mso www.tmac

.SH NAME
openslide-write-png \- Write a region of a virtual slide to a PNG

.SH SYNOPSIS
.BR "openslide-write-png " [ --help "] [" --version ]
.I slide-file x y level width height output-file

.SH DESCRIPTION
Write a region of the specified
.I level
of a virtual slide to a PNG image.
.I x
and
.I y
are pixel coordinates in level 0, the highest-resolution slide level.
.I width
and
.I height
are pixel dimensions in the specified
.IR level .

The dimensions of each level of a slide can be obtained with
.BR openslide-show-properties (1).

.SH OPTIONS
.TP
.B --help
Display usage summary.

.TP
.B --version
Display version and copyright information.

.SH EXIT STATUS
.B openslide-write-png
returns 0 on success, 1 if an error occurred, or 2 if the arguments are
invalid.

.SH COPYRIGHT
Copyright \(co 2007-2012 Carnegie Mellon University and others

OpenSlide is free software: you can redistribute it and/or modify it under
the terms of the
.URL http://gnu.org/licenses/lgpl-2.1.html "GNU Lesser General Public License, version 2.1" .

OpenSlide comes with NO WARRANTY, to the extent permitted by law.  See the
GNU Lesser General Public License for more details.

.SH SEE ALSO
.BR openslide-quickhash1sum (1),
.BR openslide-show-properties (1)