Home Explore Help
Sign In
java
/
jMonkeyEngine-wiki
mirror of https://github.com/jMonkeyEngine/wiki.git
2
0
Fork 0
Files Issues 0 Wiki
Tree: eda43e4eb7
Branches Tags
jMonkeyEngine-w...
/
jme3
/
advanced
/
material_specification.html

material_specification.html 52 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942 
  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>jMonkeyEngine3 Material Specification</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>jMonkeyEngine3 Material Specification</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="#general-syntax">General Syntax</a></li>
    524. 

  524. <li><a href="#material-definition-files-j3md">Material Definition files (J3MD)</a>
    525. 

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

  526. <li><a href="#shaders">Shaders</a></li>
    527. 

  527. <li><a href="#syntax-of-a-j3md-file">Syntax of a J3MD file</a></li>
    528. 

  528. <li><a href="#techniques">Techniques</a></li>
    529. 

  529. <li><a href="#world-global-parameters">World/Global parameters</a></li>
    530. 

  530. <li><a href="#renderstate">RenderState</a></li>
    531. 

  531. </ul>
    532. 

  532. </li>
    533. 

  533. <li><a href="#material-instance-files-j3m">Material Instance files (J3M)</a>
    534. 

  534. <ul class="sectlevel2">
    535. 

  535. <li><a href="#java-interface-for-j3m">Java interface for J3M</a></li>
    536. 

  536. </ul>
    537. 

  537. </li>
    538. 

  538. <li><a href="#conclusion">Conclusion</a></li>
    539. 

  539. </ul>
    540. 

  540. </div>
    541. 

  541. </div>
    542. 

  542. <div id="content">
    543. 

  543. <div class="sect1">
    544. 

  544. <h2 id="general-syntax">General Syntax</h2>
    545. 

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

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

  547. <p>Material definitions and material instance files are formatted similarly to curly-bracket languages, in other words, you have “blocks and other “blocks nested in them, surrounded by curly-brackets. There are statements inside the blocks, the next statement begins after a new line, or a semi-colon to allow two statements on the same line. Comments are made by prefixing with two slashes, the <code>/* */</code> style comments are not allowed.</p>
    548. 

  548. </div>
    549. 

  549. <div class="paragraph">
    550. 

  550. <p><strong>Example:</strong></p>
    551. 

  551. </div>
    552. 

  552. <div class="listingblock">
    553. 

  553. <div class="content">
    554. 

  554. <pre class="CodeRay highlight"><code>RootBlock {
    555. 

  555.   // Comment
    556. 

  556.   SubBlock NameForTheBlock {
    557. 

  557.     Statement1 // Another comment
    558. 

  558.   }
    559. 

  559.   SubBlock2 {
    560. 

  560.     SubSubBlock {
    561. 

  561.       Statement2
    562. 

  562.       Statement3
    563. 

  563.       // two statements on the same line
    564. 

  564.       Statement4; Statement5
    565. 

  565.     }
    566. 

  566.   }
    567. 

  567.   SubBlock3
    568. 

  568.     { // bracket can be on next line as well
    569. 

  569.     }
    570. 

  570. }</code></pre>
    571. 

  571. </div>
    572. 

  572. </div>
    573. 

  573. <div class="paragraph">
    574. 

  574. <p>The syntax for J3MD and J3M files follows from this base format.</p>
    575. 

  575. </div>
    576. 

  576. </div>
    577. 

  577. </div>
    578. 

  578. <div class="sect1">
    579. 

  579. <h2 id="material-definition-files-j3md">Material Definition files (J3MD)</h2>
    580. 

  580. <div class="sectionbody">
    581. 

  581. <div class="paragraph">
    582. 

  582. <p>Material definitions provide the “logic for the material. Usually a shader that will handle drawing the object, and corresponding parameters that allow configuration of the shader. The J3MD file abstracts the shader and its configuration away from the user, allowing a simple interface where one can simply set a few parameters on the material to change its appearance and the way it&#8217;s handled.</p>
    583. 

  583. </div>
    584. 

  584. <div class="paragraph">
    585. 

  585. <p>Material definitions support multiple techniques, each technique describes a different way to draw the object. For example, currently in jME3, an additional technique is used to render shadow maps for example.</p>
    586. 

  586. </div>
    587. 

  587. <div class="sect2">
    588. 

  588. <h3 id="shaders">Shaders</h3>
    589. 

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

  590. <p>Shader support inside J3MD files is rather sophisticated. First, shaders may reference shader libraries, in a similar way to Java&#8217;s “import statement, or C++'s “include pre-processor directive. Shader libraries in turn, can also reference other shader libraries this way. In the end, it is possible for a shader to use many functions together from many libraries and combine them in ways to create a more advanced effect. For example, any shader that wishes to take advantage of hardware skinning, can just import the skinning shader library and use the function, without having to write the specific logic needed for hardware skinning.</p>
    591. 

  591. </div>
    592. 

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

  593. <p>Shaders can also take advantage of “defines that are specified inside material definitions.
    594. 

  594. The defines “bind into material parameters, so that a change in a material parameter can apply or remove a define from the corresponding shader. This allows the shader to completely change in behavior during run-time.</p>
    595. 

  595. </div>
    596. 

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

  597. <p>Although it is possible to use shader uniforms for the very same purpose, those may introduce slowdowns in older GPUs, that do not support branching. In that case, using defines can allow changing the way the shader works without using shader uniforms. In order to introduce a define into a shader, however, its source code must be changed, and therefore, it must be re-compiled. It is therefore not recommended to change define bound parameters often.</p>
    598. 

  598. </div>
    599. 

  599. </div>
    600. 

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

  601. <h3 id="syntax-of-a-j3md-file">Syntax of a J3MD file</h3>
    602. 

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

  603. <p>All J3MD files begin with <code>MaterialDef</code> as the root block, following that, is the name of the material def (in this example <code>Test Material 123</code>). The name is not used for anything important currently, except for debugging. The name is typed as is without quotes, and can have spaces.</p>
    604. 

  604. </div>
    605. 

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

  606. <p><strong>Example of a first line of a J3MD file:</strong></p>
    607. 

  607. </div>
    608. 

  608. <div class="listingblock">
    609. 

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

  610. <pre class="CodeRay highlight"><code>MaterialDef Test Material 123 {</code></pre>
    611. 

  611. </div>
    612. 

  612. </div>
    613. 

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

  614. <p>Inside a MaterialDef block, there can be at most one MaterialParameters block, and one or more <code>Technique</code> blocks.</p>
    615. 

  615. </div>
    616. 

  616. <div class="paragraph">
    617. 

  617. <p>Techniques may have an optional name, which specifies the name of the technique. If no name is specified for a technique, then its name is “Default, and it is used by default if the user does not specify another technique to use for the material.</p>
    618. 

  618. </div>
    619. 

  619. <div class="paragraph">
    620. 

  620. <p><strong>Example of J3MD:</strong></p>
    621. 

  621. </div>
    622. 

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

  623. <div class="content">
    624. 

  624. <pre class="CodeRay highlight"><code>MaterialDef Test Material 123 {
    625. 

  625.   MaterialParameters { }
    626. 

  626.   Technique { }
    627. 

  627.   Technique NamedTech { }
    628. 

  628. }</code></pre>
    629. 

  629. </div>
    630. 

  630. </div>
    631. 

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

  632. <p>Inside the MaterialParameters block, the parameters are specified. Every parameter has a type and a name. Material parameters are similar to Java variables in that aspect.</p>
    633. 

  633. </div>
    634. 

  634. <div class="paragraph">
    635. 

  635. <p><strong>Example of a MaterialParameters block:</strong></p>
    636. 

  636. </div>
    637. 

  637. <div class="listingblock">
    638. 

  638. <div class="content">
    639. 

  639. <pre class="CodeRay highlight"><code>MaterialParameters {
    640. 

  640.     Texture2D TexParam
    641. 

  641.     Color     ColorParam
    642. 

  642.     Vector3   VectorParam
    643. 

  643.     Boolean   BoolParam
    644. 

  644. // ...
    645. 

  645. }</code></pre>
    646. 

  646. </div>
    647. 

  647. </div>
    648. 

  648. <div class="paragraph">
    649. 

  649. <p>Whereas in the J3MD file, the parameter names and types are specified, in a J3M (Material instance) file, the values for these parameters are assigned, as will be shown later. This is how the materials are configured.</p>
    650. 

  650. </div>
    651. 

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

  652. <p>At the time of writing, the following types of parameters are allowed inside J3MD files: Int, Boolean, Float, Vector2, Vector3, Vector4, Texture2D, TextureCubeMap.</p>
    653. 

  653. </div>
    654. 

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

  655. <p>You can specify a default value for material parameters, inside material definitions, in the case that no value is specified in the material instance.</p>
    656. 

  656. </div>
    657. 

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

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

  659. <pre class="CodeRay highlight"><code>MaterialParameters {
    660. 

  660.      Float MyParam : 1
    661. 

  661. // ...
    662. 

  662. }</code></pre>
    663. 

  663. </div>
    664. 

  664. </div>
    665. 

  665. <div class="paragraph">
    666. 

  666. <p>1 will be used as the default value and sent to the shader if it has not been set by a meterial.setFloat() call.</p>
    667. 

  667. </div>
    668. 

  668. </div>
    669. 

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

  670. <h3 id="techniques">Techniques</h3>
    671. 

  671. <div class="paragraph">
    672. 

  672. <p>Techniques are more advanced blocks than the MaterialParameters block. Techniques may have nested blocks, any many types of statements.</p>
    673. 

  673. </div>
    674. 

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

  675. <p>In this section, the statements and nested blocks that are allowed inside the Technique block will be described.</p>
    676. 

  676. </div>
    677. 

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

  678. <p>The two most important statements, are the <code>FragmentShader</code> and <code>VertexShader</code> statements. These statements specify the shader to use for the technique, and are required inside the “Default technique. Both operate in the same way, after the statement, the language of the shader is specified, usually with a version number as well, for example <code>GLSL100</code> for OpenGL Shading Language version 1.00. Followed by a colon and an absolute path for an asset describing the actual shader source code. For GLSL, it is permitted to specify .glsl, .frag, and .vert files.</p>
    679. 

  679. </div>
    680. 

  680. <div class="paragraph">
    681. 

  681. <p>When the material is applied to an object, the shader has its uniforms set based on the material parameter values specified in the material instance. but the parameter is prefixed with an“m_.</p>
    682. 

  682. </div>
    683. 

  683. <div class="paragraph">
    684. 

  684. <p>For example, assuming the parameter <code>Shininess</code> is defined in the MaterialParameters block like so:</p>
    685. 

  685. </div>
    686. 

  686. <div class="listingblock">
    687. 

  687. <div class="content">
    688. 

  688. <pre class="CodeRay highlight"><code>MaterialParameters {
    689. 

  689.   Float Shininess
    690. 

  690. }</code></pre>
    691. 

  691. </div>
    692. 

  692. </div>
    693. 

  693. <div class="paragraph">
    694. 

  694. <p>The value of that parameter will map into an uniform with same name with the “m_ prefix in the GLSL shader:</p>
    695. 

  695. </div>
    696. 

  696. <div class="listingblock">
    697. 

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

  698. <pre class="CodeRay highlight"><code>uniform float m_Shininess;</code></pre>
    699. 

  699. </div>
    700. 

  700. </div>
    701. 

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

  702. <p>The letter <code>m</code> in the prefix stands for material.</p>
    703. 

  703. </div>
    704. 

  704. </div>
    705. 

  705. <div class="sect2">
    706. 

  706. <h3 id="world-global-parameters">World/Global parameters</h3>
    707. 

  707. <div class="paragraph">
    708. 

  708. <p>An important structure, that also relates to shaders, is the WorldParameters structure. It is similar in purpose to the MaterialParameters structure; it exposes various parameters to the shader, but it works differently. Whereas the user specified material parameters, world parameters are specified by the engine. In addition, the WorldParameters structure is nested in the Technique, because it is specific to the shader being used. For example, the Time world parameter specifies the time in seconds since the engine started running, the material can expose this parameter to the shader by specifying it in the WorldParameters structure like so:</p>
    709. 

  709. </div>
    710. 

  710. <div class="listingblock">
    711. 

  711. <div class="content">
    712. 

  712. <pre class="CodeRay highlight"><code>WorldParameters {
    713. 

  713.   Time
    714. 

  714. // ...
    715. 

  715. }</code></pre>
    716. 

  716. </div>
    717. 

  717. </div>
    718. 

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

  719. <p>The shader will be able to access this parameter through a uniform, also named <code>Time</code> but prefixed with <code>g_</code>:</p>
    720. 

  720. </div>
    721. 

  721. <div class="listingblock">
    722. 

  722. <div class="content">
    723. 

  723. <pre class="CodeRay highlight"><code>uniform float g_Time;</code></pre>
    724. 

  724. </div>
    725. 

  725. </div>
    726. 

  726. <div class="paragraph">
    727. 

  727. <p>The <code>g</code> letter stands for “global, which is considered a synonym with “world in the context of parameter scope.</p>
    728. 

  728. </div>
    729. 

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

  730. <p>There are many world parameters available for shaders, a comprehensive list will be specified elsewhere.</p>
    731. 

  731. </div>
    732. 

  732. </div>
    733. 

  733. <div class="sect2">
    734. 

  734. <h3 id="renderstate">RenderState</h3>
    735. 

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

  736. <p>The RenderState block specifies values for various render states in the rendering context. The RenderState block is nested inside the Technique block. There are many types of render states, and a comprehensive list will not be included in this document.</p>
    737. 

  737. </div>
    738. 

  738. <div class="paragraph">
    739. 

  739. <p>The most commonly used render state is alpha blending, to specify it for a particular technique, including a RenderState block with the statement <code>Blend Alpha</code>.</p>
    740. 

  740. </div>
    741. 

  741. <div class="paragraph">
    742. 

  742. <p><strong>Example:</strong></p>
    743. 

  743. </div>
    744. 

  744. <div class="listingblock">
    745. 

  745. <div class="content">
    746. 

  746. <pre class="CodeRay highlight"><code>RenderState {
    747. 

  747.  Blend Alpha
    748. 

  748. }</code></pre>
    749. 

  749. </div>
    750. 

  750. </div>
    751. 

  751. <div class="paragraph">
    752. 

  752. <p><strong>Full Example of a J3MD</strong></p>
    753. 

  753. </div>
    754. 

  754. <div class="paragraph">
    755. 

  755. <p>Included is a full example of a J3MD file using all the features learned:</p>
    756. 

  756. </div>
    757. 

  757. <div class="listingblock">
    758. 

  758. <div class="content">
    759. 

  759. <pre class="CodeRay highlight"><code>MaterialDef Test Material 123 {
    760. 

  760.   MaterialParameters {
    761. 

  761.     Float m_Shininess
    762. 

  762.     Texture2D m_MyTex
    763. 

  763.   }
    764. 

  764.   Technique {
    765. 

  765.     VertexShader GLSL100 : Common/MatDefs/Misc/MyShader.vert
    766. 

  766.     FragmentShader GLSL100 : Common/MatDefs/Misc/MyShader.frag
    767. 

  767.     WorldParameters {
    768. 

  768.       Time
    769. 

  769.     }
    770. 

  770.     RenderState {
    771. 

  771.       Blend Alpha
    772. 

  772.     }
    773. 

  773.   }
    774. 

  774. }</code></pre>
    775. 

  775. </div>
    776. 

  776. </div>
    777. 

  777. </div>
    778. 

  778. </div>
    779. 

  779. </div>
    780. 

  780. <div class="sect1">
    781. 

  781. <h2 id="material-instance-files-j3m">Material Instance files (J3M)</h2>
    782. 

  782. <div class="sectionbody">
    783. 

  783. <div class="paragraph">
    784. 

  784. <p>In comparison to J3MD files, material instance (J3M) files are significantly simpler. In most cases, the user will not have to modify or create his/her own J3MD files.</p>
    785. 

  785. </div>
    786. 

  786. <div class="paragraph">
    787. 

  787. <p>All J3M files begin with the word <code>Material</code> followed by the name of the material (once again, used for debugging only). Following the name, is a colon and the absolute asset path to the material definition (J3MD) file extended or implemented, followed by a curly-bracket.</p>
    788. 

  788. </div>
    789. 

  789. <div class="paragraph">
    790. 

  790. <p><strong>Example:</strong></p>
    791. 

  791. </div>
    792. 

  792. <div class="listingblock">
    793. 

  793. <div class="content">
    794. 

  794. <pre class="CodeRay highlight"><code>Material MyGrass : Common/MatDefs/Misc/TestMaterial.j3md {</code></pre>
    795. 

  795. </div>
    796. 

  796. </div>
    797. 

  797. <div class="paragraph">
    798. 

  798. <p>The material definition is a required component, depending on the material definition being used, the appearance and functionality of the material changes completely. Whereas the material definition provided the “logic for the material, the material instance provides the configuration for how this logic operates.</p>
    799. 

  799. </div>
    800. 

  800. <div class="paragraph">
    801. 

  801. <p>The J3M file includes only a single structure; MaterialParameters, analogous to the same-named structure in the J3MD file. Whereas the J3MD file specified the parameter names and types, the J3M file specifies the values for these parameters. By changing the parameters, the configuration of the parent J3MD changes, allowing a different effect to be achieved.</p>
    802. 

  802. </div>
    803. 

  803. <div class="paragraph">
    804. 

  804. <p>To specify a value for a parameter, one must specify first the parameter name, followed by a colon, and then followed by the parameter value. For texture parameters, the value is an absolute asset path pointing to the image file. Optionally, the path can be prefixed with the word “Flip in order to flip the image along the Y-axis, this may be needed for some models.</p>
    805. 

  805. </div>
    806. 

  806. <div class="paragraph">
    807. 

  807. <p><strong>Example of a MaterialParameters block in J3M:</strong></p>
    808. 

  808. </div>
    809. 

  809. <div class="listingblock">
    810. 

  810. <div class="content">
    811. 

  811. <pre class="CodeRay highlight"><code>MaterialParameters {
    812. 

  812.   m_Shininess : 20.0
    813. 

  813. }</code></pre>
    814. 

  814. </div>
    815. 

  815. </div>
    816. 

  816. <table class="tableblock frame-all grid-all spread">
    817. 

  817. <colgroup>
    818. 

  818. <col style="width: 50%;">
    819. 

  819. <col style="width: 50%;">
    820. 

  820. </colgroup>
    821. 

  821. <thead>
    822. 

  822. <tr>
    823. 

  823. <th class="tableblock halign-left valign-top">Param type</th>
    824. 

  824. <th class="tableblock halign-left valign-top">Value example</th>
    825. 

  825. </tr>
    826. 

  826. </thead>
    827. 

  827. <tbody>
    828. 

  828. <tr>
    829. 

  829. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    830. 

  830. <p>Int</p>
    831. 

  831. </div></div></td>
    832. 

  832. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    833. 

  833. <p>123</p>
    834. 

  834. </div></div></td>
    835. 

  835. </tr>
    836. 

  836. <tr>
    837. 

  837. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    838. 

  838. <p>Boolean</p>
    839. 

  839. </div></div></td>
    840. 

  840. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    841. 

  841. <p>true</p>
    842. 

  842. </div></div></td>
    843. 

  843. </tr>
    844. 

  844. <tr>
    845. 

  845. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    846. 

  846. <p>Float</p>
    847. 

  847. </div></div></td>
    848. 

  848. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    849. 

  849. <p>0.1</p>
    850. 

  850. </div></div></td>
    851. 

  851. </tr>
    852. 

  852. <tr>
    853. 

  853. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    854. 

  854. <p>Vector2</p>
    855. 

  855. </div></div></td>
    856. 

  856. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    857. 

  857. <p>0.1 5.6</p>
    858. 

  858. </div></div></td>
    859. 

  859. </tr>
    860. 

  860. <tr>
    861. 

  861. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    862. 

  862. <p>Vector3</p>
    863. 

  863. </div></div></td>
    864. 

  864. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    865. 

  865. <p>0.1 5.6 2.99</p>
    866. 

  866. </div></div></td>
    867. 

  867. </tr>
    868. 

  868. <tr>
    869. 

  869. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    870. 

  870. <p>Vector4=Color</p>
    871. 

  871. </div></div></td>
    872. 

  872. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    873. 

  873. <p>0.1 5.6 2.99 3</p>
    874. 

  874. </div></div></td>
    875. 

  875. </tr>
    876. 

  876. <tr>
    877. 

  877. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    878. 

  878. <p>Texture2D=TextureCubeMap</p>
    879. 

  879. </div></div></td>
    880. 

  880. <td class="tableblock halign-left valign-top"><div><div class="paragraph">
    881. 

  881. <p>Textures/MyTex.jpg</p>
    882. 

  882. </div></div></td>
    883. 

  883. </tr>
    884. 

  884. </tbody>
    885. 

  885. </table>
    886. 

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

  887. <p>}</p>
    888. 

  888. </div>
    889. 

  889. <div class="paragraph">
    890. 

  890. <p>The formatting of the value, depends on the type of the value that was specified in the J3MD file being extended. Examples are provided for every parameter type:</p>
    891. 

  891. </div>
    892. 

  892. <div class="paragraph">
    893. 

  893. <p><strong>Full example of a J3M</strong></p>
    894. 

  894. </div>
    895. 

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

  896. <div class="content">
    897. 

  897. <pre class="CodeRay highlight"><code>Material MyGrass : Common/MatDefs/Misc/TestMaterial.j3md {
    898. 

  898.   MaterialParameters {
    899. 

  899.     m_MyTex : Flip Textures/GrassTex.jpg
    900. 

  900.     m_Shininess : 20.0
    901. 

  901.   }
    902. 

  902. }</code></pre>
    903. 

  903. </div>
    904. 

  904. </div>
    905. 

  905. <div class="sect2">
    906. 

  906. <h3 id="java-interface-for-j3m">Java interface for J3M</h3>
    907. 

  907. <div class="paragraph">
    908. 

  908. <p>It is possible to generate an identical J3M file using Java code, by using the classes in the com.jme3.material package. Specifics of the <a href="http://jmonkeyengine.org/javadoc/com/jme3/material/Material.html">Material API</a> will not be provided in this document. The J3M file above is represented by this Java code:</p>
    909. 

  909. </div>
    910. 

  910. <div class="listingblock">
    911. 

  911. <div class="content">
    912. 

  912. <pre class="CodeRay highlight"><code data-lang="java"><span class="comment">// Create a material instance</span>
    913. 

  913. Material mat = <span class="keyword">new</span> Material(assetManager, <span class="string"><span class="delimiter">&quot;</span><span class="content">Common/MatDefs/Misc/
    914. 

  914.     TestMaterial.j3md</span><span class="delimiter">&quot;</span></span>);
    915. 

  915. <span class="comment">// Load the texture. Specify &quot;true&quot; for the flip flag in the TextureKey</span>
    916. 

  916. Texture tex =
    917. 

  917. assetManager.loadTexture(<span class="keyword">new</span> TextureKey(<span class="string"><span class="delimiter">&quot;</span><span class="content">Textures/GrassTex.jpg</span><span class="delimiter">&quot;</span></span>, <span class="predefined-constant">true</span>));
    918. 

  918. <span class="comment">// Set the parameters</span>
    919. 

  919. mat.setTexture(<span class="string"><span class="delimiter">&quot;</span><span class="content">MyTex</span><span class="delimiter">&quot;</span></span>, tex);
    920. 

  920. mat.setFloat(<span class="string"><span class="delimiter">&quot;</span><span class="content">Shininess</span><span class="delimiter">&quot;</span></span>, <span class="float">20.0f</span>);</code></pre>
    921. 

  921. </div>
    922. 

  922. </div>
    923. 

  923. </div>
    924. 

  924. </div>
    925. 

  925. </div>
    926. 

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

  927. <h2 id="conclusion">Conclusion</h2>
    928. 

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

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

  930. <p>Congratulations on being able to read this entire document! To reward your efforts, jMonkeyEngine.com will offer a free prize, please contact Momoko_Fan aka “Kirill Vainer with the password “bananapie to claim.</p>
    931. 

  931. </div>
    932. 

  932. </div>
    933. 

  933. </div>
    934. 

  934. </div>
    935. 

  935. <div id="footer">
    936. 

  936. <div id="footer-text">
    937. 

  937. Version <br>
    938. 

  938. Last updated 2016-06-05 15:58:32 UTC
    939. 

  939. </div>
    940. 

  940. </div>
    941. 

  941. </body>
    942. 

  942. </html>
    943.