From Headus Docs

Revision as of 06:12, 22 May 2015 (edit) Headus (Talk | contribs) (→Defining Panels Geometry) ← Previous diff		Current revision (03:10, 27 June 2015) (edit) (undo) Headus (Talk | contribs) (→Other Command Line Parameters)
(17 intermediate revisions not shown.)
Line 1:		Line 1:
	== Defining Panels Geometry ==		== Defining Panels Geometry ==
-
	[[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>
		+
		+	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
		+
		+	== Defining Panoramic Background ==
		+
		+	[[Image:Pano.jpg|right|thumb|Pano Parameters]]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
		+
		+	== 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
		+
		+	{{warning|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.}}
		+
		+	== 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.
		+
		+	== 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.
-	width : of display panel in mm	+	; -n,<file> : normal map. Don't remove.
-	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	+
-	Defaults;	+	; -t,<file> : color map. Don't remove.
-	-panels,296,475,401,375,2	+	; -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.