CavePainting/technical user documentation - Revision history

Ryan Cabeen at 15:08, 19 September 2013

2013-09-19T15:08:23Z

← Older revision		Revision as of 15:08, 19 September 2013
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>/users/jadrian/cavepainting-cavemono</tt> and
	* <tt>/users/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):

Jadrian Miles: /* Running in Mono */

2009-06-02T03:59:05Z

Running in Mono

← Older revision		Revision as of 03:59, 2 June 2009
Line 23:		Line 23:
	* <tt>/share/gfx2/dollar-g/tools/linux/bin/vrg3d-runcave-winserv</tt>		* <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:		Modified versions of these two files, with mono support, were written 2009-06-01 to:
	* <tt>/~~home~~/jadrian/cavepainting-cavemono</tt> and		* <tt>/users/jadrian/cavepainting-cavemono</tt> and
	* <tt>/~~home~~/jadrian/vrg3d-runcave-winservmono</tt>		* <tt>/users/jadrian/vrg3d-runcave-winservmono</tt>

	== Importing Bat Marker Data ==		== Importing Bat Marker Data ==

Jadrian Miles at 03:24, 2 June 2009

2009-06-02T03:24:39Z

← Older revision		Revision as of 03:24, 2 June 2009
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):

Jadrian Miles at 18:47, 2 December 2008

2008-12-02T18:47:29Z

← Older revision		Revision as of 18:47, 2 December 2008
Line 1:		Line 1:
	~~{{stub}}~~

	== 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):

Jadrian Miles: /* Importing Bat Marker Data */

2008-12-02T18:47:21Z

Importing Bat Marker Data

← Older revision		Revision as of 18:47, 2 December 2008
Line 9:		Line 9:
	</pre>		</pre>

	Config ~~File Variables~~:		Config file variables:
	* '''<code>BatMarkersFile</code>''': path to a marker file.		* '''<code>BatMarkersFile</code>''': path to a marker file.
	* '''<code>BatMarkersScale</code>''': a scaling parameter to map the coordinates in the marker file to world coordinates in CavePainting.		* '''<code>BatMarkersScale</code>''': a scaling parameter to map the coordinates in the marker file to world coordinates in CavePainting.

Jadrian Miles: /* Config File Variables */

2008-12-02T18:46:28Z

Config File Variables

← Older revision		Revision as of 18:46, 2 December 2008
Line 1:		Line 1:
	{{stub}}		{{stub}}

	== ~~Config File Variables ==~~		== 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):
	** '''<~~code~~>~~BatMarkersFile~~</~~code~~>~~''': path to a 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):
	<pre>		<pre>
	0.5,0.5,0.5,1,0.2,-0.2,0.3,1		0.5,0.5,0.5,1,0.2,-0.2,0.3,1
Line 9:		Line 8:
	0.7,0.3,0.4,1,0.4,0.0,0.1,1		0.7,0.3,0.4,1,0.4,0.0,0.1,1
	</pre>		</pre>
	** '''<code>BatMarkersScale</code>''': a scaling parameter to map the coordinates in the ~~markers~~ file to world coordinates in CavePainting.
	** '''<code>BatMarkersSize</code>''': the radius, in the world coordinate frame, of the spheres representing the markers.		Config File Variables:
	** '''<code>BatMarkersTimestepIncrement</code>''': the number of rows in the ~~markers~~ file to skip between creating frames.		* '''<code>BatMarkersFile</code>''': path to a marker file.
	** '''<code>BatMarkersFrame</code>''': ???		* '''<code>BatMarkersScale</code>''': a scaling parameter to map the coordinates in the marker file to world coordinates in CavePainting.
			* '''<code>BatMarkersSize</code>''': the radius, in the world coordinate frame, of the spheres representing the markers.
			* '''<code>BatMarkersTimestepIncrement</code>''': the number of rows in the marker file to skip between creating frames.
			* '''<code>BatMarkersFrame</code>''': ???

	[[Category:CavePainting]][[Category:User Documentation]]		[[Category:CavePainting]][[Category:User Documentation]]

Jadrian Miles: /* Config File Variables */

2008-12-02T18:35:24Z

Config File Variables

← Older revision		Revision as of 18:35, 2 December 2008
Line 3:		Line 3:
	== Config File Variables ==		== Config File Variables ==
	* Importing Bat Marker Data		* Importing Bat Marker Data
	** '''<code>BatMarkersFile</code>''': a 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.		** '''<code>BatMarkersFile</code>''': path to a 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):
			<pre>
			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
			</pre>
	** '''<code>BatMarkersScale</code>''': a scaling parameter to map the coordinates in the markers file to world coordinates in CavePainting.		** '''<code>BatMarkersScale</code>''': a scaling parameter to map the coordinates in the markers file to world coordinates in CavePainting.
	** '''<code>BatMarkersSize</code>''': the radius, in the world coordinate frame, of the spheres representing the markers.		** '''<code>BatMarkersSize</code>''': the radius, in the world coordinate frame, of the spheres representing the markers.

Jadrian Miles: New page: {{stub}} == Config File Variables == * Importing Bat Marker Data ** '''`BatMarkersFile`''': a CSV file in which each row is a time step and each group of four columns are the X...

2008-11-21T02:17:54Z

New page: {{stub}} == Config File Variables == * Importing Bat Marker Data ** '''<code>BatMarkersFile</code>''': a CSV file in which each row is a time step and each group of four columns are the X...

New page

{{stub}}

== Config File Variables ==
* Importing Bat Marker Data
** '''<code>BatMarkersFile</code>''': a 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.
** '''<code>BatMarkersScale</code>''': a scaling parameter to map the coordinates in the markers file to world coordinates in CavePainting.
** '''<code>BatMarkersSize</code>''': the radius, in the world coordinate frame, of the spheres representing the markers.
** '''<code>BatMarkersTimestepIncrement</code>''': the number of rows in the markers file to skip between creating frames.
** '''<code>BatMarkersFrame</code>''': ???

[[Category:CavePainting]][[Category:User Documentation]]

CavePainting/technical user documentation - Revision history

Ryan Cabeen at 15:08, 19 September 2013

Jadrian Miles: /* Running in Mono */

Jadrian Miles at 03:24, 2 June 2009

Jadrian Miles at 18:47, 2 December 2008

Jadrian Miles: /* Importing Bat Marker Data */

Jadrian Miles: /* Config File Variables */

Jadrian Miles: /* Config File Variables */

Jadrian Miles: New page: {{stub}} == Config File Variables == * Importing Bat Marker Data ** '''BatMarkersFile''': a CSV file in which each row is a time step and each group of four columns are the X...

Jadrian Miles: New page: {{stub}} == Config File Variables == * Importing Bat Marker Data ** '''`BatMarkersFile`''': a CSV file in which each row is a time step and each group of four columns are the X...