pixelpos

NAME

pixelpos - extracts pixel values of points marked on an image and send them to the standard output.

SYNOPSIS

DESCRIPTION

pixelpos displays an image and offers the possibility to define points on it (marked by small rings). Left clicking defines a point and sent its coordinates to 'standard error'. When the program is closed (pressing 'q'), the image coordinates of the points are sent to 'standard output' (see data format below). Alternatively, pressing key 'x', the coordinates of the selected point is directly sent to 'standard output'. By default, the last point marked is selected (red ring), the other points are unselected (grey rings). Any existing point can be selected or its position changed using the mouse (explained below). The image can be a jpg, a png or a tiff image (the type is recognised by the extension, 16bits images can also be opened). In order to offer very fast zooming and panning, only a part of the image is shown at a particular moment with full accuracy, the rest of the image is shown at a lower resolution. The region of interest can be changed interactively using the mouse. The luminosity and contrast of the region of interest can be changed very fast using the keyboard or reset to its original value.

OPTIONS

-h,--help,-?: Returns the manual page

-xm INTEGER: INTEGER is the x coordinate of the bottom left corner of the bounding box.

-xM INTEGER: INTEGER is the x coordinate of the upper right corner of the bounding box.

-ym INTEGER: INTEGER is the y coordinate of the bottom left corner of the bounding box.

-yM INTEGER: INTEGER is the y coordinate of the upper right corner of the bounding box.

-i FILE, --input FILE: FILE contains image coordinates of points on the image which are imported when the file opens.

-q,--quiet: Just output what is requested, no extra information.

-nof: the points are not sent to standard output when the program is closed (see effect of key 'x' below)

DATA FORMAT

> number_of_points

> ref_number_1 u1 v1

> ref_number_2 u2 v3

> ...

> ref_number_n un vn

INTERACTIONS

Mouse

left mouse button: if inside the ring marking an existing point: move the point; if outside any ring marking an existing point: create a new point

control + left button: 1st time: select 1st corner of a window; 2d time: select 2d corner of a window and return the average pixel coordinate in the window

shift + left button: translate

middle button: idem (translate)

right button: if outside any ring marking an existing point: zoom. if inside the ring marking an existing point: select the point.

control + shift + left button: recentre the region of interest.: keyboard
e: erase selected point
x: export selected point
w: wireframe mode (points are seen more clearly)
s: solid mode (the image is seen)
q: quit (and write the extracted points on the standard output)
1: lower contrast
2: higher contrast
4: lower luminosity
5: higher luminosity
0: reset contrast and luminosity

AUTHORS

Written by Pierre Smars (first version: 2001)

BUGS

Reports of bugs or problems should be submitted via electronic mail to <smars@yuntech.edu.tw>.

COPYRIGHT

Copyright (C) 2015 Pierre Smars. License GPLv2 <http://www.gnu.org/licenses/gpl-2.0.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.