Tweek the stereo settings: allow negative eye separation.
[blender.git] / source / gameengine / PyDoc / Rasterizer.py
1 # $Id$
2 """
3 Documentation for the Rasterizer module.
4
5 Example Uses an L{SCA_MouseSensor}, and two L{KX_ObjectActuator}s to implement MouseLook::
6         # To use a mouse movement sensor "Mouse" and a 
7         # motion actuator to mouse look:
8         import Rasterizer
9         import GameLogic
10
11         # SCALE sets the speed of motion
12         SCALE=[1, 0.5]
13         
14         co = GameLogic.getCurrentController()
15         obj = co.getOwner()
16         mouse = co.getSensor("Mouse")
17         lmotion = co.getActuator("LMove")
18         wmotion = co.getActuator("WMove")
19         
20         # Transform the mouse coordinates to see how far the mouse has moved.
21         def mousePos():
22                 x = (Rasterizer.getWindowWidth()/2 - mouse.getXPosition())*SCALE[0]
23                 y = (Rasterizer.getWindowHeight()/2 - mouse.getYPosition())*SCALE[1]
24                 return (x, y)
25         
26         pos = mousePos()
27         
28         # Set the amount of motion: X is applied in world coordinates...
29         lmotion.setTorque(0.0, 0.0, pos[0], False)
30         # ...Y is applied in local coordinates
31         wmotion.setTorque(-pos[1], 0.0, 0.0, True)
32         
33         # Activate both actuators
34         GameLogic.addActiveActuator(lmotion, True)
35         GameLogic.addActiveActuator(wmotion, True)
36         
37         # Centre the mouse
38         Rasterizer.setMousePosition(Rasterizer.getWindowWidth()/2, Rasterizer.getWindowHeight()/2)
39
40         
41 """
42
43 def getWindowWidth():
44         """
45         Gets the width of the window (in pixels)
46         
47         @rtype: integer
48         """
49 def getWindowHeight():
50         """
51         Gets the height of the window (in pixels)
52         
53         @rtype: integer
54         """
55 def makeScreenshot(filename):
56         """
57         Writes a screenshot to the given filename.
58         
59         If filename starts with // the image will be saved relative to the current directory.
60         If the filename contains # it will be replaced with the frame number.
61         
62         The standalone player saves .png files. It does not support colour space conversion 
63         or gamma correction.
64         
65         When run from Blender, makeScreenshot supports Iris, IrisZ, TGA, Raw TGA, PNG, HamX, and Jpeg.
66         Gamma, Colourspace conversion and Jpeg compression are taken from the Render settings panels.
67         
68         @type filename: string
69         """
70
71 def enableVisibility(visible):
72         """
73         Doesn't really do anything...
74         """
75
76 def showMouse(visible):
77         """
78         Enables or disables the operating system mouse cursor.
79         
80         @type visible: boolean
81         """
82
83 def setMousePosition(x, y):
84         """
85         Sets the mouse cursor position.
86         
87         @type x, y: integer
88         """
89
90 def setBackgroundColor(rgba):
91         """
92         Sets the window background colour.
93         
94         @type rgba: list [r, g, b, a]
95         """
96
97 def setMistColor(rgb):
98         """
99         Sets the mist colour.
100         
101         @type rgb: list [r, g, b]
102         """
103
104 def setMistStart(start):
105         """
106         Sets the mist start value.  Objects further away than start will have mist applied to them.
107         
108         @type start: float
109         """
110
111 def setMistEnd(end):
112         """
113         Sets the mist end value.  Objects further away from this will be coloured solid with
114         the colour set by setMistColor().
115         
116         @type end: float
117         """
118         
119 def setEyeSeparation(eyesep):
120         """
121         Sets the eye separation for stereo mode.
122         
123         @param eyesep: The distance between the left and right eye.
124         @type eyesep: float
125         """
126
127 def getEyeSeparation():
128         """
129         Gets the current eye separation for stereo mode.
130         
131         @rtype: float
132         """
133         
134 def setFocalLength(focallength):
135         """
136         Sets the focal length for stereo mode.
137         
138         @param focallength: The focal length.  
139         @type focallength: float
140         """
141
142 def getFocalLength():
143         """
144         Gets the current focal length for stereo mode.
145         
146         @rtype: float
147         """