Updated PaintWeb to the latest snapshot.
[moodle/mihaisucan.git] / lib / paintweb / docs / api-ref / symbols / pwlib.tools.pencil.html
blob347a082dc15abaf43a4e469fd8c9f151ecdea90c
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4 <head>
5 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
6 <meta name="generator" content="JsDoc Toolkit" />
8 <title>JsDoc Reference - pwlib.tools.pencil</title>
10 <style type="text/css">
11 /* default.css */
12 body
14 font: 12px "Lucida Grande", Tahoma, Arial, Helvetica, sans-serif;
15 width: 800px;
18 .header
20 clear: both;
21 background-color: #ccc;
22 padding: 8px;
27 font-size: 150%;
28 font-weight: bold;
29 padding: 0;
30 margin: 1em 0 0 .3em;
35 border: none 0;
36 border-top: 1px solid #7F8FB1;
37 height: 1px;
40 pre.code
42 display: block;
43 padding: 8px;
44 border: 1px dashed #ccc;
47 #index
49 margin-top: 24px;
50 float: left;
51 width: 160px;
52 position: absolute;
53 left: 8px;
54 background-color: #F3F3F3;
55 padding: 8px;
58 #content
60 margin-left: 190px;
61 width: 600px;
64 .classList
66 list-style-type: none;
67 padding: 0;
68 margin: 0 0 0 8px;
69 font-family: arial, sans-serif;
70 font-size: 1em;
71 overflow: auto;
74 .classList li
76 padding: 0;
77 margin: 0 0 8px 0;
80 .summaryTable { width: 100%; }
82 h1.classTitle
84 font-size:170%;
85 line-height:130%;
88 h2 { font-size: 110%; }
89 caption, div.sectionTitle
91 background-color: #7F8FB1;
92 color: #fff;
93 font-size:130%;
94 text-align: left;
95 padding: 2px 6px 2px 6px;
96 border: 1px #7F8FB1 solid;
99 div.sectionTitle { margin-bottom: 8px; }
100 .summaryTable thead { display: none; }
102 .summaryTable td
104 vertical-align: top;
105 padding: 4px;
106 border-bottom: 1px #7F8FB1 solid;
107 border-right: 1px #7F8FB1 solid;
110 /*col#summaryAttributes {}*/
111 .summaryTable td.attributes
113 border-left: 1px #7F8FB1 solid;
114 width: 140px;
115 text-align: right;
118 td.attributes, .fixedFont
120 line-height: 15px;
121 color: #002EBE;
122 font-family: "Courier New",Courier,monospace;
123 font-size: 13px;
126 .summaryTable td.nameDescription
128 text-align: left;
129 font-size: 13px;
130 line-height: 15px;
133 .summaryTable td.nameDescription, .description
135 line-height: 15px;
136 padding: 4px;
137 padding-left: 4px;
140 .summaryTable { margin-bottom: 8px; }
142 ul.inheritsList
144 list-style: square;
145 margin-left: 20px;
146 padding-left: 0;
149 .detailList {
150 margin-left: 20px;
151 line-height: 15px;
153 .detailList dt { margin-left: 20px; }
155 .detailList .heading
157 font-weight: bold;
158 padding-bottom: 6px;
159 margin-left: 0;
162 .light, td.attributes, .light a:link, .light a:visited
164 color: #777;
165 font-style: italic;
168 .fineprint
170 text-align: right;
171 font-size: 10px;
173 </style>
174 </head>
176 <body>
177 <!-- ============================== header ================================= -->
178 <!-- begin static/header.html -->
179 <div id="header">
180 </div>
181 <!-- end static/header.html -->
183 <!-- ============================== classes index ============================ -->
184 <div id="index">
185 <!-- begin publish.classesIndex -->
186 <div align="center"><a href="../index.html">Class Index</a>
187 | <a href="../files.html">File Index</a></div>
188 <hr />
189 <h2>Classes</h2>
190 <ul class="classList">
192 <li><i><a href="../symbols/_global_.html">_global_</a></i></li>
194 <li><a href="../symbols/PaintWeb.html">PaintWeb</a></li>
196 <li><a href="../symbols/pwlib.html">pwlib</a></li>
198 <li><a href="../symbols/pwlib.appEvent.html">pwlib.appEvent</a></li>
200 <li><a href="../symbols/pwlib.appEvent.appDestroy.html">pwlib.appEvent.appDestroy</a></li>
202 <li><a href="../symbols/pwlib.appEvent.appInit.html">pwlib.appEvent.appInit</a></li>
204 <li><a href="../symbols/pwlib.appEvent.canvasSizeChange.html">pwlib.appEvent.canvasSizeChange</a></li>
206 <li><a href="../symbols/pwlib.appEvent.clipboardUpdate.html">pwlib.appEvent.clipboardUpdate</a></li>
208 <li><a href="../symbols/pwlib.appEvent.commandRegister.html">pwlib.appEvent.commandRegister</a></li>
210 <li><a href="../symbols/pwlib.appEvent.commandUnregister.html">pwlib.appEvent.commandUnregister</a></li>
212 <li><a href="../symbols/pwlib.appEvent.configChange.html">pwlib.appEvent.configChange</a></li>
214 <li><a href="../symbols/pwlib.appEvent.extensionRegister.html">pwlib.appEvent.extensionRegister</a></li>
216 <li><a href="../symbols/pwlib.appEvent.extensionUnregister.html">pwlib.appEvent.extensionUnregister</a></li>
218 <li><a href="../symbols/pwlib.appEvent.guiFloatingPanelStateChange.html">pwlib.appEvent.guiFloatingPanelStateChange</a></li>
220 <li><a href="../symbols/pwlib.appEvent.guiHide.html">pwlib.appEvent.guiHide</a></li>
222 <li><a href="../symbols/pwlib.appEvent.guiResizeEnd.html">pwlib.appEvent.guiResizeEnd</a></li>
224 <li><a href="../symbols/pwlib.appEvent.guiResizeStart.html">pwlib.appEvent.guiResizeStart</a></li>
226 <li><a href="../symbols/pwlib.appEvent.guiShow.html">pwlib.appEvent.guiShow</a></li>
228 <li><a href="../symbols/pwlib.appEvent.guiTabActivate.html">pwlib.appEvent.guiTabActivate</a></li>
230 <li><a href="../symbols/pwlib.appEvent.historyUpdate.html">pwlib.appEvent.historyUpdate</a></li>
232 <li><a href="../symbols/pwlib.appEvent.imageCrop.html">pwlib.appEvent.imageCrop</a></li>
234 <li><a href="../symbols/pwlib.appEvent.imageSave.html">pwlib.appEvent.imageSave</a></li>
236 <li><a href="../symbols/pwlib.appEvent.imageSaveResult.html">pwlib.appEvent.imageSaveResult</a></li>
238 <li><a href="../symbols/pwlib.appEvent.imageSizeChange.html">pwlib.appEvent.imageSizeChange</a></li>
240 <li><a href="../symbols/pwlib.appEvent.imageZoom.html">pwlib.appEvent.imageZoom</a></li>
242 <li><a href="../symbols/pwlib.appEvent.selectionChange.html">pwlib.appEvent.selectionChange</a></li>
244 <li><a href="../symbols/pwlib.appEvent.shadowAllow.html">pwlib.appEvent.shadowAllow</a></li>
246 <li><a href="../symbols/pwlib.appEvent.toolActivate.html">pwlib.appEvent.toolActivate</a></li>
248 <li><a href="../symbols/pwlib.appEvent.toolPreactivate.html">pwlib.appEvent.toolPreactivate</a></li>
250 <li><a href="../symbols/pwlib.appEvent.toolRegister.html">pwlib.appEvent.toolRegister</a></li>
252 <li><a href="../symbols/pwlib.appEvent.toolUnregister.html">pwlib.appEvent.toolUnregister</a></li>
254 <li><a href="../symbols/pwlib.appEvents.html">pwlib.appEvents</a></li>
256 <li><a href="../symbols/pwlib.browser.html">pwlib.browser</a></li>
258 <li><a href="../symbols/pwlib.dom.html">pwlib.dom</a></li>
260 <li><a href="../symbols/pwlib.dom.KeyboardEventListener.html">pwlib.dom.KeyboardEventListener</a></li>
262 <li><a href="../symbols/pwlib.dom.keyCodes.html">pwlib.dom.keyCodes</a></li>
264 <li><a href="../symbols/pwlib.dom.keyCodes_fixes.html">pwlib.dom.keyCodes_fixes</a></li>
266 <li><a href="../symbols/pwlib.dom.keyCodes_Safari2.html">pwlib.dom.keyCodes_Safari2</a></li>
268 <li><a href="../symbols/pwlib.dom.keyNames.html">pwlib.dom.keyNames</a></li>
270 <li><a href="../symbols/pwlib.extensions.html">pwlib.extensions</a></li>
272 <li><a href="../symbols/pwlib.extensions.colormixer.html">pwlib.extensions.colormixer</a></li>
274 <li><a href="../symbols/pwlib.extensions.moodle.html">pwlib.extensions.moodle</a></li>
276 <li><a href="../symbols/pwlib.extensions.mousekeys.html">pwlib.extensions.mousekeys</a></li>
278 <li><a href="../symbols/pwlib.fileCache.html">pwlib.fileCache</a></li>
280 <li><a href="../symbols/pwlib.gui.html">pwlib.gui</a></li>
282 <li><a href="../symbols/pwlib.guiColorInput.html">pwlib.guiColorInput</a></li>
284 <li><a href="../symbols/pwlib.guiFloatingPanel.html">pwlib.guiFloatingPanel</a></li>
286 <li><a href="../symbols/pwlib.guiResizer.html">pwlib.guiResizer</a></li>
288 <li><a href="../symbols/pwlib.guiTabPanel.html">pwlib.guiTabPanel</a></li>
290 <li><a href="../symbols/pwlib.tools.html">pwlib.tools</a></li>
292 <li><a href="../symbols/pwlib.tools.bcurve.html">pwlib.tools.bcurve</a></li>
294 <li><a href="../symbols/pwlib.tools.cpicker.html">pwlib.tools.cpicker</a></li>
296 <li><a href="../symbols/pwlib.tools.ellipse.html">pwlib.tools.ellipse</a></li>
298 <li><a href="../symbols/pwlib.tools.eraser.html">pwlib.tools.eraser</a></li>
300 <li><a href="../symbols/pwlib.tools.hand.html">pwlib.tools.hand</a></li>
302 <li><a href="../symbols/pwlib.tools.insertimg.html">pwlib.tools.insertimg</a></li>
304 <li><a href="../symbols/pwlib.tools.line.html">pwlib.tools.line</a></li>
306 <li><a href="../symbols/pwlib.tools.pencil.html">pwlib.tools.pencil</a></li>
308 <li><a href="../symbols/pwlib.tools.polygon.html">pwlib.tools.polygon</a></li>
310 <li><a href="../symbols/pwlib.tools.rectangle.html">pwlib.tools.rectangle</a></li>
312 <li><a href="../symbols/pwlib.tools.selection.html">pwlib.tools.selection</a></li>
314 <li><a href="../symbols/pwlib.tools.text.html">pwlib.tools.text</a></li>
316 </ul>
317 <hr />
318 <!-- end publish.classesIndex -->
319 </div>
321 <div id="content">
322 <!-- ============================== class title ============================ -->
323 <h1 class="classTitle">
325 Class pwlib.tools.pencil
326 </h1>
328 <!-- ============================== class summary ========================== -->
329 <p class="description">
332 The drawing pencil.
335 <br /><i>Defined in: </i> <a href="../symbols/src/src_tools_pencil.js.html">pencil.js</a>.
337 </p>
339 <!-- ============================== constructor summary ==================== -->
341 <table class="summaryTable" cellspacing="0" summary="A summary of the constructor documented in the class pwlib.tools.pencil.">
342 <caption>Class Summary</caption>
343 <thead>
344 <tr>
345 <th scope="col">Constructor Attributes</th>
346 <th scope="col">Constructor Name and Description</th>
347 </tr>
348 </thead>
349 <tbody>
350 <tr>
351 <td class="attributes">&nbsp;</td>
352 <td class="nameDescription" >
353 <div class="fixedFont">
354 <b><a href="../symbols/pwlib.tools.pencil.html#constructor">pwlib.tools.pencil</a></b>(app)
355 </div>
356 <div class="description"></div>
357 </td>
358 </tr>
359 </tbody>
360 </table>
363 <!-- ============================== properties summary ===================== -->
367 <table class="summaryTable" cellspacing="0" summary="A summary of the fields documented in the class pwlib.tools.pencil.">
368 <caption>Field Summary</caption>
369 <thead>
370 <tr>
371 <th scope="col">Field Attributes</th>
372 <th scope="col">Field Name and Description</th>
373 </tr>
374 </thead>
375 <tbody>
377 <tr>
378 <td class="attributes">&lt;private&gt; &lt;inner&gt; &nbsp;</td>
379 <td class="nameDescription">
380 <div class="fixedFont">
381 <b><a href="../symbols/pwlib.tools.pencil.html#-points">points</a></b>
382 </div>
383 <div class="description">Holds the points needed to be drawn.</div>
384 </td>
385 </tr>
387 <tr>
388 <td class="attributes">&lt;private&gt; &lt;inner&gt; &nbsp;</td>
389 <td class="nameDescription">
390 <div class="fixedFont">
391 <b><a href="../symbols/pwlib.tools.pencil.html#-timer">timer</a></b>
392 </div>
393 <div class="description">The interval ID used for running the pencil drawing operation every few
394 milliseconds.</div>
395 </td>
396 </tr>
398 <tr>
399 <td class="attributes">&lt;private&gt; &lt;inner&gt; &nbsp;</td>
400 <td class="nameDescription">
401 <div class="fixedFont">
402 <b><a href="../symbols/pwlib.tools.pencil.html#-x0">x0</a></b>
403 </div>
404 <div class="description">Holds the last point on the <var>x</var> axis of the image, for the current
405 drawing operation.</div>
406 </td>
407 </tr>
409 <tr>
410 <td class="attributes">&lt;private&gt; &lt;inner&gt; &nbsp;</td>
411 <td class="nameDescription">
412 <div class="fixedFont">
413 <b><a href="../symbols/pwlib.tools.pencil.html#-y0">y0</a></b>
414 </div>
415 <div class="description">Holds the last point on the <var>y</var> axis of the image, for the current
416 drawing operation.</div>
417 </td>
418 </tr>
420 </tbody>
421 </table>
427 <!-- ============================== methods summary ======================== -->
431 <table class="summaryTable" cellspacing="0" summary="A summary of the methods documented in the class pwlib.tools.pencil.">
432 <caption>Method Summary</caption>
433 <thead>
434 <tr>
435 <th scope="col">Method Attributes</th>
436 <th scope="col">Method Name and Description</th>
437 </tr>
438 </thead>
439 <tbody>
441 <tr>
442 <td class="attributes">&nbsp;</td>
443 <td class="nameDescription">
444 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.pencil.html#deactivate">deactivate</a></b>()
445 </div>
446 <div class="description">Tool deactivation event handler.</div>
447 </td>
448 </tr>
450 <tr>
451 <td class="attributes">&nbsp;</td>
452 <td class="nameDescription">
453 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.pencil.html#draw">draw</a></b>()
454 </div>
455 <div class="description">Draw the points in the stack.</div>
456 </td>
457 </tr>
459 <tr>
460 <td class="attributes">&nbsp;</td>
461 <td class="nameDescription">
462 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.pencil.html#keydown">keydown</a></b>(ev)
463 </div>
464 <div class="description">Allows the user to press <kbd>Escape</kbd> to cancel the drawing operation.</div>
465 </td>
466 </tr>
468 <tr>
469 <td class="attributes">&nbsp;</td>
470 <td class="nameDescription">
471 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.pencil.html#mousedown">mousedown</a></b>()
472 </div>
473 <div class="description">Initialize the drawing operation.</div>
474 </td>
475 </tr>
477 <tr>
478 <td class="attributes">&nbsp;</td>
479 <td class="nameDescription">
480 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.pencil.html#mousemove">mousemove</a></b>()
481 </div>
482 <div class="description">Save the mouse coordinates in the array.</div>
483 </td>
484 </tr>
486 <tr>
487 <td class="attributes">&nbsp;</td>
488 <td class="nameDescription">
489 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.pencil.html#mouseup">mouseup</a></b>()
490 </div>
491 <div class="description">End the drawing operation, once the user releases the mouse button.</div>
492 </td>
493 </tr>
495 </tbody>
496 </table>
501 <!-- ============================== events summary ======================== -->
504 <!-- ============================== constructor details ==================== -->
506 <div class="details"><a name="constructor"> </a>
507 <div class="sectionTitle">
508 Class Detail
509 </div>
511 <div class="fixedFont">
512 <b>pwlib.tools.pencil</b>(app)
513 </div>
515 <div class="description">
518 </div>
524 <dl class="detailList">
525 <dt class="heading">Parameters:</dt>
527 <dt>
528 <span class="light fixedFont">{<a href="../symbols/PaintWeb.html">PaintWeb</a>}</span> <b>app</b>
530 </dt>
531 <dd>Reference to the main paint application object.</dd>
533 </dl>
542 </div>
545 <!-- ============================== field details ========================== -->
547 <div class="sectionTitle">
548 Field Detail
549 </div>
551 <a name="-points"> </a>
552 <div class="fixedFont">&lt;private&gt; &lt;inner&gt;
554 <span class="light">{Array}</span>
555 <b>points</b>
557 </div>
558 <div class="description">
559 Holds the points needed to be drawn. Each point is added by the
560 <code>mousemove</code> event handler.
563 </div>
572 <hr />
574 <a name="-timer"> </a>
575 <div class="fixedFont">&lt;private&gt; &lt;inner&gt;
578 <b>timer</b>
580 </div>
581 <div class="description">
582 The interval ID used for running the pencil drawing operation every few
583 milliseconds.
586 </div>
593 <dl class="detailList">
594 <dt class="heading">See:</dt>
596 <dd>PaintWeb.config.toolDrawDelay</dd>
598 </dl>
602 <hr />
604 <a name="-x0"> </a>
605 <div class="fixedFont">&lt;private&gt; &lt;inner&gt;
607 <span class="light">{Number}</span>
608 <b>x0</b>
610 </div>
611 <div class="description">
612 Holds the last point on the <var>x</var> axis of the image, for the current
613 drawing operation.
616 </div>
625 <hr />
627 <a name="-y0"> </a>
628 <div class="fixedFont">&lt;private&gt; &lt;inner&gt;
630 <span class="light">{Number}</span>
631 <b>y0</b>
633 </div>
634 <div class="description">
635 Holds the last point on the <var>y</var> axis of the image, for the current
636 drawing operation.
639 </div>
652 <!-- ============================== method details ========================= -->
654 <div class="sectionTitle">
655 Method Detail
656 </div>
658 <a name="deactivate"> </a>
659 <div class="fixedFont">
662 <b>deactivate</b>()
664 </div>
665 <div class="description">
666 Tool deactivation event handler.
669 </div>
681 <hr />
683 <a name="draw"> </a>
684 <div class="fixedFont">
687 <b>draw</b>()
689 </div>
690 <div class="description">
691 Draw the points in the stack. This function is called every few
692 milliseconds.
695 </div>
706 <dl class="detailList">
707 <dt class="heading">See:</dt>
709 <dd>PaintWeb.config.toolDrawDelay</dd>
711 </dl>
714 <hr />
716 <a name="keydown"> </a>
717 <div class="fixedFont">
719 <span class="light">{Boolean}</span>
720 <b>keydown</b>(ev)
722 </div>
723 <div class="description">
724 Allows the user to press <kbd>Escape</kbd> to cancel the drawing operation.
727 </div>
732 <dl class="detailList">
733 <dt class="heading">Parameters:</dt>
735 <dt>
736 <span class="light fixedFont">{Event}</span> <b>ev</b>
738 </dt>
739 <dd>The DOM Event object.</dd>
741 </dl>
747 <dl class="detailList">
748 <dt class="heading">Returns:</dt>
750 <dd><span class="light fixedFont">{Boolean}</span> True if the drawing operation was cancelled, or false if
751 not.</dd>
753 </dl>
758 <hr />
760 <a name="mousedown"> </a>
761 <div class="fixedFont">
764 <b>mousedown</b>()
766 </div>
767 <div class="description">
768 Initialize the drawing operation.
771 </div>
783 <hr />
785 <a name="mousemove"> </a>
786 <div class="fixedFont">
789 <b>mousemove</b>()
791 </div>
792 <div class="description">
793 Save the mouse coordinates in the array.
796 </div>
808 <hr />
810 <a name="mouseup"> </a>
811 <div class="fixedFont">
814 <b>mouseup</b>()
816 </div>
817 <div class="description">
818 End the drawing operation, once the user releases the mouse button.
821 </div>
837 <!-- ============================== event details ========================= -->
840 <hr />
841 </div>
844 <!-- ============================== footer ================================= -->
845 <div class="fineprint" style="clear:both">
847 Documentation generated by <a href="http://code.google.com/p/jsdoc-toolkit/" target="_blank">JsDoc Toolkit</a> 2.3.0 on Fri Jul 31 2009 20:23:24 GMT+0300 (EEST)
848 </div>
849 </body>
850 </html>