Kezdőlap Felfedezés Súgó
Bejelentkezés
java
/
jMonkeyEngine-wiki
tükrözi: https://github.com/jMonkeyEngine/wiki.git
2
0
Másolás 0
Fájlok Problémák 0 Wiki
Fa: eda43e4eb7
Branch-ok Tag-ek
jMonkeyEngine-w...
/
jme3
/
advanced
/
light_and_shadow.html

light_and_shadow.html 53 KB
Előzmények Nyers

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972 
  1. <!DOCTYPE html>
    2. 

  2. <html lang="en">
    3. 

  3. <head>
    4. 

  4. <meta charset="UTF-8">
    5. 

  5. <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
    6. 

  6. <meta name="viewport" content="width=device-width, initial-scale=1.0">
    7. 

  7. <meta name="generator" content="Asciidoctor 1.5.4">
    8. 

  8. <title>Light and Shadow</title>
    9. 

  9. <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700">
    10. 

  10. <style>
    11. 

  11. /* Asciidoctor default stylesheet | MIT License | http://asciidoctor.org */
    12. 

  12. /* Remove comment around @import statement below when using as a custom stylesheet */
    13. 

  13. /*@import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700";*/
    14. 

  14. article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}
    15. 

  15. audio,canvas,video{display:inline-block}
    16. 

  16. audio:not([controls]){display:none;height:0}
    17. 

  17. [hidden],template{display:none}
    18. 

  18. script{display:none!important}
    19. 

  19. html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}
    20. 

  20. body{margin:0}
    21. 

  21. a{background:transparent}
    22. 

  22. a:focus{outline:thin dotted}
    23. 

  23. a:active,a:hover{outline:0}
    24. 

  24. h1{font-size:2em;margin:.67em 0}
    25. 

  25. abbr[title]{border-bottom:1px dotted}
    26. 

  26. b,strong{font-weight:bold}
    27. 

  27. dfn{font-style:italic}
    28. 

  28. hr{-moz-box-sizing:content-box;box-sizing:content-box;height:0}
    29. 

  29. mark{background:#ff0;color:#000}
    30. 

  30. code,kbd,pre,samp{font-family:monospace;font-size:1em}
    31. 

  31. pre{white-space:pre-wrap}
    32. 

  32. q{quotes:"\201C" "\201D" "\2018" "\2019"}
    33. 

  33. small{font-size:80%}
    34. 

  34. sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}
    35. 

  35. sup{top:-.5em}
    36. 

  36. sub{bottom:-.25em}
    37. 

  37. img{border:0}
    38. 

  38. svg:not(:root){overflow:hidden}
    39. 

  39. figure{margin:0}
    40. 

  40. fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}
    41. 

  41. legend{border:0;padding:0}
    42. 

  42. button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}
    43. 

  43. button,input{line-height:normal}
    44. 

  44. button,select{text-transform:none}
    45. 

  45. button,html input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer}
    46. 

  46. button[disabled],html input[disabled]{cursor:default}
    47. 

  47. input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0}
    48. 

  48. input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}
    49. 

  49. input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}
    50. 

  50. button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}
    51. 

  51. textarea{overflow:auto;vertical-align:top}
    52. 

  52. table{border-collapse:collapse;border-spacing:0}
    53. 

  53. *,*:before,*:after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}
    54. 

  54. html,body{font-size:100%}
    55. 

  55. body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;font-weight:400;font-style:normal;line-height:1;position:relative;cursor:auto}
    56. 

  56. a:hover{cursor:pointer}
    57. 

  57. img,object,embed{max-width:100%;height:auto}
    58. 

  58. object,embed{height:100%}
    59. 

  59. img{-ms-interpolation-mode:bicubic}
    60. 

  60. .left{float:left!important}
    61. 

  61. .right{float:right!important}
    62. 

  62. .text-left{text-align:left!important}
    63. 

  63. .text-right{text-align:right!important}
    64. 

  64. .text-center{text-align:center!important}
    65. 

  65. .text-justify{text-align:justify!important}
    66. 

  66. .hide{display:none}
    67. 

  67. body{-webkit-font-smoothing:antialiased}
    68. 

  68. img,object,svg{display:inline-block;vertical-align:middle}
    69. 

  69. textarea{height:auto;min-height:50px}
    70. 

  70. select{width:100%}
    71. 

  71. .center{margin-left:auto;margin-right:auto}
    72. 

  72. .spread{width:100%}
    73. 

  73. p.lead,.paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{font-size:1.21875em;line-height:1.6}
    74. 

  74. .subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em}
    75. 

  75. div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0;direction:ltr}
    76. 

  76. a{color:#2156a5;text-decoration:underline;line-height:inherit}
    77. 

  77. a:hover,a:focus{color:#1d4b8f}
    78. 

  78. a img{border:none}
    79. 

  79. p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}
    80. 

  80. p aside{font-size:.875em;line-height:1.35;font-style:italic}
    81. 

  81. h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em}
    82. 

  82. h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0}
    83. 

  83. h1{font-size:2.125em}
    84. 

  84. h2{font-size:1.6875em}
    85. 

  85. h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}
    86. 

  86. h4,h5{font-size:1.125em}
    87. 

  87. h6{font-size:1em}
    88. 

  88. hr{border:solid #ddddd8;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em;height:0}
    89. 

  89. em,i{font-style:italic;line-height:inherit}
    90. 

  90. strong,b{font-weight:bold;line-height:inherit}
    91. 

  91. small{font-size:60%;line-height:inherit}
    92. 

  92. code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)}
    93. 

  93. ul,ol,dl{font-size:1em;line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}
    94. 

  94. ul,ol,ul.no-bullet,ol.no-bullet{margin-left:1.5em}
    95. 

  95. ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0;font-size:1em}
    96. 

  96. ul.square li ul,ul.circle li ul,ul.disc li ul{list-style:inherit}
    97. 

  97. ul.square{list-style-type:square}
    98. 

  98. ul.circle{list-style-type:circle}
    99. 

  99. ul.disc{list-style-type:disc}
    100. 

  100. ul.no-bullet{list-style:none}
    101. 

  101. ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}
    102. 

  102. dl dt{margin-bottom:.3125em;font-weight:bold}
    103. 

  103. dl dd{margin-bottom:1.25em}
    104. 

  104. abbr,acronym{text-transform:uppercase;font-size:90%;color:rgba(0,0,0,.8);border-bottom:1px dotted #ddd;cursor:help}
    105. 

  105. abbr{text-transform:none}
    106. 

  106. blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}
    107. 

  107. blockquote cite{display:block;font-size:.9375em;color:rgba(0,0,0,.6)}
    108. 

  108. blockquote cite:before{content:"\2014 \0020"}
    109. 

  109. blockquote cite a,blockquote cite a:visited{color:rgba(0,0,0,.6)}
    110. 

  110. blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)}
    111. 

  111. @media only screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}
    112. 

  112. h1{font-size:2.75em}
    113. 

  113. h2{font-size:2.3125em}
    114. 

  114. h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em}
    115. 

  115. h4{font-size:1.4375em}}
    116. 

  116. table{background:#fff;margin-bottom:1.25em;border:solid 1px #dedede}
    117. 

  117. table thead,table tfoot{background:#f7f8f7;font-weight:bold}
    118. 

  118. table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left}
    119. 

  119. table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)}
    120. 

  120. table tr.even,table tr.alt,table tr:nth-of-type(even){background:#f8f8f7}
    121. 

  121. table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{display:table-cell;line-height:1.6}
    122. 

  122. body{tab-size:4}
    123. 

  123. h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em}
    124. 

  124. h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400}
    125. 

  125. .clearfix:before,.clearfix:after,.float-group:before,.float-group:after{content:" ";display:table}
    126. 

  126. .clearfix:after,.float-group:after{clear:both}
    127. 

  127. *:not(pre)>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background-color:#f7f7f8;-webkit-border-radius:4px;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed}
    128. 

  128. pre,pre>code{line-height:1.45;color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;text-rendering:optimizeSpeed}
    129. 

  129. .keyseq{color:rgba(51,51,51,.8)}
    130. 

  130. kbd{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;display:inline-block;color:rgba(0,0,0,.8);font-size:.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em white inset;box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em #fff inset;margin:0 .15em;padding:.2em .5em;vertical-align:middle;position:relative;top:-.1em;white-space:nowrap}
    131. 

  131. .keyseq kbd:first-child{margin-left:0}
    132. 

  132. .keyseq kbd:last-child{margin-right:0}
    133. 

  133. .menuseq,.menu{color:rgba(0,0,0,.8)}
    134. 

  134. b.button:before,b.button:after{position:relative;top:-1px;font-weight:400}
    135. 

  135. b.button:before{content:"[";padding:0 3px 0 2px}
    136. 

  136. b.button:after{content:"]";padding:0 2px 0 3px}
    137. 

  137. p a>code:hover{color:rgba(0,0,0,.9)}
    138. 

  138. #header,#content,#footnotes,#footer{width:100%;margin-left:auto;margin-right:auto;margin-top:0;margin-bottom:0;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em}
    139. 

  139. #header:before,#header:after,#content:before,#content:after,#footnotes:before,#footnotes:after,#footer:before,#footer:after{content:" ";display:table}
    140. 

  140. #header:after,#content:after,#footnotes:after,#footer:after{clear:both}
    141. 

  141. #content{margin-top:1.25em}
    142. 

  142. #content:before{content:none}
    143. 

  143. #header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0}
    144. 

  144. #header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #ddddd8}
    145. 

  145. #header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ddddd8;padding-bottom:8px}
    146. 

  146. #header .details{border-bottom:1px solid #ddddd8;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}
    147. 

  147. #header .details span:first-child{margin-left:-.125em}
    148. 

  148. #header .details span.email a{color:rgba(0,0,0,.85)}
    149. 

  149. #header .details br{display:none}
    150. 

  150. #header .details br+span:before{content:"\00a0\2013\00a0"}
    151. 

  151. #header .details br+span.author:before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)}
    152. 

  152. #header .details br+span#revremark:before{content:"\00a0|\00a0"}
    153. 

  153. #header #revnumber{text-transform:capitalize}
    154. 

  154. #header #revnumber:after{content:"\00a0"}
    155. 

  155. #content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #ddddd8;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}
    156. 

  156. #toc{border-bottom:1px solid #efefed;padding-bottom:.5em}
    157. 

  157. #toc>ul{margin-left:.125em}
    158. 

  158. #toc ul.sectlevel0>li>a{font-style:italic}
    159. 

  159. #toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0}
    160. 

  160. #toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none}
    161. 

  161. #toc li{line-height:1.3334;margin-top:.3334em}
    162. 

  162. #toc a{text-decoration:none}
    163. 

  163. #toc a:active{text-decoration:underline}
    164. 

  164. #toctitle{color:#7a2518;font-size:1.2em}
    165. 

  165. @media only screen and (min-width:768px){#toctitle{font-size:1.375em}
    166. 

  166. body.toc2{padding-left:15em;padding-right:0}
    167. 

  167. #toc.toc2{margin-top:0!important;background-color:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #efefed;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto}
    168. 

  168. #toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em}
    169. 

  169. #toc.toc2>ul{font-size:.9em;margin-bottom:0}
    170. 

  170. #toc.toc2 ul ul{margin-left:0;padding-left:1em}
    171. 

  171. #toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em}
    172. 

  172. body.toc2.toc-right{padding-left:0;padding-right:15em}
    173. 

  173. body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #efefed;left:auto;right:0}}
    174. 

  174. @media only screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0}
    175. 

  175. #toc.toc2{width:20em}
    176. 

  176. #toc.toc2 #toctitle{font-size:1.375em}
    177. 

  177. #toc.toc2>ul{font-size:.95em}
    178. 

  178. #toc.toc2 ul ul{padding-left:1.25em}
    179. 

  179. body.toc2.toc-right{padding-left:0;padding-right:20em}}
    180. 

  180. #content #toc{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
    181. 

  181. #content #toc>:first-child{margin-top:0}
    182. 

  182. #content #toc>:last-child{margin-bottom:0}
    183. 

  183. #footer{max-width:100%;background-color:rgba(0,0,0,.8);padding:1.25em}
    184. 

  184. #footer-text{color:rgba(255,255,255,.8);line-height:1.44}
    185. 

  185. .sect1{padding-bottom:.625em}
    186. 

  186. @media only screen and (min-width:768px){.sect1{padding-bottom:1.25em}}
    187. 

  187. .sect1+.sect1{border-top:1px solid #efefed}
    188. 

  188. #content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400}
    189. 

  189. #content h1>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}
    190. 

  190. #content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}
    191. 

  191. #content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none}
    192. 

  192. #content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221}
    193. 

  193. .audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}
    194. 

  194. .admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic}
    195. 

  195. table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0}
    196. 

  196. .paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{color:rgba(0,0,0,.85)}
    197. 

  197. table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}
    198. 

  198. .admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}
    199. 

  199. .admonitionblock>table td.icon{text-align:center;width:80px}
    200. 

  200. .admonitionblock>table td.icon img{max-width:none}
    201. 

  201. .admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase}
    202. 

  202. .admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #ddddd8;color:rgba(0,0,0,.6)}
    203. 

  203. .admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}
    204. 

  204. .exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:4px;border-radius:4px}
    205. 

  205. .exampleblock>.content>:first-child{margin-top:0}
    206. 

  206. .exampleblock>.content>:last-child{margin-bottom:0}
    207. 

  207. .sidebarblock{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
    208. 

  208. .sidebarblock>:first-child{margin-top:0}
    209. 

  209. .sidebarblock>:last-child{margin-bottom:0}
    210. 

  210. .sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center}
    211. 

  211. .exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}
    212. 

  212. .literalblock pre,.listingblock pre:not(.highlight),.listingblock pre[class="highlight"],.listingblock pre[class^="highlight "],.listingblock pre.CodeRay,.listingblock pre.prettyprint{background:#f7f7f8}
    213. 

  213. .sidebarblock .literalblock pre,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class="highlight"],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint{background:#f2f1f1}
    214. 

  214. .literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{-webkit-border-radius:4px;border-radius:4px;word-wrap:break-word;padding:1em;font-size:.8125em}
    215. 

  215. .literalblock pre.nowrap,.literalblock pre[class].nowrap,.listingblock pre.nowrap,.listingblock pre[class].nowrap{overflow-x:auto;white-space:pre;word-wrap:normal}
    216. 

  216. @media only screen and (min-width:768px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:.90625em}}
    217. 

  217. @media only screen and (min-width:1280px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:1em}}
    218. 

  218. .literalblock.output pre{color:#f7f7f8;background-color:rgba(0,0,0,.9)}
    219. 

  219. .listingblock pre.highlightjs{padding:0}
    220. 

  220. .listingblock pre.highlightjs>code{padding:1em;-webkit-border-radius:4px;border-radius:4px}
    221. 

  221. .listingblock pre.prettyprint{border-width:0}
    222. 

  222. .listingblock>.content{position:relative}
    223. 

  223. .listingblock code[data-lang]:before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:#999}
    224. 

  224. .listingblock:hover code[data-lang]:before{display:block}
    225. 

  225. .listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:.5em;color:#999}
    226. 

  226. .listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}
    227. 

  227. table.pyhltable{border-collapse:separate;border:0;margin-bottom:0;background:none}
    228. 

  228. table.pyhltable td{vertical-align:top;padding-top:0;padding-bottom:0;line-height:1.45}
    229. 

  229. table.pyhltable td.code{padding-left:.75em;padding-right:0}
    230. 

  230. pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #ddddd8}
    231. 

  231. pre.pygments .lineno{display:inline-block;margin-right:.25em}
    232. 

  232. table.pyhltable .linenodiv{background:none!important;padding-right:0!important}
    233. 

  233. .quoteblock{margin:0 1em 1.25em 1.5em;display:table}
    234. 

  234. .quoteblock>.title{margin-left:-1.5em;margin-bottom:.75em}
    235. 

  235. .quoteblock blockquote,.quoteblock blockquote p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}
    236. 

  236. .quoteblock blockquote{margin:0;padding:0;border:0}
    237. 

  237. .quoteblock blockquote:before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)}
    238. 

  238. .quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}
    239. 

  239. .quoteblock .attribution{margin-top:.5em;margin-right:.5ex;text-align:right}
    240. 

  240. .quoteblock .quoteblock{margin-left:0;margin-right:0;padding:.5em 0;border-left:3px solid rgba(0,0,0,.6)}
    241. 

  241. .quoteblock .quoteblock blockquote{padding:0 0 0 .75em}
    242. 

  242. .quoteblock .quoteblock blockquote:before{display:none}
    243. 

  243. .verseblock{margin:0 1em 1.25em 1em}
    244. 

  244. .verseblock pre{font-family:"Open Sans","DejaVu Sans",sans;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility}
    245. 

  245. .verseblock pre strong{font-weight:400}
    246. 

  246. .verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}
    247. 

  247. .quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic}
    248. 

  248. .quoteblock .attribution br,.verseblock .attribution br{display:none}
    249. 

  249. .quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:rgba(0,0,0,.6)}
    250. 

  250. .quoteblock.abstract{margin:0 0 1.25em 0;display:block}
    251. 

  251. .quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}
    252. 

  252. .quoteblock.abstract blockquote:before,.quoteblock.abstract blockquote p:first-of-type:before{display:none}
    253. 

  253. table.tableblock{max-width:100%;border-collapse:separate}
    254. 

  254. table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock th>p:last-child,table.tableblock td>p:last-child{margin-bottom:0}
    255. 

  255. table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede}
    256. 

  256. table.grid-all th.tableblock,table.grid-all td.tableblock{border-width:0 1px 1px 0}
    257. 

  257. table.grid-all tfoot>tr>th.tableblock,table.grid-all tfoot>tr>td.tableblock{border-width:1px 1px 0 0}
    258. 

  258. table.grid-cols th.tableblock,table.grid-cols td.tableblock{border-width:0 1px 0 0}
    259. 

  259. table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}
    260. 

  260. table.grid-rows th.tableblock,table.grid-rows td.tableblock{border-width:0 0 1px 0}
    261. 

  261. table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}
    262. 

  262. table.grid-rows tfoot>tr>th.tableblock,table.grid-rows tfoot>tr>td.tableblock{border-width:1px 0 0 0}
    263. 

  263. table.frame-all{border-width:1px}
    264. 

  264. table.frame-sides{border-width:0 1px}
    265. 

  265. table.frame-topbot{border-width:1px 0}
    266. 

  266. th.halign-left,td.halign-left{text-align:left}
    267. 

  267. th.halign-right,td.halign-right{text-align:right}
    268. 

  268. th.halign-center,td.halign-center{text-align:center}
    269. 

  269. th.valign-top,td.valign-top{vertical-align:top}
    270. 

  270. th.valign-bottom,td.valign-bottom{vertical-align:bottom}
    271. 

  271. th.valign-middle,td.valign-middle{vertical-align:middle}
    272. 

  272. table thead th,table tfoot th{font-weight:bold}
    273. 

  273. tbody tr th{display:table-cell;line-height:1.6;background:#f7f8f7}
    274. 

  274. tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold}
    275. 

  275. p.tableblock>code:only-child{background:none;padding:0}
    276. 

  276. p.tableblock{font-size:1em}
    277. 

  277. td>div.verse{white-space:pre}
    278. 

  278. ol{margin-left:1.75em}
    279. 

  279. ul li ol{margin-left:1.5em}
    280. 

  280. dl dd{margin-left:1.125em}
    281. 

  281. dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}
    282. 

  282. ol>li p,ul>li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em}
    283. 

  283. ul.unstyled,ol.unnumbered,ul.checklist,ul.none{list-style-type:none}
    284. 

  284. ul.unstyled,ol.unnumbered,ul.checklist{margin-left:.625em}
    285. 

  285. ul.checklist li>p:first-child>.fa-square-o:first-child,ul.checklist li>p:first-child>.fa-check-square-o:first-child{width:1em;font-size:.85em}
    286. 

  286. ul.checklist li>p:first-child>input[type="checkbox"]:first-child{width:1em;position:relative;top:1px}
    287. 

  287. ul.inline{margin:0 auto .625em auto;margin-left:-1.375em;margin-right:0;padding:0;list-style:none;overflow:hidden}
    288. 

  288. ul.inline>li{list-style:none;float:left;margin-left:1.375em;display:block}
    289. 

  289. ul.inline>li>*{display:block}
    290. 

  290. .unstyled dl dt{font-weight:400;font-style:normal}
    291. 

  291. ol.arabic{list-style-type:decimal}
    292. 

  292. ol.decimal{list-style-type:decimal-leading-zero}
    293. 

  293. ol.loweralpha{list-style-type:lower-alpha}
    294. 

  294. ol.upperalpha{list-style-type:upper-alpha}
    295. 

  295. ol.lowerroman{list-style-type:lower-roman}
    296. 

  296. ol.upperroman{list-style-type:upper-roman}
    297. 

  297. ol.lowergreek{list-style-type:lower-greek}
    298. 

  298. .hdlist>table,.colist>table{border:0;background:none}
    299. 

  299. .hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}
    300. 

  300. td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}
    301. 

  301. td.hdlist1{font-weight:bold;padding-bottom:1.25em}
    302. 

  302. .literalblock+.colist,.listingblock+.colist{margin-top:-.5em}
    303. 

  303. .colist>table tr>td:first-of-type{padding:0 .75em;line-height:1}
    304. 

  304. .colist>table tr>td:last-of-type{padding:.25em 0}
    305. 

  305. .thumb,.th{line-height:0;display:inline-block;border:solid 4px #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}
    306. 

  306. .imageblock.left,.imageblock[style*="float: left"]{margin:.25em .625em 1.25em 0}
    307. 

  307. .imageblock.right,.imageblock[style*="float: right"]{margin:.25em 0 1.25em .625em}
    308. 

  308. .imageblock>.title{margin-bottom:0}
    309. 

  309. .imageblock.thumb,.imageblock.th{border-width:6px}
    310. 

  310. .imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em}
    311. 

  311. .image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}
    312. 

  312. .image.left{margin-right:.625em}
    313. 

  313. .image.right{margin-left:.625em}
    314. 

  314. a.image{text-decoration:none;display:inline-block}
    315. 

  315. a.image object{pointer-events:none}
    316. 

  316. sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}
    317. 

  317. sup.footnote a,sup.footnoteref a{text-decoration:none}
    318. 

  318. sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}
    319. 

  319. #footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}
    320. 

  320. #footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em 0;border-width:1px 0 0 0}
    321. 

  321. #footnotes .footnote{padding:0 .375em 0 .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:.2em}
    322. 

  322. #footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none}
    323. 

  323. #footnotes .footnote:last-of-type{margin-bottom:0}
    324. 

  324. #content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}
    325. 

  325. .gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}
    326. 

  326. .gist .file-data>table td.line-data{width:99%}
    327. 

  327. div.unbreakable{page-break-inside:avoid}
    328. 

  328. .big{font-size:larger}
    329. 

  329. .small{font-size:smaller}
    330. 

  330. .underline{text-decoration:underline}
    331. 

  331. .overline{text-decoration:overline}
    332. 

  332. .line-through{text-decoration:line-through}
    333. 

  333. .aqua{color:#00bfbf}
    334. 

  334. .aqua-background{background-color:#00fafa}
    335. 

  335. .black{color:#000}
    336. 

  336. .black-background{background-color:#000}
    337. 

  337. .blue{color:#0000bf}
    338. 

  338. .blue-background{background-color:#0000fa}
    339. 

  339. .fuchsia{color:#bf00bf}
    340. 

  340. .fuchsia-background{background-color:#fa00fa}
    341. 

  341. .gray{color:#606060}
    342. 

  342. .gray-background{background-color:#7d7d7d}
    343. 

  343. .green{color:#006000}
    344. 

  344. .green-background{background-color:#007d00}
    345. 

  345. .lime{color:#00bf00}
    346. 

  346. .lime-background{background-color:#00fa00}
    347. 

  347. .maroon{color:#600000}
    348. 

  348. .maroon-background{background-color:#7d0000}
    349. 

  349. .navy{color:#000060}
    350. 

  350. .navy-background{background-color:#00007d}
    351. 

  351. .olive{color:#606000}
    352. 

  352. .olive-background{background-color:#7d7d00}
    353. 

  353. .purple{color:#600060}
    354. 

  354. .purple-background{background-color:#7d007d}
    355. 

  355. .red{color:#bf0000}
    356. 

  356. .red-background{background-color:#fa0000}
    357. 

  357. .silver{color:#909090}
    358. 

  358. .silver-background{background-color:#bcbcbc}
    359. 

  359. .teal{color:#006060}
    360. 

  360. .teal-background{background-color:#007d7d}
    361. 

  361. .white{color:#bfbfbf}
    362. 

  362. .white-background{background-color:#fafafa}
    363. 

  363. .yellow{color:#bfbf00}
    364. 

  364. .yellow-background{background-color:#fafa00}
    365. 

  365. span.icon>.fa{cursor:default}
    366. 

  366. .admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default}
    367. 

  367. .admonitionblock td.icon .icon-note:before{content:"\f05a";color:#19407c}
    368. 

  368. .admonitionblock td.icon .icon-tip:before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111}
    369. 

  369. .admonitionblock td.icon .icon-warning:before{content:"\f071";color:#bf6900}
    370. 

  370. .admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}
    371. 

  371. .admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}
    372. 

  372. .conum[data-value]{display:inline-block;color:#fff!important;background-color:rgba(0,0,0,.8);-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold}
    373. 

  373. .conum[data-value] *{color:#fff!important}
    374. 

  374. .conum[data-value]+b{display:none}
    375. 

  375. .conum[data-value]:after{content:attr(data-value)}
    376. 

  376. pre .conum[data-value]{position:relative;top:-.125em}
    377. 

  377. b.conum *{color:inherit!important}
    378. 

  378. .conum:not([data-value]):empty{display:none}
    379. 

  379. dt,th.tableblock,td.content,div.footnote{text-rendering:optimizeLegibility}
    380. 

  380. h1,h2,p,td.content,span.alt{letter-spacing:-.01em}
    381. 

  381. p strong,td.content strong,div.footnote strong{letter-spacing:-.005em}
    382. 

  382. p,blockquote,dt,td.content,span.alt{font-size:1.0625rem}
    383. 

  383. p{margin-bottom:1.25rem}
    384. 

  384. .sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em}
    385. 

  385. .exampleblock>.content{background-color:#fffef7;border-color:#e0e0dc;-webkit-box-shadow:0 1px 4px #e0e0dc;box-shadow:0 1px 4px #e0e0dc}
    386. 

  386. .print-only{display:none!important}
    387. 

  387. @media print{@page{margin:1.25cm .75cm}
    388. 

  388. *{-webkit-box-shadow:none!important;box-shadow:none!important;text-shadow:none!important}
    389. 

  389. a{color:inherit!important;text-decoration:underline!important}
    390. 

  390. a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important}
    391. 

  391. a[href^="http:"]:not(.bare):after,a[href^="https:"]:not(.bare):after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em}
    392. 

  392. abbr[title]:after{content:" (" attr(title) ")"}
    393. 

  393. pre,blockquote,tr,img,object,svg{page-break-inside:avoid}
    394. 

  394. thead{display:table-header-group}
    395. 

  395. svg{max-width:100%}
    396. 

  396. p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3}
    397. 

  397. h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid}
    398. 

  398. #toc,.sidebarblock,.exampleblock>.content{background:none!important}
    399. 

  399. #toc{border-bottom:1px solid #ddddd8!important;padding-bottom:0!important}
    400. 

  400. .sect1{padding-bottom:0!important}
    401. 

  401. .sect1+.sect1{border:0!important}
    402. 

  402. #header>h1:first-child{margin-top:1.25rem}
    403. 

  403. body.book #header{text-align:center}
    404. 

  404. body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em 0}
    405. 

  405. body.book #header .details{border:0!important;display:block;padding:0!important}
    406. 

  406. body.book #header .details span:first-child{margin-left:0!important}
    407. 

  407. body.book #header .details br{display:block}
    408. 

  408. body.book #header .details br+span:before{content:none!important}
    409. 

  409. body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important}
    410. 

  410. body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always}
    411. 

  411. .listingblock code[data-lang]:before{display:block}
    412. 

  412. #footer{background:none!important;padding:0 .9375em}
    413. 

  413. #footer-text{color:rgba(0,0,0,.6)!important;font-size:.9em}
    414. 

  414. .hide-on-print{display:none!important}
    415. 

  415. .print-only{display:block!important}
    416. 

  416. .hide-for-print{display:none!important}
    417. 

  417. .show-for-print{display:inherit!important}}
    418. 

  418. </style>
    419. 

  419. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.5.0/css/font-awesome.min.css">
    420. 

  420. <style>
    421. 

  421. /* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
    422. 

  422. /*pre.CodeRay {background-color:#f7f7f8;}*/
    423. 

  423. .CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em}
    424. 

  424. .CodeRay span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)}
    425. 

  425. .CodeRay .line-numbers strong{color:rgba(0,0,0,.4)}
    426. 

  426. table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none}
    427. 

  427. table.CodeRay td{vertical-align: top;line-height:1.45}
    428. 

  428. table.CodeRay td.line-numbers{text-align:right}
    429. 

  429. table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)}
    430. 

  430. table.CodeRay td.code{padding:0 0 0 .5em}
    431. 

  431. table.CodeRay td.code>pre{padding:0}
    432. 

  432. .CodeRay .debug{color:#fff !important;background:#000080 !important}
    433. 

  433. .CodeRay .annotation{color:#007}
    434. 

  434. .CodeRay .attribute-name{color:#000080}
    435. 

  435. .CodeRay .attribute-value{color:#700}
    436. 

  436. .CodeRay .binary{color:#509}
    437. 

  437. .CodeRay .comment{color:#998;font-style:italic}
    438. 

  438. .CodeRay .char{color:#04d}
    439. 

  439. .CodeRay .char .content{color:#04d}
    440. 

  440. .CodeRay .char .delimiter{color:#039}
    441. 

  441. .CodeRay .class{color:#458;font-weight:bold}
    442. 

  442. .CodeRay .complex{color:#a08}
    443. 

  443. .CodeRay .constant,.CodeRay .predefined-constant{color:#008080}
    444. 

  444. .CodeRay .color{color:#099}
    445. 

  445. .CodeRay .class-variable{color:#369}
    446. 

  446. .CodeRay .decorator{color:#b0b}
    447. 

  447. .CodeRay .definition{color:#099}
    448. 

  448. .CodeRay .delimiter{color:#000}
    449. 

  449. .CodeRay .doc{color:#970}
    450. 

  450. .CodeRay .doctype{color:#34b}
    451. 

  451. .CodeRay .doc-string{color:#d42}
    452. 

  452. .CodeRay .escape{color:#666}
    453. 

  453. .CodeRay .entity{color:#800}
    454. 

  454. .CodeRay .error{color:#808}
    455. 

  455. .CodeRay .exception{color:inherit}
    456. 

  456. .CodeRay .filename{color:#099}
    457. 

  457. .CodeRay .function{color:#900;font-weight:bold}
    458. 

  458. .CodeRay .global-variable{color:#008080}
    459. 

  459. .CodeRay .hex{color:#058}
    460. 

  460. .CodeRay .integer,.CodeRay .float{color:#099}
    461. 

  461. .CodeRay .include{color:#555}
    462. 

  462. .CodeRay .inline{color:#000}
    463. 

  463. .CodeRay .inline .inline{background:#ccc}
    464. 

  464. .CodeRay .inline .inline .inline{background:#bbb}
    465. 

  465. .CodeRay .inline .inline-delimiter{color:#d14}
    466. 

  466. .CodeRay .inline-delimiter{color:#d14}
    467. 

  467. .CodeRay .important{color:#555;font-weight:bold}
    468. 

  468. .CodeRay .interpreted{color:#b2b}
    469. 

  469. .CodeRay .instance-variable{color:#008080}
    470. 

  470. .CodeRay .label{color:#970}
    471. 

  471. .CodeRay .local-variable{color:#963}
    472. 

  472. .CodeRay .octal{color:#40e}
    473. 

  473. .CodeRay .predefined{color:#369}
    474. 

  474. .CodeRay .preprocessor{color:#579}
    475. 

  475. .CodeRay .pseudo-class{color:#555}
    476. 

  476. .CodeRay .directive{font-weight:bold}
    477. 

  477. .CodeRay .type{font-weight:bold}
    478. 

  478. .CodeRay .predefined-type{color:inherit}
    479. 

  479. .CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold}
    480. 

  480. .CodeRay .key{color:#808}
    481. 

  481. .CodeRay .key .delimiter{color:#606}
    482. 

  482. .CodeRay .key .char{color:#80f}
    483. 

  483. .CodeRay .value{color:#088}
    484. 

  484. .CodeRay .regexp .delimiter{color:#808}
    485. 

  485. .CodeRay .regexp .content{color:#808}
    486. 

  486. .CodeRay .regexp .modifier{color:#808}
    487. 

  487. .CodeRay .regexp .char{color:#d14}
    488. 

  488. .CodeRay .regexp .function{color:#404;font-weight:bold}
    489. 

  489. .CodeRay .string{color:#d20}
    490. 

  490. .CodeRay .string .string .string{background:#ffd0d0}
    491. 

  491. .CodeRay .string .content{color:#d14}
    492. 

  492. .CodeRay .string .char{color:#d14}
    493. 

  493. .CodeRay .string .delimiter{color:#d14}
    494. 

  494. .CodeRay .shell{color:#d14}
    495. 

  495. .CodeRay .shell .delimiter{color:#d14}
    496. 

  496. .CodeRay .symbol{color:#990073}
    497. 

  497. .CodeRay .symbol .content{color:#a60}
    498. 

  498. .CodeRay .symbol .delimiter{color:#630}
    499. 

  499. .CodeRay .tag{color:#008080}
    500. 

  500. .CodeRay .tag-special{color:#d70}
    501. 

  501. .CodeRay .variable{color:#036}
    502. 

  502. .CodeRay .insert{background:#afa}
    503. 

  503. .CodeRay .delete{background:#faa}
    504. 

  504. .CodeRay .change{color:#aaf;background:#007}
    505. 

  505. .CodeRay .head{color:#f8f;background:#505}
    506. 

  506. .CodeRay .insert .insert{color:#080}
    507. 

  507. .CodeRay .delete .delete{color:#800}
    508. 

  508. .CodeRay .change .change{color:#66f}
    509. 

  509. .CodeRay .head .head{color:#f4f}
    510. 

  510. </style>
    511. 

  511. </head>
    512. 

  512. <body class="article toc2 toc-left">
    513. 

  513. <div id="header">
    514. 

  514. <h1>Light and Shadow</h1>
    515. 

  515. <div class="details">
    516. 

  516. <span id="author" class="author"></span><br>
    517. 

  517. <span id="revnumber">version ,</span>
    518. 

  518. <span id="revdate">2016/03/17 20:48</span>
    519. 

  519. </div>
    520. 

  520. <div id="toc" class="toc2">
    521. 

  521. <div id="toctitle">Table of Contents</div>
    522. 

  522. <ul class="sectlevel1">
    523. 

  523. <li><a href="#light-sources-and-colors">Light Sources and Colors</a>
    524. 

  524. <ul class="sectlevel2">
    525. 

  525. <li><a href="#pointlight">PointLight</a></li>
    526. 

  526. <li><a href="#directionallight">DirectionalLight</a></li>
    527. 

  527. <li><a href="#spotlight">SpotLight</a></li>
    528. 

  528. <li><a href="#ambientlight">AmbientLight</a></li>
    529. 

  529. </ul>
    530. 

  530. </li>
    531. 

  531. <li><a href="#light-follows-spatial">Light Follows Spatial</a></li>
    532. 

  532. <li><a href="#basicshadowrenderer-deprecated">BasicShadowRenderer (deprecated)</a></li>
    533. 

  533. <li><a href="#casting-shadows">Casting Shadows</a></li>
    534. 

  534. <li><a href="#parallel-split-shadow-map-deprecated">Parallel-Split Shadow Map (deprecated)</a></li>
    535. 

  535. <li><a href="#screen-space-ambient-occlusion">Screen Space Ambient Occlusion</a></li>
    536. 

  536. </ul>
    537. 

  537. </div>
    538. 

  538. </div>
    539. 

  539. <div id="content">
    540. 

  540. <div id="preamble">
    541. 

  541. <div class="sectionbody">
    542. 

  542. <div class="paragraph">
    543. 

  543. <p><span class="image"><img src="../../jme3/advanced/shading-ani.gif" alt="Examples of shading and lighting." height=""></span></p>
    544. 

  544. </div>
    545. 

  545. <div class="paragraph">
    546. 

  546. <p>Light and Shadow are two separate things in 3D engines, although we percieve them together in real life:</p>
    547. 

  547. </div>
    548. 

  548. <div class="ulist">
    549. 

  549. <ul>
    550. 

  550. <li>
    551. 

  551. <p>Lighting means that an object is brighter on the side facing the light direction, and darker on the backside. Computationally, this is relatively easy.</p>
    552. 

  552. </li>
    553. 

  553. <li>
    554. 

  554. <p>Lighting does not mean that objects cast a shadow on the floor or other objects: Activating shadow processing is an additional step described here. Since casting shadows has an impact on performance, drop shadows and ambient occlusion shading are not activated by default.</p>
    555. 

  555. </li>
    556. 

  556. </ul>
    557. 

  557. </div>
    558. 

  558. </div>
    559. 

  559. </div>
    560. 

  560. <div class="sect1">
    561. 

  561. <h2 id="light-sources-and-colors">Light Sources and Colors</h2>
    562. 

  562. <div class="sectionbody">
    563. 

  563. <div class="imageblock" style="text-align: right">
    564. 

  564. <div class="content">
    565. 

  565. <img src="../../jme3/advanced/light-sources.png" alt="A lit scene with multiple light sources" height="200">
    566. 

  566. </div>
    567. 

  567. </div>
    568. 

  568. <div class="paragraph">
    569. 

  569. <p>You can add several types of light sources to a scene using <code>rootNode.addLight(mylight)</code>.</p>
    570. 

  570. </div>
    571. 

  571. <div class="paragraph">
    572. 

  572. <p>The available light sources in <code>com.​jme3.​light</code> are:</p>
    573. 

  573. </div>
    574. 

  574. <div class="ulist">
    575. 

  575. <ul>
    576. 

  576. <li>
    577. 

  577. <p>SpotLight</p>
    578. 

  578. </li>
    579. 

  579. <li>
    580. 

  580. <p>PointLight</p>
    581. 

  581. </li>
    582. 

  582. <li>
    583. 

  583. <p>AmbientLight</p>
    584. 

  584. </li>
    585. 

  585. <li>
    586. 

  586. <p>DirectionalLight</p>
    587. 

  587. </li>
    588. 

  588. </ul>
    589. 

  589. </div>
    590. 

  590. <div class="paragraph">
    591. 

  591. <p>You control the color and intensity of each light source. Typically you set the color to white (<code>new ColorRGBA(1.0f,1.0f,1.0f,1.0f)</code> or <code>ColorRGBA.White</code>), which makes all scene elements appear in their natural color.</p>
    592. 

  592. </div>
    593. 

  593. <div class="paragraph">
    594. 

  594. <p>You can choose to use lights in other colors than white, or darker colors. This influences the scene&#8217;s atmosphere and will make the scene appear colder (e.g. <code>ColorRGBA.Cyan</code>) or warmer (<code>ColorRGBA.Yellow</code>), brighter (higher values) or darker (lower values).</p>
    595. 

  595. </div>
    596. 

  596. <div class="paragraph">
    597. 

  597. <p>You can get a list of all lights added to a Spatial by calling <code>getWorldLightList()</code> (includes inherited lights) or <code>getLocalLightList()</code> (only directly added lights), and iterating over the result.</p>
    598. 

  598. </div>
    599. 

  599. <div class="sect2">
    600. 

  600. <h3 id="pointlight">PointLight</h3>
    601. 

  601. <div class="imageblock" style="text-align: right">
    602. 

  602. <div class="content">
    603. 

  603. <img src="../../jme3/advanced/elephant-pointlights.png" alt="An elephant model illuminated by pointlights" height="205">
    604. 

  604. </div>
    605. 

  605. </div>
    606. 

  606. <div class="paragraph">
    607. 

  607. <p>A PointLight has a location and shines from there in all directions as far as its radius reaches. The light intensity decreases with increased distance from the light source. A PointLight can be used to cast shadows along with a PointLightShadowRenderer (see the Casting Shadows section)</p>
    608. 

  608. </div>
    609. 

  609. <div class="paragraph">
    610. 

  610. <p><strong>Typical example:</strong> Lamp, lightbulb, torch, candle.</p>
    611. 

  611. </div>
    612. 

  612. <div class="listingblock">
    613. 

  613. <div class="content">
    614. 

  614. <pre class="CodeRay highlight"><code data-lang="java">PointLight lamp_light = <span class="keyword">new</span> PointLight();
    615. 

  615. lamp_light.setColor(ColorRGBA.Yellow);
    616. 

  616. lamp_light.setRadius(<span class="float">4f</span>);
    617. 

  617. lamp_light.setPosition(<span class="keyword">new</span> Vector3f(lamp_geo.getLocalTranslation()));
    618. 

  618. rootNode.addLight(lamp_light);</code></pre>
    619. 

  619. </div>
    620. 

  620. </div>
    621. 

  621. </div>
    622. 

  622. <div class="sect2">
    623. 

  623. <h3 id="directionallight">DirectionalLight</h3>
    624. 

  624. <div class="imageblock" style="text-align: right">
    625. 

  625. <div class="content">
    626. 

  626. <img src="../../jme3/advanced/house-directionallight.png" alt="A house model illuminated with a sun-like directional light" height="210">
    627. 

  627. </div>
    628. 

  628. </div>
    629. 

  629. <div class="paragraph">
    630. 

  630. <p>A DirectionalLight has no position, only a direction. It sends out parallel beams of light and is considered “infinitely far away. You typically have one directional light per scene. A DirectionalLight can be used together with shadows.</p>
    631. 

  631. </div>
    632. 

  632. <div class="paragraph">
    633. 

  633. <p><strong>Typically example:</strong> Sun light.</p>
    634. 

  634. </div>
    635. 

  635. <div class="listingblock">
    636. 

  636. <div class="content">
    637. 

  637. <pre class="CodeRay highlight"><code data-lang="java">DirectionalLight sun = <span class="keyword">new</span> DirectionalLight();
    638. 

  638. sun.setColor(ColorRGBA.White);
    639. 

  639. sun.setDirection(<span class="keyword">new</span> Vector3f(-<span class="float">.5f</span>,-<span class="float">.5f</span>,-<span class="float">.5f</span>).normalizeLocal());
    640. 

  640. rootNode.addLight(sun);</code></pre>
    641. 

  641. </div>
    642. 

  642. </div>
    643. 

  643. </div>
    644. 

  644. <div class="sect2">
    645. 

  645. <h3 id="spotlight">SpotLight</h3>
    646. 

  646. <div class="imageblock" style="text-align: right">
    647. 

  647. <div class="content">
    648. 

  648. <img src="../../jme3/advanced/spotlight.png" alt="Spotlight" height="">
    649. 

  649. </div>
    650. 

  650. </div>
    651. 

  651. <div class="paragraph">
    652. 

  652. <p>A SpotLight sends out a distinct beam or cone of light. A SpotLight has a direction, a position, distance (range) and two angles. The inner angle is the central maximum of the light cone, the outer angle the edge of the light cone. Everything outside the light cone&#8217;s angles is not affected by the light.</p>
    653. 

  653. </div>
    654. 

  654. <div class="paragraph">
    655. 

  655. <p><strong>Typical Example:</strong> Flashlight</p>
    656. 

  656. </div>
    657. 

  657. <div class="listingblock">
    658. 

  658. <div class="content">
    659. 

  659. <pre class="CodeRay highlight"><code data-lang="java">SpotLight spot = <span class="keyword">new</span> SpotLight();
    660. 

  660. spot.setSpotRange(<span class="float">100f</span>);                           <span class="comment">// distance</span>
    661. 

  661. spot.setSpotInnerAngle(<span class="float">15f</span> * FastMath.DEG_TO_RAD); <span class="comment">// inner light cone (central beam)</span>
    662. 

  662. spot.setSpotOuterAngle(<span class="float">35f</span> * FastMath.DEG_TO_RAD); <span class="comment">// outer light cone (edge of the light)</span>
    663. 

  663. spot.setColor(ColorRGBA.White.mult(<span class="float">1.3f</span>));         <span class="comment">// light color</span>
    664. 

  664. spot.setPosition(cam.getLocation());               <span class="comment">// shine from camera loc</span>
    665. 

  665. spot.setDirection(cam.getDirection());             <span class="comment">// shine forward from camera loc</span>
    666. 

  666. rootNode.addLight(spot);</code></pre>
    667. 

  667. </div>
    668. 

  668. </div>
    669. 

  669. <div class="paragraph">
    670. 

  670. <p>If you want the spotlight to follow the flycam, repeat the setDirection(…) and setPosition(…) calls in the update loop, and kee syncing them with the camera position and direction.</p>
    671. 

  671. </div>
    672. 

  672. </div>
    673. 

  673. <div class="sect2">
    674. 

  674. <h3 id="ambientlight">AmbientLight</h3>
    675. 

  675. <div class="paragraph">
    676. 

  676. <p>An AmbientLight simply influences the brightness and color of the scene globally. It has no direction and no location and shines equally everywhere. An AmbientLight does not cast any shadows, and it lights all sides of Geometries evenly, which makes 3D objects look unnaturally flat; this is why you typically do not use an AmbientLight alone without one of the other lights.</p>
    677. 

  677. </div>
    678. 

  678. <div class="paragraph">
    679. 

  679. <p><strong>Typical example:</strong> Regulate overall brightness, tinge the whole scene in a warm or cold color.</p>
    680. 

  680. </div>
    681. 

  681. <div class="listingblock">
    682. 

  682. <div class="content">
    683. 

  683. <pre class="CodeRay highlight"><code data-lang="java">AmbientLight al = <span class="keyword">new</span> AmbientLight();
    684. 

  684. al.setColor(ColorRGBA.White.mult(<span class="float">1.3f</span>));
    685. 

  685. rootNode.addLight(al);</code></pre>
    686. 

  686. </div>
    687. 

  687. </div>
    688. 

  688. <div class="paragraph">
    689. 

  689. <p>+
    690. 

  690. <code>mylight.setColor(ColorRGBA.White.mult(1.3f));</code></p>
    691. 

  691. </div>
    692. 

  692. </div>
    693. 

  693. </div>
    694. 

  694. </div>
    695. 

  695. <div class="sect1">
    696. 

  696. <h2 id="light-follows-spatial">Light Follows Spatial</h2>
    697. 

  697. <div class="sectionbody">
    698. 

  698. <div class="paragraph">
    699. 

  699. <p>You can use a <code>com.jme3.scene.control.LightControl</code> to make a SpotLight or PointLight follow a Spatial. This can be used for a flashlight being carried by a character, or for car headlights, or an aircraft&#8217;s spotlight, etc.</p>
    700. 

  700. </div>
    701. 

  701. <div class="listingblock">
    702. 

  702. <div class="content">
    703. 

  703. <pre class="CodeRay highlight"><code data-lang="java">PointLight myLight = <span class="keyword">new</span> PointLight();
    704. 

  704. rootNode.addLight(myLight);
    705. 

  705. LightControl lightControl = <span class="keyword">new</span> LightControl(myLight);
    706. 

  706. spatial.addControl(lightControl); <span class="comment">// this spatial controls the position of this light.</span></code></pre>
    707. 

  707. </div>
    708. 

  708. </div>
    709. 

  709. <div class="paragraph">
    710. 

  710. <p>Obviously, this does not apply to AmbientLights, which have no position.</p>
    711. 

  711. </div>
    712. 

  712. </div>
    713. 

  713. </div>
    714. 

  714. <div class="sect1">
    715. 

  715. <h2 id="basicshadowrenderer-deprecated">BasicShadowRenderer (deprecated)</h2>
    716. 

  716. <div class="sectionbody">
    717. 

  717. <div class="paragraph">
    718. 

  718. <p>Full code sample</p>
    719. 

  719. </div>
    720. 

  720. <div class="ulist">
    721. 

  721. <ul>
    722. 

  722. <li>
    723. 

  723. <p><a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/light/TestShadow.java">TestShadow.java</a></p>
    724. 

  724. </li>
    725. 

  725. </ul>
    726. 

  726. </div>
    727. 

  727. </div>
    728. 

  728. </div>
    729. 

  729. <div class="sect1">
    730. 

  730. <h2 id="casting-shadows">Casting Shadows</h2>
    731. 

  731. <div class="sectionbody">
    732. 

  732. <div class="paragraph">
    733. 

  733. <p>For each type of non-ambient light source, JME3 implements two ways to simulate geometries casting shadows on other geometries:</p>
    734. 

  734. </div>
    735. 

  735. <div class="ulist">
    736. 

  736. <ul>
    737. 

  737. <li>
    738. 

  738. <p>a shadow renderer (which you apply to a viewport) and</p>
    739. 

  739. </li>
    740. 

  740. <li>
    741. 

  741. <p>a shadow filter (which you can add to a viewport&#8217;s filter post-processor).</p>
    742. 

  742. </li>
    743. 

  743. </ul>
    744. 

  744. </div>
    745. 

  745. <table class="tableblock frame-all grid-all spread">
    746. 

  746. <colgroup>
    747. 

  747. <col style="width: 100%;">
    748. 

  748. </colgroup>
    749. 

  749. <tbody>
    750. 

  750. <tr>
    751. 

  751. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    752. 

  752. <p>light source class</p>
    753. 

  753. </div></div></td>
    754. 

  754. </tr>
    755. 

  755. <tr>
    756. 

  756. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    757. 

  757. <p>shadow renderer class</p>
    758. 

  758. </div></div></td>
    759. 

  759. </tr>
    760. 

  760. <tr>
    761. 

  761. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    762. 

  762. <p>shadow filter class</p>
    763. 

  763. </div></div></td>
    764. 

  764. </tr>
    765. 

  765. <tr>
    766. 

  766. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    767. 

  767. <p>DirectionalLight</p>
    768. 

  768. </div></div></td>
    769. 

  769. </tr>
    770. 

  770. <tr>
    771. 

  771. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    772. 

  772. <p>DirectionalLightShadowRenderer</p>
    773. 

  773. </div></div></td>
    774. 

  774. </tr>
    775. 

  775. <tr>
    776. 

  776. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    777. 

  777. <p>DirectionalLightShadowFilter</p>
    778. 

  778. </div></div></td>
    779. 

  779. </tr>
    780. 

  780. <tr>
    781. 

  781. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    782. 

  782. <p>PointLight</p>
    783. 

  783. </div></div></td>
    784. 

  784. </tr>
    785. 

  785. <tr>
    786. 

  786. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    787. 

  787. <p>PointLightShadowRenderer</p>
    788. 

  788. </div></div></td>
    789. 

  789. </tr>
    790. 

  790. <tr>
    791. 

  791. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    792. 

  792. <p>PointLightShadowFilter</p>
    793. 

  793. </div></div></td>
    794. 

  794. </tr>
    795. 

  795. <tr>
    796. 

  796. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    797. 

  797. <p>SpotLight</p>
    798. 

  798. </div></div></td>
    799. 

  799. </tr>
    800. 

  800. <tr>
    801. 

  801. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    802. 

  802. <p>SpotLightShadowRenderer</p>
    803. 

  803. </div></div></td>
    804. 

  804. </tr>
    805. 

  805. <tr>
    806. 

  806. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    807. 

  807. <p>SpotLightShadowFilter</p>
    808. 

  808. </div></div></td>
    809. 

  809. </tr>
    810. 

  810. <tr>
    811. 

  811. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    812. 

  812. <p>AmbientLight</p>
    813. 

  813. </div></div></td>
    814. 

  814. </tr>
    815. 

  815. <tr>
    816. 

  816. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    817. 

  817. <p>(not applicable)</p>
    818. 

  818. </div></div></td>
    819. 

  819. </tr>
    820. 

  820. <tr>
    821. 

  821. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    822. 

  822. <p>(not applicable)</p>
    823. 

  823. </div></div></td>
    824. 

  824. </tr>
    825. 

  825. </tbody>
    826. 

  826. </table>
    827. 

  827. <div class="paragraph">
    828. 

  828. <p>You only need one shadow simulation per light source:  if you use shadow rendering, you won&#8217;t need a shadow filter and vice versa.  Which way is more efficient depends partly on the complexity of your scene. All six shadow simulation classes have similar interfaces, so once you know how to use one, you can easily figure out the rest.</p>
    829. 

  829. </div>
    830. 

  830. <div class="paragraph">
    831. 

  831. <p>Shadow calculations (cast and receive) have a performance impact, so use them sparingly.  With shadow renderers, you can turn off shadow casting and/or shadow receiving for individual geometries, for portions of the scene graph, or for the entire scene:</p>
    832. 

  832. </div>
    833. 

  833. <div class="listingblock">
    834. 

  834. <div class="content">
    835. 

  835. <pre class="CodeRay highlight"><code data-lang="java">spatial.setShadowMode(ShadowMode.Inherit);     <span class="comment">// This is the default setting for new spatials.</span>
    836. 

  836. rootNode.setShadowMode(ShadowMode.Off);        <span class="comment">// Disable shadows for the whole scene, except where overridden.</span>
    837. 

  837. wall.setShadowMode(ShadowMode.CastAndReceive); <span class="comment">// The wall can cast shadows and also receive them.</span>
    838. 

  838. floor.setShadowMode(ShadowMode.Receive);       <span class="comment">// Any shadows cast by the floor would be hidden by it.</span>
    839. 

  839. airplane.setShadowMode(ShadowMode.Cast);       <span class="comment">// There's nothing above the airplane to cast shadows on it.</span>
    840. 

  840. ghost.setShadowMode(ShadowMode.Off);           <span class="comment">// The ghost is translucent: it neither casts nor receives shadows.</span></code></pre>
    841. 

  841. </div>
    842. 

  842. </div>
    843. 

  843. <div class="paragraph">
    844. 

  844. <p>Both shadow renderers and shadow filters use shadow modes to determine which objects can cast shadows. However, only the shadow renderers pay attention to shadow modes when determining which objects receive shadows.  With a shadow filter, shadow modes have no effect on which objects receive shadows.</p>
    845. 

  845. </div>
    846. 

  846. <div class="paragraph">
    847. 

  847. <p>Here&#8217;s a sample application which demonstrates both DirectionalLightShadowRenderer and DirectionalLightShadowFilter:</p>
    848. 

  848. </div>
    849. 

  849. <div class="ulist">
    850. 

  850. <ul>
    851. 

  851. <li>
    852. 

  852. <p><a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/light/TestDirectionalLightShadow.java">TestDirectionalLightShadow.java</a></p>
    853. 

  853. </li>
    854. 

  854. </ul>
    855. 

  855. </div>
    856. 

  856. <div class="paragraph">
    857. 

  857. <p>Here is the key code fragment:</p>
    858. 

  858. </div>
    859. 

  859. <div class="listingblock">
    860. 

  860. <div class="content">
    861. 

  861. <pre class="CodeRay highlight"><code data-lang="java">        DirectionalLight sun = <span class="keyword">new</span> DirectionalLight();
    862. 

  862.         sun.setColor(ColorRGBA.White);
    863. 

  863.         sun.setDirection(cam.getDirection());
    864. 

  864.         rootNode.addLight(sun);
    865. 

  865. 

  866.         <span class="comment">/* Drop shadows */</span>
    867. 

  867.         <span class="directive">final</span> <span class="type">int</span> SHADOWMAP_SIZE=<span class="integer">1024</span>;
    868. 

  868.         DirectionalLightShadowRenderer dlsr = <span class="keyword">new</span> DirectionalLightShadowRenderer(assetManager, SHADOWMAP_SIZE, <span class="integer">3</span>);
    869. 

  869.         dlsr.setLight(sun);
    870. 

  870.         viewPort.addProcessor(dlsr);
    871. 

  871. 

  872.         DirectionalLightShadowFilter dlsf = <span class="keyword">new</span> DirectionalLightShadowFilter(assetManager, SHADOWMAP_SIZE, <span class="integer">3</span>);
    873. 

  873.         dlsf.setLight(sun);
    874. 

  874.         dlsf.setEnabled(<span class="predefined-constant">true</span>);
    875. 

  875.         FilterPostProcessor fpp = <span class="keyword">new</span> FilterPostProcessor(assetManager);
    876. 

  876.         fpp.addFilter(dlsf);
    877. 

  877.         viewPort.addProcessor(fpp);</code></pre>
    878. 

  878. </div>
    879. 

  879. </div>
    880. 

  880. <div class="paragraph">
    881. 

  881. <p>Constructor arguments:
    882. 

  882.  * your AssetManager object
    883. 

  883.  * size of the rendered shadow maps, in pixels per side (512, 1024, 2048, etc…)
    884. 

  884.  * the number of shadow maps rendered (more shadow maps = better quality, but slower)</p>
    885. 

  885. </div>
    886. 

  886. <div class="paragraph">
    887. 

  887. <p>Properties you can set:
    888. 

  888.  * setDirection(Vector3f) – the direction of the light
    889. 

  889.  * setLambda(0.65f) – to reduce the split size
    890. 

  890.  * setShadowIntensity(0.7f) – shadow darkness (1=black, 0=invisible)
    891. 

  891.  * setShadowZextend(float) – distance from camera to which shadows will be computed</p>
    892. 

  892. </div>
    893. 

  893. </div>
    894. 

  894. </div>
    895. 

  895. <div class="sect1">
    896. 

  896. <h2 id="parallel-split-shadow-map-deprecated">Parallel-Split Shadow Map (deprecated)</h2>
    897. 

  897. <div class="sectionbody">
    898. 

  898. <div class="paragraph">
    899. 

  899. <p>Full sample code</p>
    900. 

  900. </div>
    901. 

  901. <div class="ulist">
    902. 

  902. <ul>
    903. 

  903. <li>
    904. 

  904. <p><a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/light/TestPssmShadow.java">TestPssmShadow.java</a></p>
    905. 

  905. </li>
    906. 

  906. </ul>
    907. 

  907. </div>
    908. 

  908. <div class="imageblock" style="text-align: right">
    909. 

  909. <div class="content">
    910. 

  910. <img src="../../jme3/advanced/shadow.png" alt="A lit scene with PSSM drop shadows" height="200">
    911. 

  911. </div>
    912. 

  912. </div>
    913. 

  913. <div class="listingblock">
    914. 

  914. <div class="content">
    915. 

  915. <pre class="CodeRay highlight"><code data-lang="java"><span class="directive">private</span> PssmShadowRenderer pssmRenderer;
    916. 

  916. ...
    917. 

  917. public <span class="type">void</span> simpleInitApp() {
    918. 

  918.     ....
    919. 

  919.     pssmRenderer = <span class="keyword">new</span> PssmShadowRenderer(assetManager, <span class="integer">1024</span>, <span class="integer">3</span>);
    920. 

  920.     pssmRenderer.setDirection(<span class="keyword">new</span> Vector3f(-<span class="float">.5f</span>,-<span class="float">.5f</span>,-<span class="float">.5f</span>).normalizeLocal()); <span class="comment">// light direction</span>
    921. 

  921.     viewPort.addProcessor(pssmRenderer);</code></pre>
    922. 

  922. </div>
    923. 

  923. </div>
    924. 

  924. </div>
    925. 

  925. </div>
    926. 

  926. <div class="sect1">
    927. 

  927. <h2 id="screen-space-ambient-occlusion">Screen Space Ambient Occlusion</h2>
    928. 

  928. <div class="sectionbody">
    929. 

  929. <div class="paragraph">
    930. 

  930. <p>Full sample code</p>
    931. 

  931. </div>
    932. 

  932. <div class="ulist">
    933. 

  933. <ul>
    934. 

  934. <li>
    935. 

  935. <p><a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/post/TestSSAO.java">jme3/src/test/jme3test/post/TestSSAO.java</a> – Screen-Space Ambient Occlusion shadows</p>
    936. 

  936. </li>
    937. 

  937. <li>
    938. 

  938. <p><a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/post/TestTransparentSSAO.java">jme3/src/test/jme3test/post/TestTransparentSSAO.java</a> – Screen-Space Ambient Occlusion shadows plus transparancy</p>
    939. 

  939. </li>
    940. 

  940. <li>
    941. 

  941. <p><a href="http://hub.jmonkeyengine.org/2010/08/screen-space-ambient-occlusion-for-jmonkeyengine-3-0/">Screen Space Ambient Occlusion for jMonkeyEngine (article)</a></p>
    942. 

  942. </li>
    943. 

  943. </ul>
    944. 

  944. </div>
    945. 

  945. <div class="paragraph">
    946. 

  946. <p>Ambient Occlusion refers to the shadows which nearby objects cast on each other under an ambient lighting. Screen Space Ambient Occlusion (SSAO) approximates how light radiates in real life.</p>
    947. 

  947. </div>
    948. 

  948. <div class="paragraph">
    949. 

  949. <p>In JME3, SSAO is implemented by adding an instance of <code>com.jme3.post.SSAOFilter</code> to a viewport which already simulates shadows using another method such as DirectionalLightShadowRenderer.</p>
    950. 

  950. </div>
    951. 

  951. <div class="listingblock">
    952. 

  952. <div class="content">
    953. 

  953. <pre class="CodeRay highlight"><code data-lang="java">FilterPostProcessor fpp = <span class="keyword">new</span> FilterPostProcessor(assetManager);
    954. 

  954. SSAOFilter ssaoFilter = <span class="keyword">new</span> SSAOFilter(<span class="float">12.94f</span>, <span class="float">43.92f</span>, <span class="float">0.33f</span>, <span class="float">0.61f</span>);
    955. 

  955. fpp.addFilter(ssaoFilter);
    956. 

  956. viewPort.addProcessor(fpp);</code></pre>
    957. 

  957. </div>
    958. 

  958. </div>
    959. 

  959. <div class="paragraph">
    960. 

  960. <p><span class="image"><img src="../../jme3/advanced/shading-textured-ani.gif" alt="Shading with and without Ambient Occlusion" height=""></span></p>
    961. 

  961. </div>
    962. 

  962. </div>
    963. 

  963. </div>
    964. 

  964. </div>
    965. 

  965. <div id="footer">
    966. 

  966. <div id="footer-text">
    967. 

  967. Version <br>
    968. 

  968. Last updated 2016-06-05 15:58:32 UTC
    969. 

  969. </div>
    970. 

  970. </div>
    971. 

  971. </body>
    972. 

  972. </html>
    973.