source: OGRE/trunk/ogrenew/Docs/manual/manual_61.html @ 657

Revision 657, 12.7 KB checked in by mattausch, 19 years ago (diff)

added ogre dependencies and patched ogre sources
RevLine 
[657]1<HTML>
2<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
3<!-- Created on , 12 2006 by texi2html 1.64 -->
4<!--
5Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
6            Karl Berry  <karl@freefriends.org>
7            Olaf Bachmann <obachman@mathematik.uni-kl.de>
8            and many others.
9Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
10Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
11 
12-->
13<HEAD>
14<TITLE>OGRE Manual v1.0.7: Additive Light Masking</TITLE>
15
16<META NAME="description" CONTENT="OGRE Manual v1.0.7: Additive Light Masking">
17<META NAME="keywords" CONTENT="OGRE Manual v1.0.7: Additive Light Masking">
18<META NAME="resource-type" CONTENT="document">
19<META NAME="distribution" CONTENT="global">
20<META NAME="Generator" CONTENT="texi2html 1.64">
21<LINK TYPE="text/css" rel="stylesheet" href="../style.css"> 
22</HEAD>
23
24<BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
25
26<A NAME="SEC235"></A>
27<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
28<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_60.html#SEC233"> &lt; </A>]</TD>
29<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_57.html#SEC212"> Up </A>]</TD>
30<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt; ]</TD>
31<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="index.html#SEC_Top">Top</A>]</TD>
32<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_toc.html#SEC_Contents">Contents</A>]</TD>
33<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
34<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_abt.html#SEC_About"> ? </A>]</TD>
35</TR></TABLE>
36<HR SIZE=1>
37<H2> 7.4 Additive Light Masking </H2>
38<!--docid::SEC235::-->
39Additive light masking is about rendering the scene many times, each time representing a single light contribution whose influence is masked out in areas of shadow. Each pass is combined with (added to) the previous one such that when all the passes are complete, all the light contribution has correctly accumulated in the scene, and each light has been prevented from affecting areas which it should not be able to because of shadow casters. This is an effective technique which results in very realistic looking lighting, but it comes at a price: more rendering passes.<BR><BR>
40<P>
41
42As many technical papers (and game marketing) will tell you, rendering realistic lighting like this requires multiple passes. Being a friendly sort of engine, Ogre frees you from most of the hard work though, and will let you use the exact same material definitions whether you use this lighting technique or not (for the most part, see <A HREF="manual_61.html#SEC236">Pass Classification and Vertex Programs</A>). In order to do this technique, Ogre automatically categorises the <A HREF="manual_17.html#SEC34">3.1.2 Passes</A> you define in your materials into 3 types:
43<OL>
44<LI>ambient
45Passes categorised as 'ambient' include any base pass which is not lit by any particular light, i.e. it occurs even if there is no ambient light in the scene. The ambient pass always happens first, and sets up the initial depth value of the fragments, and the ambient colour if applicable. It also includes any emissive / self illumination contribution. No textures are rendered in this pass.
46<LI>diffuse/specular
47Passes categorised as 'diffuse/specular' (or 'per-light') are rendered once per light, and each pass contributes the diffuse ans specular colour from that single light as reflected by the diffuse / specular terms in the pass. Areas in shadow from that light are masked and are thus not updated. The resulting masked colour is added to the exisiting colour in the scene. Again, no textures are used in this pass (except for textures used for lighting calculations such as normal maps).
48<LI>decal
49Passes categorised as 'decal' add the final texture colour to the scene, which is modulated by the accumulated light built up from all the ambient and diffuse/specular passes.
50</OL>
51<P>
52
53In practice, <A HREF="manual_17.html#SEC34">3.1.2 Passes</A> rarely fall nicely into just one of these categories. For each Technique, Ogre compiles a list of 'Illumination Passes', which are derived from the user defined passes, but can be split, to ensure that the divisions between illumination pass categories can be maintained. For example, if we take a very simple material definition:
54<TABLE><tr><td>&nbsp;</td><td class=example><pre>material TestIllumination
55{
56        technique
57        {
58                pass
59                {
60                        ambient 0.5 0.2 0.2
61                        diffuse 1 0 0 
62                        specular 1 0.8 0.8 15
63                        texture_unit
64                        {
65                                texture grass.png
66                        }
67                }
68        }
69}
70</pre></td></tr></table></P><P>
71
72Ogre will split this into 3 illumination passes, which will be the equivalent of this:
73<TABLE><tr><td>&nbsp;</td><td class=example><pre>material TestIlluminationSplitIllumination
74{
75        technique
76        {
77                // Ambient pass
78                pass
79                {
80                        ambient 0.5 0.2 0.2
81                        diffuse 0 0 0
82                        specular 0 0 0
83                }
84
85                // Diffuse / specular pass
86                pass
87                {
88                        scene_blend add
89                        iteration once_per_light
90                        diffuse 1 0 0 
91                        specular 1 0.8 0.8 15
92                }
93
94                // Decal pass
95                pass
96                {
97                        scene_blend modulate
98                        lighting off
99                        texture_unit
100                        {
101                                texture grass.png
102                        }
103                }
104        }
105}
106</pre></td></tr></table>So as you can see, even a simple material requires a minimum of 3 passes when using this shadow technique, and in fact it requires (num_lights + 2) passes in the general sense. You can use more passes in your original material and Ogre will cope with that too, but be aware that each pass may turn into multiple ones if it uses more than one type of light contribution (ambient vs diffuse/specular) and / or has texture units. The main nice thing is that you get the full multipass lighting behaviour even if you don't define your materials in terms of it, meaning that your material definitions can remain the same no matter what lighting approach you decide to use.<BR><BR>
107</P><P>
108
109<A NAME="Pass Classification and Vertex Programs"></A>
110<A NAME="SEC236"></A>
111<H3> Pass Classification and Vertex Programs </H3>
112<!--docid::SEC236::-->
113Ogre is pretty good at classifying and splitting your passes to ensure that the multipass rendering approach required by additive lighting works correctly without you having to change your material definitions. However, there is one exception; when you use vertex programs, the normal lighting attributes ambient, diffuse, specular etc are not used, becuase all of that is determined by the vertex program. Ogre has no way of knowing what you're doing inside that vertex program, so you have to tell it.<BR><BR>
114<P>
115
116In practice this is very easy. Even though your vertex program could be doing a lot of complex, highly customised processing, it can still be classified into one of the 3 types listed above. All you need to do to tell Ogre what you're doing is to use the pass attributes ambient, diffuse, specular and self_illumination, just as if you were not using a vertex program. Sure, these attributes do nothing (as far as rendering is concerned) when you're using vertex programs, but it's the easiest way to indicate to Ogre which light components you're using in your vertex program. Ogre will then classify and potentially split your programmable pass based on this information - it will leave the vertex program as-is (so that any split passes will respect any vertex modification that is being done). <BR><BR>
117</P><P>
118
119Note that when classifying a diffuse/specular programmable pass, Ogre checks to see whether you have indicated the pass can be run once per light (iteration once_per_light). If so, the pass is left intact, including it's vertex and fragment programs. However, if this attribute is not included in the pass, Ogre tries to split off the per-light part, and in doing so it will disable the fragment program, since in the absence of the 'iteration once_per_light' attribute it can only assume that the fragment program is performing decal work and hence must not be used per light.<BR><BR>
120</P><P>
121
122So clearly, when you use additive light masking as a shadow technique, you need to make sure that programmable passes you use are properly set up so that they can be classified correctly. However, also note that the changes you have to make to ensure the classification is correct does not affect the way the material renders when you choose not to use additive lighting, so the principle that you should be able to use the same material definitions for all lighting scenarios still holds. Here is an example of a programmable material which will be classified correctly by the illumination pass classifier:
123<TABLE><tr><td>&nbsp;</td><td class=example><pre>// Per-pixel normal mapping Any number of lights, diffuse and specular
124material Examples/BumpMapping/MultiLightSpecular
125{
126
127        technique
128        {
129                // Base ambient pass
130                pass
131                {
132                        // ambient only, not needed for rendering, but as information
133                        // to lighting pass categorisation routine
134                        ambient 1 1 1
135                        diffuse 0 0 0
136                        specular 0 0 0 0
137                        // Really basic vertex program
138                        vertex_program_ref Ogre/BasicVertexPrograms/AmbientOneTexture
139                        {
140                                param_named_auto worldViewProj worldviewproj_matrix
141                                param_named_auto ambient ambient_light_colour
142                        }
143                       
144                }
145                // Now do the lighting pass
146                // NB we don't do decal texture here because this is repeated per light
147                pass
148                {
149                        // set ambient off, not needed for rendering, but as information
150                        // to lighting pass categorisation routine
151                        ambient 0 0 0
152                        // do this for each light
153                        iteration once_per_light
154
155               
156                        scene_blend add
157
158                        // Vertex program reference
159                        vertex_program_ref Examples/BumpMapVPSpecular
160                        {
161                                param_named_auto lightPosition light_position_object_space 0
162                                param_named_auto eyePosition camera_position_object_space
163                                param_named_auto worldViewProj worldviewproj_matrix
164                        }
165
166                        // Fragment program
167                        fragment_program_ref Examples/BumpMapFPSpecular
168                        {
169                                param_named_auto lightDiffuse light_diffuse_colour 0
170                                param_named_auto lightSpecular light_specular_colour 0
171                        }
172                       
173                        // Base bump map
174                        texture_unit
175                        {
176                                texture NMBumpsOut.png
177                                colour_op replace
178                        }
179                        // Normalisation cube map
180                        texture_unit
181                        {
182                                cubic_texture nm.png combinedUVW
183                                tex_coord_set 1
184                                tex_address_mode clamp
185                        }
186                        // Normalisation cube map #2
187                        texture_unit
188                        {
189                                cubic_texture nm.png combinedUVW
190                                tex_coord_set 1
191                                tex_address_mode clamp
192                        }
193                }
194               
195                // Decal pass
196                pass
197                {
198                        lighting off
199                        // Really basic vertex program
200                        vertex_program_ref Ogre/BasicVertexPrograms/AmbientOneTexture
201                        {
202                                param_named_auto worldViewProj worldviewproj_matrix
203                                param_named ambient float4 1 1 1 1
204                        }
205                        scene_blend dest_colour zero
206                        texture_unit
207                        {
208                                texture RustedMetal.jpg
209                        }
210                       
211                }
212        }
213}
214</pre></td></tr></table></P><P>
215
216At present only one shadow technique supports additive light masking: <A HREF="manual_58.html#SEC215">7.1 Stencil Shadows</A> through the use of SHADOWTYPE_STENCIL_ADDITIVE.
217</P><P>
218
219<A NAME="SEC237"></A>
220<H3> Static Lighting </H3>
221<!--docid::SEC237::-->
222Despite their power, additive lighting techniques have an additional limitation; they do not combine well with pre-calculated static lighting in the scene. This is because they are based on the principle that shadow is an absence of light, but since static lighting in the scene already includes areas of light and shadow, additive lighting cannot remove light to create new shadows. Therefore, if you use the additive lighting technique you must use it exclusively as your lighting solution (and you can combine it with per-pixel lighting to create a very impressive dynamic lighting solution), you cannot combine it with static lighting.
223<P>
224
225<HR SIZE=1>
226<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
227<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_60.html#SEC233"> &lt; </A>]</TD>
228<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_57.html#SEC212"> Up </A>]</TD>
229<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt; ]</TD>
230<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="index.html#SEC_Top">Top</A>]</TD>
231<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_toc.html#SEC_Contents">Contents</A>]</TD>
232<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
233<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_abt.html#SEC_About"> ? </A>]</TD>
234</TR></TABLE>
235<BR> 
236<FONT SIZE="-1">
237This document was generated
238by <I>Steve Streeting</I> on <I>, 12 2006</I>
239using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
240"><I>texi2html</I></A>
241
242</BODY>
243</HTML>
Note: See TracBrowser for help on using the repository browser.