Phaser 3.0 Errata

This document summarizes known problems or issues in Phaser Version 3.0 and either their workarounds or fixes made in any released revisions since the original release (20070414) -- the latest revison is 20090309.


[4] A: Phaser Gallery Project Loading & GUI Lockup
       B: Parameter Panel NumberFormat Input Non-US Locale Validation Issue

Version(s) Affected: Phaser Version 3.0-20070414, 20070903, 20071101, 20080224, 20081116-Release.

Problem A: Under certain circumstances, the Phaser Gallery could lock up while loading a project whose dimension is different than the dimension of the project currently loaded in the Gallary.

Problem B: In non-US locales, the Numerics Editor Parameter Panel displays values in the appropriate default locale number format; however, it does not properly validate any user changes to these values unless they are made in US locale format. In the other Numerics Editor panels, all values displayed are in US locale format and will accept only US locale formatted input.

Platform(s) Affected: All.

Workaround: Problem A: open Gallery prior to loading a project into it can help lessen the likelihood of a lockup. Problem B: use the '.' (dot) instead of the ',' (comma) character as the decimal separator in floating point numbers as values entered into the Paramater Panel and other textfields of the Numerics Editor.

Solution: Problem A is fixed in Phaser Version 3.0-20090309-Release. Problem B is addressed in this release revision only to the extent that now all Numeric Editor panels display and accept number values in only US locale formats. Proper internatilization support will be included in a future revision of Phaser.
 

[3] Phaser Custom Equation Issue

Version(s) Affected: Phaser Version 3.0-20070414, 20070903, 20071101, 20080224-Release.

Problem: Custom equations defined with more than 12 variables do not properly load in Phaser and could cause the application to become unstable.

Platform(s) Affected: All.

Workaround: N/A

Solution: Problem fixed in Phaser Version 3.0-20081116-Release.
 

[2] Phaser Gallery/GUI Lockup

Version(s) Affected: Phaser Version 3.0-20070414-Release, 3.0-20070903-Release, 3.0-20071101-Release.

Problem: On certain platforms, the Phaser Gallery might lock up while loading a project. Apparently, there exists a potential GUI thread deadlock between the opening of the Gallery and the I/O thread that loads a project into the Gallery.

Platform(s) Affected: Microsoft Windows Vista (Sun's Java 6), Apple Mac OS X 10.4.10 (Java 5), Linux (Various).

Workaround: Manually open the Gallery Window prior to loading a Gallery Project.

Solution: Problem fixed in Phaser Version 3.0-20080224-Release or later.
 

[1] Phaser View/GUI Lockup

Version(s) Affected: Phaser Version 3.0-20070414-Release, 3.0-20070903-Release.

Problem: On certain platforms, a Phaser View and its interface might lock up while running a simulation. The conditions present that can lead to this problem involve running a simulation that encounters algorithmic errors in its numerical computations and Phaser's response to the errors, automatically opening up the Numerics Console window to display the them. Apparently, there exists a potential GUI thread deadlock between the opening of the Numerics Console and the View writing to the Console.

Platform(s) Affected: Microsoft Windows Vista (Sun's Java 6), Apple Mac OS X 10.4.10 (Java 5), Linux (Various).

Workaround: Manually open the Numerics Console prior to running a simulation in a View.

Solution: Problem fixed in Phaser Version 3.0-20071101-Release or later.