TSplus Helpdesk

How to use full screen mode in HTML5 client?

Created by: Adrien Carbonne

Modified on: Fri, 16 Nov, 2018 at 10:17 PM

HTML5 full screen.

In order to support full screen mode the server has to support eitheron-the-fly-resizingorreconnection-on-resizeor be prepared for full screen mode.On-the-fly-resizingrequires support ofdynamic channelswith "Display channel" that is available in newerWindows systems likeWindows2012R2,Windows10etc.

Server supports on-the-fly-resizing (dynamic Display channel)

1. no future configuration needed, the full screen button will be present in top menu, if not forcibly disabled (*\settings.js->W.showfullscreenbutton = "no";)

2. even if server supportson-the-fly-resizingyou still may configure/editwww\software\html5\settings.js->W.full_screen = 2;in this case the session will take from start the fully available screen size and will not anymore change it self during resizing.

1. either you must configure/editwww\software\html5\settings.js->W.reconnectonresize = true; in thisreconnect-on-resizemode the client will try to reconnect session with new dimensions, buthighly not recommendedbecause if you run file transfer or sound gets played these actions will be interrupted.

2. or you must configure/editwww\software\html5\settings.js->W.full_screen = 2; in this case the session will take from start the fully available screen size.

Notice: if no one of these points above (W.reconnectonresize = true;orW.full_screen = 2;) is effective thenthe full screen button will be deactivated.

Smartfit setting, only effective if server doesn't support on-the-fly-resizing or was preset to fullscreen (W.full_screen = 2;)

1. by deafultwww\software\html5\settings.js->W.smartfit = true;is enabled. (or *= 1) in this case ifRDP session area overflows browser area theRDP area will be squeezed to fit browser area.

3. smartfit set to *= true or * = 1squeezes theRDP area by underflowing but if you set it to * =2then additionally it will stretch by overflowing.

Full screen enforced with W.full_screen = 2; or W.full_screen = 1;

1. by default when using enforced full screen mode any click inside working area will switch automatically to full screen. to disable it editsettings.js>W.allowOnclickFullScreen = false;

IMPORTANT NOTICES A: Escape button(ESC) can neither be prevented nor it can be reassigned to another button(s), it is browsers native behavior to not listen toEscape button in full screen mode and to leave full screen mode instead for security reasons.

B: Entering full screen mode is privileged event in browserstherefore such actions have to be performed only by hardware initiated eventslike mouse clickand is purely browsers native limitation to increase security.That is the main reason why it is technically not possible to reenter full screen mode after exiting it onEscape button.

C: There is no implementation of full screen mode on mobile browsers due very poor and non consistent support from mobile browsers side. D: Mac Safarifullscreen option is disabled by default insettings.js>W.macSafariFullDisable = true; The reason for this limitation,Safari does not support keyboard events while in fullscreen mode so the switching to fullscreen onSafari Macdoesn't make any sense. This limitation was created byApple due some strange way of security measurements and so it can't be workarounded.