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...
/
sdk
/
debugging_profiling_testing.html

debugging_profiling_testing.html 43 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818 
  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. <meta name="keywords" content="documentation, sdk, tool">
    9. 

  9. <title>jMonkeyEngine SDK: Debugging, Profiling, Testing</title>
    10. 

  10. <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">
    11. 

  11. <style>
    12. 

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

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

  14. /*@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";*/
    15. 

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

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

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

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

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

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

  21. body{margin:0}
    22. 

  22. a{background:transparent}
    23. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  38. img{border:0}
    39. 

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

  40. figure{margin:0}
    41. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  56. 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}
    57. 

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

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

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

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

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

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

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

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

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

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

  67. .hide{display:none}
    68. 

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

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

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

  71. select{width:100%}
    72. 

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

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

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

  75. .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}
    76. 

  76. 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}
    77. 

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

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

  79. a img{border:none}
    80. 

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

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

  82. 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}
    83. 

  83. 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}
    84. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  119. 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}
    120. 

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

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

  122. 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}
    123. 

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

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

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

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

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

  128. *: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}
    129. 

  129. 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}
    130. 

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

  131. 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}
    132. 

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

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

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

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

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

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

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

  139. #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}
    140. 

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

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

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

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

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

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

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

  147. #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}
    148. 

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

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

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

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

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

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

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

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

  156. #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}
    157. 

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

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

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

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

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

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

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

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

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

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

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

  168. #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}
    169. 

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

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

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

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

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

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

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

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

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

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

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

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

  181. #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}
    182. 

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

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

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

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

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

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

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

  189. #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}
    190. 

  190. #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}
    191. 

  191. #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}
    192. 

  192. #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}
    193. 

  193. #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}
    194. 

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

  195. .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}
    196. 

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

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

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

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

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

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

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

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

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

  205. .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}
    206. 

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

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

  208. .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}
    209. 

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

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

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

  212. .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}
    213. 

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

  214. .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}
    215. 

  215. .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}
    216. 

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

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

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

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

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

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

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

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

  224. .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}
    225. 

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

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

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

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

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

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

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

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

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

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

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

  236. .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}
    237. 

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

  238. .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)}
    239. 

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

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

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

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

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

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

  245. .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}
    246. 

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

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

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

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

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

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

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

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

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

  255. 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}
    256. 

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

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

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

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

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

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

  262. 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}
    263. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  286. 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}
    287. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  306. .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}
    307. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  322. #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}
    323. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  373. .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}
    374. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  419. </style>
    420. 

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

  421. <style>
    422. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  511. </style>
    512. 

  512. </head>
    513. 

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

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

  515. <h1>jMonkeyEngine SDK: Debugging, Profiling, Testing</h1>
    516. 

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

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

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

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

  520. </div>
    521. 

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

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

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

  524. <li><a href="#testing">Testing</a>
    525. 

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

  526. <li><a href="#creating-tests">Creating Tests</a></li>
    527. 

  527. <li><a href="#running-tests">Running Tests</a></li>
    528. 

  528. </ul>
    529. 

  529. </li>
    530. 

  530. <li><a href="#debugging">Debugging</a></li>
    531. 

  531. <li><a href="#profiling">Profiling</a>
    532. 

  532. <ul class="sectlevel3">
    533. 

  533. <li><a href="#installing-the-profiler">Installing the Profiler</a></li>
    534. 

  534. <li><a href="#monitoring-and-analyzing">Monitoring and Analyzing</a></li>
    535. 

  535. <li><a href="#comparing-snapshots">Comparing Snapshots</a></li>
    536. 

  536. <li><a href="#using-profiling-points">Using Profiling Points</a></li>
    537. 

  537. </ul>
    538. 

  538. </li>
    539. 

  539. </ul>
    540. 

  540. </div>
    541. 

  541. </div>
    542. 

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

  543. <div id="preamble">
    544. 

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

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

  546. <p>Debugging, testing and profiling are important parts of the development cycle. This documentation shows you how to make the most of the jMonkeyEngine SDK&#8217;s assistive features.</p>
    547. 

  547. </div>
    548. 

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

  549. <p>“</p>
    550. 

  550. </div>
    551. 

  551. </div>
    552. 

  552. </div>
    553. 

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

  554. <h2 id="testing">Testing</h2>
    555. 

  555. <div class="sectionbody">
    556. 

  556. <div class="paragraph">
    557. 

  557. <p>The jMonkeyEngine SDK supports the JUnit testing framework. It is a good practice to write tests (assertions) for each of your classes. Each test makes certain this “unit (e.g. method) meets its design and behaves as intended. Run your tests after each major change and you immediately see if you broke something.</p>
    558. 

  558. </div>
    559. 

  559. <div class="sect3">
    560. 

  560. <h4 id="creating-tests">Creating Tests</h4>
    561. 

  561. <div class="olist arabic">
    562. 

  562. <ol class="arabic">
    563. 

  563. <li>
    564. 

  564. <p>Right-click a Java file in the Projects window and choose Tools &gt; Create JUnit Tests.</p>
    565. 

  565. </li>
    566. 

  566. <li>
    567. 

  567. <p>Click OK. The jMonkeyEngine SDK creates a JUnit test skeleton in the Test Package directory.</p>
    568. 

  568. </li>
    569. 

  569. <li>
    570. 

  570. <p>The body of each generated test method is provided solely as a guide. In their place, you need to write your actual test cases!</p>
    571. 

  571. </li>
    572. 

  572. <li>
    573. 

  573. <p>You can use tests such as <code>assertTrue(), assertFalse(), assertEquals()</code>, or <code>assert()</code>.</p>
    574. 

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

  575. <ul>
    576. 

  576. <li>
    577. 

  577. <p>The following example assertions test an addition method: <code>assert( add(1, 1) == 2); assertTrue( add(7,-5) == add(-5,7) )…</code></p>
    578. 

  578. </li>
    579. 

  579. </ul>
    580. 

  580. </div>
    581. 

  581. </li>
    582. 

  582. <li>
    583. 

  583. <p>“Ideally, you write a test case for every method (100% coverage).</p>
    584. 

  584. </li>
    585. 

  585. </ol>
    586. 

  586. </div>
    587. 

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

  588. <p><strong>Tip:</strong> Use the Navigate menu to jump from a test to its tested class, and back!</p>
    589. 

  589. </div>
    590. 

  590. </div>
    591. 

  591. <div class="sect3">
    592. 

  592. <h4 id="running-tests">Running Tests</h4>
    593. 

  593. <div class="olist arabic">
    594. 

  594. <ol class="arabic">
    595. 

  595. <li>
    596. 

  596. <p>Run one or all tests:</p>
    597. 

  597. <div class="ulist">
    598. 

  598. <ul>
    599. 

  599. <li>
    600. 

  600. <p>Right-click the class in the Projects window and Choose Test File, or</p>
    601. 

  601. </li>
    602. 

  602. <li>
    603. 

  603. <p>Right-click the project and select Test to run all tests.</p>
    604. 

  604. </li>
    605. 

  605. </ul>
    606. 

  606. </div>
    607. 

  607. </li>
    608. 

  608. <li>
    609. 

  609. <p>Check the Test window to see successful tests (green) and failures (red).</p>
    610. 

  610. </li>
    611. 

  611. <li>
    612. 

  612. <p>If a test fails that has succeeded before, you know that your latest changes broke something!</p>
    613. 

  613. </li>
    614. 

  614. </ol>
    615. 

  615. </div>
    616. 

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

  617. <p>Using unit tests regularly allows you to detect side-effects on classes that you thought were unaffected by a code change.</p>
    618. 

  618. </div>
    619. 

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

  620. <p>See also:</p>
    621. 

  621. </div>
    622. 

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

  623. <ul>
    624. 

  624. <li>
    625. 

  625. <p><a href="http://netbeans.org/kb/docs/java/junit-intro.html">Writing JUnit Tests</a></p>
    626. 

  626. </li>
    627. 

  627. <li>
    628. 

  628. <p><a href="http://www.junit.org">http://www.junit.org</a></p>
    629. 

  629. </li>
    630. 

  630. <li>
    631. 

  631. <p><a href="http://download.oracle.com/javase/1.4.2/docs/guide/lang/assert.html">Java Assertions</a></p>
    632. 

  632. </li>
    633. 

  633. </ul>
    634. 

  634. </div>
    635. 

  635. </div>
    636. 

  636. </div>
    637. 

  637. </div>
    638. 

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

  639. <h2 id="debugging">Debugging</h2>
    640. 

  640. <div class="sectionbody">
    641. 

  641. <div class="paragraph">
    642. 

  642. <p>In the jMonkeyEngine SDK, you have access to a debugger to examine your application for errors such as deadlocks and NullPointerExeptions. You can set breakpoints, watch variables, and execute your code line-by-line to identify the source of a problem.</p>
    643. 

  643. </div>
    644. 

  644. <div class="olist arabic">
    645. 

  645. <ol class="arabic">
    646. 

  646. <li>
    647. 

  647. <p>First, you set breakpoints and/or watches before the problematic lines of code where you suspect the bug.</p>
    648. 

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

  649. <ul>
    650. 

  650. <li>
    651. 

  651. <p>If you want to watch a variable&#8217;s value: Right-click on a variable and select New Watch from the context menu.</p>
    652. 

  652. </li>
    653. 

  653. <li>
    654. 

  654. <p>If you want to step through the execution line by line: Right-click on a line and choose Toggle Line Breakpoint; a pink box appears as a mark.</p>
    655. 

  655. </li>
    656. 

  656. </ul>
    657. 

  657. </div>
    658. 

  658. </li>
    659. 

  659. <li>
    660. 

  660. <p>Choose “Debug &gt; Debug Main Project to start a debugger session for the whole project. Or, right-click a file and select Debug File to debug only one file.</p>
    661. 

  661. </li>
    662. 

  662. <li>
    663. 

  663. <p>The application starts running normally. If you have set a breakpoint, the execution stops in this line. Debugger windows open and print debugger output.</p>
    664. 

  664. </li>
    665. 

  665. <li>
    666. 

  666. <p>You can do many things now to track down a bug:</p>
    667. 

  667. <div class="ulist">
    668. 

  668. <ul>
    669. 

  669. <li>
    670. 

  670. <p>Inspect the values of local variables.</p>
    671. 

  671. </li>
    672. 

  672. <li>
    673. 

  673. <p>Use the Step buttons in the top to step into, out of, and over expressions while you watch the execution.</p>
    674. 

  674. </li>
    675. 

  675. <li>
    676. 

  676. <p>Navigate through your application&#8217;s call stack. Right-click on threads to suspend or resume them.</p>
    677. 

  677. </li>
    678. 

  678. <li>
    679. 

  679. <p>Choose Debug &gt; Evaluate Expression from the menu to evaluate an expression.</p>
    680. 

  680. </li>
    681. 

  681. <li>
    682. 

  682. <p>Move the mouse pointer over a variable to inspect its value in a tooltip.</p>
    683. 

  683. </li>
    684. 

  684. <li>
    685. 

  685. <p>Inspect the classes loaded on the heap and the percentage and number of object instances. Right-click a class in the Loaded Classes window and choose Show in Instances view (JDK 6 only).</p>
    686. 

  686. </li>
    687. 

  687. <li>
    688. 

  688. <p>And more…</p>
    689. 

  689. </li>
    690. 

  690. </ul>
    691. 

  691. </div>
    692. 

  692. </li>
    693. 

  693. <li>
    694. 

  694. <p>To stop debugging, choose Debug &gt; End Debugger Session from the menu.</p>
    695. 

  695. </li>
    696. 

  696. </ol>
    697. 

  697. </div>
    698. 

  698. </div>
    699. 

  699. </div>
    700. 

  700. <div class="sect1">
    701. 

  701. <h2 id="profiling">Profiling</h2>
    702. 

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

  703. <div class="paragraph">
    704. 

  704. <p>The profiler tool is used to monitor thread states, CPU performance, and memory usage of your jme3 application. It helps you detect memory leaks and bottlenecks in your game while it&#8217;s running.</p>
    705. 

  705. </div>
    706. 

  706. <div class="sect3">
    707. 

  707. <h4 id="installing-the-profiler">Installing the Profiler</h4>
    708. 

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

  709. <p>If you do not see a Profiler menu in the jMonkeyEngine SDK, you need to download the Profiler plugin first.</p>
    710. 

  710. </div>
    711. 

  711. <div class="olist arabic">
    712. 

  712. <ol class="arabic">
    713. 

  713. <li>
    714. 

  714. <p>Open the Tools &gt; Plugins menu, and got to the “Available plugins tab</p>
    715. 

  715. </li>
    716. 

  716. <li>
    717. 

  717. <p>Find the “Java Profiler plugin (“Java SE category) and check the Install box.</p>
    718. 

  718. </li>
    719. 

  719. <li>
    720. 

  720. <p>Click the install button and follow the instructions.</p>
    721. 

  721. </li>
    722. 

  722. <li>
    723. 

  723. <p>When you start the profiler for the first time, you are prompted to run a calibration once. Click OK in the “Profiler integration dialog to complete the installation process.</p>
    724. 

  724. </li>
    725. 

  725. </ol>
    726. 

  726. </div>
    727. 

  727. </div>
    728. 

  728. <div class="sect3">
    729. 

  729. <h4 id="monitoring-and-analyzing">Monitoring and Analyzing</h4>
    730. 

  730. <div class="olist arabic">
    731. 

  731. <ol class="arabic">
    732. 

  732. <li>
    733. 

  733. <p>Choose Profile Project from the Profile menu.</p>
    734. 

  734. </li>
    735. 

  735. <li>
    736. 

  736. <p>Select one of three tasks:</p>
    737. 

  737. <div class="ulist">
    738. 

  738. <ul>
    739. 

  739. <li>
    740. 

  740. <p><strong>Monitor Application</strong> – Collect high-level information about properties of the target JVM, including thread activity and memory allocations.</p>
    741. 

  741. </li>
    742. 

  742. <li>
    743. 

  743. <p><strong>Analyze CPU Performance</strong> – Collect detailed data on application performance, including the time to execute methods and the number of times the method is invoked.</p>
    744. 

  744. </li>
    745. 

  745. <li>
    746. 

  746. <p><strong>Analyze Memory Usage</strong> – Collect detailed data on object allocation and garbage collection.</p>
    747. 

  747. </li>
    748. 

  748. </ul>
    749. 

  749. </div>
    750. 

  750. </li>
    751. 

  751. <li>
    752. 

  752. <p>Click Run. Your application starts and runs normally.</p>
    753. 

  753. </li>
    754. 

  754. <li>
    755. 

  755. <p>Use the Profiling window to track and collect live profiling results while you application is running.</p>
    756. 

  756. </li>
    757. 

  757. </ol>
    758. 

  758. </div>
    759. 

  759. </div>
    760. 

  760. <div class="sect3">
    761. 

  761. <h4 id="comparing-snapshots">Comparing Snapshots</h4>
    762. 

  762. <div class="paragraph">
    763. 

  763. <p>Click the Take Snapshot button to capture the profiling data for later!</p>
    764. 

  764. </div>
    765. 

  765. <div class="ulist">
    766. 

  766. <ul>
    767. 

  767. <li>
    768. 

  768. <p>You can store and view snapshots in the Profiling window.</p>
    769. 

  769. </li>
    770. 

  770. <li>
    771. 

  771. <p>Choose Compare Snapshots from the profiler window to compare two selected snapshots</p>
    772. 

  772. </li>
    773. 

  773. </ul>
    774. 

  774. </div>
    775. 

  775. </div>
    776. 

  776. <div class="sect3">
    777. 

  777. <h4 id="using-profiling-points">Using Profiling Points</h4>
    778. 

  778. <div class="paragraph">
    779. 

  779. <p>Profiling points are similar to debugger breakpoints: You place them directly in the source code and they can trigger profiling behaviour when hit.</p>
    780. 

  780. </div>
    781. 

  781. <div class="ulist">
    782. 

  782. <ul>
    783. 

  783. <li>
    784. 

  784. <p>Open a class in the browser, right-click in a line, and select Profiling &gt; Insert Profiling Point to add a profiling point here.</p>
    785. 

  785. </li>
    786. 

  786. <li>
    787. 

  787. <p>Use Profiling points if you need a trigger to reset profiling results, take a snapshot or heap dump, record the timestamp or execution time of a code fragment, stop and start a load generator script (requires the load generator plugin).</p>
    788. 

  788. </li>
    789. 

  789. <li>
    790. 

  790. <p>Open the Profiling Points window to view, modify and delete the Profiling Points in your projects.</p>
    791. 

  791. </li>
    792. 

  792. </ul>
    793. 

  793. </div>
    794. 

  794. <div class="paragraph">
    795. 

  795. <p>See also:</p>
    796. 

  796. </div>
    797. 

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

  798. <ul>
    799. 

  799. <li>
    800. 

  800. <p><a href="http://netbeans.org/kb/docs/java/profiler-intro.html">Introduction to Profiling Java Applications (netbeans.org)</a></p>
    801. 

  801. </li>
    802. 

  802. <li>
    803. 

  803. <p><a href="http://netbeans.org/kb/docs/java/profiler-profilingpoints.html">Using Profiling Points (netbeans.org)</a></p>
    804. 

  804. </li>
    805. 

  805. </ul>
    806. 

  806. </div>
    807. 

  807. </div>
    808. 

  808. </div>
    809. 

  809. </div>
    810. 

  810. </div>
    811. 

  811. <div id="footer">
    812. 

  812. <div id="footer-text">
    813. 

  813. Version <br>
    814. 

  814. Last updated 2016-06-05 15:58:32 UTC
    815. 

  815. </div>
    816. 

  816. </div>
    817. 

  817. </body>
    818. 

  818. </html>
    819.