The same goes for this method as for setMode(): Do not change the display mode unless you know that that mode is supported. Use checkMode() to check whether a mode is supported or not.

Also note that calling this function will cause the entire display context to reload. This means that all Images, Fonts and other graphical objects will have to be reloaded. It is therefore advisable to call this function when as few objects as possible has been loaded.