Skip to content

Commit e047977

Browse files
committed
Documented the ScenePlugin class.
1 parent 7eb0342 commit e047977

2 files changed

Lines changed: 57 additions & 48 deletions

File tree

src/scene/SceneManager.js

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -890,7 +890,7 @@ var SceneManager = new Class({
890890
* @method Phaser.Scenes.SceneManager#sleep
891891
* @since 3.0.0
892892
*
893-
* @param {string} key - The Scene to sleep.
893+
* @param {string} key - The Scene to put to sleep.
894894
*
895895
* @return {Phaser.Scenes.SceneManager} This SceneManager.
896896
*/
@@ -935,7 +935,7 @@ var SceneManager = new Class({
935935
* @since 3.0.0
936936
*
937937
* @param {string} key - The Scene to start.
938-
* @param {object} [data] - Scene config data.
938+
* @param {object} [data] - The Scene data.
939939
*
940940
* @return {Phaser.Scenes.SceneManager} This SceneManager.
941941
*/
@@ -1091,7 +1091,7 @@ var SceneManager = new Class({
10911091
* @method Phaser.Scenes.SceneManager#bringToTop
10921092
* @since 3.0.0
10931093
*
1094-
* @param {(string|Phaser.Scene)} key - The Scene to affect.
1094+
* @param {(string|Phaser.Scene)} key - The Scene to move.
10951095
*
10961096
* @return {Phaser.Scenes.SceneManager} This SceneManager.
10971097
*/
@@ -1125,7 +1125,7 @@ var SceneManager = new Class({
11251125
* @method Phaser.Scenes.SceneManager#sendToBack
11261126
* @since 3.0.0
11271127
*
1128-
* @param {(string|Phaser.Scene)} key - The Scene to affect.
1128+
* @param {(string|Phaser.Scene)} key - The Scene to move.
11291129
*
11301130
* @return {Phaser.Scenes.SceneManager} This SceneManager.
11311131
*/
@@ -1157,7 +1157,7 @@ var SceneManager = new Class({
11571157
* @method Phaser.Scenes.SceneManager#moveDown
11581158
* @since 3.0.0
11591159
*
1160-
* @param {(string|Phaser.Scene)} key - The Scene to affect.
1160+
* @param {(string|Phaser.Scene)} key - The Scene to move.
11611161
*
11621162
* @return {Phaser.Scenes.SceneManager} This SceneManager.
11631163
*/
@@ -1191,7 +1191,7 @@ var SceneManager = new Class({
11911191
* @method Phaser.Scenes.SceneManager#moveUp
11921192
* @since 3.0.0
11931193
*
1194-
* @param {(string|Phaser.Scene)} key - The Scene to affect.
1194+
* @param {(string|Phaser.Scene)} key - The Scene to move.
11951195
*
11961196
* @return {Phaser.Scenes.SceneManager} This SceneManager.
11971197
*/

src/scene/ScenePlugin.js

Lines changed: 51 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ var PluginManager = require('../boot/PluginManager');
1717
* @constructor
1818
* @since 3.0.0
1919
*
20-
* @param {Phaser.Scene} scene - [description]
20+
* @param {Phaser.Scene} scene - The Scene that this ScenePlugin belongs to.
2121
*/
2222
var ScenePlugin = new Class({
2323

@@ -26,7 +26,7 @@ var ScenePlugin = new Class({
2626
function ScenePlugin (scene)
2727
{
2828
/**
29-
* [description]
29+
* The Scene that this ScenePlugin belongs to.
3030
*
3131
* @name Phaser.Scenes.ScenePlugin#scene
3232
* @type {Phaser.Scene}
@@ -35,7 +35,7 @@ var ScenePlugin = new Class({
3535
this.scene = scene;
3636

3737
/**
38-
* [description]
38+
* The Scene Systems instance of the Scene that this ScenePlugin belongs to.
3939
*
4040
* @name Phaser.Scenes.ScenePlugin#systems
4141
* @type {Phaser.Scenes.Systems}
@@ -49,7 +49,7 @@ var ScenePlugin = new Class({
4949
}
5050

5151
/**
52-
* [description]
52+
* The settings of the Scene this ScenePlugin belongs to.
5353
*
5454
* @name Phaser.Scenes.ScenePlugin#settings
5555
* @type {SettingsObject}
@@ -58,7 +58,7 @@ var ScenePlugin = new Class({
5858
this.settings = scene.sys.settings;
5959

6060
/**
61-
* [description]
61+
* The key of the Scene this ScenePlugin belongs to.
6262
*
6363
* @name Phaser.Scenes.ScenePlugin#key
6464
* @type {string}
@@ -67,7 +67,7 @@ var ScenePlugin = new Class({
6767
this.key = scene.sys.settings.key;
6868

6969
/**
70-
* [description]
70+
* The Game's SceneManager.
7171
*
7272
* @name Phaser.Scenes.ScenePlugin#manager
7373
* @type {Phaser.Scenes.SceneManager}
@@ -77,7 +77,9 @@ var ScenePlugin = new Class({
7777
},
7878

7979
/**
80-
* [description]
80+
* Boot the ScenePlugin.
81+
*
82+
* Registers event handlers.
8183
*
8284
* @method Phaser.Scenes.ScenePlugin#boot
8385
* @since 3.0.0
@@ -96,8 +98,8 @@ var ScenePlugin = new Class({
9698
* @method Phaser.Scenes.ScenePlugin#start
9799
* @since 3.0.0
98100
*
99-
* @param {string} key - [description]
100-
* @param {object} [data] - [description]
101+
* @param {string} key - The Scene to start.
102+
* @param {object} [data] - The Scene data.
101103
*
102104
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
103105
*/
@@ -125,9 +127,9 @@ var ScenePlugin = new Class({
125127
* @method Phaser.Scenes.ScenePlugin#add
126128
* @since 3.0.0
127129
*
128-
* @param {string} key - [description]
129-
* @param {object} sceneConfig - [description]
130-
* @param {boolean} autoStart - [description]
130+
* @param {string} key - The Scene key.
131+
* @param {(Phaser.Scene|SettingsConfig|function)} sceneConfig - The config for the Scene.
132+
* @param {boolean} autoStart - Whether to start the Scene after it's added.
131133
*
132134
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
133135
*/
@@ -144,8 +146,8 @@ var ScenePlugin = new Class({
144146
* @method Phaser.Scenes.ScenePlugin#launch
145147
* @since 3.0.0
146148
*
147-
* @param {string} key - [description]
148-
* @param {object} [data] - [description]
149+
* @param {string} key - The Scene to launch.
150+
* @param {object} [data] - The Scene data.
149151
*
150152
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
151153
*/
@@ -172,7 +174,7 @@ var ScenePlugin = new Class({
172174
* @method Phaser.Scenes.ScenePlugin#pause
173175
* @since 3.0.0
174176
*
175-
* @param {string} key - [description]
177+
* @param {string} key - The Scene to pause.
176178
*
177179
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
178180
*/
@@ -191,7 +193,7 @@ var ScenePlugin = new Class({
191193
* @method Phaser.Scenes.ScenePlugin#resume
192194
* @since 3.0.0
193195
*
194-
* @param {string} key - [description]
196+
* @param {string} key - The Scene to resume.
195197
*
196198
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
197199
*/
@@ -210,7 +212,7 @@ var ScenePlugin = new Class({
210212
* @method Phaser.Scenes.ScenePlugin#sleep
211213
* @since 3.0.0
212214
*
213-
* @param {string} key - [description]
215+
* @param {string} key - The Scene to put to sleep.
214216
*
215217
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
216218
*/
@@ -229,7 +231,7 @@ var ScenePlugin = new Class({
229231
* @method Phaser.Scenes.ScenePlugin#wake
230232
* @since 3.0.0
231233
*
232-
* @param {string} key - [description]
234+
* @param {string} key - The Scene to wake up.
233235
*
234236
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
235237
*/
@@ -248,7 +250,7 @@ var ScenePlugin = new Class({
248250
* @method Phaser.Scenes.ScenePlugin#switch
249251
* @since 3.0.0
250252
*
251-
* @param {string} key - [description]
253+
* @param {string} key - The Scene to start.
252254
*
253255
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
254256
*/
@@ -275,7 +277,7 @@ var ScenePlugin = new Class({
275277
* @method Phaser.Scenes.ScenePlugin#stop
276278
* @since 3.0.0
277279
*
278-
* @param {string} key - [description]
280+
* @param {string} key - The Scene to stop.
279281
*
280282
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
281283
*/
@@ -294,7 +296,7 @@ var ScenePlugin = new Class({
294296
* @method Phaser.Scenes.ScenePlugin#setActive
295297
* @since 3.0.0
296298
*
297-
* @param {boolean} value - [description]
299+
* @param {boolean} value - The Scene to set the active state for.
298300
*
299301
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
300302
*/
@@ -311,7 +313,7 @@ var ScenePlugin = new Class({
311313
* @method Phaser.Scenes.ScenePlugin#setVisible
312314
* @since 3.0.0
313315
*
314-
* @param {boolean} value - [description]
316+
* @param {boolean} value - The Scene to set the visible state for.
315317
*
316318
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
317319
*/
@@ -328,9 +330,9 @@ var ScenePlugin = new Class({
328330
* @method Phaser.Scenes.ScenePlugin#isSleeping
329331
* @since 3.0.0
330332
*
331-
* @param {string} key - [description]
333+
* @param {string} key - The Scene to check.
332334
*
333-
* @return {boolean} [description]
335+
* @return {boolean} Whether the Scene is sleeping.
334336
*/
335337
isSleeping: function (key)
336338
{
@@ -345,9 +347,9 @@ var ScenePlugin = new Class({
345347
* @method Phaser.Scenes.ScenePlugin#isActive
346348
* @since 3.0.0
347349
*
348-
* @param {string} key - [description]
350+
* @param {string} key - The Scene to check.
349351
*
350-
* @return {boolean} [description]
352+
* @return {boolean} Whether the Scene is active.
351353
*/
352354
isActive: function (key)
353355
{
@@ -362,9 +364,9 @@ var ScenePlugin = new Class({
362364
* @method Phaser.Scenes.ScenePlugin#isVisible
363365
* @since 3.0.0
364366
*
365-
* @param {string} key - [description]
367+
* @param {string} key - The Scene to check.
366368
*
367-
* @return {boolean} [description]
369+
* @return {boolean} Whether the Scene is visible.
368370
*/
369371
isVisible: function (key)
370372
{
@@ -375,6 +377,7 @@ var ScenePlugin = new Class({
375377

376378
/**
377379
* Swaps the position of two scenes in the Scenes list.
380+
*
378381
* This controls the order in which they are rendered and updated.
379382
*
380383
* @method Phaser.Scenes.ScenePlugin#swapPosition
@@ -399,6 +402,7 @@ var ScenePlugin = new Class({
399402

400403
/**
401404
* Swaps the position of two scenes in the Scenes list, so that Scene B is directly above Scene A.
405+
*
402406
* This controls the order in which they are rendered and updated.
403407
*
404408
* @method Phaser.Scenes.ScenePlugin#moveAbove
@@ -423,6 +427,7 @@ var ScenePlugin = new Class({
423427

424428
/**
425429
* Swaps the position of two scenes in the Scenes list, so that Scene B is directly below Scene A.
430+
*
426431
* This controls the order in which they are rendered and updated.
427432
*
428433
* @method Phaser.Scenes.ScenePlugin#moveBelow
@@ -457,7 +462,7 @@ var ScenePlugin = new Class({
457462
* @method Phaser.Scenes.ScenePlugin#remove
458463
* @since 3.2.0
459464
*
460-
* @param {(string|Phaser.Scene)} scene - The Scene to be removed.
465+
* @param {(string|Phaser.Scene)} key - The Scene to be removed.
461466
*
462467
* @return {Phaser.Scenes.SceneManager} This SceneManager.
463468
*/
@@ -471,12 +476,12 @@ var ScenePlugin = new Class({
471476
},
472477

473478
/**
474-
* [description]
479+
* Moves a Scene up one position in the Scenes list.
475480
*
476481
* @method Phaser.Scenes.ScenePlugin#moveUp
477482
* @since 3.0.0
478483
*
479-
* @param {string} key - [description]
484+
* @param {string} key - The Scene to move.
480485
*
481486
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
482487
*/
@@ -490,12 +495,12 @@ var ScenePlugin = new Class({
490495
},
491496

492497
/**
493-
* [description]
498+
* Moves a Scene down one position in the Scenes list.
494499
*
495500
* @method Phaser.Scenes.ScenePlugin#moveDown
496501
* @since 3.0.0
497502
*
498-
* @param {string} key - [description]
503+
* @param {string} key - The Scene to move.
499504
*
500505
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
501506
*/
@@ -509,12 +514,14 @@ var ScenePlugin = new Class({
509514
},
510515

511516
/**
512-
* [description]
517+
* Brings a Scene to the top of the Scenes list.
518+
*
519+
* This means it will render above all other Scenes.
513520
*
514521
* @method Phaser.Scenes.ScenePlugin#bringToTop
515522
* @since 3.0.0
516523
*
517-
* @param {string} key - [description]
524+
* @param {string} key - The Scene to move.
518525
*
519526
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
520527
*/
@@ -528,12 +535,14 @@ var ScenePlugin = new Class({
528535
},
529536

530537
/**
531-
* [description]
538+
* Sends a Scene to the back of the Scenes list.
539+
*
540+
* This means it will render below all other Scenes.
532541
*
533542
* @method Phaser.Scenes.ScenePlugin#sendToBack
534543
* @since 3.0.0
535544
*
536-
* @param {string} key - [description]
545+
* @param {string} key - The Scene to move.
537546
*
538547
* @return {Phaser.Scenes.ScenePlugin} This ScenePlugin object.
539548
*/
@@ -547,22 +556,22 @@ var ScenePlugin = new Class({
547556
},
548557

549558
/**
550-
* [description]
559+
* Retrieve a Scene.
551560
*
552561
* @method Phaser.Scenes.ScenePlugin#get
553562
* @since 3.0.0
554563
*
555-
* @param {string} key - [description]
564+
* @param {string} key - The Scene to retrieve.
556565
*
557-
* @return {Phaser.Scene} [description]
566+
* @return {Phaser.Scene} The Scene.
558567
*/
559568
get: function (key)
560569
{
561570
return this.manager.getScene(key);
562571
},
563572

564573
/**
565-
* [description]
574+
* Shut down the given Scene.
566575
*
567576
* @method Phaser.Scenes.ScenePlugin#shutdown
568577
* @since 3.0.0
@@ -573,7 +582,7 @@ var ScenePlugin = new Class({
573582
},
574583

575584
/**
576-
* [description]
585+
* Destroy the given Scene.
577586
*
578587
* @method Phaser.Scenes.ScenePlugin#destroy
579588
* @since 3.0.0

0 commit comments

Comments
 (0)