UNPKG

33.7 kBHTMLView Raw
1<!DOCTYPE html>
2
3<html lang="en">
4<head>
5 <meta charset="utf-8">
6 <meta name="viewport" content="width=device-width">
7 <title>CrossBrowdy API documentation Namespace: AmbientLight</title>
8
9 <!--[if lt IE 9]>
10 <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
11 <![endif]-->
12 <link type="text/css" rel="stylesheet" href="styles/sunlight.default.css">
13
14 <link type="text/css" rel="stylesheet" href="styles/site.cosmo.css">
15
16</head>
17
18<body style="min-width:800px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
19
20<div class="navbar navbar-default navbar-fixed-top ">
21<div class="container">
22 <div class="navbar-header">
23 <a class="navbar-brand" href="index.html">CrossBrowdy API documentation</a>
24 <button class="navbar-toggle" type="button" data-toggle="collapse" data-target="#topNavigation">
25 <span class="icon-bar"></span>
26 <span class="icon-bar"></span>
27 <span class="icon-bar"></span>
28 </button>
29 </div>
30 <div class="navbar-collapse collapse" id="topNavigation">
31 <ul class="nav navbar-nav">
32
33 <li class="dropdown">
34 <a href="namespaces.list.html" class="dropdown-toggle" data-toggle="dropdown">Namespaces<b class="caret"></b></a>
35 <ul class="dropdown-menu inline">
36 <li><a href="CB_Arrays.html">CB_Arrays</a></li><li><a href="CB_AudioDetector.html">CB_AudioDetector</a></li><li><a href="CB_baseSymbols.html">CB_baseSymbols</a></li><li><a href="CB_Client.html">CB_Client</a></li><li><a href="CB_Collisions.html">CB_Collisions</a></li><li><a href="CB_Configuration.html">CB_Configuration</a></li><li><a href="CB_Configuration.CrossBase.html">CB_Configuration.CrossBase</a></li><li><a href="CB_Configuration.CrossBrowdy.html">CB_Configuration.CrossBrowdy</a></li><li><a href="CB_Controllers.html">CB_Controllers</a></li><li><a href="CB_Controllers_Proprietary.html">CB_Controllers_Proprietary</a></li><li><a href="CB_Controllers_Proprietary.WII.html">CB_Controllers_Proprietary.WII</a></li><li><a href="CB_Controllers_Proprietary.WII_U.html">CB_Controllers_Proprietary.WII_U</a></li><li><a href="CB_Device.html">CB_Device</a></li><li><a href="CB_Device.AmbientLight.html">CB_Device.AmbientLight</a></li><li><a href="CB_Device.Battery.html">CB_Device.Battery</a></li><li><a href="CB_Device.Location.html">CB_Device.Location</a></li><li><a href="CB_Device.Motion.html">CB_Device.Motion</a></li><li><a href="CB_Device.Orientation.html">CB_Device.Orientation</a></li><li><a href="CB_Device.Proximity.html">CB_Device.Proximity</a></li><li><a href="CB_Device.Vibration.html">CB_Device.Vibration</a></li><li><a href="CB_Elements.html">CB_Elements</a></li><li><a href="CB_Events.html">CB_Events</a></li><li><a href="CB_Keyboard.html">CB_Keyboard</a></li><li><a href="CB_Keyboard.chars.html">CB_Keyboard.chars</a></li><li><a href="CB_Keyboard.extended.html">CB_Keyboard.extended</a></li><li><a href="CB_Keyboard.keys.html">CB_Keyboard.keys</a></li><li><a href="CB_Modules.html">CB_Modules</a></li><li><a href="CB_Mouse.html">CB_Mouse</a></li><li><a href="CB_Mouse.CursorImage.html">CB_Mouse.CursorImage</a></li><li><a href="CB_Net.html">CB_Net</a></li><li><a href="CB_Net.Fetch.html">CB_Net.Fetch</a></li><li><a href="CB_Net.REST.html">CB_Net.REST</a></li><li><a href="CB_Net.Sockets.html">CB_Net.Sockets</a></li><li><a href="CB_Net.Sockets.SockJS.html">CB_Net.Sockets.SockJS</a></li><li><a href="CB_Net.XHR.html">CB_Net.XHR</a></li><li><a href="CB_Pointer.html">CB_Pointer</a></li><li><a href="CB_Screen.html">CB_Screen</a></li><li><a href="CB_Speaker.html">CB_Speaker</a></li><li><a href="CB_Touch.html">CB_Touch</a></li>
37 </ul>
38 </li>
39
40 <li class="dropdown">
41 <a href="classes.list.html" class="dropdown-toggle" data-toggle="dropdown">Classes<b class="caret"></b></a>
42 <ul class="dropdown-menu inline">
43 <li><a href="CB_AudioFile.html">CB_AudioFile</a></li><li><a href="CB_AudioFile_API.AAPI.html">CB_AudioFile_API.AAPI</a></li><li><a href="CB_AudioFile_API.ACMP.html">CB_AudioFile_API.ACMP</a></li><li><a href="CB_AudioFile_API.SM2.html">CB_AudioFile_API.SM2</a></li><li><a href="CB_AudioFile_API.WAAPI.html">CB_AudioFile_API.WAAPI</a></li><li><a href="CB_AudioFileCache.html">CB_AudioFileCache</a></li><li><a href="CB_AudioFileSprites.html">CB_AudioFileSprites</a></li><li><a href="CB_AudioFileSpritesPool.html">CB_AudioFileSpritesPool</a></li><li><a href="CB_Canvas.html">CB_Canvas</a></li><li><a href="CB_GraphicSprites.html">CB_GraphicSprites</a></li><li><a href="CB_GraphicSpritesScene.html">CB_GraphicSpritesScene</a></li>
44 </ul>
45 </li>
46
47 <li class="dropdown">
48 <a href="global.html" class="dropdown-toggle" data-toggle="dropdown">Global<b class="caret"></b></a>
49 <ul class="dropdown-menu inline">
50 <li><a href="global.html#CB_addCredits">CB_addCredits</a></li><li><a href="global.html#CB_BASE_NAME">CB_BASE_NAME</a></li><li><a href="global.html#CB_baseToBase">CB_baseToBase</a></li><li><a href="global.html#CB_baseToInt">CB_baseToInt</a></li><li><a href="global.html#CB_br2nl">CB_br2nl</a></li><li><a href="global.html#CB_brToNl">CB_brToNl</a></li><li><a href="global.html#CB_combineArraysOrObjects">CB_combineArraysOrObjects</a></li><li><a href="global.html#CB_combineAutomatically">CB_combineAutomatically</a></li><li><a href="global.html#CB_combineJSON">CB_combineJSON</a></li><li><a href="global.html#CB_combineURIParameters">CB_combineURIParameters</a></li><li><a href="global.html#CB_combineURLParameters">CB_combineURLParameters</a></li><li><a href="global.html#CB_console">CB_console</a></li><li><a href="global.html#CB_copyObject">CB_copyObject</a></li><li><a href="global.html#CB_countDecimalDigits">CB_countDecimalDigits</a></li><li><a href="global.html#CB_countDecimalPart">CB_countDecimalPart</a></li><li><a href="global.html#CB_countDecimals">CB_countDecimals</a></li><li><a href="global.html#CB_countIntegerDigits">CB_countIntegerDigits</a></li><li><a href="global.html#CB_countIntegerPart">CB_countIntegerPart</a></li><li><a href="global.html#CB_credits">CB_credits</a></li><li><a href="global.html#CB_CREDITS_DEFAULT">CB_CREDITS_DEFAULT</a></li><li><a href="global.html#CB_forceString">CB_forceString</a></li><li><a href="global.html#CB_forEach">CB_forEach</a></li><li><a href="global.html#CB_getBase64StringObject">CB_getBase64StringObject</a></li><li><a href="global.html#CB_getCookie">CB_getCookie</a></li><li><a href="global.html#CB_getDatum">CB_getDatum</a></li><li><a href="global.html#CB_getJSONPropertyValue">CB_getJSONPropertyValue</a></li><li><a href="global.html#CB_getLZStringObject">CB_getLZStringObject</a></li><li><a href="global.html#CB_getValueIndex">CB_getValueIndex</a></li><li><a href="global.html#CB_getValuePath">CB_getValuePath</a></li><li><a href="global.html#CB_includeJSFile">CB_includeJSFile</a></li><li><a href="global.html#CB_indexOf">CB_indexOf</a></li><li><a href="global.html#CB_init">CB_init</a></li><li><a href="global.html#CB_intToBase">CB_intToBase</a></li><li><a href="global.html#CB_isArray">CB_isArray</a></li><li><a href="global.html#CB_isEmail">CB_isEmail</a></li><li><a href="global.html#CB_isFileLocal">CB_isFileLocal</a></li><li><a href="global.html#CB_isString">CB_isString</a></li><li><a href="global.html#CB_lastIndexOf">CB_lastIndexOf</a></li><li><a href="global.html#CB_ltrim">CB_ltrim</a></li><li><a href="global.html#CB_NAME">CB_NAME</a></li><li><a href="global.html#CB_nl2br">CB_nl2br</a></li><li><a href="global.html#CB_nlToBr">CB_nlToBr</a></li><li><a href="global.html#CB_numberFormat">CB_numberFormat</a></li><li><a href="global.html#CB_numberOfDecimalDigits">CB_numberOfDecimalDigits</a></li><li><a href="global.html#CB_numberOfDecimals">CB_numberOfDecimals</a></li><li><a href="global.html#CB_numberOfIntegerDigits">CB_numberOfIntegerDigits</a></li><li><a href="global.html#CB_OPTIONS">CB_OPTIONS</a></li><li><a href="global.html#CB_parseJSON">CB_parseJSON</a></li><li><a href="global.html#CB_parseString">CB_parseString</a></li><li><a href="global.html#CB_regularExpressionString">CB_regularExpressionString</a></li><li><a href="global.html#CB_renderString">CB_renderString</a></li><li><a href="global.html#CB_replaceAll">CB_replaceAll</a></li><li><a href="global.html#CB_rtrim">CB_rtrim</a></li><li><a href="global.html#CB_scriptPath">CB_scriptPath</a></li><li><a href="global.html#CB_scriptPathCalculate">CB_scriptPathCalculate</a></li><li><a href="global.html#CB_setCookie">CB_setCookie</a></li><li><a href="global.html#CB_setDatum">CB_setDatum</a></li><li><a href="global.html#CB_sizeof">CB_sizeof</a></li><li><a href="global.html#CB_sizeOf">CB_sizeOf</a></li><li><a href="global.html#CB_stringifyJSON">CB_stringifyJSON</a></li><li><a href="global.html#CB_symmetricCall">CB_symmetricCall</a></li><li><a href="global.html#CB_symmetricCallClear">CB_symmetricCallClear</a></li><li><a href="global.html#CB_this">CB_this</a></li><li><a href="global.html#CB_trim">CB_trim</a></li><li><a href="global.html#CB_VERSION">CB_VERSION</a></li>
51 </ul>
52 </li>
53
54 </ul>
55
56 <div class="col-sm-3 col-md-3">
57 <form class="navbar-form" role="search">
58 <div class="input-group">
59 <input type="text" class="form-control" placeholder="Search" name="q" id="search-input">
60 <div class="input-group-btn">
61 <button class="btn btn-default" id="search-submit"><i class="glyphicon glyphicon-search"></i></button>
62 </div>
63 </div>
64 </form>
65 </div>
66
67 </div>
68
69</div>
70</div>
71
72
73<div class="container" id="toc-content" style="width:100%;">
74<div class="row" style="width:100%;">
75
76
77 <div class="col-md-8" style="width:85%;">
78
79 <div id="main">
80
81
82
83 <h1 class="page-title">Namespace: AmbientLight</h1>
84
85<section>
86
87<header>
88
89 <h2>
90 <span class="ancestors"><a href="CB_Device.html">CB_Device</a>.</span>
91
92 AmbientLight
93 </h2>
94
95
96</header>
97
98
99<article>
100 <div class="container-overview">
101
102
103 <div class="description"><p>Static class to manage the device's ambient light sensor. It will return itself if it is tried to be instantiated.</p></div>
104
105
106
107<dl class="details">
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137 <dt class="tag-source method-doc-label method-doc-details-label">Source:</dt>
138 <dd class="tag-source">
139 <ul class="dummy">
140 <li>
141 <a href="CrossBase_device_CB_Device.js.html">CrossBase/device/CB_Device.js</a>,
142 <a href="CrossBase_device_CB_Device.js.html#sunlight-1-line-1063">line 1063</a>
143 </li>
144 </ul>
145 </dd>
146
147
148
149
150
151
152
153 <dt class="tag-todo method-doc-label method-doc-details-label">To Do:</dt>
154 <dd class="tag-todo">
155 <ul>
156 <li>Normalize more differences between web clients.</li>
157 </ul>
158 </dd>
159
160</dl>
161
162
163
164
165 </div>
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180 <h3 class="subsection-title">Methods</h3>
181
182 <dl>
183
184<hr>
185<dt>
186 <h4 class="name" id=".isSupported"><span class="type-signature">&lt;static> </span>isSupported<span class="signature">()</span><span class="type-signature"> &rarr; {boolean}</span></h4>
187
188
189</dt>
190<dd>
191
192
193 <div class="description">
194 <p>Tells whether the <a href="https://w3.org/TR/ambient-light/">Ambient Light Sensor API</a> or the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Ambient_Light_Events">Ambient Light Sensor Events (&quot;ondevicelight&quot;)</a> or <a href="https://modernweb.com/introduction-to-the-ambient-light-api/">&quot;onlightlevel&quot; event</a> are supported or not.</p>
195 </div>
196
197
198
199
200
201
202
203
204
205
206<dl class="details">
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236 <dt class="tag-source method-doc-label method-doc-details-label">Source:</dt>
237 <dd class="tag-source">
238 <ul class="dummy">
239 <li>
240 <a href="CrossBase_device_CB_Device.js.html">CrossBase/device/CB_Device.js</a>,
241 <a href="CrossBase_device_CB_Device.js.html#sunlight-1-line-1070">line 1070</a>
242 </li>
243 </ul>
244 </dd>
245
246
247
248
249
250
251
252</dl>
253
254
255
256
257
258
259
260
261
262
263
264
265
266 <h5>Returns:</h5>
267
268
269
270
271<dl>
272 <dt>
273 Type
274 </dt>
275 <dd>
276
277<span class="param-type">boolean</span>
278
279
280
281 </dd>
282</dl>
283
284
285
286
287
288</dd>
289
290
291
292<hr>
293<dt>
294 <h4 class="name" id=".normalizeEvent"><span class="type-signature">&lt;static> </span>normalizeEvent<span class="signature">(e, eventName [, sensor])</span><span class="type-signature"> &rarr; {Event}</span></h4>
295
296
297</dt>
298<dd>
299
300
301 <div class="description">
302 <p>Normalizes the data gotten from the the <a href="https://w3.org/TR/ambient-light/">Ambient Light Sensor API</a> or the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Ambient_Light_Events">Ambient Light Sensor Events (&quot;ondevicelight&quot;)</a> or <a href="https://modernweb.com/introduction-to-the-ambient-light-api/">&quot;onlightlevel&quot; event</a> to try to match the <a href="https://w3.org/TR/ambient-light/">Ambient Light Sensor API</a> and follow always the same rules as much as possible.</p>
303 </div>
304
305
306
307
308
309
310
311
312 <h5>Parameters:</h5>
313
314
315<table class="params table table-striped">
316 <thead>
317 <tr>
318
319 <th style="width:12%; min-width:110px;">Name</th>
320
321
322 <th style="width:12%; min-width:110px;">Type</th>
323
324
325 <th style="width:12%; min-width:110px;">Argument</th>
326
327
328
329
330 <th class="last" style="min-width:310px;">Description</th>
331 </tr>
332 </thead>
333
334 <tbody>
335
336
337 <tr>
338
339 <td class="name" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><code>e</code></td>
340
341
342 <td class="type" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
343
344
345<span class="param-type">Event</span>
346
347
348
349
350 </td>
351
352
353 <td class="attributes" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
354
355
356
357
358
359 </td>
360
361
362
363
364 <td class="description last" style="min-width:310px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><p>The event object that we want to normalize.</p></td>
365 </tr>
366
367
368
369 <tr>
370
371 <td class="name" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><code>eventName</code></td>
372
373
374 <td class="type" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
375
376
377<span class="param-type">'change'</span>
378|
379
380<span class="param-type">'reading'</span>
381|
382
383<span class="param-type">'devicelight'</span>
384|
385
386<span class="param-type">'lightlevel'</span>
387
388
389
390
391 </td>
392
393
394 <td class="attributes" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
395
396
397
398
399
400 </td>
401
402
403
404
405 <td class="description last" style="min-width:310px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><p>The name of the event that we want to normalize. Case sensitive.</p></td>
406 </tr>
407
408
409
410 <tr>
411
412 <td class="name" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><code>sensor</code></td>
413
414
415 <td class="type" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
416
417
418<span class="param-type">AmbientLightSensor</span>
419
420
421
422
423 </td>
424
425
426 <td class="attributes" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
427
428 &lt;optional><br>
429
430
431
432
433
434 </td>
435
436
437
438
439 <td class="description last" style="min-width:310px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><p><a href="https://w3.org/TR/ambient-light/#ambient-light-sensor-interface">AmbientLightSensor</a> object used by the <a href="https://w3.org/TR/ambient-light/">Ambient Light Sensor API</a>.</p></td>
440 </tr>
441
442
443 </tbody>
444</table>
445
446
447
448
449<dl class="details">
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479 <dt class="tag-source method-doc-label method-doc-details-label">Source:</dt>
480 <dd class="tag-source">
481 <ul class="dummy">
482 <li>
483 <a href="CrossBase_device_CB_Device.js.html">CrossBase/device/CB_Device.js</a>,
484 <a href="CrossBase_device_CB_Device.js.html#sunlight-1-line-1144">line 1144</a>
485 </li>
486 </ul>
487 </dd>
488
489
490
491
492
493
494
495 <dt class="tag-todo method-doc-label method-doc-details-label">To Do:</dt>
496 <dd class="tag-todo">
497 <ul>
498 <li>Normalize more differences between web clients.</li>
499 </ul>
500 </dd>
501
502</dl>
503
504
505
506
507
508
509
510
511
512
513
514
515
516 <h5>Returns:</h5>
517
518
519<div class="param-desc">
520 <p>Returns the given event object again but normalized (if possible).</p>
521</div>
522
523
524
525<dl>
526 <dt>
527 Type
528 </dt>
529 <dd>
530
531<span class="param-type">Event</span>
532
533
534
535 </dd>
536</dl>
537
538
539
540
541
542</dd>
543
544
545
546<hr>
547<dt>
548 <h4 class="name" id=".onChange"><span class="type-signature">&lt;static> </span>onChange<span class="signature">(eventFunction [, keepOldFunction] [, useCapture] [, callbackError])</span><span class="type-signature"> &rarr; {undefined|false}</span></h4>
549
550
551</dt>
552<dd>
553
554
555 <div class="description">
556 <p>Sets the event to get the ambient light or removes it. Uses the <a href="https://w3.org/TR/ambient-light/">Ambient Light Sensor API</a> or the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Ambient_Light_Events">Ambient Light Sensor Events (&quot;ondevicelight&quot;)</a> or <a href="https://modernweb.com/introduction-to-the-ambient-light-api/">&quot;onlightlevel&quot; event</a>.<br> <br/><br> The given &quot;eventFunction&quot; will receive the event object as the first parameter but this event object will vary depending on the way to get the ambient light which is supported by the client (if any):<br> <br /><br> First choice, if available, uses the <a href="https://w3.org/TR/ambient-light/">Ambient Light Sensor API</a> and &quot;event.value&quot; will contain the units in lux.<br> <br /><br> Second choice, if available, uses the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Ambient_Light_Events">Ambient Light Sensor Events (&quot;ondevicelight&quot;)</a> and &quot;event.value&quot; will contain the units in lux.<br> <br /><br> Third choice, if available, uses the <a href="https://modernweb.com/introduction-to-the-ambient-light-api/">&quot;onlightlevel&quot; event</a> and &quot;event.value&quot; will be &quot;&quot; (an empty string), &quot;dim&quot;, &quot;normal&quot; or &quot;bright&quot; instead of a number.</p>
557 </div>
558
559
560
561
562
563
564
565
566 <h5>Parameters:</h5>
567
568
569<table class="params table table-striped">
570 <thead>
571 <tr>
572
573 <th style="width:12%; min-width:110px;">Name</th>
574
575
576 <th style="width:12%; min-width:110px;">Type</th>
577
578
579 <th style="width:12%; min-width:110px;">Argument</th>
580
581
582
583 <th style="width:12%; min-width:110px;">Default</th>
584
585
586 <th class="last" style="min-width:310px;">Description</th>
587 </tr>
588 </thead>
589
590 <tbody>
591
592
593 <tr>
594
595 <td class="name" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><code>eventFunction</code></td>
596
597
598 <td class="type" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
599
600
601<span class="param-type">function</span>
602|
603
604<span class="param-type">null</span>
605
606
607
608
609 </td>
610
611
612 <td class="attributes" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
613
614
615
616
617
618 </td>
619
620
621
622 <td class="default" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
623
624 </td>
625
626
627 <td class="description last" style="min-width:310px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><p>The function that will be called when the event is fired. The event object received will already be normalized by the <a href="CB_Device.AmbientLight.html#.normalizeEvent"><code>CB_Device.AmbientLight.normalizeEvent</code></a> function automatically. Despite of this, due to the big differences between different clients, the event object received as the first parameter will vary depending on the way to get the ambient light which is supported by the client (if any). If a null value is used, the event will be removed.</p></td>
628 </tr>
629
630
631
632 <tr>
633
634 <td class="name" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><code>keepOldFunction</code></td>
635
636
637 <td class="type" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
638
639
640<span class="param-type">boolean</span>
641
642
643
644
645 </td>
646
647
648 <td class="attributes" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
649
650 &lt;optional><br>
651
652
653
654
655
656 </td>
657
658
659
660 <td class="default" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
661
662 true
663
664 </td>
665
666
667 <td class="description last" style="min-width:310px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><p>Defines whether we want to keep any possible previous event listener or not.</p></td>
668 </tr>
669
670
671
672 <tr>
673
674 <td class="name" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><code>useCapture</code></td>
675
676
677 <td class="type" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
678
679
680<span class="param-type">float</span>
681
682
683
684
685 </td>
686
687
688 <td class="attributes" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
689
690 &lt;optional><br>
691
692
693
694
695
696 </td>
697
698
699
700 <td class="default" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
701
702 false
703
704 </td>
705
706
707 <td class="description last" style="min-width:310px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><p>Defines whether the event we want to add will use capture or not. This parameter will be effective only if the current client supports the <a href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener">addEventListener</a> method and will be used as its third parameter.</p></td>
708 </tr>
709
710
711
712 <tr>
713
714 <td class="name" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><code>callbackError</code></td>
715
716
717 <td class="type" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
718
719
720<span class="param-type">function</span>
721
722
723
724
725 </td>
726
727
728 <td class="attributes" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
729
730 &lt;optional><br>
731
732
733
734
735
736 </td>
737
738
739
740 <td class="default" style="width:12%; min-width:110px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;">
741
742 </td>
743
744
745 <td class="description last" style="min-width:310px; overflow-wrap:break-word; word-wrap:break-word; word-break:break-word; line-break:strict; hyphens:none; -webkit-hyphens:none; -moz-hyphens:none;"><p>Callback that will be called if there is any error getting the ambient light. Only used by the <a href="https://w3.org/TR/ambient-light/">Ambient Light Sensor API</a> (if available).</p></td>
746 </tr>
747
748
749 </tbody>
750</table>
751
752
753
754
755<dl class="details">
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785 <dt class="tag-source method-doc-label method-doc-details-label">Source:</dt>
786 <dd class="tag-source">
787 <ul class="dummy">
788 <li>
789 <a href="CrossBase_device_CB_Device.js.html">CrossBase/device/CB_Device.js</a>,
790 <a href="CrossBase_device_CB_Device.js.html#sunlight-1-line-1093">line 1093</a>
791 </li>
792 </ul>
793 </dd>
794
795
796
797
798
799
800
801</dl>
802
803
804
805
806
807
808
809
810
811
812
813
814
815 <h5>Returns:</h5>
816
817
818<div class="param-desc">
819 <p>Returns false in the case that no way to get the ambient light is available or undefined otherwise.</p>
820</div>
821
822
823
824<dl>
825 <dt>
826 Type
827 </dt>
828 <dd>
829
830<span class="param-type">undefined</span>
831|
832
833<span class="param-type">false</span>
834
835
836
837 </dd>
838</dl>
839
840
841
842
843
844</dd>
845
846 </dl>
847
848
849
850
851
852</article>
853
854</section>
855
856
857
858
859 </div>
860 </div>
861
862 <div class="clearfix"></div>
863
864
865 <div class="col-md-3">
866 <div id="toc" class="col-md-3 hidden-xs hidden-sm hidden-md"></div>
867 </div>
868
869
870</div>
871</div>
872
873
874 <div class="modal fade" id="searchResults">
875 <div class="modal-dialog">
876 <div class="modal-content">
877 <div class="modal-header">
878 <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
879 <h4 class="modal-title">Search results</h4>
880 </div>
881 <div class="modal-body"></div>
882 <div class="modal-footer">
883 <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
884 </div>
885 </div><!-- /.modal-content -->
886 </div><!-- /.modal-dialog -->
887 </div>
888
889
890<footer>
891
892
893 <span class="copyright">
894 <a href="printable/" target="_blank">See a more printer-friendly version</a><hr /><span style="color:#000000">© <address style="display:inline; font-style:normal;"><a href="https://crossbrowdy.com/" target="_blank">CrossBrowdy</a> API documentation</address> by <a href="https://joanalbamaldonado.com/" target="_blank">Joan Alba Maldonado</a> - <a href="https://creativecommons.org/licenses/by/4.0/" target="_blank">Creative Commons Attribution 4.0 International</a><br />DocStrap Copyright © 2012-2015 The contributors to the JSDoc3 and DocStrap projects.</span>
895 </span>
896
897<span class="jsdoc-message">
898 Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a>
899
900 on Mon Feb 3rd 2020
901
902 using the <a href="https://github.com/docstrap/docstrap">DocStrap template</a>.
903</span>
904</footer>
905
906<script src="scripts/docstrap.lib.js"></script>
907<script src="scripts/toc.js"></script>
908
909 <script type="text/javascript" src="scripts/fulltext-search-ui.js"></script>
910
911
912<script>
913$( function () {
914 $( "[id*='$']" ).each( function () {
915 var $this = $( this );
916
917 $this.attr( "id", $this.attr( "id" ).replace( "$", "__" ) );
918 } );
919
920 $( ".tutorial-section pre, .readme-section pre, pre.prettyprint.source" ).each( function () {
921 var $this = $( this );
922
923 var example = $this.find( "code" );
924 exampleText = example.html();
925 var lang = /{@lang (.*?)}/.exec( exampleText );
926 if ( lang && lang[1] ) {
927 exampleText = exampleText.replace( lang[0], "" );
928 example.html( exampleText );
929 lang = lang[1];
930 } else {
931 var langClassMatch = example.parent()[0].className.match(/lang\-(\S+)/);
932 lang = langClassMatch ? langClassMatch[1] : "javascript";
933 }
934
935 if ( lang ) {
936
937 $this
938 .addClass( "sunlight-highlight-" + lang )
939 .addClass( "linenums" )
940 .html( example.html() );
941
942 }
943 } );
944
945 Sunlight.highlightAll( {
946 lineNumbers : true,
947 showMenu : true,
948 enableDoclinks : true
949 } );
950
951 $.catchAnchorLinks( {
952 navbarOffset: 10
953 } );
954 $( "#toc" ).toc( {
955 anchorName : function ( i, heading, prefix ) {
956 return $( heading ).attr( "id" ) || ( prefix + i );
957 },
958 selectors : "#toc-content h1,#toc-content h2,#toc-content h3,#toc-content h4",
959 showAndHide : false,
960 smoothScrolling: true
961 } );
962
963 $( "#main span[id^='toc']" ).addClass( "toc-shim" );
964 $( '.dropdown-toggle' ).dropdown();
965
966 $( "table" ).each( function () {
967 var $this = $( this );
968 $this.addClass('table');
969 } );
970
971} );
972</script>
973
974
975
976<!--Navigation and Symbol Display-->
977
978<script>
979 $( function () {
980 $( '#main' ).localScroll( {
981 offset : { top : 60 } //offset by the height of your header (give or take a few px, see what works for you)
982 } );
983 $( "dt.name" ).each( function () {
984 var $this = $( this ).find("h4");
985 var icon = $( "<i/>" ).addClass( "icon-plus-sign" ).addClass( "pull-right" ).addClass( "icon-white" );
986 var dt = $(this);
987 var children = dt.next( "dd" );
988
989 dt.prepend( icon ).css( {cursor : "pointer"} );
990 dt.addClass( "member-collapsed" ).addClass( "member" );
991
992
993 children.hide();
994
995 dt.children().on( "click", function () {
996 children = dt.next( "dd" );
997 children.slideToggle( "fast", function () {
998
999 if ( children.is( ":visible" ) ) {
1000 icon.addClass( "icon-minus-sign" ).removeClass( "icon-plus-sign" ).removeClass( "icon-white" );
1001 dt.addClass( "member-open" ).animate( "member-collapsed" );
1002 } else {
1003 icon.addClass( "icon-plus-sign" ).removeClass( "icon-minus-sign" ).addClass( "icon-white" );
1004 dt.addClass( "member-collapsed" ).removeClass( "member-open" );
1005 }
1006 } );
1007 } );
1008
1009 } );
1010 } );
1011</script>
1012
1013
1014<!--Google Analytics-->
1015
1016
1017
1018 <script type="text/javascript">
1019 $(document).ready(function() {
1020 SearcherDisplay.init();
1021 });
1022 </script>
1023
1024
1025</body>
1026</html>
\No newline at end of file