From Headus Docs

Revision as of 04:36, 25 May 2015 (edit) Headus (Talk | contribs) (→Externally Driven Viewpoint) ← Previous diff		Current revision (03:10, 27 June 2015) (edit) (undo) Headus (Talk | contribs) (→Other Command Line Parameters)
(6 intermediate revisions not shown.)
Line 3:		Line 3:
	[[Image:Panels.jpg|right|thumb|Panels Parameters]]On plyview command line:		[[Image:Panels.jpg|right|thumb|Panels Parameters]]On plyview command line:
-	-panels,<width>,<height>,<depth>,<base>,<scale>	+	-panels,<quality>,<width>,<height>,<depth>,<base>,<scale>
-		+
-	width : of display panel in mm	+	quality : render quality, 1 lowest, 3 good, 6 max
-	height : of display panel in mm	+	width : of display panel in mm
-	depth : distance between front and back panels	+	height : of display panel in mm
-	base : offset of panels from ground plane	+	depth : distance between front and back panels
-	scale : scale panels up or down to suit mesh size	+	base : offset of panels from ground plane
		+	scale : scale panels up or down to suit mesh size
	Default settings:		Default settings:
-	-panels,296,475,401,375,2	+	-panels,3,296,475,401,375,2
	== Defining Panoramic Background ==		== Defining Panoramic Background ==
Line 32:		Line 33:
	-driven,<file.txt>		-driven,<file.txt>
-	Then write values into the named text file from other applications, adding an optional second line for secondary viewer:	+	Then write values into the named text file from other application, adding a second line for secondary viewer:
	<inclination-degrees> <azimuth-degrees> <distance-mm> <object-spin-degrees>		<inclination-degrees> <azimuth-degrees> <distance-mm> <object-spin-degrees>
	<inclination-degrees> <azimuth-degrees> <distance-mm>		<inclination-degrees> <azimuth-degrees> <distance-mm>
		+
		+	If there's no second line, a standard (non-parallaxed) view is assigned to the non-facing panels.
	For example:		For example:
Line 46:		Line 49:
	Write next pose number into a file called '''blend_next.txt'''. File will be deleted when that pose becomes active, so driving application can look for that if required. If no new '''blend_next.txt''' file is created, viewer reverts to random pose selection.		Write next pose number into a file called '''blend_next.txt'''. File will be deleted when that pose becomes active, so driving application can look for that if required. If no new '''blend_next.txt''' file is created, viewer reverts to random pose selection.
		+
		+	== Other Command Line Parameters ==
		+
		+	; -auto : bootstraps to full screen multi-panel rendering automatically. Don't remove.
		+
		+	; -labels : show panel number, viewer number and fps rate labels. Can remove.
		+
		+	; -shade : starts up shaded. Don't remove.
		+
		+	; -blend,file.conf : defines location of config file for animation parameters.
		+
		+	; -n,<file> : normal map. Don't remove.
		+
		+	; -t,<file> : color map. Don't remove.
		+
		+	; -Db,<rgb> : background color.

---

Current revision

Contents 1 Defining Panels Geometry 2 Defining Panoramic Background 3 Externally Driven Viewpoint 4 Forcing Next Pose 5 Other Command Line Parameters

[edit] Defining Panels Geometry

On plyview command line:

 -panels,<quality>,<width>,<height>,<depth>,<base>,<scale>

 quality : render quality, 1 lowest, 3 good, 6 max
 width   : of display panel in mm
 height  : of display panel in mm
 depth   : distance between front and back panels
 base    : offset of panels from ground plane
 scale   : scale panels up or down to suit mesh size

Default settings:

 -panels,3,296,475,401,375,2

[edit] Defining Panoramic Background

On plyview command line:

 -pano,<spin>,<min>,<max>,<file>

 spin : spin dome around in degrees
 min  : done starts here in degrees
 max  : done ends here in degrees
 file : filename of 360 panoramic photo

[edit] Externally Driven Viewpoint

On plyview command line:

 -driven,<file.txt>

Then write values into the named text file from other application, adding a second line for secondary viewer:

 <inclination-degrees> <azimuth-degrees> <distance-mm> <object-spin-degrees>
 <inclination-degrees> <azimuth-degrees> <distance-mm>

If there's no second line, a standard (non-parallaxed) view is assigned to the non-facing panels.

For example:

 120.4 10.2 3232.4 77.4

I think distance here would be in the original object scale, so if the panels to object relative scales have been adjusted (see above) then this distance could possibly need to be adjusted. For example, if the panels scaling factor is "2", then multiply the real eye distance by that factor for use in the driven file.

[edit] Forcing Next Pose

Write next pose number into a file called blend_next.txt. File will be deleted when that pose becomes active, so driving application can look for that if required. If no new blend_next.txt file is created, viewer reverts to random pose selection.

[edit] Other Command Line Parameters

-auto 

bootstraps to full screen multi-panel rendering automatically. Don't remove.

-labels 

show panel number, viewer number and fps rate labels. Can remove.

-shade 

starts up shaded. Don't remove.

-blend,file.conf 

defines location of config file for animation parameters.

-n,<file> 

normal map. Don't remove.

-t,<file> 

color map. Don't remove.

-Db,<rgb> 

background color.