Updated PaintWeb to the latest snapshot.
[moodle/mihaisucan.git] / lib / paintweb / docs / api-ref / symbols / pwlib.tools.line.html
blobbb81212d7ecaf80f50e5fd51d0c88c8ac7062bc9
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.line</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.line
326 </h1>
328 <!-- ============================== class summary ========================== -->
329 <p class="description">
332 The line tool.
335 <br /><i>Defined in: </i> <a href="../symbols/src/src_tools_line.js.html">line.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.line.">
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.line.html#constructor">pwlib.tools.line</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.line.">
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.line.html#-needsRedraw">needsRedraw</a></b>
382 </div>
383 <div class="description">Tells if the drawing canvas needs to be updated or not.</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.line.html#-shiftKey">shiftKey</a></b>
392 </div>
393 <div class="description">Tells if the <kbd>Shift</kbd> key is down or not.</div>
394 </td>
395 </tr>
397 <tr>
398 <td class="attributes">&lt;private&gt; &lt;inner&gt; &nbsp;</td>
399 <td class="nameDescription">
400 <div class="fixedFont">
401 <b><a href="../symbols/pwlib.tools.line.html#-timer">timer</a></b>
402 </div>
403 <div class="description">The interval ID used for invoking the drawing operation every few
404 milliseconds.</div>
405 </td>
406 </tr>
408 <tr>
409 <td class="attributes">&lt;private&gt; &lt;inner&gt; &nbsp;</td>
410 <td class="nameDescription">
411 <div class="fixedFont">
412 <b><a href="../symbols/pwlib.tools.line.html#-x0">x0</a></b>
413 </div>
414 <div class="description">Holds the starting point on the <var>x</var> axis of the image, for the
415 current drawing operation.</div>
416 </td>
417 </tr>
419 <tr>
420 <td class="attributes">&lt;private&gt; &lt;inner&gt; &nbsp;</td>
421 <td class="nameDescription">
422 <div class="fixedFont">
423 <b><a href="../symbols/pwlib.tools.line.html#-y0">y0</a></b>
424 </div>
425 <div class="description">Holds the starting point on the <var>y</var> axis of the image, for the
426 current drawing operation.</div>
427 </td>
428 </tr>
430 </tbody>
431 </table>
437 <!-- ============================== methods summary ======================== -->
441 <table class="summaryTable" cellspacing="0" summary="A summary of the methods documented in the class pwlib.tools.line.">
442 <caption>Method Summary</caption>
443 <thead>
444 <tr>
445 <th scope="col">Method Attributes</th>
446 <th scope="col">Method Name and Description</th>
447 </tr>
448 </thead>
449 <tbody>
451 <tr>
452 <td class="attributes">&nbsp;</td>
453 <td class="nameDescription">
454 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.line.html#deactivate">deactivate</a></b>()
455 </div>
456 <div class="description">Tool deactivation event handler.</div>
457 </td>
458 </tr>
460 <tr>
461 <td class="attributes">&nbsp;</td>
462 <td class="nameDescription">
463 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.line.html#draw">draw</a></b>()
464 </div>
465 <div class="description">Perform the drawing operation.</div>
466 </td>
467 </tr>
469 <tr>
470 <td class="attributes">&nbsp;</td>
471 <td class="nameDescription">
472 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.line.html#keydown">keydown</a></b>(ev)
473 </div>
474 <div class="description">Allows the user to press <kbd>Escape</kbd> to cancel the drawing operation.</div>
475 </td>
476 </tr>
478 <tr>
479 <td class="attributes">&nbsp;</td>
480 <td class="nameDescription">
481 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.line.html#mousedown">mousedown</a></b>(ev)
482 </div>
483 <div class="description">Initialize the drawing operation, by storing the location of the pointer,
484 the start position.</div>
485 </td>
486 </tr>
488 <tr>
489 <td class="attributes">&nbsp;</td>
490 <td class="nameDescription">
491 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.line.html#mousemove">mousemove</a></b>(ev)
492 </div>
493 <div class="description">Store the <kbd>Shift</kbd> key state which is used by the drawing function.</div>
494 </td>
495 </tr>
497 <tr>
498 <td class="attributes">&nbsp;</td>
499 <td class="nameDescription">
500 <div class="fixedFont"><b><a href="../symbols/pwlib.tools.line.html#mouseup">mouseup</a></b>(ev)
501 </div>
502 <div class="description">End the drawing operation, once the user releases the mouse button.</div>
503 </td>
504 </tr>
506 </tbody>
507 </table>
512 <!-- ============================== events summary ======================== -->
515 <!-- ============================== constructor details ==================== -->
517 <div class="details"><a name="constructor"> </a>
518 <div class="sectionTitle">
519 Class Detail
520 </div>
522 <div class="fixedFont">
523 <b>pwlib.tools.line</b>(app)
524 </div>
526 <div class="description">
529 </div>
535 <dl class="detailList">
536 <dt class="heading">Parameters:</dt>
538 <dt>
539 <span class="light fixedFont">{<a href="../symbols/PaintWeb.html">PaintWeb</a>}</span> <b>app</b>
541 </dt>
542 <dd>Reference to the main paint application object.</dd>
544 </dl>
553 </div>
556 <!-- ============================== field details ========================== -->
558 <div class="sectionTitle">
559 Field Detail
560 </div>
562 <a name="-needsRedraw"> </a>
563 <div class="fixedFont">&lt;private&gt; &lt;inner&gt;
565 <span class="light">{Boolean}</span>
566 <b>needsRedraw</b>
568 </div>
569 <div class="description">
570 Tells if the drawing canvas needs to be updated or not.
573 </div>
581 <dl class="detailList">
582 <dt class="heading">Default Value:</dt>
583 <dd>
584 false
585 </dd>
586 </dl>
589 <hr />
591 <a name="-shiftKey"> </a>
592 <div class="fixedFont">&lt;private&gt; &lt;inner&gt;
594 <span class="light">{Boolean}</span>
595 <b>shiftKey</b>
597 </div>
598 <div class="description">
599 Tells if the <kbd>Shift</kbd> key is down or not. This is used by the
600 drawing function.
603 </div>
611 <dl class="detailList">
612 <dt class="heading">Default Value:</dt>
613 <dd>
614 false
615 </dd>
616 </dl>
619 <hr />
621 <a name="-timer"> </a>
622 <div class="fixedFont">&lt;private&gt; &lt;inner&gt;
625 <b>timer</b>
627 </div>
628 <div class="description">
629 The interval ID used for invoking the drawing operation every few
630 milliseconds.
633 </div>
640 <dl class="detailList">
641 <dt class="heading">See:</dt>
643 <dd>PaintWeb.config.toolDrawDelay</dd>
645 </dl>
649 <hr />
651 <a name="-x0"> </a>
652 <div class="fixedFont">&lt;private&gt; &lt;inner&gt;
654 <span class="light">{Number}</span>
655 <b>x0</b>
657 </div>
658 <div class="description">
659 Holds the starting point on the <var>x</var> axis of the image, for the
660 current drawing operation.
663 </div>
672 <hr />
674 <a name="-y0"> </a>
675 <div class="fixedFont">&lt;private&gt; &lt;inner&gt;
677 <span class="light">{Number}</span>
678 <b>y0</b>
680 </div>
681 <div class="description">
682 Holds the starting point on the <var>y</var> axis of the image, for the
683 current drawing operation.
686 </div>
699 <!-- ============================== method details ========================= -->
701 <div class="sectionTitle">
702 Method Detail
703 </div>
705 <a name="deactivate"> </a>
706 <div class="fixedFont">
709 <b>deactivate</b>()
711 </div>
712 <div class="description">
713 Tool deactivation event handler.
716 </div>
728 <hr />
730 <a name="draw"> </a>
731 <div class="fixedFont">
734 <b>draw</b>()
736 </div>
737 <div class="description">
738 Perform the drawing operation. This function is called every few
739 milliseconds.
741 <p>Hold down the <kbd>Shift</kbd> key to draw a straight
742 horizontal/vertical line.
743 <p>Press <kbd>Escape</kbd> to cancel the drawing operation.
746 </div>
757 <dl class="detailList">
758 <dt class="heading">See:</dt>
760 <dd>PaintWeb.config.toolDrawDelay</dd>
762 </dl>
765 <hr />
767 <a name="keydown"> </a>
768 <div class="fixedFont">
770 <span class="light">{Boolean}</span>
771 <b>keydown</b>(ev)
773 </div>
774 <div class="description">
775 Allows the user to press <kbd>Escape</kbd> to cancel the drawing operation.
778 </div>
783 <dl class="detailList">
784 <dt class="heading">Parameters:</dt>
786 <dt>
787 <span class="light fixedFont">{Event}</span> <b>ev</b>
789 </dt>
790 <dd>The DOM Event object.</dd>
792 </dl>
798 <dl class="detailList">
799 <dt class="heading">Returns:</dt>
801 <dd><span class="light fixedFont">{Boolean}</span> True if the drawing operation was cancelled, or false if
802 not.</dd>
804 </dl>
809 <hr />
811 <a name="mousedown"> </a>
812 <div class="fixedFont">
815 <b>mousedown</b>(ev)
817 </div>
818 <div class="description">
819 Initialize the drawing operation, by storing the location of the pointer,
820 the start position.
823 </div>
828 <dl class="detailList">
829 <dt class="heading">Parameters:</dt>
831 <dt>
832 <span class="light fixedFont">{Event}</span> <b>ev</b>
834 </dt>
835 <dd>The DOM Event object.</dd>
837 </dl>
846 <hr />
848 <a name="mousemove"> </a>
849 <div class="fixedFont">
852 <b>mousemove</b>(ev)
854 </div>
855 <div class="description">
856 Store the <kbd>Shift</kbd> key state which is used by the drawing function.
859 </div>
864 <dl class="detailList">
865 <dt class="heading">Parameters:</dt>
867 <dt>
868 <span class="light fixedFont">{Event}</span> <b>ev</b>
870 </dt>
871 <dd>The DOM Event object.</dd>
873 </dl>
882 <hr />
884 <a name="mouseup"> </a>
885 <div class="fixedFont">
888 <b>mouseup</b>(ev)
890 </div>
891 <div class="description">
892 End the drawing operation, once the user releases the mouse button.
895 </div>
900 <dl class="detailList">
901 <dt class="heading">Parameters:</dt>
903 <dt>
904 <span class="light fixedFont">{Event}</span> <b>ev</b>
906 </dt>
907 <dd>The DOM Event object.</dd>
909 </dl>
922 <!-- ============================== event details ========================= -->
925 <hr />
926 </div>
929 <!-- ============================== footer ================================= -->
930 <div class="fineprint" style="clear:both">
932 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)
933 </div>
934 </body>
935 </html>