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.cpicker
</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.cpicker
328 <!-- ============================== class summary ========================== -->
329 <p class=
"description">
332 The color picker tool.
335 <br /><i>Defined in:
</i> <a href=
"../symbols/src/src_tools_cpicker.js.html">cpicker.js
</a>.
339 <!-- ============================== constructor summary ==================== -->
341 <table class=
"summaryTable" cellspacing=
"0" summary=
"A summary of the constructor documented in the class pwlib.tools.cpicker.">
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.cpicker.html#constructor">pwlib.tools.cpicker
</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.cpicker.">
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.cpicker.html#-colorAccepted">colorAccepted
</a></b>
383 <div class=
"description">Tells if the current color values are accepted by the user.
</div>
388 <td class=
"attributes"><private
> <inner
> </td>
389 <td class=
"nameDescription">
390 <div class=
"fixedFont">
391 <b><a href=
"../symbols/pwlib.tools.cpicker.html#-colormixerActive">colormixerActive
</a></b>
393 <div class=
"description">Tells if the color mixer is active for the current target input.
</div>
398 <td class=
"attributes"><private
> <inner
> </td>
399 <td class=
"nameDescription">
400 <div class=
"fixedFont">
401 <b><a href=
"../symbols/pwlib.tools.cpicker.html#-prevColor">prevColor
</a></b>
403 <div class=
"description">Holds the previous color values - before the user started picking
404 a different color.
</div>
409 <td class=
"attributes"><private
> <inner
> </td>
410 <td class=
"nameDescription">
411 <div class=
"fixedFont">
412 <b><a href=
"../symbols/pwlib.tools.cpicker.html#-prevTool">prevTool
</a></b>
414 <div class=
"description">Holds the ID of the previously active tool.
</div>
419 <td class=
"attributes"><private
> <inner
> </td>
420 <td class=
"nameDescription">
421 <div class=
"fixedFont">
422 <b><a href=
"../symbols/pwlib.tools.cpicker.html#-targetInput">targetInput
</a></b>
424 <div class=
"description">Holds a reference to the target color input.
</div>
435 <!-- ============================== methods summary ======================== -->
439 <table class=
"summaryTable" cellspacing=
"0" summary=
"A summary of the methods documented in the class pwlib.tools.cpicker.">
440 <caption>Method Summary
</caption>
443 <th scope=
"col">Method Attributes
</th>
444 <th scope=
"col">Method Name and Description
</th>
450 <td class=
"attributes"> </td>
451 <td class=
"nameDescription">
452 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.cpicker.html#activate">activate
</a></b>()
454 <div class=
"description">The
<code>activate
</code> event handler.
</div>
459 <td class=
"attributes"> </td>
460 <td class=
"nameDescription">
461 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.cpicker.html#contextmenu">contextmenu
</a></b>()
463 <div class=
"description">The
<code>contextmenu
</code> event handler.
</div>
468 <td class=
"attributes"> </td>
469 <td class=
"nameDescription">
470 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.cpicker.html#deactivate">deactivate
</a></b>()
472 <div class=
"description">The
<code>deactivate
</code> event handler.
</div>
477 <td class=
"attributes"> </td>
478 <td class=
"nameDescription">
479 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.cpicker.html#keydown">keydown
</a></b>(ev)
481 <div class=
"description">The
<code>keydown
</code> event handler.
</div>
486 <td class=
"attributes"> </td>
487 <td class=
"nameDescription">
488 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.cpicker.html#mousedown">mousedown
</a></b>(ev)
490 <div class=
"description">The
<code>mousedown
</code> event handler.
</div>
495 <td class=
"attributes"> </td>
496 <td class=
"nameDescription">
497 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.cpicker.html#mouseup">mouseup
</a></b>(ev)
499 <div class=
"description">The
<code>mouseup
</code> event handler.
</div>
504 <td class=
"attributes"> </td>
505 <td class=
"nameDescription">
506 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.cpicker.html#preActivate">preActivate
</a></b>()
508 <div class=
"description">The
<code>preActivate
</code> event handler.
</div>
513 <td class=
"attributes"><inner
> </td>
514 <td class=
"nameDescription">
515 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.cpicker.html#-updateColor">updateColor
</a></b>(ev, usePrevColor)
517 <div class=
"description">Perform color update.
</div>
522 <td class=
"attributes"><private
> <inner
> </td>
523 <td class=
"nameDescription">
524 <div class=
"fixedFont"><b><a href=
"../symbols/pwlib.tools.cpicker.html#-updatePrevColor">updatePrevColor
</a></b>()
526 <div class=
"description">Store the color values from the target color input, before this tool
527 changes the colors.
</div>
537 <!-- ============================== events summary ======================== -->
540 <!-- ============================== constructor details ==================== -->
542 <div class=
"details"><a name=
"constructor"> </a>
543 <div class=
"sectionTitle">
547 <div class=
"fixedFont">
548 <b>pwlib.tools.cpicker
</b>(app)
551 <div class=
"description">
560 <dl class=
"detailList">
561 <dt class=
"heading">Parameters:
</dt>
564 <span class=
"light fixedFont">{
<a href=
"../symbols/PaintWeb.html">PaintWeb
</a>}
</span> <b>app
</b>
567 <dd>Reference to the main paint application object.
</dd>
581 <!-- ============================== field details ========================== -->
583 <div class=
"sectionTitle">
587 <a name=
"-colorAccepted"> </a>
588 <div class=
"fixedFont"><private
> <inner
>
590 <span class=
"light">{Boolean}
</span>
594 <div class=
"description">
595 Tells if the current color values are accepted by the user. This value is
596 used by the tool deactivation code.
610 <a name=
"-colormixerActive"> </a>
611 <div class=
"fixedFont"><private
> <inner
>
613 <span class=
"light">{Boolean}
</span>
614 <b>colormixerActive
</b>
617 <div class=
"description">
618 Tells if the color mixer is active for the current target input.
632 <a name=
"-prevColor"> </a>
633 <div class=
"fixedFont"><private
> <inner
>
635 <span class=
"light">{Object}
</span>
639 <div class=
"description">
640 Holds the previous color values - before the user started picking
655 <a name=
"-prevTool"> </a>
656 <div class=
"fixedFont"><private
> <inner
>
658 <span class=
"light">{String}
</span>
662 <div class=
"description">
663 Holds the ID of the previously active tool. Once the user completes the
664 color picking operation, the previous tool is activated.
678 <a name=
"-targetInput"> </a>
679 <div class=
"fixedFont"><private
> <inner
>
681 <span class=
"light">{
<a href=
"../symbols/pwlib.guiColorInput.html">pwlib.guiColorInput
</a>}
</span>
685 <div class=
"description">
686 Holds a reference to the target color input. This is a GUI color input
703 <!-- ============================== method details ========================= -->
705 <div class=
"sectionTitle">
709 <a name=
"activate"> </a>
710 <div class=
"fixedFont">
716 <div class=
"description">
717 The
<code>activate
</code> event handler. This method determines the current
718 target input in the Color Mixer, if any. Canvas shadow rendering is
736 <a name=
"contextmenu"> </a>
737 <div class=
"fixedFont">
743 <div class=
"description">
744 The
<code>contextmenu
</code> event handler. This method only cancels the
762 <a name=
"deactivate"> </a>
763 <div class=
"fixedFont">
769 <div class=
"description">
770 The
<code>deactivate
</code> event handler. This method allows shadow
771 rendering again, and resets the color input values if the user did not
772 accept the new color.
789 <a name=
"keydown"> </a>
790 <div class=
"fixedFont">
792 <span class=
"light">{Boolean}
</span>
796 <div class=
"description">
797 The
<code>keydown
</code> event handler. This method allows the user to
798 press the
<kbd>Escape
</kbd> key to cancel the color picking operation. By
799 doing so, the original color values are restored.
807 <dl class=
"detailList">
808 <dt class=
"heading">Parameters:
</dt>
811 <span class=
"light fixedFont">{Event}
</span> <b>ev
</b>
814 <dd>The DOM Event object.
</dd>
822 <dl class=
"detailList">
823 <dt class=
"heading">Returns:
</dt>
825 <dd><span class=
"light fixedFont">{Boolean}
</span> True if the keyboard shortcut was recognized, or false
835 <a name=
"mousedown"> </a>
836 <div class=
"fixedFont">
842 <div class=
"description">
843 The
<code>mousedown
</code> event handler. This method starts the color
852 <dl class=
"detailList">
853 <dt class=
"heading">Parameters:
</dt>
856 <span class=
"light fixedFont">{Event}
</span> <b>ev
</b>
859 <dd>The DOM Event object.
</dd>
872 <a name=
"mouseup"> </a>
873 <div class=
"fixedFont">
879 <div class=
"description">
880 The
<code>mouseup
</code> event handler. This method completes the color
881 picking operation, and activates the previous tool.
883 <p>The
<a href=
"../symbols/pwlib.appEvent.configChange.html">pwlib.appEvent.configChange
</a> application event is also
884 dispatched for the configuration property associated to the target input.
892 <dl class=
"detailList">
893 <dt class=
"heading">Parameters:
</dt>
896 <span class=
"light fixedFont">{Event}
</span> <b>ev
</b>
899 <dd>The DOM Event object.
</dd>
912 <a name=
"preActivate"> </a>
913 <div class=
"fixedFont">
919 <div class=
"description">
920 The
<code>preActivate
</code> event handler. This method checks if the
921 browser implements the
<code>getImageData()
</code> context method. If not,
922 the color picker tool cannot be used.
939 <a name=
"-updateColor"> </a>
940 <div class=
"fixedFont"><inner
>
943 <b>updateColor
</b>(ev, usePrevColor)
946 <div class=
"description">
947 Perform color update. This function updates the target input or the Color
948 Mixer to hold the color value under the mouse - it actually performs the
949 color picking operation.
951 <p>This function is also the
<code>mousemove
</code> event handler for this
960 <dl class=
"detailList">
961 <dt class=
"heading">Parameters:
</dt>
964 <span class=
"light fixedFont">{Event}
</span> <b>ev
</b>
967 <dd>The DOM Event object.
</dd>
970 <span class=
"light fixedFont">{Boolean}
</span> <b>usePrevColor
</b>
971 <i>Optional, Default: false
</i>
973 <dd>Tells the function to use the
974 previous color values we have stored. This is used when the user cancels
975 the color picking operation.
</dd>
988 <a name=
"-updatePrevColor"> </a>
989 <div class=
"fixedFont"><private
> <inner
>
992 <b>updatePrevColor
</b>()
995 <div class=
"description">
996 Store the color values from the target color input, before this tool
997 changes the colors. The previous color values are used when the user
998 decides to cancel the color picking operation.
1017 <!-- ============================== event details ========================= -->
1024 <!-- ============================== footer ================================= -->
1025 <div class=
"fineprint" style=
"clear:both">
1027 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:
23 GMT+
0300 (EEST)