jack
/
cocorobolx


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305
							<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>JSDoc: Class: BlockPyEditor</title>

    <script src="scripts/prettify/prettify.js"> </script>
    <script src="scripts/prettify/lang-css.js"> </script>
    <!--[if lt IE 9]>
      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
    <![endif]-->
    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
</head>

<body>

<div id="main">

    <h1 class="page-title">Class: BlockPyEditor</h1>

    
<section>

<header>
    
        <h2>BlockPyEditor</h2>
        
    
</header>

<article>
    <div class="container-overview">
    
        
    <h4 class="name" id="BlockPyEditor"><span class="type-signature"></span>new BlockPyEditor<span class="signature">(main, tag)</span><span class="type-signature"></span></h4>

    
<div class="description">
    An object that manages the various editors, where users can edit their program. Also manages the
movement between editors.
There are currently four editors:
 - Blocks: A Blockly instance
 - Text: A CodeMirror instance
 - Instructor: Features for changing the assignment and environment settings
 - Upload: (Incomplete) A menu for uploading and running code from a desktop file.
</div>


    <h5>This:</h5>
    <ul><li>{<a href="BlockPyEditor.html">BlockPyEditor</a>}</li></ul>


    <h5>Parameters:</h5>
    

<table class="params">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>main</code></td>
            

            <td class="type">
            
                
<span class="param-type">Object</span>


            </td>

            
            <td class="description last">The main BlockPy instance</td>
        </tr>

    
        <tr>
            
                <td class="name"><code>tag</code></td>
            

            <td class="type">
            
                
<span class="param-type">HTMLElement</span>


            </td>

            
            <td class="description last">The HTML object this is attached to.</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line15">line 15</a>
    </li></ul></dd>
    

</dl>


    </div>

    
        <h3 class="subsection-title">Members</h3>

        
<h4 class="name" id=".CATEGORY_MAP"><span class="type-signature">(static) </span>CATEGORY_MAP<span class="type-signature"></span></h4>


<div class="description">
    Maps short category names in the toolbox to the full XML used to
represent that category as usual. This is kind of a clunky mechanism
for managing the different categories, and doesn't allow us to specify
individual blocks.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line819">line 819</a>
    </li></ul></dd>
    

</dl>


<h4 class="name" id="previousLine"><span class="type-signature"></span>previousLine<span class="type-signature"></span></h4>


    <h5 class="subsection-title">Properties:</h5>

    
<table class="props">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>previousLine</code></td>
            

            <td class="type">
            
                
<span class="param-type">Number</span>


            </td>

            
            <td class="description last">Keeps track of the previously highlighted line.</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line643">line 643</a>
    </li></ul></dd>
    

</dl>


        <h3 class="subsection-title">Methods</h3>

        
    <h4 class="name" id="addAvailableModule"><span class="type-signature"></span>addAvailableModule<span class="signature">(name)</span><span class="type-signature"></span></h4>

    
<div class="description">
    Makes the module available in the availableModules multi-select menu by adding
it to the list.
</div>


    <h5>Parameters:</h5>
    

<table class="params">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>name</code></td>
            

            <td class="type">
            
                
<span class="param-type">String</span>


            </td>

            
            <td class="description last">The name of the module (human-friendly version, as opposed to the slug) to be added.</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line214">line 214</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="changeProgram"><span class="type-signature"></span>changeProgram<span class="signature">(name)</span><span class="type-signature"></span></h4>

    
<div class="description">
    Updates the current file being edited in the editors.
This appears to be deprecated.
</div>


    <h5>Parameters:</h5>
    

<table class="params">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>name</code></td>
            

            <td class="type">
            
                
<span class="param-type">String</span>


            </td>

            
            <td class="description last">The name of the file being edited (e.g, "__main__", "starting_code")</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line795">line 795</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="copyImage"><span class="type-signature"></span>copyImage<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Shows a dialog window with the current block workspace encoded as a
downloadable PNG image.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line1090">line 1090</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="getBlocksFromXml"><span class="type-signature"></span>getBlocksFromXml<span class="signature">()</span><span class="type-signature"> &rarr; {XMLDom}</span></h4>

    
<div class="description">
    Helper function for retrieving the current Blockly workspace as
an XML DOM object.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line626">line 626</a>
    </li></ul></dd>
    

</dl>


<h5>Returns:</h5>

        
<div class="param-desc">
    The blocks in the current workspace.
</div>


<dl>
    <dt>
        Type
    </dt>
    <dd>
        
<span class="param-type">XMLDom</span>


    </dd>
</dl>

    
    <h4 class="name" id="getHighlightMap"><span class="type-signature"></span>getHighlightMap<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    DEPRECATED, thankfully
Builds up an array indicating the relevant block ID for a given step.
Operates on the current this.blockly instance
It works by injecting __HIGHLIGHT__(id); at the start of every line of code
 and then extracting that with regular expressions. This makes it vulnerable
 if someone decides to use __HIGHLIGHT__ in their code. I'm betting on that
 never being a problem, though. Still, this was a miserable way of accomplishing
 the desired behavior.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line767">line 767</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="getPngFromBlocks"><span class="type-signature"></span>getPngFromBlocks<span class="signature">(callback)</span><span class="type-signature"></span></h4>

    
<div class="description">
    Generates a PNG version of the current workspace. This PNG is stored in a Base-64 encoded
string as part of a data URL (e.g., "data:image/png;base64,...").
TODO: There seems to be some problems capturing blocks that don't start with
statement level blocks (e.g., expression blocks).
</div>


    <h5>Parameters:</h5>
    

<table class="params">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>callback</code></td>
            

            <td class="type">
            
                
<span class="param-type">function</span>


            </td>

            
            <td class="description last">A function to be called with the results. This function should take two parameters, the URL (as a string) of the generated base64-encoded PNG and the IMG tag.</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line1027">line 1027</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="hideBlockMenu"><span class="type-signature"></span>hideBlockMenu<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Hides the Block tab, which involves shrinking it and hiding the Blockly instance.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line280">line 280</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="hideInstructorMenu"><span class="type-signature"></span>hideInstructorMenu<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Hides the Instructor tab, which shrinking it.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line319">line 319</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="hideSplitMenu"><span class="type-signature"></span>hideSplitMenu<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Hides the Text tab, which involves shrinking it and hiding its CodeMirror too.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line224">line 224</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="hideTextMenu"><span class="type-signature"></span>hideTextMenu<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Hides the Text tab, which involves shrinking it and hiding its CodeMirror too.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line248">line 248</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="hideUploadMenu"><span class="type-signature"></span>hideUploadMenu<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Hides the Upload tab, which shrinking it.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line303">line 303</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="highlightBlock"><span class="type-signature"></span>highlightBlock<span class="signature">(block)</span><span class="type-signature"></span></h4>

    
<div class="description">
    Highlights a block in Blockly. Unfortunately, this is the same as selecting it.
</div>


    <h5>Parameters:</h5>
    

<table class="params">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>block</code></td>
            

            <td class="type">
            
                
<span class="param-type">Number</span>


            </td>

            
            <td class="description last">The ID of the block object to highlight.</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line692">line 692</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="highlightError"><span class="type-signature"></span>highlightError<span class="signature">(line)</span><span class="type-signature"></span></h4>

    
<div class="description">
    Highlights a line of code in the CodeMirror instance. This applies the "error" style
which is meant to suggest that a line is wrong.
</div>


    <h5>Parameters:</h5>
    

<table class="params">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>line</code></td>
            

            <td class="type">
            
                
<span class="param-type">Number</span>


            </td>

            
            <td class="description last">The line of code to highlight. I think this is zero indexed?</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line677">line 677</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="highlightLine"><span class="type-signature"></span>highlightLine<span class="signature">(line)</span><span class="type-signature"></span></h4>

    
<div class="description">
    Highlights a line of code in the CodeMirror instance. This applies the "active" style
which is meant to bring attention to a line, but not suggest it is wrong.
</div>


    <h5>Parameters:</h5>
    

<table class="params">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>line</code></td>
            

            <td class="type">
            
                
<span class="param-type">Number</span>


            </td>

            
            <td class="description last">The line of code to highlight. I think this is zero indexed?</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line662">line 662</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="initBlockly"><span class="type-signature"></span>initBlockly<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Initializes the Blockly instance (handles all the blocks). This includes
attaching a number of ChangeListeners that can keep the internal code
representation updated and enforce type checking.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line79">line 79</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="initInstructor"><span class="type-signature"></span>initInstructor<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Initializes the Instructor tab, which has a number of buttons and menus for
manipulating assignments and the environment. One important job is to register the
SummerNote instance used for editing the Introduction of the assignment.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line185">line 185</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="initText"><span class="type-signature"></span>initText<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Initializes the CodeMirror instance. This handles text editing (with syntax highlighting)
and also attaches a listener for change events to update the internal code represntation.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line138">line 138</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="refreshBlockHighlight"><span class="type-signature"></span>refreshBlockHighlight<span class="signature">(line)</span><span class="type-signature"></span></h4>

    
<div class="description">
    Used to restore a block's highlight when travelling from the code tab. This
uses a mapping between the blocks and text that is generated from the parser.
The parser has stored the relevant line numbers for each block in the XML of the
block. Very sophisticated, and sadly fairly fragile.
TODO: I believe there's some kind of off-by-one error here...
</div>


    <h5>Parameters:</h5>
    

<table class="params">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>line</code></td>
            

            <td class="type">
            
                
<span class="param-type">Number</span>


            </td>

            
            <td class="description last">The line of code to highlight. I think this is zero indexed?</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line705">line 705</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="refreshHighlight"><span class="type-signature"></span>refreshHighlight<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Assuming that a line has been highlighted previously, this will set the
line to be highlighted again. Used when we need to restore a highlight.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line649">line 649</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="resetBlockSilence"><span class="type-signature"></span>resetBlockSilence<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Resets the silenceBlock after a short delay
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line576">line 576</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="setBlocksFromXml"><span class="type-signature"></span>setBlocksFromXml<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Helper function for setting the current Blockly workspace to
whatever XML DOM is given. This clears out any existing blocks.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line634">line 634</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="setLevel"><span class="type-signature"></span>setLevel<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Eventually will be used to update "levels" of sophistication of the code interface.
Currently unimplemented and unused.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line809">line 809</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="setMode"><span class="type-signature"></span>setMode<span class="signature">(mode)</span><span class="type-signature"></span></h4>

    
<div class="description">
    Dispatch method to set the mode to the given argument.
If the mode is invalid, an editor error is reported. If the
</div>


    <h5>Parameters:</h5>
    

<table class="params">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>mode</code></td>
            

            <td class="type">
            
                
<span class="param-type">String</span>


            </td>

            
            <td class="description last">The new mode to set to ("Blocks", "Text", "Upload", or "Instructor")</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line427">line 427</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="setModeToBlocks"><span class="type-signature"></span>setModeToBlocks<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Sets the current editor mode to Blocks, hiding the other menus.
Also forces the block side to update.
There is a chance this could fail, if the text side is irredeemably
awful. So then the editor bounces back to the text side.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line350">line 350</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="setModeToInstructor"><span class="type-signature"></span>setModeToInstructor<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Sets the current editor mode to the Instructor mode, hiding the other menus.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line404">line 404</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="setModeToSplit"><span class="type-signature"></span>setModeToSplit<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Sets the current editor mode to Split mode, hiding the other menus.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line390">line 390</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="setModeToText"><span class="type-signature"></span>setModeToText<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Sets the current editor mode to Text, hiding the other menus.
Also forces the text side to update.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line336">line 336</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="setModeToUpload"><span class="type-signature"></span>setModeToUpload<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Sets the current editor mode to Upload mode, hiding the other menus.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line379">line 379</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="setText"><span class="type-signature"></span>setText<span class="signature">(code)</span><span class="type-signature"></span></h4>

    
<div class="description">
    Actually changes the value of the CodeMirror instance
</div>


    <h5>Parameters:</h5>
    

<table class="params">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>code</code></td>
            

            <td class="type">
            
                
<span class="param-type">String</span>


            </td>

            
            <td class="description last">The new code for the CodeMirror</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line455">line 455</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="showBlockMenu"><span class="type-signature"></span>showBlockMenu<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Shows the Block tab, which involves restoring its height and showing the Blockly instance.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line290">line 290</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="showInstructorMenu"><span class="type-signature"></span>showInstructorMenu<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Shows the Instructor tab, which involves restoring its height.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line327">line 327</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="showSplitMenu"><span class="type-signature"></span>showSplitMenu<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Shows the Text tab, which requires restoring its height, showing AND refreshing
the CodeMirror instance.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line233">line 233</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="showTextMenu"><span class="type-signature"></span>showTextMenu<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Shows the Text tab, which requires restoring its height, showing AND refreshing
the CodeMirror instance.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line259">line 259</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="showUploadMenu"><span class="type-signature"></span>showUploadMenu<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Shows the Upload tab, which involves restoring its height.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line311">line 311</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="unhighlightBlock"><span class="type-signature"></span>unhighlightBlock<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Removes the outline around a block. Currently unused.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line741">line 741</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="unhighlightLines"><span class="type-signature"></span>unhighlightLines<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Removes any highlight in the text code editor.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line749">line 749</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="updateBlocks"><span class="type-signature"></span>updateBlocks<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Attempts to update the model for the current code file from the 
block workspace. Might be prevented if an update event was already
percolating.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line531">line 531</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="updateBlocksFromModel"><span class="type-signature"></span>updateBlocksFromModel<span class="signature">()</span><span class="type-signature"> &rarr; {Boolean}</span></h4>

    
<div class="description">
    Updates the block editor from the current code file in the
model. Might be prevented if an update event was already
percolating. This can also report an error if one occurs.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line609">line 609</a>
    </li></ul></dd>
    

</dl>


<h5>Returns:</h5>

        
<div class="param-desc">
    Returns true upon success.
</div>


<dl>
    <dt>
        Type
    </dt>
    <dd>
        
<span class="param-type">Boolean</span>


    </dd>
</dl>

    
    <h4 class="name" id="updateTextFromModel"><span class="type-signature"></span>updateTextFromModel<span class="signature">()</span><span class="type-signature"></span></h4>

    
<div class="description">
    Updates the text editor from the current code file in the
model. Might be prevented if an update event was already
percolating.
</div>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line592">line 592</a>
    </li></ul></dd>
    

</dl>


    <h4 class="name" id="updateToolbox"><span class="type-signature"></span>updateToolbox<span class="signature">(only_set)</span><span class="type-signature"> &rarr; (nullable) {String}</span></h4>

    
<div class="description">
    Creates an updated representation of the Toolboxes XML as currently specified in the
model, using whatever modules have been added or removed. This method can either set it
or just retrieve it for future use.
</div>


    <h5>Parameters:</h5>
    

<table class="params">
    <thead>
    <tr>
        
        <th>Name</th>
        

        <th>Type</th>

        
        <th class="last">Description</th>
    </tr>
    </thead>

    <tbody>
    

        <tr>
            
                <td class="name"><code>only_set</code></td>
            

            <td class="type">
            
                
<span class="param-type">Boolean</span>


            </td>

            
            <td class="description last">Whether to return the XML string or to actually set the XML. False means that it will not update the toolbox!</td>
        </tr>

    
    </tbody>
</table>


<dl class="details">

    
    <dt class="tag-source">Source:</dt>
    <dd class="tag-source"><ul class="dummy"><li>
        <a href="editor.js.html">editor.js</a>, <a href="editor.js.html#line964">line 964</a>
    </li></ul></dd>
    

</dl>


<h5>Returns:</h5>

        
<div class="param-desc">
    Possibly returns the XML of the toolbox as a string.
</div>


<dl>
    <dt>
        Type
    </dt>
    <dd>
        
<span class="param-type">String</span>


    </dd>
</dl>

    
</article>

</section>


</div>

<nav>
    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="BlockPy.html">BlockPy</a></li><li><a href="BlockPyCorgis.html">BlockPyCorgis</a></li><li><a href="BlockPyDialog.html">BlockPyDialog</a></li><li><a href="BlockPyEditor.html">BlockPyEditor</a></li><li><a href="BlockPyEngine.html">BlockPyEngine</a></li><li><a href="BlockPyEnglish.html">BlockPyEnglish</a></li><li><a href="BlockPyFeedback.html">BlockPyFeedback</a></li><li><a href="BlockPyHistory.html">BlockPyHistory</a></li><li><a href="BlockPyPresentation.html">BlockPyPresentation</a></li><li><a href="BlockPyPrinter.html">BlockPyPrinter</a></li><li><a href="BlockPyServer.html">BlockPyServer</a></li><li><a href="BlockPyToolbar.html">BlockPyToolbar</a></li><li><a href="LocalStorageWrapper.html">LocalStorageWrapper</a></li><li><a href="PythonToBlocks.html">PythonToBlocks</a></li></ul><h3>Global</h3><ul><li><a href="global.html#BlockPyInterface">BlockPyInterface</a></li><li><a href="global.html#cloneNode">cloneNode</a></li><li><a href="global.html#encodeHTML">encodeHTML</a></li><li><a href="global.html#expandArray">expandArray</a></li><li><a href="global.html#EXTENDED_ERROR_EXPLANATION">EXTENDED_ERROR_EXPLANATION</a></li><li><a href="global.html#indent">indent</a></li><li><a href="global.html#instructor_module">instructor_module</a></li><li><a href="global.html#prettyPrintDateTime">prettyPrintDateTime</a></li><li><a href="global.html#randomInteger">randomInteger</a></li><li><a href="global.html#set_button_loaded">set_button_loaded</a></li><li><a href="global.html#timerGuard">timerGuard</a></li></ul>
</nav>

<br class="clear">

<footer>
    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.3</a> on Sun Mar 26 2017 09:45:04 GMT-0400 (Eastern Daylight Time)
</footer>

<script> prettyPrint(); </script>
<script src="scripts/linenumber.js"> </script>
</body>
</html>