Pamslice User Manual



Pamslice User Manual

NAME
SYNOPSIS
OPTION USAGE
DESCRIPTION
OPTIONS
SEE ALSO
HISTORY
AUTHOR

NAME

pamslice - extract one line of values out of a Netpbm image

SYNOPSIS

pamslice {-row=rownumber | -column=columnnumber} [-plane=planenumber] [imagefile]

OPTION USAGE

All options can be abbreviated to their shortest unique prefix. You may use two hyphens instead of one. You may separate an option name and its value with white space instead of an equals sign.

DESCRIPTION

This program is part of Netpbm(1)

pamslice extracts one line of tuples (pixels) out of a Netpbm image and prints their values in a table. A line means a row or column. It shows you a one-dimensional cross section of a two-dimensional image. (With the -plane option, it can be thought of as a one-dimensional cross-section of a three-dimensional image).

The table has one line per tuple, consisting of blank-separated ASCII decimal numbers. The first number is the column number if you specified a row slice or the row number if you specified a column slice. The rest of the numbers are the sample values in plane number order. For a PBM or PGM input, there is only one plane. For a PPM input, Plane 0 is red, Plane 1 is green, and Plane 2 is blue. See the specifications of the image formats for details on exactly what these numbers mean.

If you want to see all the pixels in a PPM, PGM, or PBM image in ASCII decimal, pnmtopnm -plain is a good way to do that.

OPTIONS

-row=rownumber

This indicates that the slice is to be horizontal -- i.e. one row of the
image -- and indicates which row. Rows are numbered from the top
starting with 0.

You cannot specify both -row and -column.

-column=colnumber

This indicates that the slice is to be vertical -- i.e. one column of the
image -- and indicates which column. Columns are numbered from the left
starting with 0.

You cannot specify both -row and -column.

-plane=planenumber

This specifies that you are interested in only one plane of the image
and which one. Planes are numbered from 0 and have meanings that vary
on the type of image. In a PPM image, Plane 0 is red, Plane 1 is
green, and Plane 2 is blue.

If you don’t specify -plane, you get all the planes -- each
line of output has multiple numbers in addition to the sequence number.
If you do specify -plane, each line of output contains one
number in addition to the sequence number.

-xmgr

This option causes pamslice to format the output as input for a

xmgr so you can plot it. The only difference this option makes
is that it adds header information to the beginning of the output.

SEE ALSO

pamcut(1)

pnmtopnm(1)

pnmtoplainpnm(1)

pnm(5)

HISTORY

pamslice replaced pgmslice in Netpbm 10.3 (June 2002). It was backward compatible, but worked on Netpbm images other than PGM and PBM and added the -plane and -xmgr options.

AUTHOR

Jos Dingjan <jos@tuatha.org> wrote pgmslice after being unable to find the source code to Marco Beijersbergen’s program with the same name. Bryan Henderson converted it to pamslice.







Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.