[9fans] marsv man page

[okamoto@granite.cias.osakafu-u.ac.jp]

[-- Attachment #1: Type: text/plain, Size: 156 bytes --]

I included the man page of marsv(1pub).
If you have any suggestions to make it more readable English,
please let me know PERSONALLY.

Thanks,

Kenji

[-- Attachment #2: Type: text/plain, Size: 3931 bytes --]

.TH MARSV 1
.SH NAME
marsv \- viewes PDS images and measures altitude of Mars surface using
MOLA grid data, and outputts its result to postscript formatted file
.SH SYNOPSIS
.B marsv
.SH DESCRIPTION
.I Marsv
is a GUI program to measure Mars altitude, latitude and longitude at the place
pointed by mouse on a Qube image or MOLA grid data, and to draw its contour
map laying over the image using MOLA grid data, and to output postscript file
for printing.
.PP
Marsv is aimed to make acme like user interface for Mars image
manipulation additionally with 3 button menu bar, where button 1 (left button)
shows the category name of the item, button 2 (middle button) does the indicated
job by the menu name, and button 3 (right button) lists the items of that category
and let choose one.
.PP
In Altitude menu of ISISmenu category of QUBELoad menu or MOLALoad menu,
button 1 shows the values of altitude, longitude and latitude pointed by the mouse.
When the mouse in this mode is dragged, those values will be shown continuously,
which makes you to understand the real shape of the object you are now watching.
In Contour menu of ISISmenu category of QUBELoad menu, dragging button 3 can
make correction of the minor discrepancy between that indicated by MOLA grid data
and by Qube image data.  After this recalibration, remapping of the countour will
be necessary to get a correct one.   The values of longitude and latitude
showed in Altitude menu of ISISmenu category are also recalculated by the above
procedure.  In short, you have to confirm the accuracy of those data shown by mouse
by showing contour maps, and if necessary, that recalibration should be done.
Those two values will not usually match each other from our experiences.
.PP
Mrasv designed as an single threaded concurrent program using thread(2) and
control(2) libraries of Plan 9.   Marsv assumes there is a MOLA grid data (such as
ieg0031t.img for 0.031 degree grid) under $home/data/mars/mola/ directory.
Additionally, marsv can read many other PDS formatted images of other planet,
and make a bit of annotations using Pen menu by changing colors from Palette
menu.
.SH EXTENSION
Four general purpose user interfaces with its own window are implemented as shown
in struct Form, struct Filebrowse, struct Select and struct Viewer.   Those structures are
constructed using two new basic structures, controlling those shape, position or
behaviours called struct Win and struct WinComm.
.PP
Struct Canvas is prepared to provide layer structures to marsv image by using memdraw
and layer functions in draw(2) libraries of Plan 9, which is a mechanism to use multiple
memory layers to draw for altitude, latitude and longitude data at the moving mouse
point.   Struct Layer and CanvasBase are used as their base structures.   The other
many structures from control(2) library are also used through newly defined structure
of Wincontrol.
.PP
We added struct Textbutton3 for our usage of 3 button menu bar to
control(2) library.  You may want to copy textbutton3.c file to /sys/src/libcontrol,
and do mk the control library with some change to /sys/include/control.h and
/sys/src/libcontrol/control.c and mkfile to make those usable..
.PP
If you want to extend functionarities to marsv, please refer to files such as imager.c
or marsv.c.
.SH BUGS
Some images with larger width may fail to be shown, because of the limit
of 9p protocol.  16 bit color is not supported to save the created image.  You will
lose true color from saving in 16 bit true color mode of Plan 9.
To input file name etc. onto the entry box, you have to hit Enter key at the end
to ensure the input, which is not a bug though.   There may be many other bugs.
.SH AUTHORS
Marsv is written by Yoshitatsu Suzuki and Kenji Okamoto of Osaka Prefecture
University.   We are financially supported by the citizens of Osaka Prefecure Japan.