X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=docs-mini%2FREADME.multiscreen;h=6dd8aa3fc418bedb411710f7b5594c9c9995dd8b;hb=10e6cc016bcfe39332dce2f360eaa90ff8366cf2;hp=9954f13f9b62bd4d9d61836e07f8a16e26c1cd2e;hpb=6f802959cef6ed5d00640c80b6209a994ff871b5;p=flightgear.git
diff --git a/docs-mini/README.multiscreen b/docs-mini/README.multiscreen
index 9954f13f9..6dd8aa3fc 100644
--- a/docs-mini/README.multiscreen
+++ b/docs-mini/README.multiscreen
@@ -81,6 +81,31 @@ window, camera, or gui tags.
width, height - int
The dimensions of the viewport
+ physical-dimensions
+ The physical dimension of the projection surface.
+ Use this together with the master-perspective, right-of-perspective
+ left-of-perspective, above-perspective, below-perspective or
+ reference-points-perspective
+
+ width, height - double
+ The dimensions of the projection plane, if unset the veiwport values
+ are taken as default.
+
+ bezel
+ Gives informantion about the bezel of monitors for a seamless view.
+
+ right
+ right bezel with in the same units than with and height above
+
+ left
+ left bezel with in the same units than with and height above
+
+ top
+ top bezel with in the same units than with and height above
+
+ bottom
+ bottom bezel with in the same units than with and height above
+
view
The view node specifies the origin and direction of the camera in
relation to the whole camera group. The coordinate system is +y up,
@@ -113,6 +138,11 @@ window, camera, or gui tags.
and other background elements may not be drawn if the view plane is
closer than 120km.
+ fixed-near-far - bool
+ If true the near and far values are taken from above, if false
+ near and far are adapted from the scene and visibility.
+ Defaults to true.
+
offset-x, offset-y - double
Offsets of the viewing volume specified by the other parameters in
the near plane, in meters.
@@ -129,10 +159,101 @@ window, camera, or gui tags.
near, far - double
The near and far planes, in meters from the camera eye point.
+ fixed-near-far - bool
+ If true the near and far values are taken from above, if false
+ near and far are adapted from the scene and visibility.
+ Defaults to true.
+
ortho
This specifies an orthographic view. The parameters are the sames as
the frustum node's.
+ fixed-near-far - bool
+ If true the near and far values are taken from above, if false
+ near and far are adapted from the scene and visibility.
+ Defaults to true.
+
+ master-perspective
+ Defines a persective projection matrix for use as the leading display
+ in a seamless multiscreen configuration. This kind of perspective
+ projection is zoomable.
+
+ eye-distance - double
+ The distance of the eyepoint from the projection surface in units of
+ the physical-dimensions values above.
+
+ x-offset, y-offset - double
+ Offset of the eyelpint from the center of the screen in units of
+ the physical-dimensions values above.
+
+ left-of-perspective, right-of-perspective, above-perspective,
+ below-perspective
+ Defines a perspective projection matrix for use as derived display
+ in a seamless multiscreen configuration. The projection matrix
+ is computed so that the respective edge of this display matches the
+ assiciated other edge of the other display. For example the right edge
+ of a left-of-perspective display matches the left edge of the parent
+ display. This also works with different zoom levels, leading to distorted
+ but still seamless multiview configurations.
+ The bezel with configured in the physical dimensions of this screen and
+ the parent screen are taken into account for this type of projection.
+
+ parent-camera - string
+ Name of the parent camera.
+
+ reference-points-perspective
+ Defines a perspective projection matrix for use as derived display
+ in a seamless multiscreen configuration. This type is very similar to
+ left-of-perspective and friends. It is just a more flexible but less
+ convenient way to get the same effect. A child display is configured
+ by 2 sets of reference points one in this current camera and one in
+ the parrent camera which should match in the final view.
+
+ parent-camera - string
+ Name of the parent camera.
+
+ this
+ reference points for this projection.
+
+ point - array of two points
+
+ x, y - double
+ x and y coodinates of the reference points in units of this
+ physical-dimensions.
+
+ parent
+ reference points for the parent projection.
+
+ point - array of two points
+
+ x, y - double
+ x and y coodinates of the reference points in units of the
+ parents physical-dimensions.
+
+ texture
+ This tag indicates that the camera renders to a texture instead of the
+ framebuffer. For now the following tags are supported, but obviously
+ different texture formats should be specified too.
+ name - string
+ The name of the texture. This can be referred to by other cameras.
+ width, height - double
+ The dimensions of the texture
+
+ panoramic-distortion
+ This tag cause the camera to create distortion geometry that
+ corrects for projection onto a spherical screen. It is equivalent to
+ the --panoramic-sd option to osgviewer.
+
+ texture - string
+ The name of a texture, created by another camera, that will be
+ rendered on the distortion correction geometry.
+
+ radius - double
+ Radius of string
+
+ collar - double
+ size of screen collar.
+
gui
This is a special camera node that displays the 2D GUI.
@@ -313,3 +434,228 @@ accounted for.
+
+This example renders the scene for projection onto a spherical screen.
+
+
+
+
+
+
+
+ main
+
+ 0
+ 0
+
+ 1024
+ 768
+
+
+ 0
+
+
+ 0.133
+ -0.133
+ -.1668
+ .1668
+ 0.4
+ 120000.0
+
+
+ mainview
+ 1024
+ 768
+
+
+
+ main
+
+ 768
+ 0
+ 0
+ 1024
+ -1.0
+ 1.0
+
+
+ mainview
+
+
+
+
+ main
+
+
+
+
+
+
+
+Here is an example for a 3 screen seamless zoomable multiscreen
+configuration using 3 533mmx300mm displays each with a 23mm bezel.
+The side views are angled with 45 deg.
+The commented out reference-points-perspective shows the
+aequivalent configuration than the active right-of-perspective.
+This is done by just using two reference points at the outer
+edge of the bezel of the respective display.
+
+
+
+
+
+ 0.0
+
+
+
+
+
+
+ 0.0
+
+ 0
+ 0
+ true
+
+
+
+ 0.1
+
+ 0
+ 1
+ true
+
+
+
+ CenterCamera
+
+ 0.0
+
+
+ 0
+ 0
+ 1920
+ 1080
+
+
+ 0.0
+ 0.0
+ 0.0
+
+
+
+ 533
+ 300
+
+ 23
+ 23
+ 23
+ 23
+
+
+
+
+ 450
+ 0
+ 130
+
+
+
+ RightCamera
+
+ 0.0
+
+
+ 1920
+ 0
+ 1920
+ 1080
+
+
+ -45
+ 0
+ 0
+
+
+
+ 533
+ 300
+
+ 23
+ 23
+ 23
+ 23
+
+
+
+ CenterCamera
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ LeftCamera
+
+ 0.1
+
+
+ 0
+ 0
+ 1920
+ 1080
+
+
+ 45
+ 0
+ 0
+
+
+
+ 533
+ 300
+
+ 23
+ 23
+ 23
+ 23
+
+
+
+ CenterCamera
+
+
+
+
+ 0.0
+
+
+
+
+
+