Acasă Explorează Ajutor
Autentificare
java
/
jMonkeyEngine-wiki
oglindă de https://github.com/jMonkeyEngine/wiki.git
2
0
Bifurcare 0
Fisiere Probleme 0 Wiki
Arbore: eda43e4eb7
Ramuri Etichete
jMonkeyEngine-w...
/
jme3
/
advanced
/
atom_framework
/
atomcore
/
cycle.html

cycle.html 45 KB
Istoric Crud

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791 
  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>cycle</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>cycle</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="#well-defined-cycles">Well defined Cycles</a>
    524. 

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

  525. <li><a href="#why-6">Why 6?</a></li>
    526. 

  526. <li><a href="#pull-or-push">Pull or push?</a></li>
    527. 

  527. </ul>
    528. 

  528. </li>
    529. 

  529. <li><a href="#customable-cycles">Customable cycles</a>
    530. 

  530. <ul class="sectlevel3">
    531. 

  531. <li><a href="#customable-routines">Customable routines</a></li>
    532. 

  532. <li><a href="#customable-rendering-bucket">Customable (rendering) bucket</a></li>
    533. 

  533. </ul>
    534. 

  534. </li>
    535. 

  535. <li><a href="#cycle-scale">Cycle &amp; Scale</a></li>
    536. 

  536. <li><a href="#technical-reviews">Technical reviews</a>
    537. 

  537. <ul class="sectlevel3">
    538. 

  538. <li><a href="#cycle-or-ring">Cycle (or ring)</a></li>
    539. 

  539. <li><a href="#cicular-or-ring-buffer">Cicular (or ring) buffer</a></li>
    540. 

  540. <li><a href="#is-there-a-real-cycle-or-just-a-lot-of-streams">Is there a real cycle? or just a lot of streams</a></li>
    541. 

  541. </ul>
    542. 

  542. </li>
    543. 

  543. </ul>
    544. 

  544. </div>
    545. 

  545. </div>
    546. 

  546. <div id="content">
    547. 

  547. <div class="sect1">
    548. 

  548. <h2 id="well-defined-cycles">Well defined Cycles</h2>
    549. 

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

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

  551. <p>Cycle are ordered activities which repeat over and over during the entire application life time. It&#8217;s usually referred as game loop.</p>
    552. 

  552. </div>
    553. 

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

  554. <p>If you see a cycle as a list (ordered collection) of actions that the application does one at a time. You will see the application Iterate over them. In the opposite view (or in the action body), a traveller (usually data) seen it drag from one to the next one, so call pull to next step.</p>
    555. 

  555. </div>
    556. 

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

  557. <p>As Atom also support reactive programming, it&#8217;s essential that developer should understand clearly what is the benefit of program with this direction or other. To get (Between) BEST OF BOTH WORLD!</p>
    558. 

  558. </div>
    559. 

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

  560. <h3 id="why-6">Why 6?</h3>
    561. 

  561. <div class="paragraph">
    562. 

  562. <p>Game programmer usually stick with 3 steps execution</p>
    563. 

  563. </div>
    564. 

  564. <div class="olist arabic">
    565. 

  565. <ol class="arabic">
    566. 

  566. <li>
    567. 

  567. <p>init</p>
    568. 

  568. </li>
    569. 

  569. <li>
    570. 

  570. <p>update</p>
    571. 

  571. </li>
    572. 

  572. <li>
    573. 

  573. <p>destroy</p>
    574. 

  574. </li>
    575. 

  575. </ol>
    576. 

  576. </div>
    577. 

  577. <div class="paragraph">
    578. 

  578. <p>Instead of that, Atom use 6 steps execution cycle:</p>
    579. 

  579. </div>
    580. 

  580. <div class="olist arabic">
    581. 

  581. <ol class="arabic">
    582. 

  582. <li>
    583. 

  583. <p>init</p>
    584. 

  584. </li>
    585. 

  585. <li>
    586. 

  586. <p>start</p>
    587. 

  587. </li>
    588. 

  588. <li>
    589. 

  589. <p>load</p>
    590. 

  590. </li>
    591. 

  591. <li>
    592. 

  592. <p>config</p>
    593. 

  593. </li>
    594. 

  594. <li>
    595. 

  595. <p>update</p>
    596. 

  596. </li>
    597. 

  597. <li>
    598. 

  598. <p>finish</p>
    599. 

  599. </li>
    600. 

  600. </ol>
    601. 

  601. </div>
    602. 

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

  603. <p>These 6, I carefully learnt from other “good module and component framework I 've use: Wicket, OSGi,Spring…they have different steps number!</p>
    604. 

  604. </div>
    605. 

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

  606. <p><a href="http://wicketguide.comsysto.com/guide/chapter6.html#chapter6_1">http://wicketguide.comsysto.com/guide/chapter6.html#chapter6_1</a></p>
    607. 

  607. </div>
    608. 

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

  609. <p><a href="http://en.wikipedia.org/wiki/OSGi#Life-cycle">http://en.wikipedia.org/wiki/OSGi#Life-cycle</a></p>
    610. 

  610. </div>
    611. 

  611. <div class="paragraph">
    612. 

  612. <p><a href="http://www.tutorialspoint.com/spring/spring_bean_life_cycle.htm">http://www.tutorialspoint.com/spring/spring_bean_life_cycle.htm</a></p>
    613. 

  613. </div>
    614. 

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

  615. <p>The reason of these 6 step routine compare to 2,3,4,5.. or any other division is to support lazy loading, heavy task, gabage collection wise, much more…</p>
    616. 

  616. </div>
    617. 

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

  618. <p>So we usually have these 3 main methods:</p>
    619. 

  619. </div>
    620. 

  620. <div class="literalblock">
    621. 

  621. <div class="content">
    622. 

  622. <pre>init , start , end</pre>
    623. 

  623. </div>
    624. 

  624. </div>
    625. 

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

  626. <p>For a real-time game, we need 2 more:</p>
    627. 

  627. </div>
    628. 

  628. <div class="literalblock">
    629. 

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

  630. <pre>load, update</pre>
    631. 

  631. </div>
    632. 

  632. </div>
    633. 

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

  634. <p>“Config method is kind of a replicate of “init or “load, or confusion of these two, even can be done in “update somehow but in fact, it&#8217;s worth to be separated. The config step will help you gain a lot in the way to extend the frameworks or to adapt/scale  your game to smaller or bigger usecase, anyway 6 “is not too much but enough !</p>
    635. 

  635. </div>
    636. 

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

  637. <p>Anyway this is a common cycle and compromise between ICycle who join the Atom conversations; that&#8217;s hook in methods (classic style isn&#8217;t it?). Beside of that, you can define your own routines through safe tasks and channels which provided by AtomMain. Though this tunnels, all your operations are guarantee to be not conflict in concurrent term with any other jobs of Managers, actors or helpers. So the Data is for you until you end the tasks (or be shut by forced because timeout for ex)!!</p>
    638. 

  638. </div>
    639. 

  639. </div>
    640. 

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

  641. <h3 id="pull-or-push">Pull or push?</h3>
    642. 

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

  643. <p>As said in the analysis about JME3&#8217;s patterns, especially rendering and update loop, it&#8217;s pull and push at the same time. Confused? Yes it&#8217;s… Why is so confused?</p>
    644. 

  644. </div>
    645. 

  645. <div class="paragraph">
    646. 

  646. <p>Java developers are “toooo familiar with MVC architecture that bring to us by Swing and all classic sun solutions. That&#8217;s why we find them in every programming books and every beginner&#8217;s articles, especially if you develops game in desktop, (obviously in swing also). OpenGL and LWJGL also start as window based solution. So that we get “used to it… Latter, a lot of web frameworks also make tanged mess of push &amp; pull concepts?</p>
    647. 

  647. </div>
    648. 

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

  649. <p>Swing-MVC concepts are embeded in a event-driven enviroment… and it&#8217;s actually pull.</p>
    650. 

  650. </div>
    651. 

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

  652. <p>Real-time application can be event-driven or not. As my exprience, apply this Swing-MVC to real-time application not usually help greatly but sounds very confused and blury. It can help if you too familiar with it anyway, but be careful or you break the MVC contracts easily and make it not useful. You can blindy apply it without concerning of consequence, but that don’t make any sense.</p>
    653. 

  653. </div>
    654. 

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

  655. <p>The solid and only reason to say JME3 is pull and push, and why we still has to stop once for a while because of OpenGL via LWJGL is still monotholic! Not the GPU processing or GPU-CPU data exchange. So we still have to stop at the renderer&#8217;s door, knock and wait until its done, then go to next step? Umh not quite.</p>
    656. 

  656. </div>
    657. 

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

  658. <p>But to do this, we have to not depend in the update() and render() methods to get to total freedom.</p>
    659. 

  659. </div>
    660. 

  660. <div class="sect3">
    661. 

  661. <h4 id="concurrent-parallel-world">Concurrent / Parallel world</h4>
    662. 

  662. <div class="paragraph">
    663. 

  663. <p>Welcome to the parallel world which some time the well-defined cycle not even exist.</p>
    664. 

  664. </div>
    665. 

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

  666. <p>But the routine or the flow does exist indeed!</p>
    667. 

  667. </div>
    668. 

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

  669. <p>Just look at how your “data or “signal actually run through your systems, though “node and “stages as a network of roads &amp; cars. This actually a well-study area known as data flow analysis. In a perspective, data seem to be “pushed from sources to targets. Some may also view its as data are “requested by some nodes and “pulled by those nodes.</p>
    670. 

  670. </div>
    671. 

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

  672. <p><a href="https://github.com/Netflix/RxJava/wiki">https://github.com/Netflix/RxJava/wiki</a></p>
    673. 

  673. </div>
    674. 

  674. </div>
    675. 

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

  676. <h4 id="what-is-the-new-routines-options">What is the new routines options?</h4>
    677. 

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

  678. <p>Even if “Cycle- which we used to known is just a conceptual view of points, my solution for this problem is to declare several new kinds of well-defined “Cycle :</p>
    679. 

  679. </div>
    680. 

  680. <div class="olist arabic">
    681. 

  681. <ol class="arabic">
    682. 

  682. <li>
    683. 

  683. <p>Push cycle</p>
    684. 

  684. </li>
    685. 

  685. <li>
    686. 

  686. <p>Pull cycle</p>
    687. 

  687. </li>
    688. 

  688. <li>
    689. 

  689. <p>Non-cycle</p>
    690. 

  690. </li>
    691. 

  691. </ol>
    692. 

  692. </div>
    693. 

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

  694. <p>… because defining routines in Atom is not only free but also helps in a lot of situations like when you interact with GUIs, networks or webs.</p>
    695. 

  695. </div>
    696. 

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

  697. <h5 id="pull-cycle">Pull cycle</h5>
    698. 

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

  699. <p>To connect to Swing MVC (also a pull cycle) with events, you can wrap them in Actors and let events send as messages between actors. The Swing actor in the EDT act as the brigde here.</p>
    700. 

  700. </div>
    701. 

  701. </div>
    702. 

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

  703. <h5 id="push-cycle">Push cycle</h5>
    704. 

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

  705. <p>As in functional reactive programming and flow based programming, functions (small piece of jobs) are flow with their data. A flow is not a well defined cycle but a routine and can be monitored.</p>
    706. 

  706. </div>
    707. 

  707. </div>
    708. 

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

  709. <h5 id="non-cycle">Non-cycle</h5>
    710. 

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

  711. <p>A serial of Tasks can also form atribinary routines ( non-cycle) and be coordinated together via Data they exchange.</p>
    712. 

  712. </div>
    713. 

  713. </div>
    714. 

  714. </div>
    715. 

  715. </div>
    716. 

  716. </div>
    717. 

  717. </div>
    718. 

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

  719. <h2 id="customable-cycles">Customable cycles</h2>
    720. 

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

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

  722. <h4 id="customable-routines">Customable routines</h4>
    723. 

  723. <div class="paragraph">
    724. 

  724. <p>Via tasks and workers, you can atribinary make your own cycle that do anything around and later participate in the rendering stage and JME logic stage (if they want).</p>
    725. 

  725. </div>
    726. 

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

  727. <p>This freedom of doing things (in parallel if you want) is thanks to lock-free concurrent algorimths and data structure that Atom use. In other hand, the synchonizing problem is under research!</p>
    728. 

  728. </div>
    729. 

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

  730. <p>Read: <a href="../../../../jme3/advanced/atom_framework/atomcore/concurrent.html">AtomPar</a></p>
    731. 

  731. </div>
    732. 

  732. </div>
    733. 

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

  734. <h4 id="customable-rendering-bucket">Customable (rendering) bucket</h4>
    735. 

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

  736. <p>Bucket is a way to layered your rendering queue into layers or separate them into different categories (aka buckets) to handle differently.</p>
    737. 

  737. </div>
    738. 

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

  739. <p>With a composable comperator, a sub-list from a list, or a sub-tree from a tree, even a sub-graph from a entire scene graph can be extracted, or the whole collection can be sorted arcordingly. Custom bucket in Atom framework is implemented in AtomLight package to extend JME3 rendering pipeline.</p>
    740. 

  740. </div>
    741. 

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

  742. <p>Note that a custom bucket is not very efficient! Even though if you enable a setting, Atom will take care of its render order and the update will be “IO wise with special indexing structure call B-Tree. If you use it without cautions it can require a lot of memory and make your rendering suffer.</p>
    743. 

  743. </div>
    744. 

  744. </div>
    745. 

  745. </div>
    746. 

  746. </div>
    747. 

  747. <div class="sect1">
    748. 

  748. <h2 id="cycle-scale">Cycle &amp; Scale</h2>
    749. 

  749. <div class="sectionbody">
    750. 

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

  751. <p>You can see there is a trend for networks call non blocking IO, which Node.js is the first most and remarkable success. In that world, there is actually not a wellform cycle or turn at all. Because if there is a Queue or a lock, a insist port holder or an strict order (like a cycle), it can not scale at all!!</p>
    752. 

  752. </div>
    753. 

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

  754. <p>In fact the atribinary networks and async data signals have a lot more problems than we can possible imagine. Not everything can be fast and precise…Some parts (services) may be slow by intend, some parts cause errors frequently.</p>
    755. 

  755. </div>
    756. 

  756. <div class="paragraph">
    757. 

  757. <p>The fault torrent architecture of AtomEx make sure some sercurity and transactional problems are shielded. AtomDust in another hand focus in highly loose mobile devices and atribinay short range connections. Those carefully design systems for usecases actually make Atom suitable even without a real Cycle.</p>
    758. 

  758. </div>
    759. 

  759. </div>
    760. 

  760. </div>
    761. 

  761. <div class="sect1">
    762. 

  762. <h2 id="technical-reviews">Technical reviews</h2>
    763. 

  763. <div class="sectionbody">
    764. 

  764. <div class="sect3">
    765. 

  765. <h4 id="cycle-or-ring">Cycle (or ring)</h4>
    766. 

  766. 

  767. </div>
    768. 

  768. <div class="sect3">
    769. 

  769. <h4 id="cicular-or-ring-buffer">Cicular (or ring) buffer</h4>
    770. 

  770. <div class="paragraph">
    771. 

  771. <p>Ring buffer is fast way to make concurrent real time data streaming…</p>
    772. 

  772. </div>
    773. 

  773. <div class="paragraph">
    774. 

  774. <p><a href="http://mechanitis.blogspot.com/2011/06/dissecting-disruptor-whats-so-special.html">http://mechanitis.blogspot.com/2011/06/dissecting-disruptor-whats-so-special.html</a></p>
    775. 

  775. </div>
    776. 

  776. </div>
    777. 

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

  778. <h4 id="is-there-a-real-cycle-or-just-a-lot-of-streams">Is there a real cycle? or just a lot of streams</h4>
    779. 

  779. 

  780. </div>
    781. 

  781. </div>
    782. 

  782. </div>
    783. 

  783. </div>
    784. 

  784. <div id="footer">
    785. 

  785. <div id="footer-text">
    786. 

  786. Version <br>
    787. 

  787. Last updated 2016-06-05 15:58:32 UTC
    788. 

  788. </div>
    789. 

  789. </div>
    790. 

  790. </body>
    791. 

  791. </html>
    792.