BlackBerry has some special behaviors for orientationModes
we need to document so our developers are aware of them.
No orientation direction restrictions supported.
BlackBerry will not support restricting an orientation to a specific
direction. For example if you only set the modes to LANDSCAPE_LEFT, it
will NOT prevent LANDSCAPE_RIGHT orientation changes. If either
LANDSCAPE_LEFT or LANDSCAPE_RIGHT are specified full landscape orientation
changes will be allowed.
Not all orientation directions are allowed.
BlackBerry will refuse to allow some orientation directions from occurring.
For example on a phone form factor the device will never rotate the UI
to be facing the south direction (UPSIDE_PORTRAIT). Something similar may
happen on tablet form factors, but it may be a different direction. We should
verify the behavior on tablet hardware.
New LANDSCAPE constant.
BlackBerry adds the LANDSCAPE constant. This is used to enable
full landscape orientation support. This is the same as using
both LANDSCAPE_LEFT and LANDSCAPE_RIGHT constants.
Empty orientationModes array behavior.
If the array is left empty the default behavior will be restored.
This behavior is defined by what orientation setting are used in the
application manifest. See the [OrientationSupport](
http://developer.blackberry.com/cascades/reference/bb__cascades__orientationsupport.html) guide for more details.
Document this as a part of standard docs. If needed we can add to current change log if needed.
The orientationModes are documented in our docs: http://docs.appcelerator.com/titanium/latest/#!/guide/tiapp.xml_and_timodule.xml_Reference-section-29004921_tiapp.xmlandtimodule.xmlReference-BlackBerryspecificsection
Closing ticket as fixed.