Class: ScaleManager

Members

<static, constant> EXACT_FIT : integer

A scale mode that stretches content to fill all available space - see scaleMode.

Type:

• integer

Source:

src/core/ScaleManager.js line 634

<static, constant> MODES : Array.<string>

Names of the scale modes, indexed by value.

Type:

• Array.<string>

Source:

src/core/ScaleManager.js line 674

<static, constant> NO_SCALE : integer

A scale mode that prevents any scaling - see scaleMode.

Type:

• integer

Source:

src/core/ScaleManager.js line 642

<static, constant> RESIZE : integer

A scale mode that causes the Game size to change - see scaleMode.

Type:

• integer

Source:

src/core/ScaleManager.js line 658

<static, constant> SHOW_ALL : integer

A scale mode that shows the entire game while maintaining proportions - see scaleMode.

Type:

• integer

Source:

src/core/ScaleManager.js line 650

<static, constant> USER_SCALE : integer

A scale mode that allows a custom scale factor - see scaleMode.

Type:

• integer

Source:

src/core/ScaleManager.js line 666

<readonly> aspectRatio : number

The aspect ratio of the scaled Display canvas.

Type:

• number

Source:

src/core/ScaleManager.js line 371

<readonly> boundingParent : DOMElement

The DOM element that is considered the Parent bounding element, if any.

This null if parentIsWindow is true or if fullscreen mode is entered and fullScreenTarget is specified. It will also be null if there is no game canvas or if the game canvas has no parent.

Type:

• DOMElement

Source:

src/core/ScaleManager.js line 2171

<readonly> bounds : Phaser.Rectangle

The bounds of the scaled game. The x/y will match the offset of the canvas element and the width/height the scaled width and height.

Type:

• Phaser.Rectangle

Source:

src/core/ScaleManager.js line 364

<protected> compatibility

Various compatibility settings. A value of "(auto)" indicates the setting is configured based on device and runtime information.

A refresh may need to be performed after making changes.

Properties:

Name	Type	Argument	Default	Description
supportsFullScreen	boolean	<optional>	(auto)	True only if fullscreen support will be used. (Changing to fullscreen still might not work.)
orientationFallback	boolean	<optional>	(auto)	See Phaser.DOM.getScreenOrientation.
noMargins	boolean	<optional>	false	If true then the Display canvas's margins will not be updated anymore: existing margins must be manually cleared. Disabling margins prevents automatic canvas alignment/centering, possibly in fullscreen.
scrollTo	Phaser.Point	<optional> <nullable>	(auto)	If specified the window will be scrolled to this position on every refresh.
forceMinimumDocumentHeight	boolean	<optional>	false	If enabled the document elements minimum height is explicitly set on updates. The height set varies by device and may either be the height of the window or the viewport.
canExpandParent	boolean	<optional>	true	If enabled then SHOW_ALL and USER_SCALE modes can try and expand the parent element. It may be necessary for the parent element to impose CSS width/height restrictions.
clickTrampoline	string	<optional>	(auto)	On certain browsers (eg. IE) FullScreen events need to be triggered via 'click' events. A value of 'when-not-mouse' uses a click trampoline when a pointer that is not the primary mouse is used. Any other string value (including the empty string) prevents using click trampolines. For more details on click trampolines see Phaser.Pointer#addClickTrampoline.

Source:

src/core/ScaleManager.js line 432

<protected, readonly> currentScaleMode : number

Returns the current scale mode - for normal or fullscreen operation.

See scaleMode for the different modes allowed.

Type:

• number

Source:

src/core/ScaleManager.js line 2299

<protected, readonly> dom : Phaser.DOM

Provides access to some cross-device DOM functions.

Type:

• Phaser.DOM

Source:

src/core/ScaleManager.js line 84

enterIncorrectOrientation : Phaser.Signal

This signal is dispatched when the browser enters an incorrect orientation, as defined by forceOrientation.

This is signaled from preUpdate (or pauseUpdate) even when the game is paused.

Type:

• Phaser.Signal

Source:

src/core/ScaleManager.js line 233

<protected, readonly> forceLandscape : boolean

If true, the game should only run in a landscape orientation. Change with forceOrientation.

Type:

• boolean

Source:

src/core/ScaleManager.js line 162

<protected, readonly> forcePortrait : boolean

If true, the game should only run in a portrait Change with forceOrientation.

Type:

• boolean

Source:

src/core/ScaleManager.js line 172

fullScreenScaleMode : integer

The scaling method used by the ScaleManager when in fullscreen.

See scaleMode for the different modes allowed.

Type:

• integer

Source:

src/core/ScaleManager.js line 2260

fullScreenTarget : DOMElement

If specified, this is the DOM element on which the Fullscreen API enter request will be invoked. The target element must have the correct CSS styling and contain the Display canvas.

The elements style will be modified (ie. the width and height might be set to 100%) but it will not be added to, removed from, or repositioned within the DOM. An attempt is made to restore relevant style changes when fullscreen mode is left.

For pre-2.2.0 behavior set game.scale.fullScreenTarget = game.canvas.

Type:

• DOMElement

Source:

src/core/ScaleManager.js line 270

<protected, readonly> game : Phaser.Game

A reference to the currently running game.

Type:

• Phaser.Game

Source:

src/core/ScaleManager.js line 76

grid : Phaser.FlexGrid

EXPERIMENTAL: A responsive grid on which you can align game objects.

Type:

• Phaser.FlexGrid

Source:

src/core/ScaleManager.js line 91

hasPhaserSetFullScreen : boolean

This boolean provides you with a way to determine if the browser is in Full Screen mode (via the Full Screen API), and Phaser was the one responsible for activating it.

It's possible that ScaleManager.isFullScreen returns true even if Phaser wasn't the one that made the browser go full-screen, so this flag lets you determine that.

Type:

• boolean

Source:

src/core/ScaleManager.js line 255

<readonly> height : number

Target height (in pixels) of the Display canvas.

Type:

• number

Source:

src/core/ScaleManager.js line 105

<protected, readonly> incorrectOrientation : boolean

True if forceLandscape or forcePortrait are set and do not agree with the browser orientation.

This value is not updated immediately.

Type:

• boolean

Source:

src/core/ScaleManager.js line 183

<readonly> isFullScreen : boolean

Returns true if the browser is in fullscreen mode, otherwise false.

Type:

• boolean

Source:

src/core/ScaleManager.js line 2385

<readonly> isGameLandscape : boolean

Returns true if the game dimensions are landscape (width > height). This is especially useful to check when using the RESIZE scale mode but wanting to maintain game orientation on desktop browsers, where typically the screen orientation will always be landscape regardless of the browser viewport.

Type:

• boolean

Source:

src/core/ScaleManager.js line 2454

<readonly> isGamePortrait : boolean

Returns true if the game dimensions are portrait (height > width). This is especially useful to check when using the RESIZE scale mode but wanting to maintain game orientation on desktop browsers, where typically the screen orientation will always be landscape regardless of the browser viewport.

Type:

• boolean

Source:

src/core/ScaleManager.js line 2435

<readonly> isLandscape : boolean

Returns true if the screen orientation is in landscape mode.

Type:

• boolean

Source:

src/core/ScaleManager.js line 2419

<readonly> isPortrait : boolean

Returns true if the screen orientation is in portrait mode.

Type:

• boolean

Source:

src/core/ScaleManager.js line 2403

leaveIncorrectOrientation : Phaser.Signal

This signal is dispatched when the browser leaves an incorrect orientation, as defined by forceOrientation.

This is signaled from preUpdate (or pauseUpdate) even when the game is paused.

Type:

• Phaser.Signal

Source:

src/core/ScaleManager.js line 243

<protected, readonly> margin : Bounds-like

The Display canvas is aligned by adjusting the margins; the last margins are stored here.

Type:

• Bounds-like

Source:

src/core/ScaleManager.js line 357

<protected, readonly> maxHeight : number

Maximum height the canvas should be scaled to (in pixels). If null it will scale to whatever height the browser can handle. Change with setMinMax.

Type:

• number

Source:

src/core/ScaleManager.js line 143

<protected, readonly> maxWidth : number

Maximum width the canvas should be scaled to (in pixels). If null it will scale to whatever width the browser can handle. Change with setMinMax.

Type:

• number

Source:

src/core/ScaleManager.js line 124

<protected, readonly> minHeight : number

Minimum height the canvas should be scaled to (in pixels). Change with setMinMax.

Type:

• number

Source:

src/core/ScaleManager.js line 133

<protected, readonly> minWidth : number

Minimum width the canvas should be scaled to (in pixels). Change with setMinMax.

Type:

• number

Source:

src/core/ScaleManager.js line 114

<protected, readonly> offset : Phaser.Point

The offset coordinates of the Display canvas from the top-left of the browser window. The is used internally by Phaser.Pointer (for Input) and possibly other types.

Type:

• Phaser.Point

Source:

src/core/ScaleManager.js line 152

onFullScreenChange : Phaser.Signal

This signal is dispatched when the browser enters or leaves fullscreen mode, if supported.

The signal is supplied with a single argument: scale (the ScaleManager). Use scale.isFullScreen to determine if currently running in Fullscreen mode.

Type:

• Phaser.Signal

Source:

src/core/ScaleManager.js line 312

onFullScreenError : Phaser.Signal

This signal is dispatched when the browser fails to enter fullscreen mode; or if the device does not support fullscreen mode and startFullScreen is invoked.

The signal is supplied with a single argument: scale (the ScaleManager).

Type:

• Phaser.Signal

Source:

src/core/ScaleManager.js line 323

onFullScreenInit : Phaser.Signal

This signal is dispatched when fullscreen mode is ready to be initialized but before the fullscreen request.

The signal is passed two arguments: scale (the ScaleManager), and an object in the form {targetElement: DOMElement}.

The targetElement is the fullScreenTarget element, if such is assigned, or a new element created by createFullScreenTarget.

Custom CSS styling or resets can be applied to targetElement as required.

If targetElement is not the same element as fullScreenTarget:

• After initialization the Display canvas is moved onto the targetElement for the duration of the fullscreen mode, and restored to it's original DOM location when fullscreen is exited.
• The targetElement is moved/re-parented within the DOM and may have its CSS styles updated.

The behavior of a pre-assigned target element is covered in fullScreenTarget.

Type:

• Phaser.Signal

Source:

src/core/ScaleManager.js line 301

onOrientationChange : Phaser.Signal

This signal is dispatched when the orientation changes or the validity of the current orientation changes.

The signal is supplied with the following arguments:

• scale - the ScaleManager object
• prevOrientation, a string - The previous orientation as per screenOrientation.
• wasIncorrect, a boolean - True if the previous orientation was last determined to be incorrect.

Access the current orientation and validity with scale.screenOrientation and scale.incorrectOrientation. Thus the following tests can be done:

// The orientation itself changed:
scale.screenOrientation !== prevOrientation
// The orientation just became incorrect:
scale.incorrectOrientation && !wasIncorrect

It is possible that this signal is triggered after forceOrientation so the orientation correctness changes even if the orientation itself does not change.

This is signaled from preUpdate (or pauseUpdate) even when the game is paused.

Type:

• Phaser.Signal

Source:

src/core/ScaleManager.js line 223

onSizeChange : Phaser.Signal

This signal is dispatched when the size of the Display canvas changes or the size of the Game changes. When invoked this is done after the Canvas size/position have been updated.

The callback is supplied with three arguments: the Scale Manager, canvas width, and canvas height. (Game dimensions can be found in scale.game.width and scale.game.height.)

This signal is only called when a change occurs and a reflow may be required. For example, if the canvas does not change sizes because of CSS settings (such as min-width) then this signal will not be triggered.

Use this to handle responsive game layout options.

This is signaled from preUpdate (or pauseUpdate) even when the game is paused.

Type:

• Phaser.Signal

Source:

src/core/ScaleManager.js line 513

pageAlignHorizontally : boolean

When enabled the Display canvas will be horizontally-aligned in the Parent container (or window).

To align horizontally across the page the Display canvas should be added directly to page; or the parent container should itself be horizontally aligned.

Horizontal alignment is not applicable with the RESIZE scaling mode.

Type:

• boolean

Default Value:

• false

Source:

src/core/ScaleManager.js line 2318

pageAlignVertically : boolean

When enabled the Display canvas will be vertically-aligned in the Parent container (or window).

To align vertically the Parent element should have a non-collapsible height, such that it will maintain a height larger than the height of the contained Game canvas - the game canvas will then be scaled vertically within the remaining available height dictated by the Parent element.

One way to prevent the parent from collapsing is to add an absolute "min-height" CSS property to the parent element. If specifying a relative "min-height/height" or adjusting margins, the Parent height must still be non-collapsible (see note).

Note: In version 2.2 the minimum document height is not automatically set to the viewport/window height. To automatically update the minimum document height set compatibility.forceMinimumDocumentHeight to true.

Vertical alignment is not applicable with the RESIZE scaling mode.

Type:

• boolean

Default Value:

• false

Source:

src/core/ScaleManager.js line 2348

parentIsWindow : boolean

True if the the browser window (instead of the display canvas's DOM parent) should be used as the bounding parent.

This is set automatically based on the parent argument passed to Phaser.Game.

The parentNode property is generally ignored while this is in effect.

Type:

• boolean

Source:

src/core/ScaleManager.js line 465

parentNode : DOMElement

The original DOM element for the parent of the Display canvas. This may be different in fullscreen - see createFullScreenTarget.

This is set automatically based on the parent argument passed to Phaser.Game.

This should only be changed after moving the Game canvas to a different DOM parent.

Type:

• DOMElement

Source:

src/core/ScaleManager.js line 477

<readonly> parentScaleFactor : Phaser.Point

The scale of the game in relation to its parent container.

Type:

• Phaser.Point

Source:

src/core/ScaleManager.js line 484

<readonly> scaleFactor : Phaser.Point

The current scale factor based on the game dimensions vs. the scaled dimensions.

Type:

• Phaser.Point

Source:

src/core/ScaleManager.js line 340

<protected, readonly> scaleFactorInversed : Phaser.Point

The current inversed scale factor. The displayed dimensions divided by the game dimensions.

Type:

• Phaser.Point

Source:

src/core/ScaleManager.js line 348

scaleMode : integer

The scaling method used by the ScaleManager when not in fullscreen.

Phaser.ScaleManager.NO_SCALE

The Game display area will not be scaled - even if it is too large for the canvas/screen. This mode _ignores_ any applied scaling factor and displays the canvas at the Game size.

Phaser.ScaleManager.EXACT_FIT

The Game display area will be _stretched_ to fill the entire size of the canvas's parent element and/or screen. Proportions are not maintained.

Phaser.ScaleManager.SHOW_ALL

Show the entire game display area while _maintaining_ the original aspect ratio.

Phaser.ScaleManager.RESIZE

The dimensions of the game display area are changed to match the size of the parent container. That is, this mode _changes the Game size_ to match the display size.

Any manually set Game size (see setGameSize) is ignored while in effect.

Phaser.ScaleManager.USER_SCALE

The game Display is scaled according to the user-specified scale set by setUserScale.

This scale can be adjusted in the resize callback for flexible custom-sizing needs.

Type:

• integer

Source:

src/core/ScaleManager.js line 2198

<readonly> screenOrientation : string

The last known orientation of the screen, as defined in the Window Screen Web API. See Phaser.DOM.getScreenOrientation for possible values.

Type:

• string

Source:

src/core/ScaleManager.js line 333

<readonly> sourceAspectRatio : number

The aspect ratio of the original game dimensions.

Type:

• number

Source:

src/core/ScaleManager.js line 378

<protected> trackParentInterval : integer

The maximum time (in ms) between dimension update checks for the Canvas's parent element (or window). Update checks normally happen quicker in response to other events.

Type:

• integer

Default Value:

• 2000

Source:

src/core/ScaleManager.js line 495

See:

• refresh

<readonly> width : number

Target width (in pixels) of the Display canvas.

Type:

• number

Source:

src/core/ScaleManager.js line 98

windowConstraints

The edges on which to constrain the game Display/canvas in addition to the restrictions of the parent container.

The properties are strings and can be '', 'visual', 'layout', or 'layout-soft'.

• If 'visual', the edge will be constrained to the Window / displayed screen area
• If 'layout', the edge will be constrained to the CSS Layout bounds
• An invalid value is treated as 'visual'

Properties:

Name	Type	Description
bottom	string
right	string

Default Value:

• {"right":"layout","bottom":""}

Source:

src/core/ScaleManager.js line 401

Methods

align( [horizontal] [, vertical])

Shorthand for setting pageAlignHorizontally and pageAlignVertically.

Parameters:

Name	Type	Argument	Description
horizontal	boolean	<optional>	Value for #pageAlignHorizontally. Pass null to leave unchanged.
vertical	boolean	<optional>	Value for #pageAlignVertically. Omit or pass null to leave unchanged.

Source:

src/core/ScaleManager.js line 1521

<protected> boot()

Start the ScaleManager.

Source:

src/core/ScaleManager.js line 684

<protected> createFullScreenTarget()

Creates a fullscreen target. This is called automatically as as needed when entering fullscreen mode and the resulting element is supplied to onFullScreenInit.

Use onFullScreenInit to customize the created object.

Source:

src/core/ScaleManager.js line 1794

<protected> destroy()

Destroys the ScaleManager and removes any event listeners. This should probably only be called when the game is destroyed.

Source:

src/core/ScaleManager.js line 2139

forceOrientation(forceLandscape [, forcePortrait])

Force the game to run in only one orientation.

This enables generation of incorrect orientation signals and affects resizing but does not otherwise rotate or lock the orientation.

Orientation checks are performed via the Screen Orientation API, if available in browser. This means it will check your monitor orientation on desktop, or your device orientation on mobile, rather than comparing actual game dimensions. If you need to check the viewport dimensions instead and bypass the Screen Orientation API then set: ScaleManager.compatibility.orientationFallback = 'viewport'

Parameters:

Name	Type	Argument	Default	Description
forceLandscape	boolean			true if the game should run in landscape mode only.
forcePortrait	boolean	<optional>	false	true if the game should run in portrait mode only.

Source:

src/core/ScaleManager.js line 1218

<protected> getParentBounds( [target] [, parent])

Returns the computed Parent size/bounds that the Display canvas is allowed/expected to fill.

If in fullscreen mode or without parent (see parentIsWindow), this will be the bounds of the visual viewport itself.

This function takes the windowConstraints into consideration - if the parent is partially outside the viewport then this function may return a smaller than expected size.

Values are rounded to the nearest pixel.

Parameters:

Name	Type	Argument	Default	Description
target	Phaser.Rectangle	<optional>	(new Rectangle)	The rectangle to update; a new one is created as needed.
parent	HTMLElement	<optional>		Ignore #boundingParent and use this node instead.

Source:

src/core/ScaleManager.js line 1463

Returns:

The established parent bounds.

Type

Phaser.Rectangle

<protected> parseConfig(config)

Load configuration settings.

Parameters:

Name	Type	Description
config	object	The game configuration object.

Source:

src/core/ScaleManager.js line 790

<protected> preUpdate()

The ScaleManager.preUpdate is called automatically by the core Game loop.

Source:

src/core/ScaleManager.js line 1087

refresh()

The "refresh" methods informs the ScaleManager that a layout refresh is required.

The ScaleManager automatically queues a layout refresh (eg. updates the Game size or Display canvas layout) when the browser is resized, the orientation changes, or when there is a detected change of the Parent size. Refreshing is also done automatically when public properties, such as scaleMode, are updated or state-changing methods are invoked.

The "refresh" method may need to be used in a few (rare) situtations when

• a device change event is not correctly detected; or
• the Parent size changes (and an immediate reflow is desired); or
• the ScaleManager state is updated by non-standard means; or
• certain compatibility properties are manually changed.

The queued layout refresh is not immediate but will run promptly in an upcoming preRender.

Source:

src/core/ScaleManager.js line 1356

<protected> scaleSprite(sprite [, width] [, height] [, letterBox])

Takes a Sprite or Image object and scales it to fit the given dimensions. Scaling happens proportionally without distortion to the sprites texture. The letterBox parameter controls if scaling will produce a letter-box effect or zoom the sprite until it fills the given values. Note that with letterBox set to false the scaled sprite may spill out over either the horizontal or vertical sides of the target dimensions. If you wish to stop this you can crop the Sprite.

Parameters:

Name	Type	Argument	Default	Description
sprite	Phaser.Sprite | Phaser.Image			The sprite we want to scale.
width	integer	<optional>		The target width that we want to fit the sprite in to. If not given it defaults to ScaleManager.width.
height	integer	<optional>		The target height that we want to fit the sprite in to. If not given it defaults to ScaleManager.height.
letterBox	boolean	<optional>	false	True if we want the fitted mode. Otherwise, the function uses the zoom mode.

Source:

src/core/ScaleManager.js line 2068

Returns:

The scaled sprite.

Type

Phaser.Sprite | Phaser.Image

setGameSize(width, height)

Set the actual Game size. Use this instead of directly changing game.width or game.height.

The actual physical display (Canvas element size) depends on various settings including

• Scale mode
• Scaling factor
• Size of Canvas's parent element or CSS rules such as min-height/max-height;
• The size of the Window

Parameters:

Name	Type	Description
width	integer	Game width, in pixels.
height	integer	Game height, in pixels.

Source:

src/core/ScaleManager.js line 928

setMinMax(minWidth, minHeight [, maxWidth] [, maxHeight])

Set the min and max dimensions for the Display canvas.

Note: The min/max dimensions are only applied in some cases

• When the device is not in an incorrect orientation; or
• The scale mode is EXACT_FIT when not in fullscreen

Parameters:

Name	Type	Argument	Description
minWidth	number		The minimum width the game is allowed to scale down to.
minHeight	number		The minimum height the game is allowed to scale down to.
maxWidth	number	<optional>	The maximum width the game is allowed to scale up to; only changed if specified.
maxHeight	number	<optional>	The maximum height the game is allowed to scale up to; only changed if specified.

Source:

src/core/ScaleManager.js line 1056

To Do:

• These values are only sometimes honored.

setResizeCallback(callback, context)

Sets the callback that will be invoked before sizing calculations.

Typically this is triggered when the Scale Manager has detected a change to the canvas's boundaries: the browser window has been resized, the device has been rotated, or the parent container's size has changed. At this point the Scale Manager has not resized the game or canvas yet (and may not resize them at all after it makes its sizing calculations). You can read the size of the parent container from the parentBounds argument to the callback.

This is the appropriate place to call setUserScale if needing custom dynamic scaling.

The callback is supplied with two arguments scale and parentBounds where scale is the ScaleManager and parentBounds, a Phaser.Rectangle, is the size of the Parent element.

This callback

• May be invoked even though the parent container or canvas sizes have not changed
• Unlike onSizeChange, it runs before the canvas is guaranteed to be updated
• Will be invoked from preUpdate, even when the game is paused

See onSizeChange for a better way of reacting to layout updates.

Parameters:

Name	Type	Description
callback	function	The callback that will be called each time a window.resize event happens or if set, the parent container resizes.
context	object	The context in which the callback will be called.

Source:

src/core/ScaleManager.js line 987

<protected> setupScale(width, height)

Calculates and sets the game dimensions based on the given width and height.

This should not be called when in fullscreen mode.

Parameters:

Name	Type	Description
width	number | string	The width of the game.
height	number | string	The height of the game.

Source:

src/core/ScaleManager.js line 830

setUserScale(hScale, vScale [, hTrim] [, vTrim] [, queueUpdate] [, force])

Set a User scaling factor used in the USER_SCALE scaling mode.

The target canvas size is computed by:

canvas.width = (game.width * hScale) - hTrim
canvas.height = (game.height * vScale) - vTrim

This method can be used in the resize callback. Set queueUpdate and force to false if the resize callback is being called repeatedly.

Parameters:

Name	Type	Argument	Default	Description
hScale	number			Horizontal scaling factor.
vScale	numer			Vertical scaling factor.
hTrim	integer	<optional>	0	Horizontal trim, applied after scaling.
vTrim	integer	<optional>	0	Vertical trim, applied after scaling.
queueUpdate	boolean	<optional>	true	Queue a size/bounds check at next preUpdate
force	boolean	<optional>	true	Force a resize during the next preUpdate

Source:

src/core/ScaleManager.js line 955

startFullScreen( [antialias] [, allowTrampoline] [, options])

Display the game in the browser's fullscreen mode.

This must be called from a user-input Pointer or Mouse event (and possibly a "user gesture"), e.g.,

• Phaser.Events#onInputUp
• Phaser.Input#onUp or Phaser.Input#onTap
• click, mousedown, mouseup, pointerup, or touchend

Games within an iframe will also be blocked from fullscreen unless the iframe has the allowfullscreen attribute.

The Fullscreen API must be supported by the browser for this to work - it is not the same as setting the game size to fill the browser window. See compatibility.supportsFullScreen to check if the current device is reported to support fullscreen mode.

The fullScreenFailed signal will be dispatched if the fullscreen change request failed or the game does not support the Fullscreen API.

Safari blocks access to keyboard events in fullscreen mode (as a security measure).

Parameters:

Name	Type	Argument	Default	Description
antialias	boolean	<optional>		Changes the anti-alias feature of the canvas before jumping in to fullscreen (false = retain pixel art, true = smooth art). If not specified then no change is made. Only works in CANVAS mode.
allowTrampoline	boolean	<optional>		Internal argument. If false click trampolining is suppressed.
options	object	<optional>	{navigationUI: 'hide'}	Options passed to requestFullscreen().

Source:

src/core/ScaleManager.js line 1814

See:

• https://developer.mozilla.org/en-US/docs/Web/API/Element/requestFullScreen

Returns:

Returns true if the device supports fullscreen mode and fullscreen mode was attempted to be started. (It might not actually start, wait for the signals.)

Type

boolean

stopFullScreen()

Stops / exits fullscreen mode, if active.

Source:

src/core/ScaleManager.js line 1925

Returns:

Returns true if the browser supports fullscreen mode and fullscreen mode will be exited.

Type

boolean