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">
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">
14 font: 12px "Lucida Grande", Tahoma
, Arial
, Helvetica
, sans-serif
;
21 background-color: #ccc;
36 border-top: 1px solid
#7F8FB1;
44 border: 1px dashed
#ccc;
54 background-color: #F3F3F3;
66 list-style-type: none
;
69 font-family: arial
, sans-serif
;
80 .summaryTable { width: 100%; }
88 h2
{ font-size: 110%; }
89 caption
, div
.sectionTitle
91 background-color: #7F8FB1;
95 padding: 2px 6px 2px 6px;
96 border: 1px #7F8FB1 solid
;
99 div
.sectionTitle
{ margin-bottom: 8px; }
100 .summaryTable thead { display: none
; }
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
;
118 td
.attributes
, .fixedFont
122 font-family: "Courier New",Courier
,monospace
;
126 .summaryTable td
.nameDescription
133 .summaryTable td
.nameDescription
, .description
140 .summaryTable { margin-bottom: 8px; }
153 .detailList dt { margin-left: 20px; }
162 .light
, td
.attributes
, .light
a:link
, .light
a:visited
177 <!-- ============================== header ================================= -->
178 <!-- begin static/header.html -->
181 <!-- end static/header.html -->
183 <!-- ============================== classes 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>
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>
318 <!-- end publish.classesIndex -->
322 <!-- ============================== class title ============================ -->
323 <h1 class=
"classTitle">
325 Class pwlib.tools.pencil
328 <!-- ============================== class summary ========================== -->
329 <p class=
"description">
335 <br /><i>Defined in:
</i> <a href=
"../symbols/src/src_tools_pencil.js.html">pencil.js
</a>.
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>
345 <th scope=
"col">Constructor Attributes
</th>
346 <th scope=
"col">Constructor Name and Description
</th>
351 <td class=
"attributes"> </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)
356 <div class=
"description"></div>
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>
371 <th scope=
"col">Field Attributes
</th>
372 <th scope=
"col">Field Name and Description
</th>
378 <td class=
"attributes"><private
> <inner
> </td>
379 <td class=
"nameDescription">
380 <div class=
"fixedFont">
381 <b><a href=
"../symbols/pwlib.tools.pencil.html#-points">points
</a></b>
383 <div class=
"description">Holds the points needed to be drawn.
</div>
388 <td class=
"attributes"><private
> <inner
> </td>
389 <td class=
"nameDescription">
390 <div class=
"fixedFont">
391 <b><a href=
"../symbols/pwlib.tools.pencil.html#-timer">timer
</a></b>
393 <div class=
"description">The interval ID used for running the pencil drawing operation every few
399 <td class=
"attributes"><private
> <inner
> </td>
400 <td class=
"nameDescription">
401 <div class=
"fixedFont">
402 <b><a href=
"../symbols/pwlib.tools.pencil.html#-x0">x0
</a></b>
404 <div class=
"description">Holds the last point on the
<var>x
</var> axis of the image, for the current
405 drawing operation.
</div>
410 <td class=
"attributes"><private
> <inner
> </td>
411 <td class=
"nameDescription">
412 <div class=
"fixedFont">
413 <b><a href=
"../symbols/pwlib.tools.pencil.html#-y0">y0
</a></b>
415 <div class=
"description">Holds the last point on the
<var>y
</var> axis of the image, for the current
416 drawing operation.
</div>
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>
435 <th scope=
"col">Method Attributes
</th>
436 <th scope=
"col">Method Name and Description
</th>
442 <td class=
"attributes"> </td>
443 <td class=
"nameDescription">
444 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.pencil.html#deactivate">deactivate
</a></b>()
446 <div class=
"description">Tool deactivation event handler.
</div>
451 <td class=
"attributes"> </td>
452 <td class=
"nameDescription">
453 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.pencil.html#draw">draw
</a></b>()
455 <div class=
"description">Draw the points in the stack.
</div>
460 <td class=
"attributes"> </td>
461 <td class=
"nameDescription">
462 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.pencil.html#keydown">keydown
</a></b>(ev)
464 <div class=
"description">Allows the user to press
<kbd>Escape
</kbd> to cancel the drawing operation.
</div>
469 <td class=
"attributes"> </td>
470 <td class=
"nameDescription">
471 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.pencil.html#mousedown">mousedown
</a></b>()
473 <div class=
"description">Initialize the drawing operation.
</div>
478 <td class=
"attributes"> </td>
479 <td class=
"nameDescription">
480 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.pencil.html#mousemove">mousemove
</a></b>()
482 <div class=
"description">Save the mouse coordinates in the array.
</div>
487 <td class=
"attributes"> </td>
488 <td class=
"nameDescription">
489 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.pencil.html#mouseup">mouseup
</a></b>()
491 <div class=
"description">End the drawing operation, once the user releases the mouse button.
</div>
501 <!-- ============================== events summary ======================== -->
504 <!-- ============================== constructor details ==================== -->
506 <div class=
"details"><a name=
"constructor"> </a>
507 <div class=
"sectionTitle">
511 <div class=
"fixedFont">
512 <b>pwlib.tools.pencil
</b>(app)
515 <div class=
"description">
524 <dl class=
"detailList">
525 <dt class=
"heading">Parameters:
</dt>
528 <span class=
"light fixedFont">{
<a href=
"../symbols/PaintWeb.html">PaintWeb
</a>}
</span> <b>app
</b>
531 <dd>Reference to the main paint application object.
</dd>
545 <!-- ============================== field details ========================== -->
547 <div class=
"sectionTitle">
551 <a name=
"-points"> </a>
552 <div class=
"fixedFont"><private
> <inner
>
554 <span class=
"light">{Array}
</span>
558 <div class=
"description">
559 Holds the points needed to be drawn. Each point is added by the
560 <code>mousemove
</code> event handler.
574 <a name=
"-timer"> </a>
575 <div class=
"fixedFont"><private
> <inner
>
581 <div class=
"description">
582 The interval ID used for running the pencil drawing operation every few
593 <dl class=
"detailList">
594 <dt class=
"heading">See:
</dt>
596 <dd>PaintWeb.config.toolDrawDelay
</dd>
605 <div class=
"fixedFont"><private
> <inner
>
607 <span class=
"light">{Number}
</span>
611 <div class=
"description">
612 Holds the last point on the
<var>x
</var> axis of the image, for the current
628 <div class=
"fixedFont"><private
> <inner
>
630 <span class=
"light">{Number}
</span>
634 <div class=
"description">
635 Holds the last point on the
<var>y
</var> axis of the image, for the current
652 <!-- ============================== method details ========================= -->
654 <div class=
"sectionTitle">
658 <a name=
"deactivate"> </a>
659 <div class=
"fixedFont">
665 <div class=
"description">
666 Tool deactivation event handler.
684 <div class=
"fixedFont">
690 <div class=
"description">
691 Draw the points in the stack. This function is called every few
706 <dl class=
"detailList">
707 <dt class=
"heading">See:
</dt>
709 <dd>PaintWeb.config.toolDrawDelay
</dd>
716 <a name=
"keydown"> </a>
717 <div class=
"fixedFont">
719 <span class=
"light">{Boolean}
</span>
723 <div class=
"description">
724 Allows the user to press
<kbd>Escape
</kbd> to cancel the drawing operation.
732 <dl class=
"detailList">
733 <dt class=
"heading">Parameters:
</dt>
736 <span class=
"light fixedFont">{Event}
</span> <b>ev
</b>
739 <dd>The DOM Event object.
</dd>
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
760 <a name=
"mousedown"> </a>
761 <div class=
"fixedFont">
767 <div class=
"description">
768 Initialize the drawing operation.
785 <a name=
"mousemove"> </a>
786 <div class=
"fixedFont">
792 <div class=
"description">
793 Save the mouse coordinates in the array.
810 <a name=
"mouseup"> </a>
811 <div class=
"fixedFont">
817 <div class=
"description">
818 End the drawing operation, once the user releases the mouse button.
837 <!-- ============================== event details ========================= -->
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)