CavePainting/technical user documentation: Difference between revisions

From VrlWiki
Jump to navigation Jump to search
Jadrian Miles (talk | contribs)
No edit summary
No edit summary
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
== Running in Mono ==
To record a CavePainting session live in the Cave using a video or still camera, it's preferable to run in mono video mode so that the left and right image don't get ghosted on top of each other.  Kiosk support for this mode is limited right now, and Jadrian doesn't have system permissions to add support, so here's an explanation of how CavePainting is run in stereo and how it ought to run in mono.
This is the chain of calls initiated by selecting a CavePainting button from the kiosk:
<kiosk button>
| ~cavedemo/kiosk/<tab>/<button>/run
| | $G = /share/gfx2/dollar-g/tools/linux
| | $G/bin/cavepainting-cave
| | | cd $G/lib/kuchora/apps
| | | $G/bin/vrg3d-runcave-winserv -x ./cavepainting-gcc3-d -f <common.cfg> -f <cave.cfg>
| | | | <foreach of left, front, right, floor>
| | | | ./cavepainting-gcc3-d cave<left>-winserv -c CLUSTER_NODE_ID=1 -f <common.cfg> -f <cave.cfg>
The only difference to run in mono is the last command in the chain of calls, which should be:
| | | | ./cavepainting-gcc3-d cave<left>-winservmono -c CLUSTER_NODE_ID=1 -f <common.cfg> -f <cave.cfg>
See for example the files
* <tt>/share/cs137/dollar-g-cs137/tools/linux/bin/cavepainting-cavemono</tt> and
* <tt>/share/cs137/dollar-g-cs137/tools/linux/bin/vrg3d-runcave-winservmono</tt>
and contrast to
* <tt>/share/gfx2/dollar-g/tools/linux/bin/cavepainting-cave</tt> and
* <tt>/share/gfx2/dollar-g/tools/linux/bin/vrg3d-runcave-winserv</tt>
Modified versions of these two files, with mono support, were written 2009-06-01 to:
* <tt>/home/jadrian/cavepainting-cavemono</tt> and
* <tt>/home/jadrian/vrg3d-runcave-winservmono</tt>
== Importing Bat Marker Data ==
== Importing Bat Marker Data ==
CavePainting can import data representing the 3D positions of points through time.  A marker file is a plain-text <abbr title="comma-separated value">CSV</abbr> file in which each row is a time step and each group of four columns are the X, Y, and Z positions for a marker, followed by the number 1 in the fourth column.  For example, the following describes two markers' positions (sets of four columns) over three timesteps (rows):
CavePainting can import data representing the 3D positions of points through time.  A marker file is a plain-text <abbr title="comma-separated value">CSV</abbr> file in which each row is a time step and each group of four columns are the X, Y, and Z positions for a marker, followed by the number 1 in the fourth column.  For example, the following describes two markers' positions (sets of four columns) over three timesteps (rows):

Latest revision as of 15:08, 19 September 2013

Importing Bat Marker Data

CavePainting can import data representing the 3D positions of points through time. A marker file is a plain-text CSV file in which each row is a time step and each group of four columns are the X, Y, and Z positions for a marker, followed by the number 1 in the fourth column. For example, the following describes two markers' positions (sets of four columns) over three timesteps (rows):

0.5,0.5,0.5,1,0.2,-0.2,0.3,1
0.6,0.4,0.5,1,0.3,-0.1,0.2,1
0.7,0.3,0.4,1,0.4,0.0,0.1,1

Config file variables:

  • BatMarkersFile: path to a marker file.
  • BatMarkersScale: a scaling parameter to map the coordinates in the marker file to world coordinates in CavePainting.
  • BatMarkersSize: the radius, in the world coordinate frame, of the spheres representing the markers.
  • BatMarkersTimestepIncrement: the number of rows in the marker file to skip between creating frames.
  • BatMarkersFrame: ???