416 lines
48 KiB
HTML
416 lines
48 KiB
HTML
<!DOCTYPE html>
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
||
<title>Documentation.html</title>
|
||
<meta name="generator" content="Haroopad 0.13.1" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
|
||
<style>div.oembedall-githubrepos{border:1px solid #DDD;border-radius:4px;list-style-type:none;margin:0 0 10px;padding:8px 10px 0;font:13.34px/1.4 helvetica,arial,freesans,clean,sans-serif;width:452px;background-color:#fff}div.oembedall-githubrepos .oembedall-body{background:-moz-linear-gradient(center top,#FAFAFA,#EFEFEF);background:-webkit-gradient(linear,left top,left bottom,from(#FAFAFA),to(#EFEFEF));border-bottom-left-radius:4px;border-bottom-right-radius:4px;border-top:1px solid #EEE;margin-left:-10px;margin-top:8px;padding:5px 10px;width:100%}div.oembedall-githubrepos h3{font-size:14px;margin:0;padding-left:18px;white-space:nowrap}div.oembedall-githubrepos p.oembedall-description{color:#444;font-size:12px;margin:0 0 3px}div.oembedall-githubrepos p.oembedall-updated-at{color:#888;font-size:11px;margin:0}div.oembedall-githubrepos ul.oembedall-repo-stats{border:none;float:right;font-size:11px;font-weight:700;padding-left:15px;position:relative;z-index:5;margin:0}div.oembedall-githubrepos ul.oembedall-repo-stats li{border:none;color:#666;display:inline-block;list-style-type:none;margin:0!important}div.oembedall-githubrepos ul.oembedall-repo-stats li a{background-color:transparent;border:none;color:#666!important;background-position:5px -2px;background-repeat:no-repeat;border-left:1px solid #DDD;display:inline-block;height:21px;line-height:21px;padding:0 5px 0 23px}div.oembedall-githubrepos ul.oembedall-repo-stats li:first-child a{border-left:medium none;margin-right:-3px}div.oembedall-githubrepos ul.oembedall-repo-stats li a:hover{background:5px -27px no-repeat #4183C4;color:#FFF!important;text-decoration:none}div.oembedall-githubrepos ul.oembedall-repo-stats li:first-child a:hover{border-bottom-left-radius:3px;border-top-left-radius:3px}ul.oembedall-repo-stats li:last-child a:hover{border-bottom-right-radius:3px;border-top-right-radius:3px}span.oembedall-closehide{background-color:#aaa;border-radius:2px;cursor:pointer;margin-right:3px}div.oembedall-container{margin-top:5px;text-align:left}.oembedall-ljuser{font-weight:700}.oembedall-ljuser img{vertical-align:bottom;border:0;padding-right:1px}.oembedall-stoqembed{border-bottom:1px dotted #999;float:left;overflow:hidden;width:730px;line-height:1;background:#FFF;color:#000;font-family:Arial,Liberation Sans,DejaVu Sans,sans-serif;font-size:80%;text-align:left;margin:0;padding:0}.oembedall-stoqembed a{color:#07C;text-decoration:none;margin:0;padding:0}.oembedall-stoqembed a:hover{text-decoration:underline}.oembedall-stoqembed a:visited{color:#4A6B82}.oembedall-stoqembed h3{font-family:Trebuchet MS,Liberation Sans,DejaVu Sans,sans-serif;font-size:130%;font-weight:700;margin:0;padding:0}.oembedall-stoqembed .oembedall-reputation-score{color:#444;font-size:120%;font-weight:700;margin-right:2px}.oembedall-stoqembed .oembedall-user-info{height:35px;width:185px}.oembedall-stoqembed .oembedall-user-info .oembedall-user-gravatar32{float:left;height:32px;width:32px}.oembedall-stoqembed .oembedall-user-info .oembedall-user-details{float:left;margin-left:5px;overflow:hidden;white-space:nowrap;width:145px}.oembedall-stoqembed .oembedall-question-hyperlink{font-weight:700}.oembedall-stoqembed .oembedall-stats{background:#EEE;margin:0 0 0 7px;padding:4px 7px 6px;width:58px}.oembedall-stoqembed .oembedall-statscontainer{float:left;margin-right:8px;width:86px}.oembedall-stoqembed .oembedall-votes{color:#555;padding:0 0 7px;text-align:center}.oembedall-stoqembed .oembedall-vote-count-post{font-size:240%;color:#808185;display:block;font-weight:700}.oembedall-stoqembed .oembedall-views{color:#999;padding-top:4px;text-align:center}.oembedall-stoqembed .oembedall-status{margin-top:-3px;padding:4px 0;text-align:center;background:#75845C;color:#FFF}.oembedall-stoqembed .oembedall-status strong{color:#FFF;display:block;font-size:140%}.oembedall-stoqembed .oembedall-summary{float:left;width:635px}.oembedall-stoqembed .oembedall-excerpt{line-height:1.2;margin:0;padding:0 0 5px}.oembedall-stoqembed .oembedall-tags{float:left;line-height:18px}.oembedall-stoqembed .oembedall-tags a:hover{text-decoration:none}.oembedall-stoqembed .oembedall-post-tag{background-color:#E0EAF1;border-bottom:1px solid #3E6D8E;border-right:1px solid #7F9FB6;color:#3E6D8E;font-size:90%;line-height:2.4;margin:2px 2px 2px 0;padding:3px 4px;text-decoration:none;white-space:nowrap}.oembedall-stoqembed .oembedall-post-tag:hover{background-color:#3E6D8E;border-bottom:1px solid #37607D;border-right:1px solid #37607D;color:#E0EAF1}.oembedall-stoqembed .oembedall-fr{float:right}.oembedall-stoqembed .oembedall-statsarrow{background-image:url(http://cdn.sstatic.net/stackoverflow/img/sprites.png?v=3);background-repeat:no-repeat;overflow:hidden;background-position:0 -435px;float:right;height:13px;margin-top:12px;width:7px}.oembedall-facebook1{border:1px solid #1A3C6C;padding:0;font:13.34px/1.4 verdana;width:500px}.oembedall-facebook2{background-color:#627add}.oembedall-facebook2 a{color:#e8e8e8;text-decoration:none}.oembedall-facebookBody{background-color:#fff;vertical-align:top;padding:5px}.oembedall-facebookBody .contents{display:inline-block;width:100%}.oembedall-facebookBody div img{float:left;margin-right:5px}div.oembedall-lanyard{-webkit-box-shadow:none;-webkit-transition-delay:0s;-webkit-transition-duration:.4000000059604645s;-webkit-transition-property:width;-webkit-transition-timing-function:cubic-bezier(0.42,0,.58,1);background-attachment:scroll;background-clip:border-box;background-color:transparent;background-image:none;background-origin:padding-box;border-width:0;box-shadow:none;color:#112644;display:block;float:left;font-family:'Trebuchet MS',Trebuchet,sans-serif;font-size:16px;height:253px;line-height:19px;margin:0;max-width:none;min-height:0;outline:#112644 0;overflow-x:visible;overflow-y:visible;padding:0;position:relative;text-align:left;vertical-align:baseline;width:804px}div.oembedall-lanyard .tagline{font-size:1.5em}div.oembedall-lanyard .wrapper{overflow:hidden;clear:both}div.oembedall-lanyard .split{float:left;display:inline}div.oembedall-lanyard .prominent-place .flag:active,div.oembedall-lanyard .prominent-place .flag:focus,div.oembedall-lanyard .prominent-place .flag:hover,div.oembedall-lanyard .prominent-place .flag:link,div.oembedall-lanyard .prominent-place .flag:visited{float:left;display:block;width:48px;height:48px;position:relative;top:-5px;margin-right:10px}div.oembedall-lanyard .place-context{font-size:.889em}div.oembedall-lanyard .prominent-place .sub-place{display:block}div.oembedall-lanyard .prominent-place{font-size:1.125em;line-height:1.1em;font-weight:400}div.oembedall-lanyard .main-date{color:#8CB4E0;font-weight:700;line-height:1.1}div.oembedall-lanyard .first{width:48.57%;margin:0 0 0 2.857%}.mermaid .label{color:#333}.node circle,.node polygon,.node rect{fill:#cde498;stroke:#13540c;stroke-width:1px}.edgePath .path{stroke:green;stroke-width:1.5px}.cluster rect{fill:#cdffb2;rx:40;stroke:#6eaa49;stroke-width:1px}.cluster text{fill:#333}.actor{stroke:#13540c;fill:#cde498}text.actor{fill:#000;stroke:none}.actor-line{stroke:grey}.messageLine0{stroke-width:1.5;stroke-dasharray:"2 2";marker-end:"url(#arrowhead)";stroke:#333}.messageLine1{stroke-width:1.5;stroke-dasharray:"2 2";stroke:#333}#arrowhead{fill:#333}#crosshead path{fill:#333!important;stroke:#333!important}.messageText{fill:#333;stroke:none}.labelBox{stroke:#326932;fill:#cde498}.labelText,.loopText{fill:#000;stroke:none}.loopLine{stroke-width:2;stroke-dasharray:"2 2";marker-end:"url(#arrowhead)";stroke:#326932}.note{stroke:#6eaa49;fill:#fff5ad}.noteText{fill:#000;stroke:none;font-family:'trebuchet ms',verdana,arial;font-size:14px}.section{stroke:none;opacity:.2}.section0,.section2{fill:#6eaa49}.section1,.section3{fill:#fff;opacity:.2}.sectionTitle0,.sectionTitle1,.sectionTitle2,.sectionTitle3{fill:#333}.sectionTitle{text-anchor:start;font-size:11px;text-height:14px}.grid .tick{stroke:lightgrey;opacity:.3;shape-rendering:crispEdges}.grid path{stroke-width:0}.today{fill:none;stroke:red;stroke-width:2px}.task{stroke-width:2}.taskText{text-anchor:middle;font-size:11px}.taskTextOutsideRight{fill:#000;text-anchor:start;font-size:11px}.taskTextOutsideLeft{fill:#000;text-anchor:end;font-size:11px}.taskText0,.taskText1,.taskText2,.taskText3{fill:#fff}.task0,.task1,.task2,.task3{fill:#487e3a;stroke:#13540c}.taskTextOutside0,.taskTextOutside1,.taskTextOutside2,.taskTextOutside3{fill:#000}.active0,.active1,.active2,.active3{fill:#cde498;stroke:#13540c}.activeText0,.activeText1,.activeText2,.activeText3{fill:#000!important}.done0,.done1,.done2,.done3{stroke:grey;fill:lightgrey;stroke-width:2}.doneText0,.doneText1,.doneText2,.doneText3{fill:#000!important}.crit0,.crit1,.crit2,.crit3{stroke:#f88;fill:red;stroke-width:2}.activeCrit0,.activeCrit1,.activeCrit2,.activeCrit3{stroke:#f88;fill:#cde498;stroke-width:2}.doneCrit0,.doneCrit1,.doneCrit2,.doneCrit3{stroke:#f88;fill:lightgrey;stroke-width:2;cursor:pointer;shape-rendering:crispEdges}.activeCritText0,.activeCritText1,.activeCritText2,.activeCritText3,.doneCritText0,.doneCritText1,.doneCritText2,.doneCritText3{fill:#000!important}.titleText{text-anchor:middle;font-size:18px;fill:#000}text{font-family:'trebuchet ms',verdana,arial;font-size:14px}html{height:100%}body{margin:0!important;padding:5px 20px 26px!important;background-color:#fff;font-family:"Lucida Grande","Segoe UI","Apple SD Gothic Neo","Malgun Gothic","Lucida Sans Unicode",Helvetica,Arial,sans-serif;font-size:.9em;overflow-x:hidden;overflow-y:auto}br,h1,h2,h3,h4,h5,h6{clear:both}hr.page{background:url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAYAAAAECAYAAACtBE5DAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyJpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuMC1jMDYwIDYxLjEzNDc3NywgMjAxMC8wMi8xMi0xNzozMjowMCAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENTNSBNYWNpbnRvc2giIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6OENDRjNBN0E2NTZBMTFFMEI3QjRBODM4NzJDMjlGNDgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6OENDRjNBN0I2NTZBMTFFMEI3QjRBODM4NzJDMjlGNDgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo4Q0NGM0E3ODY1NkExMUUwQjdCNEE4Mzg3MkMyOUY0OCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo4Q0NGM0E3OTY1NkExMUUwQjdCNEE4Mzg3MkMyOUY0OCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PqqezsUAAAAfSURBVHjaYmRABcYwBiM2QSA4y4hNEKYDQxAEAAIMAHNGAzhkPOlYAAAAAElFTkSuQmCC) repeat-x;border:0;height:3px;padding:0}hr.underscore{border-top-style:dashed!important}body >:first-child{margin-top:0!important}img.plugin{box-shadow:0 1px 3px rgba(0,0,0,.1);border-radius:3px}iframe{border:0}figure{-webkit-margin-before:0;-webkit-margin-after:0;-webkit-margin-start:0;-webkit-margin-end:0}kbd{border:1px solid #aaa;-moz-border-radius:2px;-webkit-border-radius:2px;border-radius:2px;-moz-box-shadow:1px 2px 2px #ddd;-webkit-box-shadow:1px 2px 2px #ddd;box-shadow:1px 2px 2px #ddd;background-color:#f9f9f9;background-image:-moz-linear-gradient(top,#eee,#f9f9f9,#eee);background-image:-o-linear-gradient(top,#eee,#f9f9f9,#eee);background-image:-webkit-linear-gradient(top,#eee,#f9f9f9,#eee);background-image:linear-gradient(top,#eee,#f9f9f9,#eee);padding:1px 3px;font-family:inherit;font-size:.85em}.oembeded .oembed_photo{display:inline-block}img[data-echo]{margin:25px 0;width:100px;height:100px;background:url(../img/ajax.gif) center center no-repeat #fff}.spinner{display:inline-block;width:10px;height:10px;margin-bottom:-.1em;border:2px solid rgba(0,0,0,.5);border-top-color:transparent;border-radius:100%;-webkit-animation:spin 1s infinite linear;animation:spin 1s infinite linear}.spinner:after{content:'';display:block;width:0;height:0;position:absolute;top:-6px;left:0;border:4px solid transparent;border-bottom-color:rgba(0,0,0,.5);-webkit-transform:rotate(45deg);transform:rotate(45deg)}@-webkit-keyframes spin{to{-webkit-transform:rotate(360deg)}}@keyframes spin{to{transform:rotate(360deg)}}p.toc{margin:0!important}p.toc ul{padding-left:10px}p.toc>ul{padding:10px;margin:0 10px;display:inline-block;border:1px solid #ededed;border-radius:5px}p.toc li,p.toc ul{list-style-type:none}p.toc li{width:100%;padding:0;overflow:hidden}p.toc li a::after{content:"."}p.toc li a:before{content:"• "}p.toc h5{text-transform:uppercase}p.toc .title{float:left;padding-right:3px}p.toc .number{margin:0;float:right;padding-left:3px;background:#fff;display:none}input.task-list-item{margin-left:-1.62em}.markdown{font-family:"Hiragino Sans GB","Microsoft YaHei",STHeiti,SimSun,"Lucida Grande","Lucida Sans Unicode","Lucida Sans",'Segoe UI',AppleSDGothicNeo-Medium,'Malgun Gothic',Verdana,Tahoma,sans-serif;padding:20px}.markdown a{text-decoration:none;vertical-align:baseline}.markdown a:hover{text-decoration:underline}.markdown h1{font-size:2.2em;font-weight:700;margin:1.5em 0 1em}.markdown h2{font-size:1.8em;font-weight:700;margin:1.275em 0 .85em}.markdown h3{font-size:1.6em;font-weight:700;margin:1.125em 0 .75em}.markdown h4{font-size:1.4em;font-weight:700;margin:.99em 0 .66em}.markdown h5{font-size:1.2em;font-weight:700;margin:.855em 0 .57em}.markdown h6{font-size:1em;font-weight:700;margin:.75em 0 .5em}.markdown h1+p,.markdown h1:first-child,.markdown h2+p,.markdown h2:first-child,.markdown h3+p,.markdown h3:first-child,.markdown h4+p,.markdown h4:first-child,.markdown h5+p,.markdown h5:first-child,.markdown h6+p,.markdown h6:first-child{margin-top:0}.markdown hr{border:1px solid #ccc}.markdown p{margin:1em 0;word-wrap:break-word}.markdown ol{list-style-type:decimal}.markdown li{display:list-item;line-height:1.4em}.markdown blockquote{margin:1em 20px}.markdown blockquote>:first-child{margin-top:0}.markdown blockquote>:last-child{margin-bottom:0}.markdown blockquote cite:before{content:'\2014 \00A0'}.markdown .code{border-radius:3px;word-wrap:break-word}.markdown pre{border-radius:3px;word-wrap:break-word;border:1px solid #ccc;overflow:auto;padding:.5em}.markdown pre code{border:0;display:block}.markdown pre>code{font-family:Consolas,Inconsolata,Courier,monospace;font-weight:700;white-space:pre;margin:0}.markdown code{border-radius:3px;word-wrap:break-word;border:1px solid #ccc;padding:0 5px;margin:0 2px}.markdown img{max-width:100%}.markdown mark{color:#000;background-color:#fcf8e3}.markdown table{padding:0;border-collapse:collapse;border-spacing:0;margin-bottom:16px}.markdown table tr td,.markdown table tr th{border:1px solid #ccc;margin:0;padding:6px 13px}.markdown table tr th{font-weight:700}.markdown table tr th>:first-child{margin-top:0}.markdown table tr th>:last-child{margin-bottom:0}.markdown table tr td>:first-child{margin-top:0}.markdown table tr td>:last-child{margin-bottom:0}@import url(http://fonts.googleapis.com/css?family=Roboto+Condensed:300italic,400italic,700italic,400,300,700);.haroopad{padding:20px;color:#222;font-size:15px;font-family:"Roboto Condensed",Tauri,"Hiragino Sans GB","Microsoft YaHei",STHeiti,SimSun,"Lucida Grande","Lucida Sans Unicode","Lucida Sans",'Segoe UI',AppleSDGothicNeo-Medium,'Malgun Gothic',Verdana,Tahoma,sans-serif;background:#fff;line-height:1.6;-webkit-font-smoothing:antialiased}.haroopad a{color:#3269a0}.haroopad a:hover{color:#4183c4}.haroopad h2{border-bottom:1px solid #e6e6e6}.haroopad h6{color:#777}.haroopad hr{border:1px solid #e6e6e6}.haroopad blockquote>code,.haroopad h1>code,.haroopad h2>code,.haroopad h3>code,.haroopad h4>code,.haroopad h5>code,.haroopad h6>code,.haroopad li>code,.haroopad p>code,.haroopad td>code{font-family:Consolas,"Liberation Mono",Menlo,Courier,monospace;font-size:85%;background-color:rgba(0,0,0,.02);padding:.2em .5em;border:1px solid #efefef}.haroopad pre>code{font-size:1em;letter-spacing:-1px;font-weight:700}.haroopad blockquote{border-left:4px solid #e6e6e6;padding:0 15px;color:#777}.haroopad table{background-color:#fafafa}.haroopad table tr td,.haroopad table tr th{border:1px solid #e6e6e6}.haroopad table tr:nth-child(2n){background-color:#f2f2f2}.hljs{display:block;overflow-x:auto;padding:.5em;background:#fdf6e3;color:#657b83;-webkit-text-size-adjust:none}.diff .hljs-header,.hljs-comment,.hljs-doctype,.hljs-javadoc,.hljs-pi,.lisp .hljs-string{color:#93a1a1}.css .hljs-tag,.hljs-addition,.hljs-keyword,.hljs-request,.hljs-status,.hljs-winutils,.method,.nginx .hljs-title{color:#859900}.hljs-command,.hljs-dartdoc,.hljs-hexcolor,.hljs-link_url,.hljs-number,.hljs-phpdoc,.hljs-regexp,.hljs-rules .hljs-value,.hljs-string,.hljs-tag .hljs-value,.tex .hljs-formula{color:#2aa198}.css .hljs-function,.hljs-built_in,.hljs-chunk,.hljs-decorator,.hljs-id,.hljs-identifier,.hljs-localvars,.hljs-title,.vhdl .hljs-literal{color:#268bd2}.hljs-attribute,.hljs-class .hljs-title,.hljs-constant,.hljs-link_reference,.hljs-parent,.hljs-type,.hljs-variable,.lisp .hljs-body,.smalltalk .hljs-number{color:#b58900}.css .hljs-pseudo,.diff .hljs-change,.hljs-attr_selector,.hljs-cdata,.hljs-header,.hljs-pragma,.hljs-preprocessor,.hljs-preprocessor .hljs-keyword,.hljs-shebang,.hljs-special,.hljs-subst,.hljs-symbol,.hljs-symbol .hljs-string{color:#cb4b16}.hljs-deletion,.hljs-important{color:#dc322f}.hljs-link_label{color:#6c71c4}.tex .hljs-formula{background:#eee8d5}.MathJax_Hover_Frame{border-radius:.25em;-webkit-border-radius:.25em;-moz-border-radius:.25em;-khtml-border-radius:.25em;box-shadow:0 0 15px #83A;-webkit-box-shadow:0 0 15px #83A;-moz-box-shadow:0 0 15px #83A;-khtml-box-shadow:0 0 15px #83A;border:1px solid #A6D!important;display:inline-block;position:absolute}.MathJax_Hover_Arrow{position:absolute;width:15px;height:11px;cursor:pointer}#MathJax_About{position:fixed;left:50%;width:auto;text-align:center;border:3px outset;padding:1em 2em;background-color:#DDD;color:#000;cursor:default;font-family:message-box;font-size:120%;font-style:normal;text-indent:0;text-transform:none;line-height:normal;letter-spacing:normal;word-spacing:normal;word-wrap:normal;white-space:nowrap;float:none;z-index:201;border-radius:15px;-webkit-border-radius:15px;-moz-border-radius:15px;-khtml-border-radius:15px;box-shadow:0 10px 20px gray;-webkit-box-shadow:0 10px 20px gray;-moz-box-shadow:0 10px 20px gray;-khtml-box-shadow:0 10px 20px gray;filter:progid:DXImageTransform.Microsoft.dropshadow(OffX=2, OffY=2, Color='gray', Positive='true')}.MathJax_Menu{position:absolute;background-color:#fff;color:#000;width:auto;padding:2px;border:1px solid #CCC;margin:0;cursor:default;font:menu;text-align:left;text-indent:0;text-transform:none;line-height:normal;letter-spacing:normal;word-spacing:normal;word-wrap:normal;white-space:nowrap;float:none;z-index:201;box-shadow:0 10px 20px gray;-webkit-box-shadow:0 10px 20px gray;-moz-box-shadow:0 10px 20px gray;-khtml-box-shadow:0 10px 20px gray;filter:progid:DXImageTransform.Microsoft.dropshadow(OffX=2, OffY=2, Color='gray', Positive='true')}.MathJax_MenuItem{padding:2px 2em;background:0 0}.MathJax_MenuArrow{position:absolute;right:.5em;color:#666}.MathJax_MenuActive .MathJax_MenuArrow{color:#fff}.MathJax_MenuArrow.RTL{left:.5em;right:auto}.MathJax_MenuCheck{position:absolute;left:.7em}.MathJax_MenuCheck.RTL{right:.7em;left:auto}.MathJax_MenuRadioCheck{position:absolute;left:1em}.MathJax_MenuRadioCheck.RTL{right:1em;left:auto}.MathJax_MenuLabel{padding:2px 2em 4px 1.33em;font-style:italic}.MathJax_MenuRule{border-top:1px solid #CCC;margin:4px 1px 0}.MathJax_MenuDisabled{color:GrayText}.MathJax_MenuActive{background-color:Highlight;color:HighlightText}.MathJax_Menu_Close{position:absolute;width:31px;height:31px;top:-15px;left:-15px}#MathJax_Zoom{position:absolute;background-color:#F0F0F0;overflow:auto;display:block;z-index:301;padding:.5em;border:1px solid #000;margin:0;font-weight:400;font-style:normal;text-align:left;text-indent:0;text-transform:none;line-height:normal;letter-spacing:normal;word-spacing:normal;word-wrap:normal;white-space:nowrap;float:none;box-shadow:5px 5px 15px #AAA;-webkit-box-shadow:5px 5px 15px #AAA;-moz-box-shadow:5px 5px 15px #AAA;-khtml-box-shadow:5px 5px 15px #AAA;filter:progid:DXImageTransform.Microsoft.dropshadow(OffX=2, OffY=2, Color='gray', Positive='true')}#MathJax_ZoomOverlay{position:absolute;left:0;top:0;z-index:300;display:inline-block;width:100%;height:100%;border:0;padding:0;margin:0;background-color:#fff;opacity:0;filter:alpha(opacity=0)}#MathJax_ZoomFrame{position:relative;display:inline-block;height:0;width:0}#MathJax_ZoomEventTrap{position:absolute;left:0;top:0;z-index:302;display:inline-block;border:0;padding:0;margin:0;background-color:#fff;opacity:0;filter:alpha(opacity=0)}.MathJax_Preview{color:#888}#MathJax_Message{position:fixed;left:1px;bottom:2px;background-color:#E6E6E6;border:1px solid #959595;margin:0;padding:2px 8px;z-index:102;color:#000;font-size:80%;width:auto;white-space:nowrap}#MathJax_MSIE_Frame{position:absolute;top:0;left:0;width:0;z-index:101;border:0;margin:0;padding:0}.MathJax_Error{color:#C00;font-style:italic}footer{position:fixed;font-size:.8em;text-align:right;bottom:0;margin-left:-25px;height:20px;width:100%}</style>
|
||
</head>
|
||
<body class="markdown haroopad">
|
||
<h2 id="table-of-contents"><a name="table-of-contents" href="#table-of-contents"></a>Table of contents</h2><p class="toc" style="undefined"></p><ul>
|
||
<li><ul>
|
||
<li><span class="title">
|
||
<a href="#table-of-contents" title="Table of contents">Table of contents</a>
|
||
</span>
|
||
<!--span class="number">
|
||
0
|
||
</span-->
|
||
</li>
|
||
<li><span class="title">
|
||
<a href="#multi-static-variables" title="Multi static variables">Multi static variables</a>
|
||
</span>
|
||
<!--span class="number">
|
||
1
|
||
</span-->
|
||
</li>
|
||
<li><span class="title">
|
||
<a href="#multi-runners" title="Multi Runners">Multi Runners</a>
|
||
</span>
|
||
<!--span class="number">
|
||
2
|
||
</span-->
|
||
</li>
|
||
<li><span class="title">
|
||
<a href="#multi-settings" title="Multi Settings">Multi Settings</a>
|
||
</span>
|
||
<!--span class="number">
|
||
3
|
||
</span-->
|
||
</li>
|
||
<li><span class="title">
|
||
<a href="#multi-constructors---multi-objs" title="Multi constructors - Multi-Objs">Multi constructors - Multi-Objs</a>
|
||
</span>
|
||
<!--span class="number">
|
||
4
|
||
</span-->
|
||
</li>
|
||
<li><span class="title">
|
||
<a href="#processor" title="Processor">Processor</a>
|
||
</span>
|
||
<!--span class="number">
|
||
5
|
||
</span-->
|
||
</li>
|
||
<li><span class="title">
|
||
<a href="#timers" title="Timers">Timers</a>
|
||
</span>
|
||
<!--span class="number">
|
||
6
|
||
</span-->
|
||
</li>
|
||
<li><span class="title">
|
||
<a href="#connections" title="Connections">Connections</a>
|
||
</span>
|
||
<!--span class="number">
|
||
7
|
||
</span-->
|
||
</li>
|
||
<li><span class="title">
|
||
<a href="#jobs" title="Jobs">Jobs</a>
|
||
</span>
|
||
<!--span class="number">
|
||
8
|
||
</span-->
|
||
</li>
|
||
<li><span class="title">
|
||
<a href="#ranges" title="Ranges">Ranges</a>
|
||
</span>
|
||
<!--span class="number">
|
||
9
|
||
</span-->
|
||
</li>
|
||
<li><span class="title">
|
||
<a href="#conditions" title="Conditions">Conditions</a>
|
||
</span>
|
||
<!--span class="number">
|
||
10
|
||
</span-->
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
|
||
</ul>
|
||
<p></p><h2 id="multi-static-variables"><a name="multi-static-variables" href="#multi-static-variables"></a>Multi static variables</h2><p><code>multi.Priority_Core</code> — Highest level of pirority that can be given to a process<br><code>multi.Priority_High</code><br><code>multi.Priority_Above_Normal</code><br><code>multi.Priority_Normal</code> — The default level of pirority that is given to a process<br><code>multi.Priority_Below_Normal</code><br><code>multi.Priority_Low</code><br><code>multi.Priority_Idle</code> — Lowest level of pirority that can be given to a process</p><h2 id="multi-runners"><a name="multi-runners" href="#multi-runners"></a>Multi Runners</h2><p>multi:mainloop(<strong>TABLE:</strong> settings) — This runs the mainloop by having its own internal while loop running<br>multi:threadloop(<strong>TABLE:</strong> settings) — This runs the mainloop by having its own internal while loop running, but prioritizes threads over multi-objects<br>multi:uManager(<strong>TABLE:</strong> settings) — This runs the mainloop, but does not have its own while loop and thus needs to be within a loop of some kind.</p><h2 id="multi-settings"><a name="multi-settings" href="#multi-settings"></a>Multi Settings</h2><p><strong>Note:</strong> Most settings have been fined tuned to be at the peak of performance already, however preLoop, protect (Which drastically lowers preformance), and stopOnError should be used freely to fit your needs.</p><table>
|
||
<thead>
|
||
<tr>
|
||
<th>Setting</th>
|
||
<th>Type: default</th>
|
||
<th>Purpose</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>preLoop</td>
|
||
<td>function: nil</td>
|
||
<td>This is a function that is called after all the important components of the library are loaded. This is called once only. The first and only argument passed is a reference to itself.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>protect</td>
|
||
<td>boolean: false</td>
|
||
<td>This runs code within a protected call. To catch when errors happen see built in connections</td>
|
||
</tr>
|
||
<tr>
|
||
<td>stopOnError</td>
|
||
<td>boolean: false</td>
|
||
<td>This setting is used with protect. If an object crashes due to some error should it be paused?</td>
|
||
</tr>
|
||
<tr>
|
||
<td>priority</td>
|
||
<td>number: 0</td>
|
||
<td>This sets the priority scheme. Look at the P-Charts below for examples.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>auto_priority</td>
|
||
<td>boolean: false</td>
|
||
<td><strong>Note: This overrides any value set for priority!</strong> If auto priority is enabled then priority scheme 3 is used and processes are considered for “recheck” after a certain amount of time. If a process isn’t taking too long to complete anymore then it will be reset to core, if it starts to take a lot of time all of a sudden it will be set to idle.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>auto_stretch</td>
|
||
<td>number: 1</td>
|
||
<td>For use with auto_priority. Modifies the internal reperesentation of idle time by multiplying multi.Priority_Idle by the value given</td>
|
||
</tr>
|
||
<tr>
|
||
<td>auto_delay</td>
|
||
<td>number: 3</td>
|
||
<td>For use with auto_priority. This changes the time in seconds that process are “rechecked”</td>
|
||
</tr>
|
||
<tr>
|
||
<td>auto_lowerbound</td>
|
||
<td>number: multi.Priority_Idle</td>
|
||
<td>For use with auto_priority. The lowerbound is what is considered to be idle time. A higher value combined with auto_stretch allows one to fine tune how pirority is managed.</td>
|
||
</tr>
|
||
</tbody>
|
||
</table><h1 id="p-chart:-priority-1"><a name="p-chart:-priority-1" href="#p-chart:-priority-1"></a>P-Chart: Priority 1</h1><p>P1 follows a forumla that resembles this: ~n=I*PRank where n is the amount of steps given to an object with PRank and where I is the idle time see chart below. The aim of this priority scheme was to make core objects run fastest while letting idle processes get decent time as well.</p><table>
|
||
<thead>
|
||
<tr>
|
||
<th>Priority: n</th>
|
||
<th>PRank</th>
|
||
<th>Formula</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>Core: 3322269</td>
|
||
<td>7</td>
|
||
<td>n = ~<strong>I*</strong>7</td>
|
||
</tr>
|
||
<tr>
|
||
<td>High: 2847660</td>
|
||
<td>6</td>
|
||
<td>n = ~<strong>I*</strong>6</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Above_Normal: 2373050</td>
|
||
<td>5</td>
|
||
<td>n = ~<strong>I*</strong>5</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Normal: 1898440</td>
|
||
<td>4</td>
|
||
<td>n = ~<strong>I*</strong>4</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Below_Normal: 1423830</td>
|
||
<td>3</td>
|
||
<td>n = ~<strong>I*</strong>3</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Low: 949220</td>
|
||
<td>2</td>
|
||
<td>n = ~<strong>I*</strong>2</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>I</strong>dle: 474610</td>
|
||
<td>1</td>
|
||
<td>n = ~<strong>I*</strong>1</td>
|
||
</tr>
|
||
</tbody>
|
||
</table><p><strong>General Rule:</strong> ~n=<strong>I*</strong>PRank</p><h1 id="p-chart:-priority-2"><a name="p-chart:-priority-2" href="#p-chart:-priority-2"></a>P-Chart: Priority 2</h1><p>P2 follows a formula that resembles this: ~n=n*4 where n starts as the initial idle time, see chart below. The goal of this one was to make core process’ higher while keeping idle process’ low.</p><table>
|
||
<thead>
|
||
<tr>
|
||
<th>Priority: n</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>Core: 6700821</td>
|
||
</tr>
|
||
<tr>
|
||
<td>High: 1675205</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Above_Normal: 418801</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Normal: 104700</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Below_Normal: 26175</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Low: 6543</td>
|
||
</tr>
|
||
<tr>
|
||
<td><strong>I</strong>dle: 1635</td>
|
||
</tr>
|
||
</tbody>
|
||
</table><p><strong>General Rule:</strong> <code>~n=n*4</code> Where the inital n = <strong>I</strong></p><h1 id="p-chart:-priority-3"><a name="p-chart:-priority-3" href="#p-chart:-priority-3"></a>P-Chart: Priority 3</h1><p>P3 Ignores using a basic formula and instead bases its processing time on the amount of cpu time is there. If cpu-time is low and a process is set at a lower priority it will get its time reduced. There is no formula, at idle almost all process work at the same speed!</p><p>There are 2 settings for this: Core and Idle. If a process takes too long then it is set to idle. Otherwise it will stay core.</p><p>Example of settings:</p><pre class="lua hljs"><code class="lua" data-origin="<pre><code class="lua">settings = {
|
||
preLoop = function(m)
|
||
print("All settings have been loaded!")
|
||
end,
|
||
protect = false,
|
||
stopOnError = false,
|
||
priority = 0,
|
||
auto_priority = false,
|
||
auto_stretch = 1,
|
||
auto_delay = 3,
|
||
auto_lowerbound = multi.Priority_Idle
|
||
}
|
||
|
||
-- Below are how the runners work
|
||
|
||
multi:mainloop(settings)
|
||
|
||
-- or
|
||
|
||
multi:threadloop(settings)
|
||
|
||
-- or
|
||
|
||
while true do
|
||
multi:uManager(settings)
|
||
end
|
||
</code></pre>">settings = {
|
||
preLoop = <span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">(m)</span></span>
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"All settings have been loaded!"</span>)
|
||
<span class="hljs-keyword">end</span>,
|
||
protect = <span class="hljs-keyword">false</span>,
|
||
stopOnError = <span class="hljs-keyword">false</span>,
|
||
priority = <span class="hljs-number">0</span>,
|
||
auto_priority = <span class="hljs-keyword">false</span>,
|
||
auto_stretch = <span class="hljs-number">1</span>,
|
||
auto_delay = <span class="hljs-number">3</span>,
|
||
auto_lowerbound = multi.Priority_Idle
|
||
}
|
||
|
||
<span class="hljs-comment">-- Below are how the runners work</span>
|
||
|
||
multi:mainloop(settings)
|
||
|
||
<span class="hljs-comment">-- or</span>
|
||
|
||
multi:threadloop(settings)
|
||
|
||
<span class="hljs-comment">-- or</span>
|
||
|
||
<span class="hljs-keyword">while</span> <span class="hljs-keyword">true</span> <span class="hljs-keyword">do</span>
|
||
multi:uManager(settings)
|
||
<span class="hljs-keyword">end</span>
|
||
</code></pre><h2 id="multi-constructors---multi-objs"><a name="multi-constructors---multi-objs" href="#multi-constructors---multi-objs"></a>Multi constructors - Multi-Objs</h2><p><strong>Processors</strong><br>proc = multi:newProcessor(<strong>STRING:</strong> file [<strong>nil</strong>])</p><p><strong>Non-Actors</strong><br>timer = multi:newTimer()<br>conn = multi:newConnection(<strong>BOOLEAN:</strong> protect [<strong>true</strong>])<br>nil = multi:newJob(<strong>FUNCTION:</strong> func, <strong>STRING:</strong> name)<br>range = multi:newRange()<br>cond = multi:newCondition(<strong>FUNCTION:</strong> func)</p><p><strong>Actors</strong><br>event = multi:newEvent(<strong>FUNCTION:</strong> task)<br>updater = multi:newUpdater(<strong>NUMBER:</strong> skip [<strong>1</strong>])<br>alarm = multi:newAlarm(<strong>NUMBER:</strong> [<strong>0</strong>])<br>loop = multi:newLoop(<strong>FUNCTION:</strong> func)<br>tloop = multi:newTLoop(<strong>FUNCTION:</strong> func ,<strong>NUMBER:</strong> set [<strong>1</strong>])<br>func = multi:newFunction(<strong>FUNCTION:</strong> func)<br>step = multi:newStep(<strong>NUMBER:</strong> start, <strong>NUMBER:</strong> reset, <strong>NUMBER:</strong> count [<strong>1</strong>], <strong>NUMBER:</strong> skip [<strong>0</strong>])<br>tstep = multi:newStep(<strong>NUMBER:</strong> start, <strong>NUMBER:</strong> reset, <strong>NUMBER:</strong> count [<strong>1</strong>], <strong>NUMBER:</strong> set [<strong>1</strong>])<br>trigger = multi:newTrigger(<strong>FUNCTION:</strong> func)<br>stamper = multi:newTimeStamper()<br>watcher = multi:newWatcher(<strong>STRING</strong> name)<br>watcher = multi:newWatcher(<strong>TABLE</strong> namespace, <strong>STRING</strong> name)<br>cobj = multi:newCustomObject(<strong>TABLE</strong> objRef, <strong>BOOLEAN</strong> isActor)</p><p>Note: A lot of methods will return self as a return. This is due to the ability to chain that was added in 12.x.x</p><h2 id="processor"><a name="processor" href="#processor"></a>Processor</h2><p>proc = multi:newProcessor(<strong>STRING:</strong> file [<strong>nil</strong>])<br>Creates a processor runner that acts like the multi runner. Actors and Non-Actors can be created on these objects. Pausing a process pauses all objects that are running on that process.</p><p>An optional argument file is used if you want to load a file containing the processor data.<br>Note: This isn’t portable on all areas where lua is used. Some interperters disable loadstring so it is not encouraged to use the file method for creating processors</p><p>loop = Processor:getController() — returns the loop that runs the “runner” that drives this processor<br><strong>self</strong> = Processor:Start() — Starts the processor<br><strong>self</strong> = Processor:Pause() — Pauses the processor<br><strong>self</strong> = Processor:Resume() — Resumes a paused processor<br>nil = Processor:Destroy() — Destroys the processor and all of the Actors running on it</p><p>Example</p><pre class="lua hljs"><code class="lua" data-origin="<pre><code class="lua">multi = require("multi")
|
||
proc = multi:newProcessor()
|
||
proc:newTLoop(function() -- create a t loop that runs every second
|
||
print("Hi!")
|
||
end,1) -- where we set the 1 second
|
||
proc:Start() -- let's start the processor
|
||
multi:mainloop() -- the main runner that drives everything
|
||
</code></pre>">multi = <span class="hljs-built_in">require</span>(<span class="hljs-string">"multi"</span>)
|
||
proc = multi:newProcessor()
|
||
proc:newTLoop(<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">()</span></span> <span class="hljs-comment">-- create a t loop that runs every second</span>
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"Hi!"</span>)
|
||
<span class="hljs-keyword">end</span>,<span class="hljs-number">1</span>) <span class="hljs-comment">-- where we set the 1 second</span>
|
||
proc:Start() <span class="hljs-comment">-- let's start the processor</span>
|
||
multi:mainloop() <span class="hljs-comment">-- the main runner that drives everything</span>
|
||
</code></pre><h2 id="timers"><a name="timers" href="#timers"></a>Timers</h2><p>timer = multi:newTimer()<br>Creates a timer object that can keep track of time</p><p><strong>self</strong> = timer:Start() — Starts the timer<br>time_elapsed = timer:Get() — Returns the time elapsed since timer:Start() was called<br>boolean = timer:isPaused() — Returns if the timer is paused or not<br><strong>self</strong> = timer:Pause() — Pauses the timer, it skips time that would be counted during the time that it is paused<br><strong>self</strong> = timer:Resume() — Resumes a paused timer. <strong>See note below</strong><br><strong>self</strong> = timer:tofile(<strong>STRING</strong> path) — Saves the object to a file at location path</p><p><strong>Note:</strong> If a timer was paused after 1 second then resumed a second later and Get() was called a second later, timer would have 2 seconds counted though 3 really have passed.</p><h2 id="connections"><a name="connections" href="#connections"></a>Connections</h2><p>Arguable my favorite object in this library, next to threads</p><p>conn = multi:newConnection(<strong>BOOLEAN:</strong> protect [<strong>true</strong>])<br>Creates a connection object and defaults to a protective state. All calls will run within pcall()</p><p><strong>self</strong> = conn:HoldUT(<strong>NUMBER</strong> n [<strong>0</strong>]) — Will hold futhur execution of the thread until the connection was triggered. If n is supplied the connection must be triggered n times before it will allow ececution to continue.<br><strong>self</strong> = conn:FConnect(<strong>FUNCTION</strong> func) — Creates a connection that is forced to execute when Fire() is called. <strong>Deprecated</strong><br>returns or nil = conn:Fire(…) — Triggers the connection with arguments …, “returns” if non-nil is a table containing return values from the triggered connections.<br><strong>self</strong> = conn:Bind(<strong>TABLE</strong> t) — sets the table to hold the connections. Leaving it alone is best unless you know what you are doing<br><strong>self</strong> = conn:Remove() — removes the bind that was put in place. This will also destroy all connections that existed before.<br>Link = conn:connect(<strong>FUNCTION</strong> func, <strong>STRING</strong> name [<strong>nil</strong>], <strong>NUMBER</strong> [<strong>#conns+1</strong>]) — Connects to the object using function func which will recieve the arguments passed by Fire(…). You can name a connection, which allows you to use conn:getConnection(name). Names must be unique! num is simple the position in the order in which connections are triggered. The return Link is the link to the connected event that was made. You can remove this event or even trigger it specifically if need be.<br>Link:Fire(…) — Fires the created event<br>bool = Link:Destroy() — returns true if success.<br>subConn = conn:getConnection(<strong>STRING</strong> name, <strong>BOOLEAN</strong> ingore) — returns the sub connection which matches name.<br>returns or nil subConn:Fire() — “returns” if non-nil is a table containing return values from the triggered connections.<br><strong>self</strong> = conn:tofile(<strong>STRING</strong> path) — Saves the object to a file at location path</p><p>The connect feature has some syntax sugar to it as seen below<br>Link = conn(<strong>FUNCTION</strong> func, <strong>STRING</strong> name [<strong>nil</strong>], <strong>NUMBER</strong> [<strong>#conns+1</strong>])</p><p>Example:</p><pre class="lua hljs"><code class="lua" data-origin="<pre><code class="lua">local multi = require("multi")
|
||
-- Let’s create the events
|
||
yawn={}
|
||
OnCustomSafeEvent=multi:newConnection(true) -- lets pcall the calls in case something goes wrong default
|
||
OnCustomEvent=multi:newConnection(false) -- let’s not pcall the calls and let errors happen.
|
||
OnCustomEvent:Bind(yawn) -- create the connection lookup data in yawn
|
||
|
||
-- Let’s connect to them, a recent update adds a nice syntax to connect to these
|
||
cd1=OnCustomSafeEvent:Connect(function(arg1,arg2,...)
|
||
print("CSE1",arg1,arg2,...)
|
||
end,"bob") -- let’s give this connection a name
|
||
cd2=OnCustomSafeEvent:Connect(function(arg1,arg2,...)
|
||
print("CSE2",arg1,arg2,...)
|
||
end,"joe") -- let’s give this connection a name
|
||
cd3=OnCustomSafeEvent:Connect(function(arg1,arg2,...)
|
||
print("CSE3",arg1,arg2,...)
|
||
end) -- let’s not give this connection a name
|
||
|
||
-- Using syntax sugar
|
||
OnCustomEvent(function(arg1,arg2,...)
|
||
print(arg1,arg2,...)
|
||
end)
|
||
|
||
-- Now within some loop/other object you trigger the connection like
|
||
OnCustomEvent:Fire(1,2,"Hello!!!") -- fire all connections
|
||
|
||
-- You may have noticed that some events have names! See the following example!
|
||
OnCustomSafeEvent:getConnection("bob"):Fire(1,100,"Bye!") -- fire only bob!
|
||
OnCustomSafeEvent:getConnection("joe"):Fire(1,100,"Hello!") -- fire only joe!!
|
||
OnCustomSafeEvent:Fire(1,100,"Hi Ya Folks!!!") -- fire them all!!!
|
||
|
||
-- Connections have more to them than that though!
|
||
-- As seen above cd1-cd3 these are hooks to the connection object. This allows you to remove a connection
|
||
-- For Example:
|
||
cd1:Remove() -- remove this connection from the master connection object
|
||
print("------")
|
||
OnCustomSafeEvent:Fire(1,100,"Hi Ya Folks!!!") -- fire them all again!!!
|
||
-- To remove all connections use:
|
||
OnCustomSafeEvent:Remove()
|
||
print("------")
|
||
OnCustomSafeEvent:Fire(1,100,"Hi Ya Folks!!!") -- fire them all again!!!
|
||
</code></pre>"><span class="hljs-keyword">local</span> multi = <span class="hljs-built_in">require</span>(<span class="hljs-string">"multi"</span>)
|
||
<span class="hljs-comment">-- Let’s create the events</span>
|
||
yawn={}
|
||
OnCustomSafeEvent=multi:newConnection(<span class="hljs-keyword">true</span>) <span class="hljs-comment">-- lets pcall the calls in case something goes wrong default</span>
|
||
OnCustomEvent=multi:newConnection(<span class="hljs-keyword">false</span>) <span class="hljs-comment">-- let’s not pcall the calls and let errors happen.</span>
|
||
OnCustomEvent:Bind(yawn) <span class="hljs-comment">-- create the connection lookup data in yawn</span>
|
||
|
||
<span class="hljs-comment">-- Let’s connect to them, a recent update adds a nice syntax to connect to these</span>
|
||
cd1=OnCustomSafeEvent:Connect(<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">(arg1,arg2,...)</span></span>
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"CSE1"</span>,arg1,arg2,...)
|
||
<span class="hljs-keyword">end</span>,<span class="hljs-string">"bob"</span>) <span class="hljs-comment">-- let’s give this connection a name</span>
|
||
cd2=OnCustomSafeEvent:Connect(<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">(arg1,arg2,...)</span></span>
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"CSE2"</span>,arg1,arg2,...)
|
||
<span class="hljs-keyword">end</span>,<span class="hljs-string">"joe"</span>) <span class="hljs-comment">-- let’s give this connection a name</span>
|
||
cd3=OnCustomSafeEvent:Connect(<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">(arg1,arg2,...)</span></span>
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"CSE3"</span>,arg1,arg2,...)
|
||
<span class="hljs-keyword">end</span>) <span class="hljs-comment">-- let’s not give this connection a name</span>
|
||
|
||
<span class="hljs-comment">-- Using syntax sugar</span>
|
||
OnCustomEvent(<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">(arg1,arg2,...)</span></span>
|
||
<span class="hljs-built_in">print</span>(arg1,arg2,...)
|
||
<span class="hljs-keyword">end</span>)
|
||
|
||
<span class="hljs-comment">-- Now within some loop/other object you trigger the connection like</span>
|
||
OnCustomEvent:Fire(<span class="hljs-number">1</span>,<span class="hljs-number">2</span>,<span class="hljs-string">"Hello!!!"</span>) <span class="hljs-comment">-- fire all connections</span>
|
||
|
||
<span class="hljs-comment">-- You may have noticed that some events have names! See the following example!</span>
|
||
OnCustomSafeEvent:getConnection(<span class="hljs-string">"bob"</span>):Fire(<span class="hljs-number">1</span>,<span class="hljs-number">100</span>,<span class="hljs-string">"Bye!"</span>) <span class="hljs-comment">-- fire only bob!</span>
|
||
OnCustomSafeEvent:getConnection(<span class="hljs-string">"joe"</span>):Fire(<span class="hljs-number">1</span>,<span class="hljs-number">100</span>,<span class="hljs-string">"Hello!"</span>) <span class="hljs-comment">-- fire only joe!!</span>
|
||
OnCustomSafeEvent:Fire(<span class="hljs-number">1</span>,<span class="hljs-number">100</span>,<span class="hljs-string">"Hi Ya Folks!!!"</span>) <span class="hljs-comment">-- fire them all!!!</span>
|
||
|
||
<span class="hljs-comment">-- Connections have more to them than that though!</span>
|
||
<span class="hljs-comment">-- As seen above cd1-cd3 these are hooks to the connection object. This allows you to remove a connection</span>
|
||
<span class="hljs-comment">-- For Example:</span>
|
||
cd1:Remove() <span class="hljs-comment">-- remove this connection from the master connection object</span>
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"------"</span>)
|
||
OnCustomSafeEvent:Fire(<span class="hljs-number">1</span>,<span class="hljs-number">100</span>,<span class="hljs-string">"Hi Ya Folks!!!"</span>) <span class="hljs-comment">-- fire them all again!!!</span>
|
||
<span class="hljs-comment">-- To remove all connections use:</span>
|
||
OnCustomSafeEvent:Remove()
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"------"</span>)
|
||
OnCustomSafeEvent:Fire(<span class="hljs-number">1</span>,<span class="hljs-number">100</span>,<span class="hljs-string">"Hi Ya Folks!!!"</span>) <span class="hljs-comment">-- fire them all again!!!</span>
|
||
</code></pre><h2 id="jobs"><a name="jobs" href="#jobs"></a>Jobs</h2><p>nil = multi:newJob(<strong>FUNCTION:</strong> func, <strong>STRING:</strong> name) — Adds a job to a queue of jobs that get executed after some time. func is the job that is being ran, name is the name of the job.<br>nil = multi:setJobSpeed(<strong>NUMBER</strong> n) — seconds between when each job should be done.<br>bool, number = multi:hasJobs() — returns true if there are jobs to be processed. And the number of jobs to be processed<br>num = multi:getJobs() — returns the number of jobs left to be processed.<br>number = multi:removeJob(name) — removes all jobs of name, name. Returns the number of jobs removed</p><p><strong>Note:</strong> Jobs may be turned into actual objects in the future.</p><p>Example:</p><pre class="lua hljs"><code class="lua" data-origin="<pre><code class="lua">local multi = require("multi")
|
||
print(multi:hasJobs())
|
||
multi:setJobSpeed(1) -- set job speed to 1 second
|
||
multi:newJob(function()
|
||
print("A job!")
|
||
end,"test")
|
||
|
||
multi:newJob(function()
|
||
print("Another job!")
|
||
multi:removeJob("test") -- removes all jobs with name "test"
|
||
end,"test")
|
||
|
||
multi:newJob(function()
|
||
print("Almost done!")
|
||
end,"test")
|
||
|
||
multi:newJob(function()
|
||
print("Final job!")
|
||
end,"test")
|
||
print(multi:hasJobs())
|
||
print("There are "..multi:getJobs().." jobs in the queue!")
|
||
multi:mainloop()
|
||
</code></pre>"><span class="hljs-keyword">local</span> multi = <span class="hljs-built_in">require</span>(<span class="hljs-string">"multi"</span>)
|
||
<span class="hljs-built_in">print</span>(multi:hasJobs())
|
||
multi:setJobSpeed(<span class="hljs-number">1</span>) <span class="hljs-comment">-- set job speed to 1 second</span>
|
||
multi:newJob(<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">()</span></span>
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"A job!"</span>)
|
||
<span class="hljs-keyword">end</span>,<span class="hljs-string">"test"</span>)
|
||
|
||
multi:newJob(<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">()</span></span>
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"Another job!"</span>)
|
||
multi:removeJob(<span class="hljs-string">"test"</span>) <span class="hljs-comment">-- removes all jobs with name "test"</span>
|
||
<span class="hljs-keyword">end</span>,<span class="hljs-string">"test"</span>)
|
||
|
||
multi:newJob(<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">()</span></span>
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"Almost done!"</span>)
|
||
<span class="hljs-keyword">end</span>,<span class="hljs-string">"test"</span>)
|
||
|
||
multi:newJob(<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">()</span></span>
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"Final job!"</span>)
|
||
<span class="hljs-keyword">end</span>,<span class="hljs-string">"test"</span>)
|
||
<span class="hljs-built_in">print</span>(multi:hasJobs())
|
||
<span class="hljs-built_in">print</span>(<span class="hljs-string">"There are "</span>..multi:getJobs()..<span class="hljs-string">" jobs in the queue!"</span>)
|
||
multi:mainloop()
|
||
</code></pre><h2 id="ranges"><a name="ranges" href="#ranges"></a>Ranges</h2><h2 id="conditions"><a name="conditions" href="#conditions"></a>Conditions</h2>
|
||
|
||
<footer style="position:fixed; font-size:.8em; text-align:right; bottom:0px; margin-left:-25px; height:20px; width:100%;">generated by <a href="http://pad.haroopress.com" target="_blank">haroopad</a></footer>
|
||
</body>
|
||
</html>
|