/** * The top level utils module. the utils module is a set of common javascript functions that are * useful for applications. Platforms: Android|Iphone|Ipad * * @id Titanium.Utils * @type * @since 0.9 */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.Utils.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Decode a base64 string * * @id Titanium.Utils.base64decode * @param {String} str the string to use for the input * @type String */ /** * Encode a string into base64 * * @id Titanium.Utils.base64encode * @param {String} str the string to use for the input * @type String */ /** * Fire a synthesized event to the views listener * * @id Titanium.Utils.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Compute a md5 hash algorithm against the input and return a hex-based string * * @id Titanium.Utils.md5HexDigest * @param {String} str the string to use for the input * @type String */ /** * Remove a previously added event listener * * @id Titanium.Utils.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * The top level titanium module. Platforms: Android|Iphone|Ipad * * @id Titanium * @type * @since 0.1 */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * One or more filenames to include as if the javascript code was written in place. this is similar to a c #include function. * * @id Titanium.include * @param {String} name filename to include * @type Void */ /** * Remove a previously added event listener * * @id Titanium.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * The user-agent string used by titanium * * @id Titanium.userAgent * @type String * @property */ /** * The version of titanium that is executing * * @id Titanium.version * @type String * @property */ /** * A text area is created by the method titanium.ui.createtextfield. the text field is a single line field. Platforms: Android|Iphone|Ipad * * @code * Basic Text Field with rounded border: *

Create a simple text field with a round border style.

* 
var tf1 = Titanium.UI.createTextField({
 *     color:'#336699',
 *     height:35,
 *     top:10,
 *     left:10,
 *     width:250,
 *     borderStyle:Titanium.UI.INPUT_BORDERSTYLE_ROUNDED
 * });
 *
* @id Titanium.UI.TextField * @type * @since 0.8 */ /** * Add a child to the view hierarchy * * @id Titanium.UI.TextField.add * @param {Object} view the view to add to this views hiearchy * @type Void */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.UI.TextField.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Animate the view * * @id Titanium.UI.TextField.animate * @param {Object} obj either a dictionary of animation properties or an Animation object * @param {Function} callback function to be invoked upon completion of the animation * @type Void */ /** * Force the field to lose focus * * @id Titanium.UI.TextField.blur * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.UI.TextField.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Force the field to gain focus * * @id Titanium.UI.TextField.focus * @type Void */ /** * Return boolean (true) if the field has text * * @id Titanium.UI.TextField.hasText * @type Void */ /** * Hide the view * * @id Titanium.UI.TextField.hide * @type Void */ /** * Remove a previously add view from the view hiearchy * * @id Titanium.UI.TextField.remove * @param {Object} view the view to remove from this views hiearchy * @type Void */ /** * Remove a previously added event listener * * @id Titanium.UI.TextField.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * Make the view visible * * @id Titanium.UI.TextField.show * @type Void */ /** * Return a blob image of the rendered view * * @id Titanium.UI.TextField.toImage * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately * @type Object */ /** * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 * * @id Titanium.UI.TextField.anchorPoint * @type Object * @property */ /** * Read-only object with x and y properties of where the view is during animation * * @id Titanium.UI.TextField.animatedCenterPoint * @type Object * @property */ /** * Value of the background color of the field * * @id Titanium.UI.TextField.backgroundColor * @type String * @property */ /** * The image url to the background image of the field when in the disabled state * * @id Titanium.UI.TextField.backgroundDisabledImage * @type String * @property */ /** * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. * * @id Titanium.UI.TextField.backgroundGradient * @type Object * @property */ /** * The image url to the background image of the field * * @id Titanium.UI.TextField.backgroundImage * @type String * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image * * @id Titanium.UI.TextField.backgroundLeftCap * @type Float * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image * * @id Titanium.UI.TextField.backgroundTopCap * @type Float * @property */ /** * The border color of the view * * @id Titanium.UI.TextField.borderColor * @type String * @property */ /** * The border radius of the view * * @id Titanium.UI.TextField.borderRadius * @type Float * @property */ /** * The border style constant for the field * * @id Titanium.UI.TextField.borderStyle * @type Int * @property */ /** * The border width of the view * * @id Titanium.UI.TextField.borderWidth * @type Float * @property */ /** * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TextField.bottom * @type Float|String * @property */ /** * A dictionary with properties x and y to indicate the center of the views position relative to the parent view * * @id Titanium.UI.TextField.center * @type Object * @property */ /** * The mode constant for how to handle displaying the clear button * * @id Titanium.UI.TextField.clearButtonMode * @type Int * @property */ /** * Boolean that indicates if the value of the field is cleared upon editing * * @id Titanium.UI.TextField.clearOnEdit * @type Boolean * @property */ /** * Boolean indicating if the field is editable * * @id Titanium.UI.TextField.editable * @type Boolean * @property */ /** * Boolean indicating the enabled state of the field * * @id Titanium.UI.TextField.enabled * @type Boolean * @property */ /** * Property for the view height. can be either float value or a string of the width. * * @id Titanium.UI.TextField.height * @type Float|String * @property */ /** * The hint text to display when the field is unfocused * * @id Titanium.UI.TextField.hintText * @type String * @property */ /** * Array of toolbar button objects to be used when the keyboard is displayed * * @id Titanium.UI.TextField.keyboardToolbar * @type Array * @property */ /** * The color of the keyboard toolbar * * @id Titanium.UI.TextField.keyboardToolbarColor * @type String * @property */ /** * The height of the keyboard toolbar * * @id Titanium.UI.TextField.keyboardToolbarHeight * @type Float * @property */ /** * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TextField.left * @type Float|String * @property */ /** * The left button view * * @id Titanium.UI.TextField.leftButton * @type Object * @property */ /** * The mode of the left button view * * @id Titanium.UI.TextField.leftButtonMode * @type Int * @property */ /** * The left padding of the space between the button and the edge of the field * * @id Titanium.UI.TextField.leftButtonPadding * @type Float * @property */ /** * The minimum size of the font when the font is sized based on the contents. enables font scaling to fit * * @id Titanium.UI.TextField.minimumFontSize * @type Int * @property */ /** * The opacity from 0.0-1.0 * * @id Titanium.UI.TextField.opacity * @type Float * @property */ /** * The left padding of the text field * * @id Titanium.UI.TextField.paddingLeft * @type Float * @property */ /** * The right padding of the text field * * @id Titanium.UI.TextField.paddingRight * @type Float * @property */ /** * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TextField.right * @type Float|String * @property */ /** * The right button view * * @id Titanium.UI.TextField.rightButton * @type Object * @property */ /** * The mode of the right button view * * @id Titanium.UI.TextField.rightButtonMode * @type Int * @property */ /** * The right padding of the space between the button and the edge of the field * * @id Titanium.UI.TextField.rightButtonPadding * @type Float * @property */ /** * The size of the view as a dictionary of width and height properties * * @id Titanium.UI.TextField.size * @type Object * @property */ /** * Boolean to indicate if the return key should be suppressed during entry * * @id Titanium.UI.TextField.suppressReturn * @type Boolean * @property */ /** * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TextField.top * @type Float|String * @property */ /** * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) * * @id Titanium.UI.TextField.touchEnabled * @type Boolean * @property */ /** * The transformation matrix to apply to the view * * @id Titanium.UI.TextField.transform * @type Object * @property */ /** * Value of the field * * @id Titanium.UI.TextField.value * @type String * @property */ /** * The constant or string value for the fields vertical alignment. * * @id Titanium.UI.TextField.verticalAlign * @type Int|String * @property */ /** * A boolean of the visibility of the view * * @id Titanium.UI.TextField.visible * @type Boolean * @property */ /** * Property for the view width. can either be `auto`, a float value or a string of the width. * * @id Titanium.UI.TextField.width * @type Float|String * @property */ /** * The z index position relative to other sibling views * * @id Titanium.UI.TextField.zIndex * @type Int * @property */ /** * The android specific ui capabilities. all properties, methods and events in this namespace will only work on android related devices. Platforms: Android * * @id Titanium.UI.Android * @type Object * @since 1.0 */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.UI.Android.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.UI.Android.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Remove a previously added event listener * * @id Titanium.UI.Android.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * The resultset instance returned by invoking a database sql execute. Platforms: Android|Iphone|Ipad * * @id Titanium.Database.ResultSet * @type * @since 0.1 */ /** * Close the result set and release resources. once closed, this result set must no longer be used * * @id Titanium.Database.ResultSet.close * @type Void */ /** * Retrieve a row value by field index * * @id Titanium.Database.ResultSet.field * @param {Int} index column index (which is zero based) * @type Object */ /** * Retrieve a row value by field name * * @id Titanium.Database.ResultSet.fieldByName * @param {String} name column name from SQL query * @type Object */ /** * Return the number of columns in the result set * * @id Titanium.Database.ResultSet.fieldCount * @type Int */ /** * Return the field name for field index * * @id Titanium.Database.ResultSet.fieldName * @param {Int} index field name column index (which is zero based) * @type String */ /** * Return true if the row is a valid row * * @id Titanium.Database.ResultSet.isValidRow * @type Boolean */ /** * Iterate to the next row in the result set. returns false if no more results are available * * @id Titanium.Database.ResultSet.next * @type Boolean */ /** * The number of rows in the result set * * @id Titanium.Database.ResultSet.rowCount * @type Int * @property */ /** * Returns true if the current row is still valid * * @id Titanium.Database.ResultSet.validRow * @type Boolean * @property */ /** * The top level geolocation module. the geolocation module is used for accessing device location based information. Platforms: Android|Iphone|Ipad * * @id Titanium.Geolocation * @type Object * @since 0.1 */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.Geolocation.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.Geolocation.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Remove a previously added event listener * * @id Titanium.Geolocation.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * Configure the calibration ui. set the false to disable the calibration display. * * @id Titanium.Geolocation.setShowCalibration * @type Void */ /** * Accuracy constant * * @id Titanium.Geolocation.ACCURACY_BEST * @type Int * @property */ /** * Accuracy constant * * @id Titanium.Geolocation.ACCURACY_HUNDRED_METERS * @type Int * @property */ /** * Accuracy constant * * @id Titanium.Geolocation.ACCURACY_KILOMETER * @type Int * @property */ /** * Accuracy constant * * @id Titanium.Geolocation.ACCURACY_NEAREST_TEN_METERS * @type Int * @property */ /** * Accuracy constant * * @id Titanium.Geolocation.ACCURACY_THREE_KILOMETERS * @type Int * @property */ /** * The gps location provider * * @id Titanium.Geolocation.PROVIDER_GPS * @type String * @property */ /** * The network location provider * * @id Titanium.Geolocation.PROVIDER_NETWORK * @type String * @property */ /** * Returns true if the user has enabled or disable location services for the device (not the application). * * @id Titanium.Geolocation.locationServicesEnabled * @type Boolean * @property */ /** * Allows setting of the preferred location provider. returns undefined when the preferred provider is auto-detected * * @id Titanium.Geolocation.preferredProvider * @type String * @property */ /** * (ios only). this property informs the end-user why location services are being requested by the application. this string will be display in the permission dialog. this property is required starting in 4.0. * * @id Titanium.Geolocation.purpose * @type String * @property */ /** * Returns true if the calibration ui can show * * @id Titanium.Geolocation.showCalibration * @type Boolean * @property */ /** * The dashboard view provides a view that supports the ability to have springboard-like view of icons which can be reordered by dragging and can contain multiple pages of icons in a scrollable view. the dashboard view is created by the method titanium.ui.createdashboardview. Platforms: Iphone|Ipad * * @id Titanium.UI.DashboardView * @type * @since 1.2 */ /** * Add a child to the view hierarchy * * @id Titanium.UI.DashboardView.add * @param {Object} view the view to add to this views hiearchy * @type Void */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.UI.DashboardView.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Animate the view * * @id Titanium.UI.DashboardView.animate * @param {Object} obj either a dictionary of animation properties or an Animation object * @param {Function} callback function to be invoked upon completion of the animation * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.UI.DashboardView.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Hide the view * * @id Titanium.UI.DashboardView.hide * @type Void */ /** * Remove a previously add view from the view hiearchy * * @id Titanium.UI.DashboardView.remove * @param {Object} view the view to remove from this views hiearchy * @type Void */ /** * Remove a previously added event listener * * @id Titanium.UI.DashboardView.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * Make the view visible * * @id Titanium.UI.DashboardView.show * @type Void */ /** * Put the dashboard in edit mode * * @id Titanium.UI.DashboardView.startEditing * @type Void */ /** * Cancel editing * * @id Titanium.UI.DashboardView.stopEditing * @type Void */ /** * Return a blob image of the rendered view * * @id Titanium.UI.DashboardView.toImage * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately * @type Object */ /** * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 * * @id Titanium.UI.DashboardView.anchorPoint * @type Object * @property */ /** * Read-only object with x and y properties of where the view is during animation * * @id Titanium.UI.DashboardView.animatedCenterPoint * @type Object * @property */ /** * The background color of the view * * @id Titanium.UI.DashboardView.backgroundColor * @type String * @property */ /** * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. * * @id Titanium.UI.DashboardView.backgroundGradient * @type Object * @property */ /** * The background image url of the view * * @id Titanium.UI.DashboardView.backgroundImage * @type String * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image * * @id Titanium.UI.DashboardView.backgroundLeftCap * @type Float * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image * * @id Titanium.UI.DashboardView.backgroundTopCap * @type Float * @property */ /** * The border color of the view * * @id Titanium.UI.DashboardView.borderColor * @type String * @property */ /** * The border radius of the view * * @id Titanium.UI.DashboardView.borderRadius * @type Float * @property */ /** * The border width of the view * * @id Titanium.UI.DashboardView.borderWidth * @type Float * @property */ /** * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.DashboardView.bottom * @type Float|String * @property */ /** * A dictionary with properties x and y to indicate the center of the views position relative to the parent view * * @id Titanium.UI.DashboardView.center * @type Object * @property */ /** * An array of titanium.ui.dashboarditem objects to display in the view * * @id Titanium.UI.DashboardView.data * @type Array * @property */ /** * Property for the view height. can be either float value or a string of the width. * * @id Titanium.UI.DashboardView.height * @type Float|String * @property */ /** * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.DashboardView.left * @type Float|String * @property */ /** * The opacity from 0.0-1.0 * * @id Titanium.UI.DashboardView.opacity * @type Float * @property */ /** * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.DashboardView.right * @type Float|String * @property */ /** * The size of the view as a dictionary of width and height properties * * @id Titanium.UI.DashboardView.size * @type Object * @property */ /** * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.DashboardView.top * @type Float|String * @property */ /** * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) * * @id Titanium.UI.DashboardView.touchEnabled * @type Boolean * @property */ /** * The transformation matrix to apply to the view * * @id Titanium.UI.DashboardView.transform * @type Object * @property */ /** * A boolean of the visibility of the view * * @id Titanium.UI.DashboardView.visible * @type Boolean * @property */ /** * Property for the view width. can either be `auto`, a float value or a string of the width. * * @id Titanium.UI.DashboardView.width * @type Float|String * @property */ /** * True (default) to wobble during edit, false to disable wobble effect * * @id Titanium.UI.DashboardView.wobble * @type Boolean * @property */ /** * The z index position relative to other sibling views * * @id Titanium.UI.DashboardView.zIndex * @type Int * @property */ /** * The mapview is an object created by titanium.map.createview and is used for embedding native mapping capabilities as a view in your application. with native maps, you can control the mapping location, the type of map, the zoom level and you can add custom annotations directly to the map. Platforms: Android|Iphone|Ipad * * @id Titanium.Map.MapView * @type * @since 0.8 */ /** * Add a child to the view hierarchy * * @id Titanium.Map.MapView.add * @param {Object} view the view to add to this views hiearchy * @type Void */ /** * Add a new annotation to the map * * @id Titanium.Map.MapView.addAnnotation * @param {Object} annotation either a dictionary of properties for the annotation or a [Titanium.Map.Annotation](Titanium.Map.Annotation) instance. * @type Void */ /** * Add one or more new annotation to the map * * @id Titanium.Map.MapView.addAnnotations * @param {Array} annotations an array of either a dictionary of properties for the annotation or a [Titanium.Map.Annotation](Titanium.Map.Annotation) instance. * @type Void */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.Map.MapView.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Add a route. currently only supported on iphone * * @id Titanium.Map.MapView.addRoute * @param {Object} route dictionary with the properties: name route name, points dictionary of values with longitude and latitude keys, color for the line color and width for the line width. * @type Void */ /** * Animate the view * * @id Titanium.Map.MapView.animate * @param {Object} obj either a dictionary of animation properties or an Animation object * @param {Function} callback function to be invoked upon completion of the animation * @type Void */ /** * Cause the annotation to be deselected (hidden). * * @id Titanium.Map.MapView.deselectAnnotation * @param {String,object} annotation either a string of the annotation title or a [Titanium.Map.Annotation](Titanium.Map.Annotation) reference. * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.Map.MapView.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Hide the view * * @id Titanium.Map.MapView.hide * @type Void */ /** * Remove a previously add view from the view hiearchy * * @id Titanium.Map.MapView.remove * @param {Object} view the view to remove from this views hiearchy * @type Void */ /** * Removes all annotations added to the map * * @id Titanium.Map.MapView.removeAllAnnotations * @type Void */ /** * Remove an existing annotation from the map * * @id Titanium.Map.MapView.removeAnnotation * @param {String,object} annotation either a string of the annotation title or a [Titanium.Map.Annotation](Titanium.Map.Annotation) reference. * @type Void */ /** * Remove one or more existing annotations from the map * * @id Titanium.Map.MapView.removeAnnotations * @param {Array} annotation an array of either a string of the annotation title or a [Titanium.Map.Annotation](Titanium.Map.Annotation) reference. * @type Void */ /** * Remove a previously added event listener * * @id Titanium.Map.MapView.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * Remove a previously added route. currently only supported on iphone * * @id Titanium.Map.MapView.removeRoute * @param {Object} route same route object used during addRoute * @type Void */ /** * Cause the annotation to be selected (shown). * * @id Titanium.Map.MapView.selectAnnotation * @param {String,object} annotation either a string of the annotation title or a [Titanium.Map.Annotation](Titanium.Map.Annotation) reference. * @type Void */ /** * Make the view visible * * @id Titanium.Map.MapView.show * @type Void */ /** * Return a blob image of the rendered view * * @id Titanium.Map.MapView.toImage * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately * @type Object */ /** * Zoom in or out of the map * * @id Titanium.Map.MapView.zoom * @param {Double} level zoom level (can be positive or negative) * @type Void */ /** * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 * * @id Titanium.Map.MapView.anchorPoint * @type Object * @property */ /** * Boolean is mapping actions should be animated * * @id Titanium.Map.MapView.animate * @type Boolean * @property */ /** * Read-only object with x and y properties of where the view is during animation * * @id Titanium.Map.MapView.animatedCenterPoint * @type Object * @property */ /** * An array of annotations to add to the map * * @id Titanium.Map.MapView.annotations * @type Array * @property */ /** * The background color of the view * * @id Titanium.Map.MapView.backgroundColor * @type String * @property */ /** * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. * * @id Titanium.Map.MapView.backgroundGradient * @type Object * @property */ /** * The background image url of the view * * @id Titanium.Map.MapView.backgroundImage * @type String * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image * * @id Titanium.Map.MapView.backgroundLeftCap * @type Float * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image * * @id Titanium.Map.MapView.backgroundTopCap * @type Float * @property */ /** * The border color of the view * * @id Titanium.Map.MapView.borderColor * @type String * @property */ /** * The border radius of the view * * @id Titanium.Map.MapView.borderRadius * @type Float * @property */ /** * The border width of the view * * @id Titanium.Map.MapView.borderWidth * @type Float * @property */ /** * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.Map.MapView.bottom * @type Float|String * @property */ /** * A dictionary with properties x and y to indicate the center of the views position relative to the parent view * * @id Titanium.Map.MapView.center * @type Object * @property */ /** * Property for the view height. can be either float value or a string of the width. * * @id Titanium.Map.MapView.height * @type Float|String * @property */ /** * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.Map.MapView.left * @type Float|String * @property */ /** * A dictionary that specifies the following properties specifying the region location to set the map: latitudedelta, longitudedelta, latitude, longitude. * * @id Titanium.Map.MapView.location * @type Object * @property */ /** * The map type constant of either titanium.map.standard_type, titanium.map.satellite_type or titanium.map.hybrid_type. * * @id Titanium.Map.MapView.mapType * @type Int * @property */ /** * The opacity from 0.0-1.0 * * @id Titanium.Map.MapView.opacity * @type Float * @property */ /** * A dictionary that specifies the following properties specifying the region location to set the map: latitudedelta, longitudedelta, latitude, longitude. * * @id Titanium.Map.MapView.region * @type Object * @property */ /** * Boolean to indicate if the map should attempt to fit the map view into the region in the visible view * * @id Titanium.Map.MapView.regionFit * @type Boolean * @property */ /** * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.Map.MapView.right * @type Float|String * @property */ /** * The size of the view as a dictionary of width and height properties * * @id Titanium.Map.MapView.size * @type Object * @property */ /** * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.Map.MapView.top * @type Float|String * @property */ /** * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) * * @id Titanium.Map.MapView.touchEnabled * @type Boolean * @property */ /** * The transformation matrix to apply to the view * * @id Titanium.Map.MapView.transform * @type Object * @property */ /** * Boolean to indicate if the map should show the user's current device location as a pin on the map * * @id Titanium.Map.MapView.userLocation * @type Boolean * @property */ /** * A boolean of the visibility of the view * * @id Titanium.Map.MapView.visible * @type Boolean * @property */ /** * Property for the view width. can either be `auto`, a float value or a string of the width. * * @id Titanium.Map.MapView.width * @type Float|String * @property */ /** * The z index position relative to other sibling views * * @id Titanium.Map.MapView.zIndex * @type Int * @property */ /** * The 2dmatrix is created by titanium.ui.create2dmatrix. the 2d matrix is an object for holding values for an affine transformation matrix. a 2d matrix is used to rotate, scale, translate, or skew the objects in a two-dimensional space. a 2d matrix is represented by a 3 by 3 matrix. because the third column is always (0,0,1), the data structure contains values for only the first two columns. Platforms: Android|Iphone|Ipad * * @id Titanium.UI.2DMatrix * @type * @since 0.9 */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.UI.2DMatrix.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.UI.2DMatrix.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Returns a matrix constructed by inverting an existing matrix * * @id Titanium.UI.2DMatrix.invert * @type Void */ /** * Returns a matrix constructed by combining two existing matrix. * * @id Titanium.UI.2DMatrix.multiply * @param {Object} t2 The second matrix. This matrix is concatenated to the matrix instance against which the function is invoked. The result of this function is the first matrix multiplied by the second matrix. You might perform several multiplications in order to create a single matrix that contains the cumulative effects of several transformations. Note that matrix operations are not commutative - the order in which you concatenate matrices is important. That is, the result of multiplying matrix t1 by matrix t2 does not necessarily equal the result of multiplying matrix t2 by matrix t1. * @type Object */ /** * Remove a previously added event listener * * @id Titanium.UI.2DMatrix.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * Returns a matrix constructed by rotating an existing matrix * * @id Titanium.UI.2DMatrix.rotate * @param {Float} angle The angle, in degrees, by which to rotate the matrix. A positive value specifies counterclockwise rotation and a negative value specifies clockwise rotation. * @type Object */ /** * Returns a matrix constructed by scaling an existing matrix * * @id Titanium.UI.2DMatrix.scale * @param {Float} sx The value by which to scale x values of the matrix * @param {Float} sy The value by which to scale y values of the matrix * @type Object */ /** * Returns a matrix constructed by translating an existing matrix * * @id Titanium.UI.2DMatrix.translate * @param {Float} tx The value by which to move x values with the matrix * @param {Float} ty The value by which to move y values with the matrix * @type Object */ /** * The entry at position [1,1] in the matrix. * * @id Titanium.UI.2DMatrix.a * @type Float * @property */ /** * The entry at position [1,2] in the matrix. * * @id Titanium.UI.2DMatrix.b * @type Float * @property */ /** * The entry at position [2,1] in the matrix. * * @id Titanium.UI.2DMatrix.c * @type Float * @property */ /** * The entry at position [2,2] in the matrix. * * @id Titanium.UI.2DMatrix.d * @type Float * @property */ /** * The entry at position [3,1] in the matrix. * * @id Titanium.UI.2DMatrix.tx * @type Float * @property */ /** * The entry at position [3,2] in the matrix. * * @id Titanium.UI.2DMatrix.ty * @type Float * @property */ /** * The videoplayer object is returned by titanium.media.createvideoplayer and is useful for playing videos. Platforms: Android|Iphone|Ipad * * @id Titanium.Media.VideoPlayer * @type * @since 0.9 */ /** * Add a child to the view hierarchy * * @id Titanium.Media.VideoPlayer.add * @param {Object} view the view to add to this views hiearchy * @type Void */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.Media.VideoPlayer.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Animate the view * * @id Titanium.Media.VideoPlayer.animate * @param {Object} obj either a dictionary of animation properties or an Animation object * @param {Function} callback function to be invoked upon completion of the animation * @type Void */ /** * Cancels all pending asynchronous thumbnail requests. * * @id Titanium.Media.VideoPlayer.cancelAllThumbnailImageRequests * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.Media.VideoPlayer.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Hide the view * * @id Titanium.Media.VideoPlayer.hide * @type Void */ /** * Start playing the video * * @id Titanium.Media.VideoPlayer.play * @type Void */ /** * Release the internal video resources immediately. this is not usually necessary but can help if you no longer need to use the player after it is used to help converse memory. * * @id Titanium.Media.VideoPlayer.release * @type Void */ /** * Remove a previously add view from the view hiearchy * * @id Titanium.Media.VideoPlayer.remove * @param {Object} view the view to remove from this views hiearchy * @type Void */ /** * Remove a previously added event listener * * @id Titanium.Media.VideoPlayer.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * Asynchronously request thumbnails for one or more times, provided as an array of numbers (double). fires a thumbnail event on completion. optionally invokes the callback function passed in the method. * * @id Titanium.Media.VideoPlayer.requestThumbnailImagesAtTimes * @param {Array} times array of doubles for each time to request * @param {Int} option either [[Titanium.Media.VIDEO_TIME_OPTION_NEAREST_KEYFRAME]] or [[Titanium.Media.VIDEO_TIME_OPTION_EXACT]]. * @type Void */ /** * A view for customization which is always displayed behind movie content. * * @id Titanium.Media.VideoPlayer.setBackgroundView * @param {Object} view view to set * @type Void */ /** * The a non-url based media to play, either a file or blob. * * @id Titanium.Media.VideoPlayer.setMedia * @param {Object} media media to play * @type Void */ /** * The url to play * * @id Titanium.Media.VideoPlayer.setUrl * @param {String} url the url to play * @type Void */ /** * Make the view visible * * @id Titanium.Media.VideoPlayer.show * @type Void */ /** * Stop playing the video * * @id Titanium.Media.VideoPlayer.stop * @type Void */ /** * Returns a thumbnail at the given time as a blob. * * @id Titanium.Media.VideoPlayer.thumbnailImageAtTime * @param {Double} time playback time * @param {Int} option either [[Titanium.Media.VIDEO_TIME_OPTION_NEAREST_KEYFRAME]] or [[Titanium.Media.VIDEO_TIME_OPTION_EXACT]] * @type Object */ /** * Return a blob image of the rendered view * * @id Titanium.Media.VideoPlayer.toImage * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately * @type Object */ /** * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 * * @id Titanium.Media.VideoPlayer.anchorPoint * @type Object * @property */ /** * Read-only object with x and y properties of where the view is during animation * * @id Titanium.Media.VideoPlayer.animatedCenterPoint * @type Object * @property */ /** * Indicates if a movie should automatically start playback when it is likely to finish uninterrupted based on e.g. network conditions. defaults to true. * * @id Titanium.Media.VideoPlayer.autoplay * @type Boolean * @property */ /** * Background color for the view. deprecated, set the background color on the view. * * @id Titanium.Media.VideoPlayer.backgroundColor * @type String * @property */ /** * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. * * @id Titanium.Media.VideoPlayer.backgroundGradient * @type Object * @property */ /** * The background image url of the view * * @id Titanium.Media.VideoPlayer.backgroundImage * @type String * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image * * @id Titanium.Media.VideoPlayer.backgroundLeftCap * @type Float * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image * * @id Titanium.Media.VideoPlayer.backgroundTopCap * @type Float * @property */ /** * The border color of the view * * @id Titanium.Media.VideoPlayer.borderColor * @type String * @property */ /** * The border radius of the view * * @id Titanium.Media.VideoPlayer.borderRadius * @type Float * @property */ /** * The border width of the view * * @id Titanium.Media.VideoPlayer.borderWidth * @type Float * @property */ /** * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.Media.VideoPlayer.bottom * @type Float|String * @property */ /** * A dictionary with properties x and y to indicate the center of the views position relative to the parent view * * @id Titanium.Media.VideoPlayer.center * @type Object * @property */ /** * Deprecated. use url property instead. * * @id Titanium.Media.VideoPlayer.contentURL * @type String * @property */ /** * The duration of the movie, or 0.0 if not known. * * @id Titanium.Media.VideoPlayer.duration * @type Double * @property */ /** * The end time of movie playback. defaults to nan, which indicates natural end time of the movie. * * @id Titanium.Media.VideoPlayer.endPlaybackTime * @type Double * @property */ /** * Determines if the movie is presented in the entire screen (obscuring all other application content). default is false. setting this property to true before the movie player's view is visible will have no effect. * * @id Titanium.Media.VideoPlayer.fullscreen * @type Boolean * @property */ /** * Property for the view height. can be either float value or a string of the width. * * @id Titanium.Media.VideoPlayer.height * @type Float|String * @property */ /** * The start time of movie playback. defaults to nan, indicating the natural start time of the movie. * * @id Titanium.Media.VideoPlayer.initialPlaybackTime * @type Double * @property */ /** * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.Media.VideoPlayer.left * @type Float|String * @property */ /** * Returns the network load state of the movie player. * * @id Titanium.Media.VideoPlayer.loadState * @type Int * @property */ /** * The media object, either a file or blob. * * @id Titanium.Media.VideoPlayer.media * @type Object * @property */ /** * The style of the playback controls. defaults to titanium.media.video_control_default * * @id Titanium.Media.VideoPlayer.mediaControlStyle * @type Int * @property */ /** * The types of media in the movie, or titanium.media.video_media_type_none if not known. * * @id Titanium.Media.VideoPlayer.mediaTypes * @type Int * @property */ /** * Deprecated in 3.2+ of the iphone sdk - use mediacontrolstyle. provides the ability to set the control mode of the movie player. defaults to titanium.media.video_control_default. * * @id Titanium.Media.VideoPlayer.movieControlMode * @type Int * @property */ /** * Returns a dictionary with properties width and height. returns the natural size of the movie or 0 for both properties if not known or applicable. * * @id Titanium.Media.VideoPlayer.naturalSize * @type Object * @property */ /** * The opacity from 0.0-1.0 * * @id Titanium.Media.VideoPlayer.opacity * @type Float * @property */ /** * The currently playable duration of the movie, for progressively downloaded network content. * * @id Titanium.Media.VideoPlayer.playableDuration * @type Double * @property */ /** * Returns the current playback state of the music player * * @id Titanium.Media.VideoPlayer.playbackState * @type Int * @property */ /** * Boolean to indicate if the player has started playing. * * @id Titanium.Media.VideoPlayer.playing * @type Boolean * @property */ /** * Determines how the movie player repeats when reaching the end of playback. defaults to titanium.media.video_repeat_mode_none. * * @id Titanium.Media.VideoPlayer.repeatMode * @type Int * @property */ /** * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.Media.VideoPlayer.right * @type Float|String * @property */ /** * Determines how the content scales to fit the view. defaults to titanium.media.video_scaling_aspect_fit. * * @id Titanium.Media.VideoPlayer.scalingMode * @type Int * @property */ /** * The size of the view as a dictionary of width and height properties * * @id Titanium.Media.VideoPlayer.size * @type Object * @property */ /** * The playback type of the movie. defaults to titanium.media.video_source_type_unknown. specifying a playback type before playing the movie can result in faster load times. * * @id Titanium.Media.VideoPlayer.sourceType * @type Int * @property */ /** * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.Media.VideoPlayer.top * @type Float|String * @property */ /** * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) * * @id Titanium.Media.VideoPlayer.touchEnabled * @type Boolean * @property */ /** * The transformation matrix to apply to the view * * @id Titanium.Media.VideoPlayer.transform * @type Object * @property */ /** * Url of the media. * * @id Titanium.Media.VideoPlayer.url * @type String * @property */ /** * Indicates if the movie player should inherit the application's audio session instead of creating a new session (which would interrupt the application's session). defaults to true. setting this property during playback will not take effect until playback is stopped and started again. * * @id Titanium.Media.VideoPlayer.useApplicationAudioSession * @type Boolean * @property */ /** * A boolean of the visibility of the view * * @id Titanium.Media.VideoPlayer.visible * @type Boolean * @property */ /** * Property for the view width. can either be `auto`, a float value or a string of the width. * * @id Titanium.Media.VideoPlayer.width * @type Float|String * @property */ /** * The z index position relative to other sibling views * * @id Titanium.Media.VideoPlayer.zIndex * @type Int * @property */ /** * The tcpsocket instance returned from titanium.network.createtcpsocket. this object represents a socket which either listens locally on the device for connections, or connects to a remote machine. Platforms: Iphone|Ipad * * @id Titanium.Network.TCPSocket * @type * @since 1.2.0 */ /** * Close the socket * * @id Titanium.Network.TCPSocket.close * @type Void */ /** * Connect the scocket to a tcp server * * @id Titanium.Network.TCPSocket.connect * @type Void */ /** * Set up the socket to receive connections * * @id Titanium.Network.TCPSocket.listen * @type Void */ /** * Write data to the socket, if the mode is write_mode or read_write_mode * * @id Titanium.Network.TCPSocket.write * @param {Object,string} data either a string or blob object representing the data to be transferred * @param {Int} sendTo the socket reference to send the data to. Default is to send to all connected sockets * @type Void */ /** * The host name to connect to. must be inaddr_any or an identifier for the local device in order to listen * * @id Titanium.Network.TCPSocket.hostName * @type String * @property */ /** * Whether or not the socket is valid * * @id Titanium.Network.TCPSocket.isValid * @type Boolean * @property */ /** * The socket's mode * * @id Titanium.Network.TCPSocket.mode * @type Int * @property */ /** * The port to connect/listen on * * @id Titanium.Network.TCPSocket.port * @type Int * @property */ /** * The tab group allows you to manage a tabbed ui of one or more windows. the tab group is created by the method titanium.ui.createtabgroup. Platforms: Android|Iphone|Ipad * * @id Titanium.UI.TabGroup * @type * @since 0.9 */ /** * Add a child to the view hierarchy * * @id Titanium.UI.TabGroup.add * @param {Object} view the view to add to this views hiearchy * @type Void */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.UI.TabGroup.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Add a tab to the tab group * * @id Titanium.UI.TabGroup.addTab * @type Void */ /** * Animate the view * * @id Titanium.UI.TabGroup.animate * @param {Object} obj either a dictionary of animation properties or an Animation object * @param {Function} callback function to be invoked upon completion of the animation * @type Void */ /** * Close the tab group and remove it from the ui * * @id Titanium.UI.TabGroup.close * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.UI.TabGroup.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Hide the view * * @id Titanium.UI.TabGroup.hide * @type Void */ /** * Open the tab group and make it visible * * @id Titanium.UI.TabGroup.open * @type Void */ /** * Remove a previously add view from the view hiearchy * * @id Titanium.UI.TabGroup.remove * @param {Object} view the view to remove from this views hiearchy * @type Void */ /** * Remove a previously added event listener * * @id Titanium.UI.TabGroup.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * Remove a tab from the tab group * * @id Titanium.UI.TabGroup.removeTab * @type Void */ /** * Select the currently active tab in a tab group * * @id Titanium.UI.TabGroup.setActiveTab * @param {Object} indexOrObject an int representing the desired tab index or a reference to the tab object you'd like to switch to * @type Void */ /** * Make the view visible * * @id Titanium.UI.TabGroup.show * @type Void */ /** * Return a blob image of the rendered view * * @id Titanium.UI.TabGroup.toImage * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately * @type Object */ /** * The active tab * * @id Titanium.UI.TabGroup.activeTab * @type Object * @property */ /** * Whether or not the user can configure the tab group via the 'more' tab's edit functionality. iphone/ipad only * * @id Titanium.UI.TabGroup.allowUserCustomization * @type Boolean * @property */ /** * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 * * @id Titanium.UI.TabGroup.anchorPoint * @type Object * @property */ /** * Read-only object with x and y properties of where the view is during animation * * @id Titanium.UI.TabGroup.animatedCenterPoint * @type Object * @property */ /** * The background color of the view * * @id Titanium.UI.TabGroup.backgroundColor * @type String * @property */ /** * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. * * @id Titanium.UI.TabGroup.backgroundGradient * @type Object * @property */ /** * The background image url of the view * * @id Titanium.UI.TabGroup.backgroundImage * @type String * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image * * @id Titanium.UI.TabGroup.backgroundLeftCap * @type Float * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image * * @id Titanium.UI.TabGroup.backgroundTopCap * @type Float * @property */ /** * The bar color * * @id Titanium.UI.TabGroup.barColor * @type String * @property */ /** * The border color of the view * * @id Titanium.UI.TabGroup.borderColor * @type String * @property */ /** * The border radius of the view * * @id Titanium.UI.TabGroup.borderRadius * @type Float * @property */ /** * The border width of the view * * @id Titanium.UI.TabGroup.borderWidth * @type Float * @property */ /** * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TabGroup.bottom * @type Float|String * @property */ /** * A dictionary with properties x and y to indicate the center of the views position relative to the parent view * * @id Titanium.UI.TabGroup.center * @type Object * @property */ /** * The title for the 'more' tab edit button. iphone/ipad only * * @id Titanium.UI.TabGroup.editButtonTitle * @type String * @property */ /** * Property for the view height. can be either float value or a string of the width. * * @id Titanium.UI.TabGroup.height * @type Float|String * @property */ /** * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TabGroup.left * @type Float|String * @property */ /** * The opacity from 0.0-1.0 * * @id Titanium.UI.TabGroup.opacity * @type Float * @property */ /** * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TabGroup.right * @type Float|String * @property */ /** * The size of the view as a dictionary of width and height properties * * @id Titanium.UI.TabGroup.size * @type Object * @property */ /** * Array of tab objects that are managed by the tab group * * @id Titanium.UI.TabGroup.tabs * @type Array * @property */ /** * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TabGroup.top * @type Float|String * @property */ /** * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) * * @id Titanium.UI.TabGroup.touchEnabled * @type Boolean * @property */ /** * The transformation matrix to apply to the view * * @id Titanium.UI.TabGroup.transform * @type Object * @property */ /** * A boolean of the visibility of the view * * @id Titanium.UI.TabGroup.visible * @type Boolean * @property */ /** * Property for the view width. can either be `auto`, a float value or a string of the width. * * @id Titanium.UI.TabGroup.width * @type Float|String * @property */ /** * The z index position relative to other sibling views * * @id Titanium.UI.TabGroup.zIndex * @type Int * @property */ /** * The top level map module. the map module is used for creating in-application native maps. Platforms: Android|Iphone|Ipad * * @code * Map Example: *

This is a basic map example that uses a custom annotation on the map.

* 
var mountainView = Titanium.Map.createAnnotation({
 *     latitude:37.390749,
 *     longitude:-122.081651,
 *     title:"Appcelerator Headquarters",
 *     subtitle:'Mountain View, CA',
 *     pincolor:Titanium.Map.ANNOTATION_RED,
 *     animate:true,
 *     leftButton: '../images/appcelerator_small.png',
 *     myid:1 // CUSTOM ATTRIBUTE THAT IS PASSED INTO EVENT OBJECTS
 * });
 * 
 * var mapview = Titanium.Map.createView({
 *     mapType: Titanium.Map.STANDARD_TYPE,
 *     region: {latitude:33.74511, longitude:-84.38993, 
 *             latitudeDelta:0.01, longitudeDelta:0.01},
 *     animate:true,
 *     regionFit:true,
 *     userLocation:true,
 *     annotations:[mountainView]
 * });
 * 
 * win.add(mapview);
 *
* @id Titanium.Map * @type Object * @since 0.8 */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.Map.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Create and return an instance of titanium.map.annotation * * @id Titanium.Map.createAnnotation * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.Map.Annotation * @type Object */ /** * Create and return an instance of titanium.map.mapview * * @id Titanium.Map.createMapView * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.Map.MapView * @type Object */ /** * Fire a synthesized event to the views listener * * @id Titanium.Map.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Remove a previously added event listener * * @id Titanium.Map.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * The head of the pin is green. green pins indicate starting points on the map. * * @id Titanium.Map.ANNOTATION_GREEN * @type Int * @property */ /** * The head of the pin is purple. purple pins indicate user-specified points on the map. * * @id Titanium.Map.ANNOTATION_PURPLE * @type Int * @property */ /** * The head of the pin is red. red pins indicate destination points on the map. * * @id Titanium.Map.ANNOTATION_RED * @type Int * @property */ /** * Displays a satellite image of the area with road and road name information layered on top. * * @id Titanium.Map.HYBRID_TYPE * @type Int * @property */ /** * Displays satellite imagery of the area. * * @id Titanium.Map.SATELLITE_TYPE * @type Int * @property */ /** * Displays a street map that shows the position of all roads and some road names. * * @id Titanium.Map.STANDARD_TYPE * @type Int * @property */ /** * The httpclient instance returned from titanium.network.createhttpclient. this object (mostly) implements the xmlhttprequest specification. Platforms: Android|Iphone|Ipad * * @id Titanium.Network.HTTPClient * @type * @since 0.1 */ /** * Abort a pending request * * @id Titanium.Network.HTTPClient.abort * @type Void */ /** * Return the response header. * * @id Titanium.Network.HTTPClient.getResponseHeader * @param {String} name the header name * @type String */ /** * Open the request and ready the connection * * @id Titanium.Network.HTTPClient.open * @param {String} method the HTTP method * @param {String} url the URL for the request * @param {Boolean} async optional property to indicate if asynchronous (default) or not * @type Void */ /** * Send the request * * @id Titanium.Network.HTTPClient.send * @param {Object} data the data to send in the request. can either be null, dictionary, string, File object or Blob. * @type Void */ /** * Set the request header. must be called after open but before send. * * @id Titanium.Network.HTTPClient.setRequestHeader * @param {String} name name of the header * @param {String} value value of the header. May be null to clearing out a property, such as X-Requested-With * @type Void */ /** * Set the request timeout * * @id Titanium.Network.HTTPClient.setTimeout * @param {Double} timeout the timeout in milliseconds * @type Void */ /** * The done readystate constant * * @id Titanium.Network.HTTPClient.DONE * @type Int * @property */ /** * The headers_received readystate constant * * @id Titanium.Network.HTTPClient.HEADERS_RECEIVED * @type Int * @property */ /** * The loading readystate constant * * @id Titanium.Network.HTTPClient.LOADING * @type Int * @property */ /** * The opened readystate constant * * @id Titanium.Network.HTTPClient.OPENED * @type Int * @property */ /** * The unset readystate constant * * @id Titanium.Network.HTTPClient.UNSENT * @type Int * @property */ /** * Boolean to indicate that the response was successful * * @id Titanium.Network.HTTPClient.connected * @type Boolean * @property */ /** * The connection type, normally either get or post. * * @id Titanium.Network.HTTPClient.connectionType * @type String * @property */ /** * The absolute url of the request * * @id Titanium.Network.HTTPClient.location * @type String * @property */ /** * Set this to a function before calling open to cause the function to be called at regular intervals as the request data is being received. the progress property of the event will contain a value from 0.0-1.0 with the progress. * * @id Titanium.Network.HTTPClient.ondatastream * @type Function * @property */ /** * Set this to a function before calling open to cause the function to be called upon a error response * * @id Titanium.Network.HTTPClient.onerror * @type Function * @property */ /** * Set this to a function before calling open to cause the function to be called upon a successful response * * @id Titanium.Network.HTTPClient.onload * @type Function * @property */ /** * Set this to a function before calling open to cause the function to be called for each readystate change * * @id Titanium.Network.HTTPClient.onreadystatechange * @type Function * @property */ /** * Set this to a function before calling open to cause the function to be called at regular intervals as the request data is being transmitted. the progress property of the event will contain a value from 0.0-1.0 with the progress. * * @id Titanium.Network.HTTPClient.onsendstream * @type Function * @property */ /** * The readystate value * * @id Titanium.Network.HTTPClient.readyState * @type Int * @property */ /** * The response data as a blob object. * * @id Titanium.Network.HTTPClient.responseData * @type Object * @property */ /** * The response as text or null if an error was received or no data was returned * * @id Titanium.Network.HTTPClient.responseText * @type String * @property */ /** * The response object as an xml domdocument object. returns null if the content type returned by the server was not xml or the content could not be parsed * * @id Titanium.Network.HTTPClient.responseXML * @type Object * @property */ /** * The response http status code * * @id Titanium.Network.HTTPClient.status * @type Int * @property */ /** * Timeout is milliseconds when the connection should be aborted * * @id Titanium.Network.HTTPClient.timeout * @type Int * @property */ /** * Set this to control how ssl certification validation is performed on connection. defaults to false if in simulator or device testing and true if release for distribution mode. * * @id Titanium.Network.HTTPClient.validatesSecureCertificate * @type Boolean * @property */ /** * The cover flow view is container for showing animated, three dimensional images in a nice ui. the cover flow view is created by the method titanium.ui.createcoverflowview. Platforms: Iphone|Ipad * * @code * Simple 3 image cover flow example: *

Create a rounded view.

* 
var view = Titanium.UI.createCoverFlowView({
 *     images:['a.png','b.png','c.png'],
 *     backgroundColor:'#000'
 * });
 * window.add(view);
 *
* @id Titanium.UI.CoverFlowView * @type * @since 0.8 */ /** * Add a child to the view hierarchy * * @id Titanium.UI.CoverFlowView.add * @param {Object} view the view to add to this views hiearchy * @type Void */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.UI.CoverFlowView.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Animate the view * * @id Titanium.UI.CoverFlowView.animate * @param {Object} obj either a dictionary of animation properties or an Animation object * @param {Function} callback function to be invoked upon completion of the animation * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.UI.CoverFlowView.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Hide the view * * @id Titanium.UI.CoverFlowView.hide * @type Void */ /** * Remove a previously add view from the view hiearchy * * @id Titanium.UI.CoverFlowView.remove * @param {Object} view the view to remove from this views hiearchy * @type Void */ /** * Remove a previously added event listener * * @id Titanium.UI.CoverFlowView.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * Change an image for a index * * @id Titanium.UI.CoverFlowView.setURL * @param {Int} index index to change * @param {String} url url to the new image * @type Void */ /** * Make the view visible * * @id Titanium.UI.CoverFlowView.show * @type Void */ /** * Return a blob image of the rendered view * * @id Titanium.UI.CoverFlowView.toImage * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately * @type Object */ /** * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 * * @id Titanium.UI.CoverFlowView.anchorPoint * @type Object * @property */ /** * Read-only object with x and y properties of where the view is during animation * * @id Titanium.UI.CoverFlowView.animatedCenterPoint * @type Object * @property */ /** * The background color of the view * * @id Titanium.UI.CoverFlowView.backgroundColor * @type String * @property */ /** * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. * * @id Titanium.UI.CoverFlowView.backgroundGradient * @type Object * @property */ /** * The background image url of the view * * @id Titanium.UI.CoverFlowView.backgroundImage * @type String * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image * * @id Titanium.UI.CoverFlowView.backgroundLeftCap * @type Float * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image * * @id Titanium.UI.CoverFlowView.backgroundTopCap * @type Float * @property */ /** * The border color of the view * * @id Titanium.UI.CoverFlowView.borderColor * @type String * @property */ /** * The border radius of the view * * @id Titanium.UI.CoverFlowView.borderRadius * @type Float * @property */ /** * The border width of the view * * @id Titanium.UI.CoverFlowView.borderWidth * @type Float * @property */ /** * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.CoverFlowView.bottom * @type Float|String * @property */ /** * A dictionary with properties x and y to indicate the center of the views position relative to the parent view * * @id Titanium.UI.CoverFlowView.center * @type Object * @property */ /** * Property for the view height. can be either float value or a string of the width. * * @id Titanium.UI.CoverFlowView.height * @type Float|String * @property */ /** * Array of images to display in the view * * @id Titanium.UI.CoverFlowView.images * @type Array * @property */ /** * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.CoverFlowView.left * @type Float|String * @property */ /** * The opacity from 0.0-1.0 * * @id Titanium.UI.CoverFlowView.opacity * @type Float * @property */ /** * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.CoverFlowView.right * @type Float|String * @property */ /** * Index to make selected * * @id Titanium.UI.CoverFlowView.selected * @type Int * @property */ /** * The size of the view as a dictionary of width and height properties * * @id Titanium.UI.CoverFlowView.size * @type Object * @property */ /** * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.CoverFlowView.top * @type Float|String * @property */ /** * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) * * @id Titanium.UI.CoverFlowView.touchEnabled * @type Boolean * @property */ /** * The transformation matrix to apply to the view * * @id Titanium.UI.CoverFlowView.transform * @type Object * @property */ /** * A boolean of the visibility of the view * * @id Titanium.UI.CoverFlowView.visible * @type Boolean * @property */ /** * Property for the view width. can either be `auto`, a float value or a string of the width. * * @id Titanium.UI.CoverFlowView.width * @type Float|String * @property */ /** * The z index position relative to other sibling views * * @id Titanium.UI.CoverFlowView.zIndex * @type Int * @property */ /** * A set of constants for the style that can be used for the separatorstyle property of titanium.ui.tableview. Platforms: Iphone|Ipad * * @id Titanium.UI.iPhone.TableViewSeparatorStyle * @type * @since 0.9 */ /** * The separator cell has no distinct style. * * @id Titanium.UI.iPhone.TableViewSeparatorStyle.NONE * @type Int * @property */ /** * The separator cell has a single line running across its width. this is the default value. * * @id Titanium.UI.iPhone.TableViewSeparatorStyle.SINGLE_LINE * @type Int * @property */ /** * A set of constants for the styles available for titanium.ui.activityindicator objects. Platforms: Iphone|Ipad * * @id Titanium.UI.iPhone.ActivityIndicatorStyle * @type * @since 0.9 */ /** * The large white style of indicator. * * @id Titanium.UI.iPhone.ActivityIndicatorStyle.BIG * @type Int * @property */ /** * The standard gray style of indicator. * * @id Titanium.UI.iPhone.ActivityIndicatorStyle.DARK * @type Int * @property */ /** * The standard white style of indicator (the default). * * @id Titanium.UI.iPhone.ActivityIndicatorStyle.PLAIN * @type Int * @property */ /** * A splitwindow is a window that manages the presentation of two side-by-side view controllers. you use this class to implement a master-detail interface, in which the left-side view presents a list of items and the right-side presents details of the selected item. the splitview is for use exclusively on ipad devices. the splitwindow is created by the method titanium.ui.ipad.createsplitwindow. * Platforms: Ipad * * @code * Split Window Example: *

This is an example of a Split Window.

* 
var win = Ti.UI.createWindow();
 * 
 * var nav = Ti.UI.iPhone.createNavigationGroup({
 *    window: win
 * });
 * 
 * var splitwin = Ti.UI.iPad.createSplitWindow({
 *     detailView:nav,
 *     masterView:masterView
 * });
 * 
 * splitwin.addEventListener('visible',function(e)
 * {
 *     if (e.view == 'detail')
 *     {
 *         e.button.title = "Master";
 *         win.leftNavButton = e.button;
 *     }
 *     else if (e.view == 'master')
 *     {
 *         win.leftNavButton = null;
 *     }
 * });
 * 
 * splitwin.open();
 *
* @id Titanium.UI.iPad.SplitWindow * @type * @since 1.2 */ /** * Add a child to the view hierarchy * * @id Titanium.UI.iPad.SplitWindow.add * @param {Object} view the view to add to this views hiearchy * @type Void */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.UI.iPad.SplitWindow.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Animate the view * * @id Titanium.UI.iPad.SplitWindow.animate * @param {Object} obj either a dictionary of animation properties or an Animation object * @param {Function} callback function to be invoked upon completion of the animation * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.UI.iPad.SplitWindow.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Hide the view * * @id Titanium.UI.iPad.SplitWindow.hide * @type Void */ /** * Remove a previously add view from the view hiearchy * * @id Titanium.UI.iPad.SplitWindow.remove * @param {Object} view the view to remove from this views hiearchy * @type Void */ /** * Remove a previously added event listener * * @id Titanium.UI.iPad.SplitWindow.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * Make the view visible * * @id Titanium.UI.iPad.SplitWindow.show * @type Void */ /** * Return a blob image of the rendered view * * @id Titanium.UI.iPad.SplitWindow.toImage * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately * @type Object */ /** * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 * * @id Titanium.UI.iPad.SplitWindow.anchorPoint * @type Object * @property */ /** * Read-only object with x and y properties of where the view is during animation * * @id Titanium.UI.iPad.SplitWindow.animatedCenterPoint * @type Object * @property */ /** * The background color of the view * * @id Titanium.UI.iPad.SplitWindow.backgroundColor * @type String * @property */ /** * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. * * @id Titanium.UI.iPad.SplitWindow.backgroundGradient * @type Object * @property */ /** * The background image url of the view * * @id Titanium.UI.iPad.SplitWindow.backgroundImage * @type String * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image * * @id Titanium.UI.iPad.SplitWindow.backgroundLeftCap * @type Float * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image * * @id Titanium.UI.iPad.SplitWindow.backgroundTopCap * @type Float * @property */ /** * The border color of the view * * @id Titanium.UI.iPad.SplitWindow.borderColor * @type String * @property */ /** * The border radius of the view * * @id Titanium.UI.iPad.SplitWindow.borderRadius * @type Float * @property */ /** * The border width of the view * * @id Titanium.UI.iPad.SplitWindow.borderWidth * @type Float * @property */ /** * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.iPad.SplitWindow.bottom * @type Float|String * @property */ /** * A dictionary with properties x and y to indicate the center of the views position relative to the parent view * * @id Titanium.UI.iPad.SplitWindow.center * @type Object * @property */ /** * View for the detail view section of the splitwindow * * @id Titanium.UI.iPad.SplitWindow.detailView * @type Object * @property */ /** * Property for the view height. can be either float value or a string of the width. * * @id Titanium.UI.iPad.SplitWindow.height * @type Float|String * @property */ /** * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.iPad.SplitWindow.left * @type Float|String * @property */ /** * View for the master view section of the splitwindow * * @id Titanium.UI.iPad.SplitWindow.masterView * @type Object * @property */ /** * The opacity from 0.0-1.0 * * @id Titanium.UI.iPad.SplitWindow.opacity * @type Float * @property */ /** * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.iPad.SplitWindow.right * @type Float|String * @property */ /** * The size of the view as a dictionary of width and height properties * * @id Titanium.UI.iPad.SplitWindow.size * @type Object * @property */ /** * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.iPad.SplitWindow.top * @type Float|String * @property */ /** * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) * * @id Titanium.UI.iPad.SplitWindow.touchEnabled * @type Boolean * @property */ /** * The transformation matrix to apply to the view * * @id Titanium.UI.iPad.SplitWindow.transform * @type Object * @property */ /** * A boolean of the visibility of the view * * @id Titanium.UI.iPad.SplitWindow.visible * @type Boolean * @property */ /** * Property for the view width. can either be `auto`, a float value or a string of the width. * * @id Titanium.UI.iPad.SplitWindow.width * @type Float|String * @property */ /** * The z index position relative to other sibling views * * @id Titanium.UI.iPad.SplitWindow.zIndex * @type Int * @property */ /** * A menuitem allows you provide a selectable option with a graphic and titel. the menu item is created by the method titanium.ui.android.optionmenu.createmenuitem Platforms: Android * * @id Titanium.UI.Android.OptionMenu.MenuItem * @type * @since 1.1 */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.UI.Android.OptionMenu.MenuItem.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.UI.Android.OptionMenu.MenuItem.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Remove a previously added event listener * * @id Titanium.UI.Android.OptionMenu.MenuItem.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * The path to the image to display on the menu option * * @id Titanium.UI.Android.OptionMenu.MenuItem.icon * @type String * @property */ /** * The text for the menu option * * @id Titanium.UI.Android.OptionMenu.MenuItem.title * @type String * @property */ /** * A set of constants for the status bar style. Platforms: Iphone|Ipad * * @id Titanium.UI.iPhone.StatusBar * @type * @since 0.9 */ /** * The default status bar style * * @id Titanium.UI.iPhone.StatusBar.DEFAULT * @type Int * @property */ /** * The gray colored status bar style * * @id Titanium.UI.iPhone.StatusBar.GRAY * @type Int * @property */ /** * The opaque black status bar style. * * @id Titanium.UI.iPhone.StatusBar.OPAQUE_BLACK * @type Int * @property */ /** * The translucent black status bar style. this style provides some level of transparency to the device background. * * @id Titanium.UI.iPhone.StatusBar.TRANSLUCENT_BLACK * @type Int * @property */ /** * A table view allows you to create a scrollable table of content in a list-based fashion. the table view is created by the method titanium.ui.createtableview. Platforms: Android|Iphone|Ipad * * @code * Simple Table View with basic rows: *

The most basic example of a table view.

* 
var data = [{title:"Row 1"},{title:"Row 2"}];
 * var table = Titanium.UI.createTableView({data:data});
 * win.add(table);
 *
* @id Titanium.UI.TableView * @type * @since 0.8 */ /** * Add a child to the view hierarchy * * @id Titanium.UI.TableView.add * @param {Object} view the view to add to this views hiearchy * @type Void */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.UI.TableView.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Animate the view * * @id Titanium.UI.TableView.animate * @param {Object} obj either a dictionary of animation properties or an Animation object * @param {Function} callback function to be invoked upon completion of the animation * @type Void */ /** * Append a row to the table, optionally with animation * * @id Titanium.UI.TableView.appendRow * @param {Object} row row to append * @param {Object} properties animation properties * @type Void */ /** * Delete an existing row, optionally with animation * * @id Titanium.UI.TableView.deleteRow * @param {Object} row row to delete * @param {Object} properties animation properties * @type Void */ /** * Programmatically deselect a row * * @id Titanium.UI.TableView.deselectRow * @param {Int} row row index to deselect * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.UI.TableView.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Hide the view * * @id Titanium.UI.TableView.hide * @type Void */ /** * Insert a row before another row, optionally with animation * * @id Titanium.UI.TableView.insertRowAfter * @param {Int} index index * @param {Object} row row to insert * @param {Object} properties animation properties * @type Void */ /** * Insert a row after another row, optionally with animation * * @id Titanium.UI.TableView.insertRowBefore * @param {Int} index index * @param {Object} row row to insert * @param {Object} properties animation properties * @type Void */ /** * Remove a previously add view from the view hiearchy * * @id Titanium.UI.TableView.remove * @param {Object} view the view to remove from this views hiearchy * @type Void */ /** * Remove a previously added event listener * * @id Titanium.UI.TableView.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * Scroll to a specific row index and ensure that that row is on screen * * @id Titanium.UI.TableView.scrollToIndex * @param {Int} index index * @param {Object} properties animation properties. position property controls the position constant to use for position (on iPhone, use constants from Titanium.UI.iPhone.TableViewScrollPosition). * @type Void */ /** * Scroll the table to a specific top position where 0 is the topmost y position in the table view * * @id Titanium.UI.TableView.scrollToTop * @param {Float} top y position * @param {Object} properties optional dictionary with the key animated (default, true) as boolean to indicate if the scroll should be animated or immediate * @type Void */ /** * Programmatically select a row * * @id Titanium.UI.TableView.selectRow * @param {Int} row row index to select * @type Void */ /** * Set the data in the table, optionally with animation * * @id Titanium.UI.TableView.setData * @param {Array} data data array of rows either as objects or row objects * @param {Object} properties animation properties * @type Void */ /** * Make the view visible * * @id Titanium.UI.TableView.show * @type Void */ /** * Return a blob image of the rendered view * * @id Titanium.UI.TableView.toImage * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately * @type Object */ /** * Update an existing row, optionally with animation * * @id Titanium.UI.TableView.updateRow * @param {Object} row row data to update * @param {Object} properties animation properties * @type Void */ /** * True if the rows can be selected * * @id Titanium.UI.TableView.allowsSelection * @type Boolean * @property */ /** * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 * * @id Titanium.UI.TableView.anchorPoint * @type Object * @property */ /** * Read-only object with x and y properties of where the view is during animation * * @id Titanium.UI.TableView.animatedCenterPoint * @type Object * @property */ /** * The background color of the table view * * @id Titanium.UI.TableView.backgroundColor * @type String * @property */ /** * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. * * @id Titanium.UI.TableView.backgroundGradient * @type Object * @property */ /** * The background image to render in the background of the table view * * @id Titanium.UI.TableView.backgroundImage * @type String * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image * * @id Titanium.UI.TableView.backgroundLeftCap * @type Float * @property */ /** * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image * * @id Titanium.UI.TableView.backgroundTopCap * @type Float * @property */ /** * The border color of the view * * @id Titanium.UI.TableView.borderColor * @type String * @property */ /** * The border radius of the view * * @id Titanium.UI.TableView.borderRadius * @type Float * @property */ /** * The border width of the view * * @id Titanium.UI.TableView.borderWidth * @type Float * @property */ /** * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TableView.bottom * @type Float|String * @property */ /** * A dictionary with properties x and y to indicate the center of the views position relative to the parent view * * @id Titanium.UI.TableView.center * @type Object * @property */ /** * The data array of objects to be used for the rows of the table view * * @id Titanium.UI.TableView.data * @type Array * @property */ /** * Allow the table view to be editable (this must be true for swipe-to-delete) * * @id Titanium.UI.TableView.editable * @type Boolean * @property */ /** * Boolean to control the editing state of the table view * * @id Titanium.UI.TableView.editing * @type Boolean * @property */ /** * The filter attribute to be used when searching. this property maps to your data object or a property on the row object * * @id Titanium.UI.TableView.filterAttribute * @type String * @property */ /** * Boolean to indicate if the search should be case sensitive or case insensitive (default) * * @id Titanium.UI.TableView.filterCaseInsensitive * @type Boolean * @property */ /** * The table view footer title * * @id Titanium.UI.TableView.footerTitle * @type String * @property */ /** * The table view footer as a view that will be rendered instead of a label * * @id Titanium.UI.TableView.footerView * @type Object * @property */ /** * The table view header title * * @id Titanium.UI.TableView.headerTitle * @type String * @property */ /** * The table view header as a view that will be rendered instead of a label * * @id Titanium.UI.TableView.headerView * @type Object * @property */ /** * Property for the view height. can be either float value or a string of the width. * * @id Titanium.UI.TableView.height * @type Float|String * @property */ /** * An array of objects (with title and index properties) to control the table view index * * @id Titanium.UI.TableView.index * @type Array * @property */ /** * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TableView.left * @type Float|String * @property */ /** * Max row height for table view rows * * @id Titanium.UI.TableView.maxRowHeight * @type Float * @property */ /** * Min row height for table view rows * * @id Titanium.UI.TableView.minRowHeight * @type Float * @property */ /** * Boolean to control the moveable state of the table view * * @id Titanium.UI.TableView.moving * @type Boolean * @property */ /** * The opacity from 0.0-1.0 * * @id Titanium.UI.TableView.opacity * @type Float * @property */ /** * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TableView.right * @type Float|String * @property */ /** * Default row height for table view rows * * @id Titanium.UI.TableView.rowHeight * @type Float * @property */ /** * True (default) if tableview can be scrolled * * @id Titanium.UI.TableView.scrollable * @type Boolean * @property */ /** * The search field to use for the table view * * @id Titanium.UI.TableView.search * @type Object * @property */ /** * Boolean to control the visibility of the search field * * @id Titanium.UI.TableView.searchHidden * @type Boolean * @property */ /** * The separator color color as a hex or named value * * @id Titanium.UI.TableView.separatorColor * @type String * @property */ /** * The separator style constant. for iphone, titanium.ui.iphone.tableviewseparatorstyle * * @id Titanium.UI.TableView.separatorStyle * @type Int * @property */ /** * The size of the view as a dictionary of width and height properties * * @id Titanium.UI.TableView.size * @type Object * @property */ /** * Iphone only. the style of the table view. constant from titanium.ui.iphone.tableviewstyle * * @id Titanium.UI.TableView.style * @type Int * @property */ /** * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. * * @id Titanium.UI.TableView.top * @type Float|String * @property */ /** * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) * * @id Titanium.UI.TableView.touchEnabled * @type Boolean * @property */ /** * The transformation matrix to apply to the view * * @id Titanium.UI.TableView.transform * @type Object * @property */ /** * A boolean of the visibility of the view * * @id Titanium.UI.TableView.visible * @type Boolean * @property */ /** * Property for the view width. can either be `auto`, a float value or a string of the width. * * @id Titanium.UI.TableView.width * @type Float|String * @property */ /** * The z index position relative to other sibling views * * @id Titanium.UI.TableView.zIndex * @type Int * @property */ /** * The audiorecorder object is returned by titanium.media.createaudiorecorder and is used for recording audio from the device microphone. Platforms: Iphone|Ipad * * @id Titanium.Media.AudioRecorder * @type * @since 0.9 */ /** * Add an event listener for the instance to receive view triggered events * * @id Titanium.Media.AudioRecorder.addEventListener * @param {String} name name of the event * @param {Function} callback callback function to invoke when the event is fired * @type Void */ /** * Fire a synthesized event to the views listener * * @id Titanium.Media.AudioRecorder.fireEvent * @param {String} name name of the event * @param {Object} event event object * @type Void */ /** * Called to temporarily pause recording * * @id Titanium.Media.AudioRecorder.pause * @type Void */ /** * Remove a previously added event listener * * @id Titanium.Media.AudioRecorder.removeEventListener * @param {String} name name of the event * @param {Function} callback callback function passed in addEventListener * @type Void */ /** * Called to resume audio recording * * @id Titanium.Media.AudioRecorder.resume * @type Void */ /** * Called to start recording audio * * @id Titanium.Media.AudioRecorder.start * @type Void */ /** * Called to stop recording audio * * @id Titanium.Media.AudioRecorder.stop * @type Void */ /** * The default audio session mode to be used for this recorder. one of titanium.media.audio_session_mode_ambient, titanium.media.audio_session_mode_solo_ambient titanium.media.audio_session_mode_playback titanium.media.audio_session_mode_record, titanium.media.audio_session_mode_play_and_record. * * @id Titanium.Media.AudioRecorder.audioSessionMode * @type Int * @property */ /** * Audio compression constant to be used for the recording * * @id Titanium.Media.AudioRecorder.compression * @type Int * @property */ /** * Audio format constant for used for the recording * * @id Titanium.Media.AudioRecorder.format * @type Int * @property */ /** * Readonly property to indicate if paused * * @id Titanium.Media.AudioRecorder.paused * @type Boolean * @property */ /** * Readonly property to indicate if recording * * @id Titanium.Media.AudioRecorder.recording * @type Boolean * @property */ /** * Readonly property to indicate if stopped * * @id Titanium.Media.AudioRecorder.stopped * @type Boolean * @property */ /** * The app properties module is used for storing application related property/value pairs which persist beyond application sessions. Platforms: Iphone|Android|Ipad * * @code * store a property: *

In this example, we store a string property:

* 
Titanium.App.Properties.setString("my_prop","cool");
 *
* enumerate over saved properties: *

In this example, we print out all the saved properties to the console:

* 
var props = Titanium.App.Properties.listProperties();
 * for (var c=0;cCreate a label with a nice text shadow, 48px font that's aligned center and height auto.

 * 
var l2 = Titanium.UI.createLabel({
 *     text:'Appcelerator',
 *     height:'auto',
 *     width:'auto',
 *     shadowColor:'#aaa',
 *     shadowOffset:{x:5,y:5},
 *     color:'#900',
 *     font:{fontSize:48},
 *     textAlign:'center'
 * });
 * 

 * @id Titanium.UI.Label
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.Label.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.Label.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.Label.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.Label.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.Label.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.Label.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.Label.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.Label.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.Label.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.Label.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.Label.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.Label.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.Label.backgroundGradient
 * @type Object
 * @property
 */

/**
 * Background image for the label 
 *
 * @id Titanium.UI.Label.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.Label.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * The number of pixels to extend the background image past the label on the bottom 
 *
 * @id Titanium.UI.Label.backgroundPaddingBottom
 * @type Int
 * @property
 */

/**
 * The number of pixels to extend the background image past the label on the left 
 *
 * @id Titanium.UI.Label.backgroundPaddingLeft
 * @type Int
 * @property
 */

/**
 * The number of pixels to extend the background image past the label on the right 
 *
 * @id Titanium.UI.Label.backgroundPaddingRight
 * @type Int
 * @property
 */

/**
 * The number of pixels to extend the background image past the label on the top 
 *
 * @id Titanium.UI.Label.backgroundPaddingTop
 * @type Int
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.Label.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.Label.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.Label.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.Label.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Label.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.Label.center
 * @type Object
 * @property
 */

/**
 * The color of the label 
 *
 * @id Titanium.UI.Label.color
 * @type String
 * @property
 */

/**
 * The label font object properties 
 *
 * @id Titanium.UI.Label.font
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.Label.height
 * @type Float|String
 * @property
 */

/**
 * The color of the label when in the highlighted state 
 *
 * @id Titanium.UI.Label.highlightedColor
 * @type String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Label.left
 * @type Float|String
 * @property
 */

/**
 * The minimum size of the font when the font is sized based on the contents.  enables font scaling to fit and forces the label content to be limited to a single line 
 *
 * @id Titanium.UI.Label.minimumFontSize
 * @type Int
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.Label.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Label.right
 * @type Float|String
 * @property
 */

/**
 * The text shadow color 
 *
 * @id Titanium.UI.Label.shadowColor
 * @type String
 * @property
 */

/**
 * The shadow offset as a dictionary with the properties x and y 
 *
 * @id Titanium.UI.Label.shadowOffset
 * @type Object
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.Label.size
 * @type Object
 * @property
 */

/**
 * The text of the label 
 *
 * @id Titanium.UI.Label.text
 * @type String
 * @property
 */

/**
 * The alignment constant or string value such as left, center or right 
 *
 * @id Titanium.UI.Label.textAlign
 * @type String|Int
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Label.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.Label.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.Label.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.Label.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.Label.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.Label.zIndex
 * @type Int
 * @property
 */

/**
 * The menu that appears at the lower portion of the display when the device's menu button is pressed. Platforms: Android
 *
 * @code
 * Menu:
 * 
var menu = Titanium.UI.Android.OptionMenu.createMenu();
 * 
 * var item1 = Titanium.UI.Android.OptionMenu.createMenuItem({
 *     title : 'Item 1',
 *     icon : '/images/item1.png'
 * });
 * 
 * item1.addEventListener('click', function(){
 *     Ti.UI.createAlertDialog({ title : 'You clicked Item 1'}).show();
 * });
 * 
 * var item2 = Titanium.UI.Android.OptionMenu.createMenuItem({
 *     title : 'Refresh',
 *     icon : '/images/refresh.png'
 * });
 * item2.addEventListener('click', function(){
 *     Ti.UI.createAlertDialog({ title : 'You clicked Refresh'}).show();
 * });
 * 
 * menu.add(item1);
 * menu.add(item2);
 * 
 * // Set the menu on the current heavyweight window. A heavyweight window maps to an Android
 * // Activity. To create a heavyweight window, specify one or more of [**fullscreen**,**navBarHidden**,**modal**] to createWindow.
 * 
 * Titanium.UI.Android.OptionMenu.setMenu(menu);
 * 

 * @id Titanium.UI.Android.OptionMenu
 * @type Object
 * @since 1.1
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.Android.OptionMenu.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Create and return an instance of titanium.ui.android.optionmenu.menu 
 *
 * @id Titanium.UI.Android.OptionMenu.createMenu
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.Android.OptionMenu.Menu
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.android.optionmenu.menuitem 
 *
 * @id Titanium.UI.Android.OptionMenu.createMenuItem
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.Android.OptionMenu.MenuItem
 * @type Object
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.Android.OptionMenu.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.Android.OptionMenu.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * The titanium.ui.android.optionmenu.menu for this context. 
 *
 * @id Titanium.UI.Android.OptionMenu.menu
 * @type Object
 * @property
 */

/**
 * A set of constants for the system icon styles that can be used on a tab group tab. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.iPhone.SystemIcon
 * @type 
 * @since 0.8
 */

/**
 * Bookmark style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.BOOKMARKS
 * @type Int
 * @property
 */

/**
 * Contacts style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.CONTACTS
 * @type Int
 * @property
 */

/**
 * Downloads style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.DOWNLOADS
 * @type Int
 * @property
 */

/**
 * Favorites style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.FAVORITES
 * @type Int
 * @property
 */

/**
 * Featured style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.FEATURED
 * @type Int
 * @property
 */

/**
 * History style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.HISTORY
 * @type Int
 * @property
 */

/**
 * More style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.MORE
 * @type Int
 * @property
 */

/**
 * Most recent style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.MOST_RECENT
 * @type Int
 * @property
 */

/**
 * Most viewed style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.MOST_VIEWED
 * @type Int
 * @property
 */

/**
 * Recents style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.RECENTS
 * @type Int
 * @property
 */

/**
 * Search style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.SEARCH
 * @type Int
 * @property
 */

/**
 * Top rated style icon 
 *
 * @id Titanium.UI.iPhone.SystemIcon.TOP_RATED
 * @type Int
 * @property
 */

/**
 * The ipad specific ui capabilities.  all properties, methods and events in this namespace will only work on the apple ipad related devices.  to develop for ipad, you will need the apple iphone sdk 3.2 or later and titanium mobile sdk 1.2 or later. 
 * for ipad ui programming guidelines, please review the ipad human interface guidelines.  Platforms: Ipad
 *
 * @id Titanium.UI.iPad
 * @type Object
 * @since 1.2
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.iPad.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Create and return an instance of titanium.ui.ipad.popover 
 *
 * @id Titanium.UI.iPad.createPopover
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.iPad.Popover
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.ipad.splitwindow 
 *
 * @id Titanium.UI.iPad.createSplitWindow
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.iPad.SplitWindow
 * @type Object
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.iPad.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.iPad.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * An arrow that points in any direction. 
 *
 * @id Titanium.UI.iPad.POPOVER_ARROW_DIRECTION_ANY
 * @type Int
 * @property
 */

/**
 * An arrow that points downward. 
 *
 * @id Titanium.UI.iPad.POPOVER_ARROW_DIRECTION_DOWN
 * @type Int
 * @property
 */

/**
 * An arrow that points toward the left. 
 *
 * @id Titanium.UI.iPad.POPOVER_ARROW_DIRECTION_LEFT
 * @type Int
 * @property
 */

/**
 * An arrow that points toward the right. 
 *
 * @id Titanium.UI.iPad.POPOVER_ARROW_DIRECTION_RIGHT
 * @type Int
 * @property
 */

/**
 * The status of the arrow is currently unknown. 
 *
 * @id Titanium.UI.iPad.POPOVER_ARROW_DIRECTION_UNKNOWN
 * @type Int
 * @property
 */

/**
 * An arrow that points upward. 
 *
 * @id Titanium.UI.iPad.POPOVER_ARROW_DIRECTION_UP
 * @type Int
 * @property
 */

/**
 * A button bar is created by the method titanium.ui.createbuttonbar. Platforms: Iphone|Ipad
 *
 * @code
 * Simple 3 button button bar:
 * 
var bb1 = Titanium.UI.createButtonBar({
 *     labels:['One', 'Two', 'Three'],
 *     backgroundColor:'#336699',
 *     top:50,
 *     style:Titanium.UI.iPhone.SystemButtonStyle.BAR,
 *     height:25,
 *     width:200
 * });
 * win.add(bb1);
 * 

 * @id Titanium.UI.ButtonBar
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.ButtonBar.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.ButtonBar.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.ButtonBar.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.ButtonBar.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.ButtonBar.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.ButtonBar.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.ButtonBar.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.ButtonBar.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.ButtonBar.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.ButtonBar.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.ButtonBar.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the button bar 
 *
 * @id Titanium.UI.ButtonBar.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.ButtonBar.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.ButtonBar.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.ButtonBar.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.ButtonBar.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.ButtonBar.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.ButtonBar.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.ButtonBar.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ButtonBar.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.ButtonBar.center
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.ButtonBar.height
 * @type Float|String
 * @property
 */

/**
 * The selected index 
 *
 * @id Titanium.UI.ButtonBar.index
 * @type Int
 * @property
 */

/**
 * The array of labels for the button bar. each object should have the properties title, image, width and enabled. 
 *
 * @id Titanium.UI.ButtonBar.labels
 * @type Array
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ButtonBar.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.ButtonBar.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ButtonBar.right
 * @type Float|String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.ButtonBar.size
 * @type Object
 * @property
 */

/**
 * The style of the button bar 
 *
 * @id Titanium.UI.ButtonBar.style
 * @type Int
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ButtonBar.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.ButtonBar.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.ButtonBar.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.ButtonBar.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.ButtonBar.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.ButtonBar.zIndex
 * @type Int
 * @property
 */

/**
 * The option dialog is created by titanium.ui.createoptiondialog and allows you to show a modal dialog of one or more options to the user. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Simple Options Dialog with 2 Options:
 * 
In this example, we show a simple option dialog.

 * 
var dialog = Titanium.UI.createOptionDialog({
 *     title: 'Hello',
 *     options: ['Option 1','Option 2'],
 *     cancel:1
 * });
 * dialog.show();
 * 

 * @id Titanium.UI.OptionDialog
 * @type 
 * @since 0.8
 */

/**
 * Cause the dialog to become visible 
 *
 * @id Titanium.UI.OptionDialog.show
 * @type Void
 */

/**
 * An index to indicate which button should be the cancel button 
 *
 * @id Titanium.UI.OptionDialog.cancel
 * @type Int
 * @property
 */

/**
 * The destructive button (indicated by a visual clue in the ui) 
 *
 * @id Titanium.UI.OptionDialog.destructive
 * @type Int
 * @property
 */

/**
 * Array of button names as strings 
 *
 * @id Titanium.UI.OptionDialog.options
 * @type Array
 * @property
 */

/**
 * The title of the dialog 
 *
 * @id Titanium.UI.OptionDialog.title
 * @type String
 * @property
 */

/**
 * A set of constants for the animation styles used for transitions. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.iPhone.AnimationStyle
 * @type 
 * @since 0.9
 */

/**
 * Curl downwards during a transition animation 
 *
 * @id Titanium.UI.iPhone.AnimationStyle.CURL_DOWN
 * @type Int
 * @property
 */

/**
 * Curl upwards during a transition animation 
 *
 * @id Titanium.UI.iPhone.AnimationStyle.CURL_UP
 * @type Int
 * @property
 */

/**
 * Flip from left to right during a transition animation 
 *
 * @id Titanium.UI.iPhone.AnimationStyle.FLIP_FROM_LEFT
 * @type Int
 * @property
 */

/**
 * Flip from right to left during a transition animation 
 *
 * @id Titanium.UI.iPhone.AnimationStyle.FLIP_FROM_RIGHT
 * @type Int
 * @property
 */

/**
 * No animation 
 *
 * @id Titanium.UI.iPhone.AnimationStyle.NONE
 * @type Int
 * @property
 */

/**
 * The window is an empty drawing surface or container. the window is created by the method titanium.ui.createwindow. unlike views, windows can be opened and closed and can have special display properties such as fullscreen or modal. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Full Screen Window example:
 * 
Create a fullscreen window with a red background.

 * 
var window = Titanium.UI.createWindow({
 *    backgroundColor:'red'
 * });
 * window.open({fullscreen:true});
 * 

 * @id Titanium.UI.Window
 * @type 
 * @since 0.9
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.Window.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.Window.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.Window.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Close the window 
 *
 * @id Titanium.UI.Window.close
 * @param {Object} options close the window with optional animation or display properties
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.Window.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.Window.hide
 * @type Void
 */

/**
 * Open the window 
 *
 * @id Titanium.UI.Window.open
 * @param {Object} options open the window with optional animation or display properties
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.Window.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.Window.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.Window.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.Window.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.Window.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.Window.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * Title for the back button. only available in iphone. this is only valid when the window is a child of a tab. 
 *
 * @id Titanium.UI.Window.backButtonTitle
 * @type String
 * @property
 */

/**
 * Url to an image to show as the back button.  only available in iphone. this is only valid when the window is a child of a tab. 
 *
 * @id Titanium.UI.Window.backButtonTitleImage
 * @type String
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.Window.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.Window.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.Window.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.Window.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.Window.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * Web named color or hex value for the color of the nav bar. only available in iphone. 
 *
 * @id Titanium.UI.Window.barColor
 * @type String
 * @property
 */

/**
 * Url to a local image to place as the background of the nav bar. only available in iphone. 
 *
 * @id Titanium.UI.Window.barImage
 * @type String
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.Window.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.Window.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.Window.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Window.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.Window.center
 * @type Object
 * @property
 */

/**
 * (android only.) boolean indicates if the application should exit when the android back button is pressed while the window is being shown.  you can only set this as a createwindow({...}) option.  setting it after window creation will no effect. 
 *
 * @id Titanium.UI.Window.exitOnClose
 * @type Boolean
 * @property
 */

/**
 * Boolean indicates if the window is fullscreen (no device chrome) 
 *
 * @id Titanium.UI.Window.fullscreen
 * @type Boolean
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.Window.height
 * @type Float|String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Window.left
 * @type Float|String
 * @property
 */

/**
 * View to show in the left nav bar area. only available in iphone. 
 *
 * @id Titanium.UI.Window.leftNavButton
 * @type Object
 * @property
 */

/**
 * Boolean to indicate if the window should be opened modal in front of other windows 
 *
 * @id Titanium.UI.Window.modal
 * @type Boolean
 * @property
 */

/**
 * For modal windows, hide the nav bar (true) or show the nav bar (false, default). 
 *
 * @id Titanium.UI.Window.navBarHidden
 * @type Boolean
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.Window.opacity
 * @type Float
 * @property
 */

/**
 * Array of orientation mode constants defined in [titanium.ui] 
 *
 * @id Titanium.UI.Window.orientationModes
 * @type Array
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Window.right
 * @type Float|String
 * @property
 */

/**
 * View to show in the right nav bar area. only available in iphone. 
 *
 * @id Titanium.UI.Window.rightNavButton
 * @type Object
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.Window.size
 * @type Object
 * @property
 */

/**
 * Boolean to indicate if the tab bar should be hidden. this is only valid when the window is a child of a tab. 
 *
 * @id Titanium.UI.Window.tabBarHidden
 * @type Boolean
 * @property
 */

/**
 * Title of the window. 
 *
 * @id Titanium.UI.Window.title
 * @type String
 * @property
 */

/**
 * View to show in the title area. only available in iphone. 
 *
 * @id Titanium.UI.Window.titleControl
 * @type Object
 * @property
 */

/**
 * Url to a image that show in the title area. only available in iphone. 
 *
 * @id Titanium.UI.Window.titleImage
 * @type String
 * @property
 */

/**
 * Title prompt for the window. only available in iphone. 
 *
 * @id Titanium.UI.Window.titlePrompt
 * @type String
 * @property
 */

/**
 * Array of button objects to show in the toolbar of the window. only available in iphone. this is only valid when the window is a child of a tab. 
 *
 * @id Titanium.UI.Window.toolbar
 * @type Array
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Window.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.Window.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.Window.transform
 * @type Object
 * @property
 */

/**
 * Boolean to indicate if the nav bar is translucent. only available in iphone. 
 *
 * @id Titanium.UI.Window.translucent
 * @type Boolean
 * @property
 */

/**
 * Url to a javascript file with the windows instructions. this window will create a new javascript sub-context that will run in its own thread and global variable space. 
 *
 * @id Titanium.UI.Window.url
 * @type String
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.Window.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.Window.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.Window.zIndex
 * @type Int
 * @property
 */

/**
 * The 2dmatrix is created by titanium.ui.create2dmatrix.  the 2d matrix is an object for holding values for an affine transformation matrix. a 2d matrix is used to rotate, scale, translate, or skew the objects in a three-dimensional space. a 3d matrix is represented by a 4 by 4 matrix. because the forth column is always (0,0,1), the data structure contains values for only the first three columns. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.UI.3DMatrix
 * @type 
 * @since 0.9
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.3DMatrix.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.3DMatrix.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Returns a matrix constructed by inverting an existing matrix 
 *
 * @id Titanium.UI.3DMatrix.invert
 * @type Void
 */

/**
 * Returns a matrix constructed by combining two existing matrix. 
 *
 * @id Titanium.UI.3DMatrix.multiply
 * @param {Object} t2 The second matrix. This matrix is concatenated to the matrix instance against which the function is invoked. The result of this function is the first matrix multiplied by the second matrix. You might perform several multiplications in order to create a single matrix that contains the cumulative effects of several transformations. Note that matrix operations are not commutative - the order in which you concatenate matrices is important. That is, the result of multiplying matrix t1 by matrix t2 does not necessarily equal the result of multiplying matrix t2 by matrix t1.
 * @type Object
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.3DMatrix.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Returns a matrix constructed by rotating an existing matrix 
 *
 * @id Titanium.UI.3DMatrix.rotate
 * @param {Float} angle The angle, in degrees, by which to rotate the matrix. A positive value specifies counterclockwise rotation and a negative value specifies clockwise rotation.
 * @param {Float} x The x part of the vector about which to rotate
 * @param {Float} y The y part of the vector about which to rotate
 * @param {Float} z The z part of the vector about which to rotate
 * @type Object
 */

/**
 * Returns a matrix constructed by scaling an existing matrix 
 *
 * @id Titanium.UI.3DMatrix.scale
 * @param {Float} sx The value by which to scale x values of the matrix
 * @param {Float} sy The value by which to scale y values of the matrix
 * @param {Float} sz The value by which to scale z values of the matrix
 * @type Object
 */

/**
 * Returns a matrix constructed by translating an existing matrix 
 *
 * @id Titanium.UI.3DMatrix.translate
 * @param {Float} tx The value by which to move x values with the matrix
 * @param {Float} ty The value by which to move y values with the matrix
 * @param {Float} tz The value by which to move z values with the matrix
 * @type Object
 */

/**
 * The entry at position [1,1] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m11
 * @type Float
 * @property
 */

/**
 * The entry at position [1,2] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m12
 * @type Float
 * @property
 */

/**
 * The entry at position [1,3] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m13
 * @type Float
 * @property
 */

/**
 * The entry at position [1,4] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m14
 * @type Float
 * @property
 */

/**
 * The entry at position [2,1] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m21
 * @type Float
 * @property
 */

/**
 * The entry at position [2,2] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m22
 * @type Float
 * @property
 */

/**
 * The entry at position [2,3] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m23
 * @type Float
 * @property
 */

/**
 * The entry at position [2,4] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m24
 * @type Float
 * @property
 */

/**
 * The entry at position [3,1] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m31
 * @type Float
 * @property
 */

/**
 * The entry at position [3,2] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m32
 * @type Float
 * @property
 */

/**
 * The entry at position [3,3] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m33
 * @type Float
 * @property
 */

/**
 * The entry at position [3,4] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m34
 * @type Float
 * @property
 */

/**
 * The entry at position [4,1] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m41
 * @type Float
 * @property
 */

/**
 * The entry at position [4,2] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m42
 * @type Float
 * @property
 */

/**
 * The entry at position [4,3] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m43
 * @type Float
 * @property
 */

/**
 * The entry at position [4,4] in the matrix. 
 *
 * @id Titanium.UI.3DMatrix.m44
 * @type Float
 * @property
 */

/**
 * An annotation object that is created by the method titanium.map.createannotation. this object gives you low level control over annotations that can be added to a map view. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.Map.Annotation
 * @type 
 * @since 0.9
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Map.Annotation.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Map.Annotation.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Map.Annotation.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Boolean to indicate whether the pin should animate when dropped 
 *
 * @id Titanium.Map.Annotation.animate
 * @type Boolean
 * @property
 */

/**
 * Image view for the pin instead of default image.  currently only supported in iphone 
 *
 * @id Titanium.Map.Annotation.image
 * @type String
 * @property
 */

/**
 * The left button image on the annotation. must either be a button type constant or url 
 *
 * @id Titanium.Map.Annotation.leftButton
 * @type Int|String
 * @property
 */

/**
 * A left view that is displayed on the annotation 
 *
 * @id Titanium.Map.Annotation.leftView
 * @type Object
 * @property
 */

/**
 * The pin color as one of titanium.map.annotation_red, titanium.map.annotation_green or titanium.map.annotation_purple. 
 *
 * @id Titanium.Map.Annotation.pincolor
 * @type Int
 * @property
 */

/**
 * The right button image on the annotation. must either be a button type constant or url 
 *
 * @id Titanium.Map.Annotation.rightButton
 * @type Int|String
 * @property
 */

/**
 * A right view that is displayed on the annotation 
 *
 * @id Titanium.Map.Annotation.rightView
 * @type Object
 * @property
 */

/**
 * The secondary title of the annotation view 
 *
 * @id Titanium.Map.Annotation.subtitle
 * @type String
 * @property
 */

/**
 * The primary title of the annotation view 
 *
 * @id Titanium.Map.Annotation.title
 * @type String
 * @property
 */

/**
 * The login button created by titanium.facebook.createloginbutton. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.Facebook.LoginButton
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.Facebook.LoginButton.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Facebook.LoginButton.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.Facebook.LoginButton.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Facebook.LoginButton.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.Facebook.LoginButton.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.Facebook.LoginButton.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Facebook.LoginButton.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.Facebook.LoginButton.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.Facebook.LoginButton.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.Facebook.LoginButton.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.Facebook.LoginButton.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.Facebook.LoginButton.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.Facebook.LoginButton.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.Facebook.LoginButton.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.Facebook.LoginButton.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.Facebook.LoginButton.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.Facebook.LoginButton.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.Facebook.LoginButton.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.Facebook.LoginButton.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.Facebook.LoginButton.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.Facebook.LoginButton.center
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.Facebook.LoginButton.height
 * @type Float|String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.Facebook.LoginButton.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.Facebook.LoginButton.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.Facebook.LoginButton.right
 * @type Float|String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.Facebook.LoginButton.size
 * @type Object
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.Facebook.LoginButton.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.Facebook.LoginButton.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.Facebook.LoginButton.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.Facebook.LoginButton.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.Facebook.LoginButton.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.Facebook.LoginButton.zIndex
 * @type Int
 * @property
 */

/**
 * An image view is used to display an image or a series of images in an animation. the image view is created by the method titanium.ui.createimageview. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Basic Image View:
 * 
In this example, we create a simple image view:

 * 
var image = Titanium.UI.createImageView({url:'myimage.png'});
 * view.add(image);
 * 

 * @id Titanium.UI.ImageView
 * @type 
 * @since 0.9
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.ImageView.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.ImageView.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.ImageView.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.ImageView.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.ImageView.hide
 * @type Void
 */

/**
 * Pause a started animation. 
 *
 * @id Titanium.UI.ImageView.pause
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.ImageView.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.ImageView.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.ImageView.show
 * @type Void
 */

/**
 * Start the image animation. this method only works if you set multiple images 
 *
 * @id Titanium.UI.ImageView.start
 * @type Void
 */

/**
 * Stop a started animation and reset the index to the first image 
 *
 * @id Titanium.UI.ImageView.stop
 * @type Void
 */

/**
 * Return the image as a blob object 
 *
 * @id Titanium.UI.ImageView.toBlob
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.ImageView.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.ImageView.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.ImageView.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * Readonly boolean to indicate if the animation is animating 
 *
 * @id Titanium.UI.ImageView.animating
 * @type Boolean
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.ImageView.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.ImageView.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.ImageView.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.ImageView.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.ImageView.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.ImageView.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.ImageView.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.ImageView.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ImageView.bottom
 * @type Float|String
 * @property
 */

/**
 * Allow image to scale (android) 
 *
 * @id Titanium.UI.ImageView.canScale
 * @type Boolean
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.ImageView.center
 * @type Object
 * @property
 */

/**
 * Url to the default image to display while loading a remote image 
 *
 * @id Titanium.UI.ImageView.defaultImage
 * @type String
 * @property
 */

/**
 * Amount of time in milliseconds to animate one cycle 
 *
 * @id Titanium.UI.ImageView.duration
 * @type Float
 * @property
 */

/**
 * Enable zoom controls on android. default is true for backward compatibility. (1.3.0) 
 *
 * @id Titanium.UI.ImageView.enableZoomControls
 * @type Boolean
 * @property
 */

/**
 * Height of the image display 
 *
 * @id Titanium.UI.ImageView.height
 * @type Float
 * @property
 */

/**
 * Image to display either as string url, blob or file 
 *
 * @id Titanium.UI.ImageView.image
 * @type Object
 * @property
 */

/**
 * Array of images (either as string url, blob or file) to display in an animation 
 *
 * @id Titanium.UI.ImageView.images
 * @type Array
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ImageView.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.ImageView.opacity
 * @type Float
 * @property
 */

/**
 * Readonly boolean to indicate if the animation is paused 
 *
 * @id Titanium.UI.ImageView.paused
 * @type Boolean
 * @property
 */

/**
 * Boolean to indicate if the default image should be displaying while loading a remote image 
 *
 * @id Titanium.UI.ImageView.preventDefaultImage
 * @type Boolean
 * @property
 */

/**
 * Number of times to repeat the image animation 
 *
 * @id Titanium.UI.ImageView.repeatCount
 * @type Int
 * @property
 */

/**
 * Boolean to indicate if the animation should happen in reverse (from last to first) 
 *
 * @id Titanium.UI.ImageView.reverse
 * @type Boolean
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ImageView.right
 * @type Float|String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.ImageView.size
 * @type Object
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ImageView.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.ImageView.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.ImageView.transform
 * @type Object
 * @property
 */

/**
 * Url to the image to display (note: this property is deprecated. use image instead) 
 *
 * @id Titanium.UI.ImageView.url
 * @type String
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.ImageView.visible
 * @type Boolean
 * @property
 */

/**
 * Width of the image display 
 *
 * @id Titanium.UI.ImageView.width
 * @type Float
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.ImageView.zIndex
 * @type Int
 * @property
 */

/**
 * The domdocument returned from titanium.xml.parsestring. the result is an object that implementes the dom level 2 api. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.XML.DOMDocument
 * @type 
 * @since 0.9
 */

/**
 * A popover is used to manage the presentation of content in a popover. you use popovers to present information temporarily but in a way that does not take over the entire screen like a modal view does. the popover content is layered on top of your existing content in a special type of window. the popover remains visible until the user taps outside of the popover window or you explicitly dismiss it. the popover is created by the method titanium.ui.ipad.createpopover.
 *  Platforms: Ipad
 *
 * @code
 * Simple Popover:
 * 
In this example, we create a simple popover and position it near the button

 * 
var popover = Ti.UI.iPad.createPopover({height:100,width:100});
 * popover.add(view);
 * popover.show({view:button});
 * 

 * Popover with title and nav button:
 * 
In this example, we create a popover with a title and right navigation button.

 * 
var popover = Ti.UI.iPad.createPopover({ 
 *     width:250, 
 *     height:100,
 *     title: "Yo Yo",
 *     rightNavButton:button
 * });
 * 

 * @id Titanium.UI.iPad.Popover
 * @type 
 * @since 1.2
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.iPad.Popover.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.iPad.Popover.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.iPad.Popover.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.iPad.Popover.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the popover 
 *
 * @id Titanium.UI.iPad.Popover.hide
 * @param {Object} options dictionary with optional boolean property animated which indicates if the popover should be hidden with animation (defaults to true) or not
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.iPad.Popover.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.iPad.Popover.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Change the height of the popover 
 *
 * @id Titanium.UI.iPad.Popover.setHeight
 * @param {Int,string} height height of the popover
 * @type Void
 */

/**
 * Change the width of the popover 
 *
 * @id Titanium.UI.iPad.Popover.setWidth
 * @param {Int,string} width width of the popover
 * @type Void
 */

/**
 * Show the popover 
 *
 * @id Titanium.UI.iPad.Popover.show
 * @param {Object} options dictionary of the following properties: rect, animated and view. The view property should specify the view relative to where the popover should display. animated is a boolean indicating if the showing of the popover should be animated, defaults to true. The property rect is a dictionary with the following properties: x, y, width and height, where the rectangle in view at which to anchor the popover.
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.iPad.Popover.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.iPad.Popover.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.iPad.Popover.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * Return the arrow direction of the popover 
 *
 * @id Titanium.UI.iPad.Popover.arrowDirection
 * @type Int
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.iPad.Popover.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.iPad.Popover.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.iPad.Popover.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.iPad.Popover.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.iPad.Popover.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.iPad.Popover.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.iPad.Popover.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.iPad.Popover.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iPad.Popover.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.iPad.Popover.center
 * @type Object
 * @property
 */

/**
 * Height of the popover 
 *
 * @id Titanium.UI.iPad.Popover.height
 * @type Float
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iPad.Popover.left
 * @type Float|String
 * @property
 */

/**
 * The left button in the nav area of the popover 
 *
 * @id Titanium.UI.iPad.Popover.leftNavButton
 * @type Object
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.iPad.Popover.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iPad.Popover.right
 * @type Float|String
 * @property
 */

/**
 * The right button in the nav area of the popover 
 *
 * @id Titanium.UI.iPad.Popover.rightNavButton
 * @type Object
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.iPad.Popover.size
 * @type Object
 * @property
 */

/**
 * The title of the nav area of the popover 
 *
 * @id Titanium.UI.iPad.Popover.title
 * @type String
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iPad.Popover.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.iPad.Popover.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.iPad.Popover.transform
 * @type Object
 * @property
 */

/**
 * Boolean to indicate if the popover is visible 
 *
 * @id Titanium.UI.iPad.Popover.visible
 * @type Boolean
 * @property
 */

/**
 * Width of the popover 
 *
 * @id Titanium.UI.iPad.Popover.width
 * @type Float
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.iPad.Popover.zIndex
 * @type Int
 * @property
 */

/**
 * A text area is created by the method titanium.ui.createtextarea. the text area is a multiline field. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Basic Text Area with Customizations:
 * 
This example created a highly customized text area.

 * 
var ta1 = Titanium.UI.createTextArea({
 *     value:'I am a textarea',
 *     height:70,
 *     width:300,
 *     top:60,
 *     font:{fontSize:20,fontFamily:'Marker Felt', fontWeight:'bold'},
 *     color:'#888',
 *     textAlign:'left',
 *     appearance:Titanium.UI.KEYBOARD_APPEARANCE_ALERT,   
 *     keyboardType:Titanium.UI.KEYBOARD_NUMBERS_PUNCTUATION,
 *     returnKeyType:Titanium.UI.RETURNKEY_EMERGENCY_CALL,
 *     borderWidth:2,
 *     borderColor:'#bbb',
 *     borderRadius:5
 * });
 * 

 * @id Titanium.UI.TextArea
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.TextArea.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.TextArea.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.TextArea.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Force the field to lose focus 
 *
 * @id Titanium.UI.TextArea.blur
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.TextArea.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Force the field to gain focus 
 *
 * @id Titanium.UI.TextArea.focus
 * @type Void
 */

/**
 * Return boolean (true) if the field has text 
 *
 * @id Titanium.UI.TextArea.hasText
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.TextArea.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.TextArea.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.TextArea.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.TextArea.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.TextArea.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.TextArea.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.TextArea.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * Value of the background color of the field 
 *
 * @id Titanium.UI.TextArea.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.TextArea.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.TextArea.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.TextArea.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.TextArea.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.TextArea.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.TextArea.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.TextArea.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TextArea.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.TextArea.center
 * @type Object
 * @property
 */

/**
 * Boolean indicating if the field is editable 
 *
 * @id Titanium.UI.TextArea.editable
 * @type Boolean
 * @property
 */

/**
 * Boolean indicating the enabled state of the field 
 *
 * @id Titanium.UI.TextArea.enabled
 * @type Boolean
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.TextArea.height
 * @type Float|String
 * @property
 */

/**
 * Array of toolbar button objects to be used when the keyboard is displayed 
 *
 * @id Titanium.UI.TextArea.keyboardToolbar
 * @type Array
 * @property
 */

/**
 * The color of the keyboard toolbar 
 *
 * @id Titanium.UI.TextArea.keyboardToolbarColor
 * @type String
 * @property
 */

/**
 * The height of the keyboard toolbar 
 *
 * @id Titanium.UI.TextArea.keyboardToolbarHeight
 * @type Float
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TextArea.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.TextArea.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TextArea.right
 * @type Float|String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.TextArea.size
 * @type Object
 * @property
 */

/**
 * Boolean to indicate if the return key should be suppressed during entry 
 *
 * @id Titanium.UI.TextArea.suppressReturn
 * @type Boolean
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TextArea.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.TextArea.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.TextArea.transform
 * @type Object
 * @property
 */

/**
 * Value of the field 
 *
 * @id Titanium.UI.TextArea.value
 * @type String
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.TextArea.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.TextArea.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.TextArea.zIndex
 * @type Int
 * @property
 */

/**
 * The top level app module.  the app module is mainly used for accessing information about the application at runtime. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.App
 * @type Object
 * @since 0.1
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.App.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Fire a cross-context application event.  listeners in any javascript context can receive these events if they have added themselves as a listener with the event name.  note: you can only pass json serializable data in the data payload of the event object since the data must be transportable between contexts. 
 *
 * @id Titanium.App.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @param {String} name the event name
 * @param {Object} data optional data payload for the event. NOTE: you can only pass JSON serializable data since the data must be transportable between contexts.
 * @type Void
 */

/**
 * Return the arguments passed to the application on startup as a dictionary 
 *
 * @id Titanium.App.getArguments
 * @type Object
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.App.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * The application's copyright 
 *
 * @id Titanium.App.copyright
 * @type String
 * @property
 */

/**
 * The application's description 
 *
 * @id Titanium.App.description
 * @type String
 * @property
 */

/**
 * The application's globally unique id (this is system generated and consistent through all versions) 
 *
 * @id Titanium.App.guid
 * @type String
 * @property
 */

/**
 * The application's app id as specified in titanium developer 
 *
 * @id Titanium.App.id
 * @type String
 * @property
 */

/**
 * Property for controlling whether the phone screen will be locked on idle time. can be set to true to disable the timer 
 *
 * @id Titanium.App.idleTimerDisabled
 * @type Boolean
 * @property
 */

/**
 * The application's name 
 *
 * @id Titanium.App.name
 * @type String
 * @property
 */

/**
 * A boolean to indicate whether proximity detection is enabled 
 *
 * @id Titanium.App.proximityDetection
 * @type Boolean
 * @property
 */

/**
 * The state of the device's proximity detector 
 *
 * @id Titanium.App.proximityState
 * @type Int
 * @property
 */

/**
 * The application's publisher 
 *
 * @id Titanium.App.publisher
 * @type String
 * @property
 */

/**
 * The application url 
 *
 * @id Titanium.App.url
 * @type String
 * @property
 */

/**
 * The application's version 
 *
 * @id Titanium.App.version
 * @type String
 * @property
 */

/**
 * A tabbed bar is created by the method titanium.ui.createtabbedbar. the difference between the tabbed bar and the button bar is that the tabbed bar visually maintains a state (visually distinguished as a pressed or selected look). Platforms: Iphone|Ipad
 *
 * @code
 * Simple Tabbed Bar with 3 items:
 * 
var bb1 = Titanium.UI.createTabbedBar({
 *     labels:['One', 'Two', 'Three'],
 *     backgroundColor:'#336699',
 *     top:50,
 *     style:Titanium.UI.iPhone.SystemButtonStyle.BAR,
 *     height:25,
 *     width:200
 * });
 * win.add(bb1);
 * 

 * @id Titanium.UI.TabbedBar
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.TabbedBar.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.TabbedBar.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.TabbedBar.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.TabbedBar.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.TabbedBar.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.TabbedBar.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.TabbedBar.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.TabbedBar.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.TabbedBar.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.TabbedBar.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.TabbedBar.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the tabbed bar 
 *
 * @id Titanium.UI.TabbedBar.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.TabbedBar.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.TabbedBar.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.TabbedBar.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.TabbedBar.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.TabbedBar.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.TabbedBar.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.TabbedBar.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TabbedBar.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.TabbedBar.center
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.TabbedBar.height
 * @type Float|String
 * @property
 */

/**
 * The selected index 
 *
 * @id Titanium.UI.TabbedBar.index
 * @type Int
 * @property
 */

/**
 * The array of labels for the tabbed bar. each object should have the properties title, image, width and enabled. 
 *
 * @id Titanium.UI.TabbedBar.labels
 * @type Array
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TabbedBar.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.TabbedBar.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TabbedBar.right
 * @type Float|String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.TabbedBar.size
 * @type Object
 * @property
 */

/**
 * The style of the tabbed bar 
 *
 * @id Titanium.UI.TabbedBar.style
 * @type Int
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TabbedBar.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.TabbedBar.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.TabbedBar.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.TabbedBar.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.TabbedBar.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.TabbedBar.zIndex
 * @type Int
 * @property
 */

/**
 * The top level analytics module.  the analytics module is used for transmitting developer-defined analytics event for your application to the appcelerator analytics product. it can be used to augment additional context or application-specific information which can then be accessed during analysis using analytics. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Custom Feature Event:
 * 
This examples shows how to send a featureEvent during an application session to indicate some feature was triggered/used by the user that you would like to track.

 * 
Titanium.Analytics.featureEvent('app.feature.blah',{product:'killer'});
 * 

 * @id Titanium.Analytics
 * @type Object
 * @since 0.1
 */

/**
 * Send a generic event for the application session 
 *
 * @id Titanium.Analytics.addEvent
 * @param {String} type the event type
 * @param {String} name the event name
 * @param {Object} data event data or null if not specified. the object must be serializable as JSON
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Analytics.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Send an analytics feature event for the application session 
 *
 * @id Titanium.Analytics.featureEvent
 * @param {String} name the event name
 * @param {Object} data event data or null if not specified. the object must be serializable as JSON
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Analytics.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Send an analytics nav event for the application session 
 *
 * @id Titanium.Analytics.navEvent
 * @param {String} from the from location in the nav event
 * @param {String} to the to location in the nav event
 * @param {String} name the event name
 * @param {Object} data event data or null if not specified. the object must be serializable as JSON
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Analytics.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Send a analytics settings event for the application session 
 *
 * @id Titanium.Analytics.settingsEvent
 * @param {String} name the event name
 * @param {Object} data event data or null if not specified. the object must be serializable as JSON
 * @type Void
 */

/**
 * Send an analytics timed event for the application session 
 *
 * @id Titanium.Analytics.timedEvent
 * @param {String} name the event name
 * @param {Date} start the event start as a Date object
 * @param {Date} stop the event end as a Date object
 * @param {Float} duration the event duration
 * @param {Object} data event data or null if not specified. the object must be serializable as JSON
 * @type Void
 */

/**
 * Send an analytics user event for the application session 
 *
 * @id Titanium.Analytics.userEvent
 * @param {String} name the event name
 * @param {Object} data event data or null if not specified. the object must be serializable as JSON
 * @type Void
 */

/**
 * A tabgroup tab instance.  each tab instance maintains a stack of tab windows. only one window within in the tab can be visible at a time.  when a window is closed, either by the user or by code, the window is removed from the stack, make the previous window visible. the root tab window cannot be removed. the tab group is created by the method titanium.ui.createtab. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Simple Tab Example:
 * 
In this example, we create a simple tab and add it to a tab group.

 * 
var tab = Titanium.UI.createTab({
 *     window:mywin,
 *     title:'Hello',
 *     icon:'myicon.png'
 * });
 * tabGroup.addTab(tab);
 * 

 * @id Titanium.UI.Tab
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.Tab.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.Tab.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.Tab.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.Tab.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.Tab.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.Tab.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.Tab.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.Tab.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.Tab.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.Tab.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.Tab.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.Tab.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.Tab.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.Tab.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.Tab.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.Tab.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The badge value for the tab group for this tab. null indicates no badge is value 
 *
 * @id Titanium.UI.Tab.badge
 * @type String
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.Tab.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.Tab.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.Tab.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Tab.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.Tab.center
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.Tab.height
 * @type Float|String
 * @property
 */

/**
 * The icon url for the tab group for this tab 
 *
 * @id Titanium.UI.Tab.icon
 * @type String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Tab.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.Tab.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Tab.right
 * @type Float|String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.Tab.size
 * @type Object
 * @property
 */

/**
 * The title for the tab group for this tab 
 *
 * @id Titanium.UI.Tab.title
 * @type String
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Tab.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.Tab.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.Tab.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.Tab.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.Tab.width
 * @type Float|String
 * @property
 */

/**
 * The root level tab window.  all tabs must have at least one root level tab window. 
 *
 * @id Titanium.UI.Tab.window
 * @type Object
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.Tab.zIndex
 * @type Int
 * @property
 */

/**
 * The web view allows you to open an html5 based view which can load either local or remote content. the content can be any valid web content such as html, pdf, svg or other webkit supported content types. the web view is created by the method titanium.ui.createwebview. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Basic Web View to external URL example:
 * 
Create a web view to a remote URL and open the window as modal.

 * 
    var webview = Titanium.UI.createWebView({url:'http://www.appcelerator.com'});
 *     var window = Titanium.UI.createWindow();
 *     window.add(webview);
 *     window.open({modal:true});
 * 

 * @id Titanium.UI.WebView
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.WebView.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.WebView.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.WebView.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Returns true if the webview can go back in history 
 *
 * @id Titanium.UI.WebView.canGoBack
 * @type Boolean
 */

/**
 * Returns true if the webview can go forward in history 
 *
 * @id Titanium.UI.WebView.canGoForward
 * @type Boolean
 */

/**
 * Invoke javascript inside the context of the webview and optionally, return a result 
 *
 * @id Titanium.UI.WebView.evalJS
 * @param {String} content JavaScript code as a string. The code will be evaluated inside the webview context.
 * @type String
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.WebView.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Go back one entry in history to the previous page 
 *
 * @id Titanium.UI.WebView.goBack
 * @type Void
 */

/**
 * Go forward one entry in history to the page before the current page 
 *
 * @id Titanium.UI.WebView.goForward
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.WebView.hide
 * @type Void
 */

/**
 * Reload the current webpage 
 *
 * @id Titanium.UI.WebView.reload
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.WebView.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.WebView.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Force the webview to repaint its contents 
 *
 * @id Titanium.UI.WebView.repaint
 * @type Void
 */

/**
 * Set the basic authentication for the webview instance to be used on subsequent url requests 
 *
 * @id Titanium.UI.WebView.setBasicAuthentication
 * @param {String} username the username
 * @param {String} password the password
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.WebView.show
 * @type Void
 */

/**
 * Stop loading a currently loading page 
 *
 * @id Titanium.UI.WebView.stopLoading
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.WebView.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.WebView.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.WebView.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color for the webview 
 *
 * @id Titanium.UI.WebView.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.WebView.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.WebView.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.WebView.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.WebView.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.WebView.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.WebView.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.WebView.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.WebView.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.WebView.center
 * @type Object
 * @property
 */

/**
 * A data blob or file that is used to load the web document 
 *
 * @id Titanium.UI.WebView.data
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.WebView.height
 * @type Float|String
 * @property
 */

/**
 * The html content of the web document 
 *
 * @id Titanium.UI.WebView.html
 * @type String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.WebView.left
 * @type Float|String
 * @property
 */

/**
 * Boolean indicating if the webview is loading content 
 *
 * @id Titanium.UI.WebView.loading
 * @type Boolean
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.WebView.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.WebView.right
 * @type Float|String
 * @property
 */

/**
 * Whether the webview should scale it's contents or not 
 *
 * @id Titanium.UI.WebView.scalesPageToFit
 * @type Boolean
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.WebView.size
 * @type Object
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.WebView.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.WebView.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.WebView.transform
 * @type Object
 * @property
 */

/**
 * The url to the web document. this property will change as the content of the webview changes (such as from internal hyperlinks, etc) 
 *
 * @id Titanium.UI.WebView.url
 * @type String
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.WebView.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.WebView.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.WebView.zIndex
 * @type Int
 * @property
 */

/**
 * A tableview section object created by the method titanium.ui.createtableviewsection. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Simple Table View Section Example:
 * 
In this example, we create a section with the header Hello and add two rows to it.

 * 
var section = Titanium.UI.createTableViewSection();
 * section.headerTitle = "Hello";
 * var row1 = Titanium.UI.createTableViewRow({title:"Hello 1"});
 * var row2 = Titanium.UI.createTableViewRow({title:"Hello 2"});
 * section.add(row1);
 * section.add(row2);
 * tableview.add(section);
 * 

 * @id Titanium.UI.TableViewSection
 * @type 
 * @since 0.9
 */

/**
 * Add a row to the section 
 *
 * @id Titanium.UI.TableViewSection.add
 * @param {Object} view the view to add to this views hiearchy
 * @param {Object} row the row object to add to the section
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.TableViewSection.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.TableViewSection.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.TableViewSection.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.TableViewSection.hide
 * @type Void
 */

/**
 * Remove a remove from the section 
 *
 * @id Titanium.UI.TableViewSection.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @param {Object} row the row object to remove from the section
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.TableViewSection.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Retrieve the row object at a specific index 
 *
 * @id Titanium.UI.TableViewSection.rowAtIndex
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.TableViewSection.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.TableViewSection.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.TableViewSection.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.TableViewSection.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.TableViewSection.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.TableViewSection.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.TableViewSection.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.TableViewSection.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.TableViewSection.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.TableViewSection.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.TableViewSection.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.TableViewSection.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TableViewSection.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.TableViewSection.center
 * @type Object
 * @property
 */

/**
 * The title of the section footer 
 *
 * @id Titanium.UI.TableViewSection.footerTitle
 * @type String
 * @property
 */

/**
 * A view to use instead of the default label when rendering the section footer 
 *
 * @id Titanium.UI.TableViewSection.footerView
 * @type Object
 * @property
 */

/**
 * The title of the section header 
 *
 * @id Titanium.UI.TableViewSection.headerTitle
 * @type String
 * @property
 */

/**
 * A view to use instead of the default label when rendering the section header 
 *
 * @id Titanium.UI.TableViewSection.headerView
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.TableViewSection.height
 * @type Float|String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TableViewSection.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.TableViewSection.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TableViewSection.right
 * @type Float|String
 * @property
 */

/**
 * The (readonly) number of rows in the section 
 *
 * @id Titanium.UI.TableViewSection.rowCount
 * @type Int
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.TableViewSection.size
 * @type Object
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.TableViewSection.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.TableViewSection.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.TableViewSection.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.TableViewSection.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.TableViewSection.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.TableViewSection.zIndex
 * @type Int
 * @property
 */

/**
 * The top level accelerometer module.  the accelerometer modules contains methods and properties for using the device accelerometer. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Basic Accelerometer Event:
 * 
Adds an accelerometer update event listener which prints out the x, y and z axis as the device is moved.  You should generally remove the event when not used to conserve device resources.  If you do not have an active event listener, the accelerometer is turned off to conserve device resources.

 * 
Titanium.Accelerometer.addEventListener('update',function(e)
 * {
 *     Ti.API.debug("accelerometer - x:"+e.x+",y:"+e.y+",z:"+e.z);
 * });
 * 

 * @id Titanium.Accelerometer
 * @type Object
 * @since 0.1
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Accelerometer.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Accelerometer.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Accelerometer.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * The picker row object created by titanium.ui.createpickerrow. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Custom Views for a picker row:
 * 
Since the row object is itself a view, you can add views and widgets to it to customize the the rows display. In the example below, we create a custom label for the row.

 * 
var row = Ti.UI.createPickerRow();
 * var label = Ti.UI.createLabel({
 *     text:text,
 *     font:{fontSize:24,fontWeight:'bold'},
 *     color:text,
 *     width:'auto',
 *     height:'auto'
 * });
 * row.add(label);
 * picker.add(row);
 * 

 * @id Titanium.UI.PickerRow
 * @type 
 * @since 0.9
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.PickerRow.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.PickerRow.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.PickerRow.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.PickerRow.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.PickerRow.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.PickerRow.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.PickerRow.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.PickerRow.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.PickerRow.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.PickerRow.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.PickerRow.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.PickerRow.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.PickerRow.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.PickerRow.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.PickerRow.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.PickerRow.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.PickerRow.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.PickerRow.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.PickerRow.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.PickerRow.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.PickerRow.center
 * @type Object
 * @property
 */

/**
 * The font size when displaying the text. ignored when using a custom view 
 *
 * @id Titanium.UI.PickerRow.fontSize
 * @type Int
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.PickerRow.height
 * @type Float|String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.PickerRow.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.PickerRow.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.PickerRow.right
 * @type Float|String
 * @property
 */

/**
 * When used in the constructor, set the row to selected on initial display 
 *
 * @id Titanium.UI.PickerRow.selected
 * @type Boolean
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.PickerRow.size
 * @type Object
 * @property
 */

/**
 * The display text 
 *
 * @id Titanium.UI.PickerRow.title
 * @type String
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.PickerRow.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.PickerRow.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.PickerRow.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.PickerRow.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.PickerRow.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.PickerRow.zIndex
 * @type Int
 * @property
 */

/**
 * A set of constants for the style that can be used for the selectionstyle property of titanium.ui.tableviewrow. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.iPhone.TableViewCellSelectionStyle
 * @type 
 * @since 0.9
 */

/**
 * The cell when selected has a blue background. this is the default value. 
 *
 * @id Titanium.UI.iPhone.TableViewCellSelectionStyle.BLUE
 * @type Int
 * @property
 */

/**
 * Then cell when selected has a gray background. 
 *
 * @id Titanium.UI.iPhone.TableViewCellSelectionStyle.GRAY
 * @type Int
 * @property
 */

/**
 * The cell has no distinct style for when it is selected. 
 *
 * @id Titanium.UI.iPhone.TableViewCellSelectionStyle.NONE
 * @type Int
 * @property
 */

/**
 * The view is an empty drawing surface or container. the view is created by the method titanium.ui.createview. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Round View Example:
 * 
Create a rounded view.

 * 
var view = Titanium.UI.createView({
 *    borderRadius:10,
 *    backgroundColor:'red',
 *    width:50,
 *    height:50
 * });
 * window.add(view);
 * 

 * @id Titanium.UI.View
 * @type 
 * @since 0.9
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.View.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.View.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.View.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.View.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.View.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.View.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.View.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.View.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.View.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.View.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.View.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.View.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.View.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.View.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.View.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.View.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.View.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.View.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.View.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.View.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.View.center
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.View.height
 * @type Float|String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.View.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.View.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.View.right
 * @type Float|String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.View.size
 * @type Object
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.View.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.View.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.View.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.View.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.View.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.View.zIndex
 * @type Int
 * @property
 */

/**
 * The top level network module.  the network module is used accessing networking related functionality. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.Network
 * @type 
 * @since 0.1
 */

/**
 * Adds a connectivity listener to listen for network changes. this method has been deprecated in favor of listening for a change event. 
 *
 * @id Titanium.Network.addConnectivityListener
 * @param {Function} callback callback function to invoke upon network connectivity changes
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Network.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Create and return an instance of titanium.network.bonjourbrowser 
 *
 * @id Titanium.Network.createBonjourBrowser
 * @param {String} serviceType service to search for, must include the protocol type suffix (._tcp)
 * @param {String} domain the Bonjour service domain to conduct the search in. Default value is 'local.'
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.Network.BonjourBrowser
 * @type Object
 */

/**
 * Create and return an instance of titanium.network.bonjourservice 
 *
 * @id Titanium.Network.createBonjourService
 * @param {String} name the name of the service. Must be a unique identifier for this service type and domain.
 * @param {String} type the type of service. Must include the protocol identifier (._tcp)
 * @param {String} domain the domain to publish the service in. Default value is 'local.'
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.Network.BonjourService
 * @type Object
 */

/**
 * Create and return an instance of titanium.network.httpclient 
 *
 * @id Titanium.Network.createHTTPClient
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.Network.HTTPClient
 * @type Object
 */

/**
 * Create and return an instance of titanium.network.tcpsocket 
 *
 * @id Titanium.Network.createTCPSocket
 * @param {String} hostName the host name to connect to/listen on
 * @param {Int} port the port for the socket
 * @param {Int} mode the socket's mode; one of Titanium.Network.READ_MODE, Titanium.Network.WRITE_MODE, Titanium.Network.READ_WRITE_MODE
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.Network.TCPSocket
 * @type Object
 */

/**
 * Decode a uri component part using uri encoding 
 *
 * @id Titanium.Network.decodeURIComponent
 * @param {String} value input value to be decoded
 * @type String
 */

/**
 * Encode a uri component part using uri encoding 
 *
 * @id Titanium.Network.encodeURIComponent
 * @param {String} value input value to be encoded
 * @type String
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Network.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Register for push notifications with the apple push notification service. only available on iphone. 
 *
 * @id Titanium.Network.registerForPushNotifications
 * @param {Object} config dictionary of the following: types is an array of type constants that the application would like to receive, success is a callback function that is called when the push registration is successfully completed, error is a callback function that is called when an error is received during registration and callback is a callback function that is invoked upon receiving a new push notification. This method should be called at application startup.
 * @type Void
 */

/**
 * Removes a connectivity listener. this method has been deprecated in favor of listening for a change event. 
 *
 * @id Titanium.Network.removeConnectivityListener
 * @param {Function} callback callback function to remove
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Network.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Constant value representing the ability for sockets to listen on any locally available network device 
 *
 * @id Titanium.Network.INADDR_ANY
 * @type String
 * @property
 */

/**
 * Constant value to indicate that the network is lan 
 *
 * @id Titanium.Network.NETWORK_LAN
 * @type Int
 * @property
 */

/**
 * Constant value to indicate that the network is mobile 
 *
 * @id Titanium.Network.NETWORK_MOBILE
 * @type Int
 * @property
 */

/**
 * Constant value to indicate that the network is not available 
 *
 * @id Titanium.Network.NETWORK_NONE
 * @type Int
 * @property
 */

/**
 * Constant value to indicate that the network is not known 
 *
 * @id Titanium.Network.NETWORK_UNKNOWN
 * @type Int
 * @property
 */

/**
 * Constant value to indicate that the network is wifi 
 *
 * @id Titanium.Network.NETWORK_WIFI
 * @type Int
 * @property
 */

/**
 * Constant value for the push notification alert type 
 *
 * @id Titanium.Network.NOTIFICATION_TYPE_ALERT
 * @type Int
 * @property
 */

/**
 * Constant value for the push notification badge type 
 *
 * @id Titanium.Network.NOTIFICATION_TYPE_BADGE
 * @type Int
 * @property
 */

/**
 * Constant value for the push notification sound type 
 *
 * @id Titanium.Network.NOTIFICATION_TYPE_SOUND
 * @type Int
 * @property
 */

/**
 * Constant value specifying read-only mode for sockets 
 *
 * @id Titanium.Network.READ_MODE
 * @type Int
 * @property
 */

/**
 * Constant value specifying read-write mode for sockets 
 *
 * @id Titanium.Network.READ_WRITE_MODE
 * @type Int
 * @property
 */

/**
 * Constant value specifying write-only mode for sockets 
 *
 * @id Titanium.Network.WRITE_MODE
 * @type Int
 * @property
 */

/**
 * The network type value as a constant. 
 *
 * @id Titanium.Network.networkType
 * @type Int
 * @property
 */

/**
 * The network type name constant. returns one of none, wifi, lan or mobile. 
 *
 * @id Titanium.Network.networkTypeName
 * @type String
 * @property
 */

/**
 * Readonly boolean value that indicates if the network is reachable to the internet either via wifi or carrier network 
 *
 * @id Titanium.Network.online
 * @type Boolean
 * @property
 */

/**
 * The remote device uuid if the device was registered with the apple push notification service or null if not set. only available on iphone. 
 *
 * @id Titanium.Network.remoteDeviceUUID
 * @type String
 * @property
 */

/**
 * Returns an array of network type constants enabled for the application. only available on iphone. 
 *
 * @id Titanium.Network.remoteNotificationTypes
 * @type Array
 * @property
 */

/**
 * Returns true if remote notifications have been enabled. only available on iphone. 
 *
 * @id Titanium.Network.remoteNotificationsEnabled
 * @type Boolean
 * @property
 */

/**
 * The top level yahoo module.  the yahoo module is used for accessing yahoo related api services. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.Yahoo
 * @type 
 * @since 0.8
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Yahoo.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Yahoo.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Yahoo.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Invoke a yahoo yql query 
 *
 * @id Titanium.Yahoo.yql
 * @param {String} yql the YQL query to execute
 * @param {Function} callback the function to execute when the query completes. The event will contain the boolean property success if successful. If success is false, the message property will contain the error message. If success is true, the data property will contain the data payload received from the YQL.
 * @type Void
 */

/**
 * A set of constants for the styles available for titanium.ui.activityindicator objects. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.iPhone.ScrollIndicatorStyle
 * @type 
 * @since 0.9
 */

/**
 * A style of indicator which is black smaller than the default style. this style is good against a white content background. 
 *
 * @id Titanium.UI.iPhone.ScrollIndicatorStyle.BLACK
 * @type Int
 * @property
 */

/**
 * The default style of scroll indicator, which is black with a white border. this style is good against any content background. 
 *
 * @id Titanium.UI.iPhone.ScrollIndicatorStyle.DEFAULT
 * @type Int
 * @property
 */

/**
 * A style of indicator is white and smaller than the default style. this style is good against a black content background. 
 *
 * @id Titanium.UI.iPhone.ScrollIndicatorStyle.WHITE
 * @type Int
 * @property
 */

/**
 * The adview is a view for display apple iads. the view is created by the method titanium.ui.ios.createadview. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.iOS.AdView
 * @type 
 * @since 1.4
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.iOS.AdView.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.iOS.AdView.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.iOS.AdView.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * A banner view action can cover your application's user interface. however, your application continues to run, and receives events normally. if your application receives an event that requires the user's attention, it can programmatically cancel the action and uncover its interface by calling cancelaction. canceling actions frequently can cause a loss of revenue for your application. 
 *
 * @id Titanium.UI.iOS.AdView.cancelAction
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.iOS.AdView.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.iOS.AdView.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.iOS.AdView.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.iOS.AdView.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.iOS.AdView.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.iOS.AdView.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * Constant for 320x50 ad sizes 
 *
 * @id Titanium.UI.iOS.AdView.SIZE_320x50
 * @type String
 * @property
 */

/**
 * Constant for 480x32 ad sizes 
 *
 * @id Titanium.UI.iOS.AdView.SIZE_480x32
 * @type String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.iOS.AdView.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.iOS.AdView.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.iOS.AdView.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.iOS.AdView.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.iOS.AdView.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.iOS.AdView.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.iOS.AdView.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.iOS.AdView.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.iOS.AdView.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.iOS.AdView.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iOS.AdView.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.iOS.AdView.center
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.iOS.AdView.height
 * @type Float|String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iOS.AdView.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.iOS.AdView.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iOS.AdView.right
 * @type Float|String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.iOS.AdView.size
 * @type Object
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iOS.AdView.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.iOS.AdView.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.iOS.AdView.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.iOS.AdView.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.iOS.AdView.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.iOS.AdView.zIndex
 * @type Int
 * @property
 */

/**
 * The audioplayer object is returned by titanium.media.createaudioplayer and is used for streaming audio to the device and low-level control of the audio playback. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.Media.AudioPlayer
 * @type 
 * @since 0.9
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Media.AudioPlayer.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Media.AudioPlayer.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Pause playback 
 *
 * @id Titanium.Media.AudioPlayer.pause
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Media.AudioPlayer.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Control the playback of the audio 
 *
 * @id Titanium.Media.AudioPlayer.setPaused
 * @param {Boolean} paused pass true to pause the current playback temporarily, false to unpause it
 * @type Void
 */

/**
 * Change the url of the audio playback 
 *
 * @id Titanium.Media.AudioPlayer.setUrl
 * @param {String} url the new url
 * @type Void
 */

/**
 * Start playback 
 *
 * @id Titanium.Media.AudioPlayer.start
 * @type Void
 */

/**
 * Convert a state into a textual description suitable for display 
 *
 * @id Titanium.Media.AudioPlayer.stateDescription
 * @type String
 */

/**
 * Stop playback 
 *
 * @id Titanium.Media.AudioPlayer.stop
 * @type Void
 */

/**
 * Current playback is in the buffering from the network state 
 *
 * @id Titanium.Media.AudioPlayer.STATE_BUFFERING
 * @type Int
 * @property
 */

/**
 * Current playback is in the initialization state 
 *
 * @id Titanium.Media.AudioPlayer.STATE_INITIALIZED
 * @type Int
 * @property
 */

/**
 * Current playback is in the paused state 
 *
 * @id Titanium.Media.AudioPlayer.STATE_PAUSED
 * @type Int
 * @property
 */

/**
 * Current playback is in the playing state 
 *
 * @id Titanium.Media.AudioPlayer.STATE_PLAYING
 * @type Int
 * @property
 */

/**
 * Current playback is in the starting playback state 
 *
 * @id Titanium.Media.AudioPlayer.STATE_STARTING
 * @type Int
 * @property
 */

/**
 * Current playback is in the stopped state 
 *
 * @id Titanium.Media.AudioPlayer.STATE_STOPPED
 * @type Int
 * @property
 */

/**
 * Current playback is in the stopping state 
 *
 * @id Titanium.Media.AudioPlayer.STATE_STOPPING
 * @type Int
 * @property
 */

/**
 * Current playback is in the waiting for audio data from the network state 
 *
 * @id Titanium.Media.AudioPlayer.STATE_WAITING_FOR_DATA
 * @type Int
 * @property
 */

/**
 * Current playback is in the waiting for audio data to fill the queue state 
 *
 * @id Titanium.Media.AudioPlayer.STATE_WAITING_FOR_QUEUE
 * @type Int
 * @property
 */

/**
 * Boolean to indicate if audio should continue playing even if activity is paused (android only as of 1.3.0) 
 *
 * @id Titanium.Media.AudioPlayer.allowBackground
 * @type Boolean
 * @property
 */

/**
 * The default audio session mode to be used for this player. one of titanium.media.audio_session_mode_ambient, titanium.media.audio_session_mode_solo_ambient titanium.media.audio_session_mode_playback titanium.media.audio_session_mode_record, titanium.media.audio_session_mode_play_and_record. 
 *
 * @id Titanium.Media.AudioPlayer.audioSessionMode
 * @type Int
 * @property
 */

/**
 * Bit rate of the current playback stream 
 *
 * @id Titanium.Media.AudioPlayer.bitRate
 * @type Double
 * @property
 */

/**
 * Returns boolean indicating if the playback is idle 
 *
 * @id Titanium.Media.AudioPlayer.idle
 * @type Boolean
 * @property
 */

/**
 * Returns boolean indicating if the playback is paused 
 *
 * @id Titanium.Media.AudioPlayer.paused
 * @type Boolean
 * @property
 */

/**
 * Returns boolean indicating if the playback is streaming audio 
 *
 * @id Titanium.Media.AudioPlayer.playing
 * @type Boolean
 * @property
 */

/**
 * Returns the current playback progress. will return zero if samplerate has not yet been detected 
 *
 * @id Titanium.Media.AudioPlayer.progress
 * @type Double
 * @property
 */

/**
 * Returns int for the current state of playback 
 *
 * @id Titanium.Media.AudioPlayer.state
 * @type Int
 * @property
 */

/**
 * Returns the url for the current playback 
 *
 * @id Titanium.Media.AudioPlayer.url
 * @type String
 * @property
 */

/**
 * Returns boolean indicating if the playback is waiting for audio data from the network 
 *
 * @id Titanium.Media.AudioPlayer.waiting
 * @type Boolean
 * @property
 */

/**
 * An item that represents a visual icon in the titanium.ui.dashboardview. the dashboard item is created by the method titanium.ui.createdashboarditem. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.DashboardItem
 * @type 
 * @since 1.2
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.DashboardItem.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.DashboardItem.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.DashboardItem.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * The badge value or 0 to remove the badge 
 *
 * @id Titanium.UI.DashboardItem.badge
 * @type Int
 * @property
 */

/**
 * A boolean to indicate if this item can be deleted when it edit mode 
 *
 * @id Titanium.UI.DashboardItem.canDelete
 * @type Boolean
 * @property
 */

/**
 * The url to the image 
 *
 * @id Titanium.UI.DashboardItem.image
 * @type String
 * @property
 */

/**
 * The url to the image to display when the item is depressed (clicked) 
 *
 * @id Titanium.UI.DashboardItem.selectedImage
 * @type String
 * @property
 */

/**
 * The scrollable view provides a view that supports horizontal scrolling on one or more views in a gesture motion.  the scrollable view also optionally supports a visual paging control to indicate the page that the view is visible. the scrollable view is created by the method titanium.ui.createscrollableview. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Simple Scrollable View with 3 Views:
 * 
Create three views and place each into a scrollable view.

 * 
var view1 = Titanium.UI.createView({backgroundColor:'#123'});
 * var view2 = Titanium.UI.createView({backgroundColor:'#123'});
 * var view3 = Titanium.UI.createView({backgroundColor:'#123'});
 * var scrollView = Titanium.UI.createScrollableView({
 *     views:[view1,view2,view3],
 *     showPagingControl:true
 * });
 * win.add(scrollView);
 * 

 * @id Titanium.UI.ScrollableView
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.ScrollableView.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.ScrollableView.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Add a new view to the scrollable view 
 *
 * @id Titanium.UI.ScrollableView.addView
 * @param {Object} view the view to add
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.ScrollableView.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.ScrollableView.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.ScrollableView.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.ScrollableView.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.ScrollableView.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Remove an existing view from the scrollable view 
 *
 * @id Titanium.UI.ScrollableView.removeView
 * @param {Object} view the view to remove
 * @type Void
 */

/**
 * Scroll to a specific view 
 *
 * @id Titanium.UI.ScrollableView.scrollToView
 * @param {Int,object} view either an integer index or the view object to bring into view as the currentPage
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.ScrollableView.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.ScrollableView.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.ScrollableView.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.ScrollableView.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.ScrollableView.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.ScrollableView.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.ScrollableView.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.ScrollableView.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.ScrollableView.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.ScrollableView.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.ScrollableView.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.ScrollableView.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ScrollableView.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.ScrollableView.center
 * @type Object
 * @property
 */

/**
 * The current page visible in the view 
 *
 * @id Titanium.UI.ScrollableView.currentPage
 * @type Int
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.ScrollableView.height
 * @type Float|String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ScrollableView.left
 * @type Float|String
 * @property
 */

/**
 * The maximum zoom scale for the view 
 *
 * @id Titanium.UI.ScrollableView.maxZoomScale
 * @type Float
 * @property
 */

/**
 * The minimum zoom scale for the view 
 *
 * @id Titanium.UI.ScrollableView.minZoomScale
 * @type Float
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.ScrollableView.opacity
 * @type Float
 * @property
 */

/**
 * The color of the paging control. defaults to black. 
 *
 * @id Titanium.UI.ScrollableView.pagingControlColor
 * @type String
 * @property
 */

/**
 * The height in pixels of the paging control, if visible. defaults to 20 
 *
 * @id Titanium.UI.ScrollableView.pagingControlHeight
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ScrollableView.right
 * @type Float|String
 * @property
 */

/**
 * Boolean to indicate whether the paging control ui is visible 
 *
 * @id Titanium.UI.ScrollableView.showPagingControl
 * @type Boolean
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.ScrollableView.size
 * @type Object
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.ScrollableView.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.ScrollableView.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.ScrollableView.transform
 * @type Object
 * @property
 */

/**
 * Array of view objects to place in the view 
 *
 * @id Titanium.UI.ScrollableView.views
 * @type Array
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.ScrollableView.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.ScrollableView.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.ScrollableView.zIndex
 * @type Int
 * @property
 */

/**
 * An object which represents a person in the contacts database. Platforms: Iphone|Ipad
 *
 * @id Titanium.Contacts.Person
 * @type 
 * @since 0.8
 */

/**
 * Urls of webpages associated with the person.  multi-value, valid labels are: home, work, other, homepage.  values are strings. 
 *
 * @id Titanium.Contacts.Person.URL
 * @type Object
 * @property
 */

/**
 * The addresses for the person.  multi-value, valid labels are: home, work, other.  values are dictionaries. 
 *
 * @id Titanium.Contacts.Person.address
 * @type Object
 * @property
 */

/**
 * The birthday of the person.  single value, format is "yyyy-mm-dd't'hh:mm:ss'.'sss+0000" 
 *
 * @id Titanium.Contacts.Person.birthday
 * @type String
 * @property
 */

/**
 * The date the person was created in the database.  single value, format is "yyyy-mm-dd't'hh:mm:ss'.'sss+0000", read-only 
 *
 * @id Titanium.Contacts.Person.created
 * @type String
 * @property
 */

/**
 * Dates associated with the person.  multi-value, valid labels are: anniversary.  values are strings of format "yyyy-mm-dd't'hh:mm:ss'.'sss+0000" 
 *
 * @id Titanium.Contacts.Person.date
 * @type Object
 * @property
 */

/**
 * The department of the person.  single value 
 *
 * @id Titanium.Contacts.Person.department
 * @type String
 * @property
 */

/**
 * The email addresses for the person.  multi-value, valid labels are: home, work, other.  values are strings. 
 *
 * @id Titanium.Contacts.Person.email
 * @type Object
 * @property
 */

/**
 * The first name of the person.  single value 
 *
 * @id Titanium.Contacts.Person.firstName
 * @type String
 * @property
 */

/**
 * The phonetic first name of the person.  single value 
 *
 * @id Titanium.Contacts.Person.firstPhonetic
 * @type String
 * @property
 */

/**
 * The localized full name of the person.  single value, read-only 
 *
 * @id Titanium.Contacts.Person.fullName
 * @type String
 * @property
 */

/**
 * A blob object representing the image for the person.  set to null to remove the image.  single value 
 *
 * @id Titanium.Contacts.Person.image
 * @type Object
 * @property
 */

/**
 * The instant messenger names for the person.  multi-value, valid labels are: aim, icq, jabber, msn, yahoo.  values are dictionaries. 
 *
 * @id Titanium.Contacts.Person.instantMessage
 * @type Object
 * @property
 */

/**
 * The job title of the person.  single value 
 *
 * @id Titanium.Contacts.Person.jobTitle
 * @type String
 * @property
 */

/**
 * The kind of person.  single value, one of titanium.contacts.contacts_kind_person or titanium.contacts.contacts_kind_organization 
 *
 * @id Titanium.Contacts.Person.kind
 * @type Int
 * @property
 */

/**
 * The last name of the person.  single value 
 *
 * @id Titanium.Contacts.Person.lastName
 * @type String
 * @property
 */

/**
 * The phonetic last name of the person.  single value 
 *
 * @id Titanium.Contacts.Person.lastPhonetic
 * @type String
 * @property
 */

/**
 * The middle name of the person.  single value 
 *
 * @id Titanium.Contacts.Person.middleName
 * @type String
 * @property
 */

/**
 * The phonetic middle name of the person.  single value 
 *
 * @id Titanium.Contacts.Person.middlePhonetic
 * @type String
 * @property
 */

/**
 * The most recent date the person was modified.  single value, format is "yyyy-mm-dd't'hh:mm:ss'.'sss+0000", read-only 
 *
 * @id Titanium.Contacts.Person.modified
 * @type String
 * @property
 */

/**
 * The nickname of the person.  single value 
 *
 * @id Titanium.Contacts.Person.nickname
 * @type String
 * @property
 */

/**
 * Notes for the person.  single value 
 *
 * @id Titanium.Contacts.Person.note
 * @type String
 * @property
 */

/**
 * The organization the person belongs to.  single value 
 *
 * @id Titanium.Contacts.Person.organization
 * @type String
 * @property
 */

/**
 * The phone numbers for the person.  multi-value, valid labels are: home, work, other, mobile, pager, workfax, homefax, main, iphone.  values are strings. 
 *
 * @id Titanium.Contacts.Person.phone
 * @type Object
 * @property
 */

/**
 * The prefix for the person.  single value 
 *
 * @id Titanium.Contacts.Person.prefix
 * @type String
 * @property
 */

/**
 * The names of people the person is related to.  multi-value, valid labels are: mother, father, parent, sister, brother, child, friend, spouse, partner, manager, assistant.  values are strings. 
 *
 * @id Titanium.Contacts.Person.relatedNames
 * @type Object
 * @property
 */

/**
 * The suffix for the person.  single value 
 *
 * @id Titanium.Contacts.Person.suffix
 * @type String
 * @property
 */

/**
 * A set of constants for the animation styles used for transition on table view rows. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.iPhone.RowAnimationStyle
 * @type 
 * @since 0.9
 */

/**
 * The inserted row or rows slides in from the bottom; the deleted row or rows slides out toward the bottom. 
 *
 * @id Titanium.UI.iPhone.RowAnimationStyle.BOTTOM
 * @type Int
 * @property
 */

/**
 * The inserted or deleted row or rows fades into or out of the table view. 
 *
 * @id Titanium.UI.iPhone.RowAnimationStyle.FADE
 * @type Int
 * @property
 */

/**
 * The inserted row or rows slides in from the left; the deleted row or rows slides out to the left. 
 *
 * @id Titanium.UI.iPhone.RowAnimationStyle.LEFT
 * @type Int
 * @property
 */

/**
 * No animation is performed. the new cell value appears as if the cell had just been reloaded. 
 *
 * @id Titanium.UI.iPhone.RowAnimationStyle.NONE
 * @type Int
 * @property
 */

/**
 * The inserted row or rows slides in from the right; the deleted row or rows slides out to the right. 
 *
 * @id Titanium.UI.iPhone.RowAnimationStyle.RIGHT
 * @type Int
 * @property
 */

/**
 * The inserted row or rows slides in from the top; the deleted row or rows slides out toward the top. 
 *
 * @id Titanium.UI.iPhone.RowAnimationStyle.TOP
 * @type Int
 * @property
 */

/**
 * A button is created by the method titanium.ui.createbutton. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Simple Button Example:
 * 
var button = Titanium.UI.createButton({
 *    title: 'Hello'
 * });
 * button.addEventListener('click',function(e)
 * {
 *    Titanium.API.info("You clicked the button");
 * });
 * 

 * @id Titanium.UI.Button
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.Button.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.Button.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.Button.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.Button.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.Button.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.Button.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.Button.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.Button.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.Button.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.Button.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.Button.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The buttons background color 
 *
 * @id Titanium.UI.Button.backgroundColor
 * @type String
 * @property
 */

/**
 * Url to a button image that is drawn as the background of the button when the button is in the disabled state 
 *
 * @id Titanium.UI.Button.backgroundDisabledImage
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.Button.backgroundGradient
 * @type Object
 * @property
 */

/**
 * Url to a button image that is drawn as the background of the button 
 *
 * @id Titanium.UI.Button.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.Button.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * Url to a button image that is drawn as the background of the button when the button is in the selected state 
 *
 * @id Titanium.UI.Button.backgroundSelectedImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.Button.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.Button.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.Button.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.Button.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Button.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.Button.center
 * @type Object
 * @property
 */

/**
 * The foreground color of the button text 
 *
 * @id Titanium.UI.Button.color
 * @type String
 * @property
 */

/**
 * Boolean that indicates if the button is enabled or not 
 *
 * @id Titanium.UI.Button.enabled
 * @type Boolean
 * @property
 */

/**
 * The font properties of the button 
 *
 * @id Titanium.UI.Button.font
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.Button.height
 * @type Float|String
 * @property
 */

/**
 * The image to display on the button to the left of the title 
 *
 * @id Titanium.UI.Button.image
 * @type String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Button.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.Button.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Button.right
 * @type Float|String
 * @property
 */

/**
 * The selected color of the button text when the button is in the selected state 
 *
 * @id Titanium.UI.Button.selectedColor
 * @type String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.Button.size
 * @type Object
 * @property
 */

/**
 * Style constant for the type of button 
 *
 * @id Titanium.UI.Button.style
 * @type Int
 * @property
 */

/**
 * Button title 
 *
 * @id Titanium.UI.Button.title
 * @type String
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Button.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.Button.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.Button.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.Button.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.Button.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.Button.zIndex
 * @type Int
 * @property
 */

/**
 * The main titanium.ui module.  the ui module is responsible for native user-interface components and interaction inside titanium.  the goal of the ui module is to provide a native experience along with native performance by compiling javascript code into their native counterparts as part of the build process.  Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.UI
 * @type 
 * @since 0.4
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Create and return an instance of titanium.ui.2dmatrix 
 *
 * @id Titanium.UI.create2DMatrix
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.2DMatrix
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.3dmatrix 
 *
 * @id Titanium.UI.create3DMatrix
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.3DMatrix
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.activityindicator 
 *
 * @id Titanium.UI.createActivityIndicator
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.ActivityIndicator
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.alertdialog 
 *
 * @id Titanium.UI.createAlertDialog
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.AlertDialog
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.animation 
 *
 * @id Titanium.UI.createAnimation
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.Animation
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.button 
 *
 * @id Titanium.UI.createButton
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.Button
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.buttonbar 
 *
 * @id Titanium.UI.createButtonBar
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.ButtonBar
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.coverflowview 
 *
 * @id Titanium.UI.createCoverFlowView
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.CoverFlowView
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.dashboarditem 
 *
 * @id Titanium.UI.createDashboardItem
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.DashboardItem
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.dashboardview 
 *
 * @id Titanium.UI.createDashboardView
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.DashboardView
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.emaildialog 
 *
 * @id Titanium.UI.createEmailDialog
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.EmailDialog
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.imageview 
 *
 * @id Titanium.UI.createImageView
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.ImageView
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.label 
 *
 * @id Titanium.UI.createLabel
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.Label
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.optiondialog 
 *
 * @id Titanium.UI.createOptionDialog
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.OptionDialog
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.picker 
 *
 * @id Titanium.UI.createPicker
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.Picker
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.pickercolumn 
 *
 * @id Titanium.UI.createPickerColumn
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.PickerColumn
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.pickerrow 
 *
 * @id Titanium.UI.createPickerRow
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.PickerRow
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.progressbar 
 *
 * @id Titanium.UI.createProgressBar
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.ProgressBar
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.scrollview 
 *
 * @id Titanium.UI.createScrollView
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.ScrollView
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.scrollableview 
 *
 * @id Titanium.UI.createScrollableView
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.ScrollableView
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.searchbar 
 *
 * @id Titanium.UI.createSearchBar
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.SearchBar
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.slider 
 *
 * @id Titanium.UI.createSlider
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.Slider
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.switch 
 *
 * @id Titanium.UI.createSwitch
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.Switch
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.tab 
 *
 * @id Titanium.UI.createTab
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.Tab
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.tabgroup 
 *
 * @id Titanium.UI.createTabGroup
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.TabGroup
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.tabbedbar 
 *
 * @id Titanium.UI.createTabbedBar
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.TabbedBar
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.tableview 
 *
 * @id Titanium.UI.createTableView
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.TableView
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.tableviewrow 
 *
 * @id Titanium.UI.createTableViewRow
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.TableViewRow
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.tableviewsection 
 *
 * @id Titanium.UI.createTableViewSection
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.TableViewSection
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.textarea 
 *
 * @id Titanium.UI.createTextArea
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.TextArea
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.textfield 
 *
 * @id Titanium.UI.createTextField
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.TextField
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.toolbar 
 *
 * @id Titanium.UI.createToolbar
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.Toolbar
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.view 
 *
 * @id Titanium.UI.createView
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.View
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.webview 
 *
 * @id Titanium.UI.createWebView
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.WebView
 * @type Object
 */

/**
 * Create and return an instance of titanium.ui.window 
 *
 * @id Titanium.UI.createWindow
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.Window
 * @type Object
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Animation curve constant 
 *
 * @id Titanium.UI.ANIMATION_CURVE_EASE_IN
 * @type Int
 * @property
 */

/**
 * Animation curve constant 
 *
 * @id Titanium.UI.ANIMATION_CURVE_EASE_IN_OUT
 * @type Int
 * @property
 */

/**
 * Animation curve constant 
 *
 * @id Titanium.UI.ANIMATION_CURVE_EASE_OUT
 * @type Int
 * @property
 */

/**
 * Animation curve constant 
 *
 * @id Titanium.UI.ANIMATION_CURVE_LINEAR
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_CLEAR
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_COLOR
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_COLOR_BURN
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_COLOR_DODGE
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_COPY
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_DARKEN
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_DESTINATION_ATOP
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_DESTINATION_IN
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_DESTINATION_OUT
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_DESTINATION_OVER
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_DIFFERENCE
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_EXCLUSION
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_HARD_LIGHT
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_HUE
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_LIGHTEN
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_LUMINOSITY
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_MULTIPLY
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_NORMAL
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_OVERLAY
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_PLUS_DARKER
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_PLUS_LIGHTER
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_SATURATION
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_SCREEN
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_SOFT_LIGHT
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_SOURCE_ATOP
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_SOURCE_IN
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_SOURCE_OUT
 * @type Int
 * @property
 */

/**
 * Image mode constant 
 *
 * @id Titanium.UI.BLEND_MODE_XOR
 * @type Int
 * @property
 */

/**
 * Orientation constant 
 *
 * @id Titanium.UI.FACE_DOWN
 * @type Int
 * @property
 */

/**
 * Orientation constant 
 *
 * @id Titanium.UI.FACE_UP
 * @type Int
 * @property
 */

/**
 * Input border style constant 
 *
 * @id Titanium.UI.INPUT_BORDERSTYLE_BEZEL
 * @type Int
 * @property
 */

/**
 * Input border style constant 
 *
 * @id Titanium.UI.INPUT_BORDERSTYLE_LINE
 * @type Int
 * @property
 */

/**
 * Input border style constant 
 *
 * @id Titanium.UI.INPUT_BORDERSTYLE_NONE
 * @type Int
 * @property
 */

/**
 * Input border style constant 
 *
 * @id Titanium.UI.INPUT_BORDERSTYLE_ROUNDED
 * @type Int
 * @property
 */

/**
 * Input button mode constant 
 *
 * @id Titanium.UI.INPUT_BUTTONMODE_ALWAYS
 * @type Int
 * @property
 */

/**
 * Input button mode constant 
 *
 * @id Titanium.UI.INPUT_BUTTONMODE_NEVER
 * @type Int
 * @property
 */

/**
 * Input button mode constant 
 *
 * @id Titanium.UI.INPUT_BUTTONMODE_ONBLUR
 * @type Int
 * @property
 */

/**
 * Input button mode constant 
 *
 * @id Titanium.UI.INPUT_BUTTONMODE_ONFOCUS
 * @type Int
 * @property
 */

/**
 * Textfield keyboard appearance constant 
 *
 * @id Titanium.UI.KEYBOARD_APPEARANCE_ALERT
 * @type Int
 * @property
 */

/**
 * Textfield keyboard appearance constant 
 *
 * @id Titanium.UI.KEYBOARD_APPEARANCE_DEFAULT
 * @type Int
 * @property
 */

/**
 * Textfield keyboard constant 
 *
 * @id Titanium.UI.KEYBOARD_ASCII
 * @type Int
 * @property
 */

/**
 * Textfield keyboard constant 
 *
 * @id Titanium.UI.KEYBOARD_DEFAULT
 * @type Int
 * @property
 */

/**
 * Textfield keyboard constant 
 *
 * @id Titanium.UI.KEYBOARD_EMAIL
 * @type Int
 * @property
 */

/**
 * Textfield keyboard constant 
 *
 * @id Titanium.UI.KEYBOARD_NAMEPHONE_PAD
 * @type Int
 * @property
 */

/**
 * Textfield keyboard constant 
 *
 * @id Titanium.UI.KEYBOARD_NUMBERS_PUNCTUATION
 * @type Int
 * @property
 */

/**
 * Textfield keyboard constant 
 *
 * @id Titanium.UI.KEYBOARD_NUMBER_PAD
 * @type Int
 * @property
 */

/**
 * Textfield keyboard constant 
 *
 * @id Titanium.UI.KEYBOARD_PHONE_PAD
 * @type Int
 * @property
 */

/**
 * Textfield keyboard constant 
 *
 * @id Titanium.UI.KEYBOARD_URL
 * @type Int
 * @property
 */

/**
 * Orientation (home button on left) constant 
 *
 * @id Titanium.UI.LANDSCAPE_LEFT
 * @type Int
 * @property
 */

/**
 * Orientation (home button on right) constant 
 *
 * @id Titanium.UI.LANDSCAPE_RIGHT
 * @type Int
 * @property
 */

/**
 * Duration of the notification 
 *
 * @id Titanium.UI.NOTIFICATION_DURATION_LONG
 * @type Int
 * @property
 */

/**
 * Duration of the notification 
 *
 * @id Titanium.UI.NOTIFICATION_DURATION_SHORT
 * @type Int
 * @property
 */

/**
 * Picker type constant 
 *
 * @id Titanium.UI.PICKER_TYPE_COUNT_DOWN_TIMER
 * @type Int
 * @property
 */

/**
 * Picker type constant 
 *
 * @id Titanium.UI.PICKER_TYPE_DATE
 * @type Int
 * @property
 */

/**
 * Picker type constant 
 *
 * @id Titanium.UI.PICKER_TYPE_DATE_AND_TIME
 * @type Int
 * @property
 */

/**
 * Picker type constant 
 *
 * @id Titanium.UI.PICKER_TYPE_PLAIN
 * @type Int
 * @property
 */

/**
 * Picker type constant 
 *
 * @id Titanium.UI.PICKER_TYPE_TIME
 * @type Int
 * @property
 */

/**
 * Orientation (home button on bottom) constant 
 *
 * @id Titanium.UI.PORTRAIT
 * @type Int
 * @property
 */

/**
 * Textfield return key constant 
 *
 * @id Titanium.UI.RETURNKEY_DEFAULT
 * @type Int
 * @property
 */

/**
 * Textfield return key constant 
 *
 * @id Titanium.UI.RETURNKEY_DONE
 * @type Int
 * @property
 */

/**
 * Textfield return key constant 
 *
 * @id Titanium.UI.RETURNKEY_EMERGENCY_CALL
 * @type Int
 * @property
 */

/**
 * Textfield return key constant 
 *
 * @id Titanium.UI.RETURNKEY_GO
 * @type Int
 * @property
 */

/**
 * Textfield return key constant 
 *
 * @id Titanium.UI.RETURNKEY_GOOGLE
 * @type Int
 * @property
 */

/**
 * Textfield return key constant 
 *
 * @id Titanium.UI.RETURNKEY_JOIN
 * @type Int
 * @property
 */

/**
 * Textfield return key constant 
 *
 * @id Titanium.UI.RETURNKEY_NEXT
 * @type Int
 * @property
 */

/**
 * Textfield return key constant 
 *
 * @id Titanium.UI.RETURNKEY_ROUTE
 * @type Int
 * @property
 */

/**
 * Textfield return key constant 
 *
 * @id Titanium.UI.RETURNKEY_SEARCH
 * @type Int
 * @property
 */

/**
 * Textfield return key constant 
 *
 * @id Titanium.UI.RETURNKEY_SEND
 * @type Int
 * @property
 */

/**
 * Textfield return key constant 
 *
 * @id Titanium.UI.RETURNKEY_YAHOO
 * @type Int
 * @property
 */

/**
 * Text align constant 
 *
 * @id Titanium.UI.TEXT_ALIGNMENT_CENTER
 * @type Int
 * @property
 */

/**
 * Text align constant 
 *
 * @id Titanium.UI.TEXT_ALIGNMENT_LEFT
 * @type Int
 * @property
 */

/**
 * Text align constant 
 *
 * @id Titanium.UI.TEXT_ALIGNMENT_RIGHT
 * @type Int
 * @property
 */

/**
 * Text capitalization constant 
 *
 * @id Titanium.UI.TEXT_AUTOCAPITALIZATION_ALL
 * @type Int
 * @property
 */

/**
 * Text capitalization constant 
 *
 * @id Titanium.UI.TEXT_AUTOCAPITALIZATION_NONE
 * @type Int
 * @property
 */

/**
 * Text capitalization constant 
 *
 * @id Titanium.UI.TEXT_AUTOCAPITALIZATION_SENTENCES
 * @type Int
 * @property
 */

/**
 * Text capitalization constant 
 *
 * @id Titanium.UI.TEXT_AUTOCAPITALIZATION_WORDS
 * @type Int
 * @property
 */

/**
 * Text vertical align constant 
 *
 * @id Titanium.UI.TEXT_VERTICAL_ALIGNMENT_BOTTOM
 * @type Int
 * @property
 */

/**
 * Text vertical align constant 
 *
 * @id Titanium.UI.TEXT_VERTICAL_ALIGNMENT_CENTER
 * @type Int
 * @property
 */

/**
 * Text vertical align constant 
 *
 * @id Titanium.UI.TEXT_VERTICAL_ALIGNMENT_TOP
 * @type Int
 * @property
 */

/**
 * Orientation constant 
 *
 * @id Titanium.UI.UNKNOWN
 * @type Int
 * @property
 */

/**
 * Orientation (home button on top) constant 
 *
 * @id Titanium.UI.UPSIDE_PORTRAIT
 * @type Int
 * @property
 */

/**
 * The top level facebook module.  the facebook module is used for connecting your application with 
 * facebook through facebook connect. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.Facebook
 * @type Object
 * @since 0.8
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Facebook.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Create and return an instance of titanium.facebook.loginbutton 
 *
 * @id Titanium.Facebook.createLoginButton
 * @param {Object} params the parameters for the request. the following keys are valid: apikey (the application API key), secret (the application API secret or null if using a session proxy), sessionProxy (the URL to the application session proxy), style (the button style - which is either normal or wide).
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.Facebook.LoginButton
 * @type Object
 */

/**
 * Execute a fb api execute request 
 *
 * @id Titanium.Facebook.execute
 * @param {String} method method to execute
 * @param {Object} params JSON serializable object or null (if no parameters) to send with the request
 * @param {Function} callback the callback function to execute upon receiving a response. the result object will contain a success boolean to indicate the result. if success is false, the error property will give the error message. the data property will contain the result if successfully executed.
 * @param {Object} data the data payload for the request. Must either null, a string or a Blob object.
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Facebook.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Checks the existing permission and returns true if the user has granted the requested permission 
 *
 * @id Titanium.Facebook.hasPermission
 * @param {String} permission the permission to check
 * @type Boolean
 */

/**
 * Return true if the user has logged in 
 *
 * @id Titanium.Facebook.isLoggedIn
 * @type Void
 */

/**
 * Execute a stream request to fb 
 *
 * @id Titanium.Facebook.publishStream
 * @param {String} title the title of the stream post
 * @param {Object} data the data to include in the post. Must be JSON serializable or null.
 * @param {String} target the target user id to publish the stream or null if the logged in users account
 * @param {Function} callback the callback function to execute upon receiving a response. the result object will contain a success boolean to indicate the result. if success is false, the error property will give the error message. the data property will contain the result if successfully executed. the cancel property will be set to true if the user cancelled the dialog.
 * @type Void
 */

/**
 * Execute a fql query against the fb api 
 *
 * @id Titanium.Facebook.query
 * @param {String} fql the FQL query to execute
 * @param {Function} callback the callback to execute with results once the query is completed. the result object will contain a success boolean to indicate the result. if success is false, the error property will give the error message. the data property will contain the result if successfully executed.
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Facebook.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Request a special permission from the user 
 *
 * @id Titanium.Facebook.requestPermission
 * @param {String} permission name of the permission
 * @param {Function} callback the callback function to execute upon receiving a response. the result object will contain a success boolean to indicate the result. if success is false, the error property will give the error message. the data property will contain the result if successfully executed. the cancel property will be set to true if the user cancelled the dialog.
 * @type Void
 */

/**
 * Return true if the user has logged in 
 *
 * @id Titanium.Facebook.loggedIn
 * @type Boolean
 * @property
 */

/**
 * Return a dictionary of permissions with the keys being the name of the permission and the value being a boolean of true if granted, false if not granted 
 *
 * @id Titanium.Facebook.permissions
 * @type Object
 * @property
 */

/**
 * Return the special properties of the session 
 *
 * @id Titanium.Facebook.session
 * @type Object
 * @property
 */

/**
 * The unique user id returned from facebook. returns 0 if not logged in 
 *
 * @id Titanium.Facebook.userId
 * @type Long
 * @property
 */

/**
 * A set of constants for the system button styles that can be used for the button style property. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.iPhone.SystemButtonStyle
 * @type 
 * @since 0.8
 */

/**
 * A simple button style with a border. 
 *
 * @id Titanium.UI.iPhone.SystemButtonStyle.BORDERED
 * @type Int
 * @property
 */

/**
 * The style for a done button - for example, a button that completes some task and returns to the previous view. 
 *
 * @id Titanium.UI.iPhone.SystemButtonStyle.DONE
 * @type Int
 * @property
 */

/**
 * Glows when tapped. the default item style. 
 *
 * @id Titanium.UI.iPhone.SystemButtonStyle.PLAIN
 * @type Int
 * @property
 */

/**
 * A set of constants for the bar styles used on the style property of titanium.ui.progressbar. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.iPhone.ProgressBarStyle
 * @type 
 * @since 0.8
 */

/**
 * The style of progress view that is used in a toolbar. 
 *
 * @id Titanium.UI.iPhone.ProgressBarStyle.BAR
 * @type Int
 * @property
 */

/**
 * He standard progress-view style. this is the default. 
 *
 * @id Titanium.UI.iPhone.ProgressBarStyle.DEFAULT
 * @type Int
 * @property
 */

/**
 * The standard progress-view style. same as default. 
 *
 * @id Titanium.UI.iPhone.ProgressBarStyle.PLAIN
 * @type Int
 * @property
 */

/**
 * The top level gestures module.  the gesture module is responsible for high level device gestures that are device-wide. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.Gesture
 * @type Object
 * @since 0.8
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Gesture.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Gesture.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Gesture.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * The top level platform module.  the platform module is used accessing the device's platform
 * related functionality. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.Platform
 * @type 
 * @since 0.1
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Platform.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Create a globally unique identifier 
 *
 * @id Titanium.Platform.createUUID
 * @type String
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Platform.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Open a url in the system default manner 
 *
 * @id Titanium.Platform.openURL
 * @param {String} url the url to open
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Platform.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * The device is plugged in and currently being charged 
 *
 * @id Titanium.Platform.BATTERY_STATE_CHARGING
 * @type Int
 * @property
 */

/**
 * The battery is fully charged 
 *
 * @id Titanium.Platform.BATTERY_STATE_FULL
 * @type Int
 * @property
 */

/**
 * The battery state is unknown or not monitoring is not enabled 
 *
 * @id Titanium.Platform.BATTERY_STATE_UNKNOWN
 * @type Int
 * @property
 */

/**
 * The device is unplugged 
 *
 * @id Titanium.Platform.BATTERY_STATE_UNPLUGGED
 * @type Int
 * @property
 */

/**
 * The ip address that the device reports (only applicable on wifi network) 
 *
 * @id Titanium.Platform.address
 * @type String
 * @property
 */

/**
 * The processor architecture that the device reports 
 *
 * @id Titanium.Platform.architecture
 * @type String
 * @property
 */

/**
 * Return the amount of memory available on the device in bytes 
 *
 * @id Titanium.Platform.availableMemory
 * @type Double
 * @property
 */

/**
 * The current device battery level. this property is only accessible if batterymonitoring is enabled. on iphone, this level only changes at 5% intervals. 
 *
 * @id Titanium.Platform.batteryLevel
 * @type Float
 * @property
 */

/**
 * Boolean to indicate if battery monitoring is enabled 
 *
 * @id Titanium.Platform.batteryMonitoring
 * @type Boolean
 * @property
 */

/**
 * Constant that represents the state of the battery. this property is only accessible if batterymonitoring is enabled 
 *
 * @id Titanium.Platform.batteryState
 * @type Int
 * @property
 */

/**
 * Return the displaycaps object for platform 
 *
 * @id Titanium.Platform.displayCaps
 * @type Object
 * @property
 */

/**
 * The unique id of the device 
 *
 * @id Titanium.Platform.id
 * @type String
 * @property
 */

/**
 * The primary language of the device that the user has enabled 
 *
 * @id Titanium.Platform.locale
 * @type String
 * @property
 */

/**
 * This property will return a unique identifier for the device 
 *
 * @id Titanium.Platform.macaddress
 * @type String
 * @property
 */

/**
 * The model of the phone that the device reports 
 *
 * @id Titanium.Platform.model
 * @type String
 * @property
 */

/**
 * The name of the platform returned by the device 
 *
 * @id Titanium.Platform.name
 * @type String
 * @property
 */

/**
 * The network mask that the device reports (only applicable on wifi network) 
 *
 * @id Titanium.Platform.netmask
 * @type String
 * @property
 */

/**
 * The shortname of the operating system. for example, on an iphone, will return iphone, ipad will return ipad and android will return android. 
 *
 * @id Titanium.Platform.osname
 * @type String
 * @property
 */

/**
 * The os architecture, such as 32 bit 
 *
 * @id Titanium.Platform.ostype
 * @type String
 * @property
 */

/**
 * The number of processors the device reports 
 *
 * @id Titanium.Platform.processorCount
 * @type Int
 * @property
 */

/**
 * The username of the device, if set 
 *
 * @id Titanium.Platform.username
 * @type String
 * @property
 */

/**
 * The version of the platform returned by the device 
 *
 * @id Titanium.Platform.version
 * @type String
 * @property
 */

/**
 * The animation object is used for specifying lower-level animation properties and more low-level control of events during an animation. the animation is created by the method titanium.ui.createanimation. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Animation applied to a view:
 * 
Create a simple animation and apply it to the view.  In this example, the view will animate from red to black to orange over 2 seconds.

 * 
var view = Titanium.UI.createView({
 *    backgroundColor:'red'
 * });
 * var animation = Titanium.UI.createAnimation();
 * animation.backgroundColor = 'black';
 * animation.duration = 1000;
 * animation.addEventListener('complete',function()
 * {
 *    animation.removeEventListener('complete',this);
 *    animation.backgroundColor = 'orange';
 *    view.animate(animation);
 * });
 * view.animate(animation);
 * 

 * @id Titanium.UI.Animation
 * @type 
 * @since 0.9
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.Animation.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.Animation.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.Animation.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * The property specifies if the animation should be replayed in reverse upon completion 
 *
 * @id Titanium.UI.Animation.autoreverse
 * @type Boolean
 * @property
 */

/**
 * Value of the backgroundcolor property to change during animation 
 *
 * @id Titanium.UI.Animation.backgroundColor
 * @type String
 * @property
 */

/**
 * Value of the bottom property to change during animation 
 *
 * @id Titanium.UI.Animation.bottom
 * @type Float
 * @property
 */

/**
 * Value of the center property to change during animation 
 *
 * @id Titanium.UI.Animation.center
 * @type Object
 * @property
 */

/**
 * Value of the color property to change during animation 
 *
 * @id Titanium.UI.Animation.color
 * @type String
 * @property
 */

/**
 * The curve of the animation 
 *
 * @id Titanium.UI.Animation.curve
 * @type Int
 * @property
 */

/**
 * The duration of time in milliseconds before starting the animation 
 *
 * @id Titanium.UI.Animation.delay
 * @type Float
 * @property
 */

/**
 * The duration of time in milliseconds to perform the animation 
 *
 * @id Titanium.UI.Animation.duration
 * @type Float
 * @property
 */

/**
 * Value of the height property to change during animation 
 *
 * @id Titanium.UI.Animation.height
 * @type Float
 * @property
 */

/**
 * Value of the left property to change during animation 
 *
 * @id Titanium.UI.Animation.left
 * @type Float
 * @property
 */

/**
 * Value of the opacity property to change during animation 
 *
 * @id Titanium.UI.Animation.opacity
 * @type Float
 * @property
 */

/**
 * Value of the opaque property to change during animation 
 *
 * @id Titanium.UI.Animation.opaque
 * @type Boolean
 * @property
 */

/**
 * The number of times the animation should be performed 
 *
 * @id Titanium.UI.Animation.repeat
 * @type Int
 * @property
 */

/**
 * Value of the right property to change during animation 
 *
 * @id Titanium.UI.Animation.right
 * @type Float
 * @property
 */

/**
 * Value of the top property to change during animation 
 *
 * @id Titanium.UI.Animation.top
 * @type Float
 * @property
 */

/**
 * Value of the transform property to change during animation 
 *
 * @id Titanium.UI.Animation.transform
 * @type Object
 * @property
 */

/**
 * During a transition animation, this is the constant to the type of transition to use 
 *
 * @id Titanium.UI.Animation.transition
 * @type Int
 * @property
 */

/**
 * Value of the visible property to change during animation 
 *
 * @id Titanium.UI.Animation.visible
 * @type Boolean
 * @property
 */

/**
 * Value of the width property to change during animation 
 *
 * @id Titanium.UI.Animation.width
 * @type Float
 * @property
 */

/**
 * Value of the zindex property to change during animation 
 *
 * @id Titanium.UI.Animation.zIndex
 * @type Int
 * @property
 */

/**
 * The email dialog is created by titanium.ui.createemaildialog and allows you to send in application emails on behalf of the application user. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Simple Email Dialog with Attachment:
 * 
In this example, we send an email with a file attachment.

 * 
var emailDialog = Titanium.UI.createEmailDialog()
 * emailDialog.subject = "Hello from Titanium";
 * emailDialog.toRecipients = ['foo@yahoo.com'];
 * emailDialog.messageBody = 'Appcelerator Titanium Rocks!';
 * var f = Ti.Filesystem.getFile('cricket.wav');
 * emailDialog.addAttachment(f);
 * emailDialog.open();
 * 

 * @id Titanium.UI.EmailDialog
 * @type 
 * @since 0.8
 */

/**
 * Add an attachment to the email. the attachment can either be a blob or file object. (note: android will only accept one attachment at this time.) 
 *
 * @id Titanium.UI.EmailDialog.addAttachment
 * @param {Object} attachment attachment object as either a Blob or File object
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.EmailDialog.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.EmailDialog.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Open the email dialog. the email dialog itself is a modal window 
 *
 * @id Titanium.UI.EmailDialog.open
 * @param {Object} properties object of animation properties. pass animated property (as boolean) to indicate if the dialog should be animated on open.
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.EmailDialog.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Constant for the cancelled status result 
 *
 * @id Titanium.UI.EmailDialog.CANCELLED
 * @type Int
 * @property
 */

/**
 * Constant for the failed status result 
 *
 * @id Titanium.UI.EmailDialog.FAILED
 * @type Int
 * @property
 */

/**
 * Constant for the saved status result 
 *
 * @id Titanium.UI.EmailDialog.SAVED
 * @type Int
 * @property
 */

/**
 * Constant for the sent status result 
 *
 * @id Titanium.UI.EmailDialog.SENT
 * @type Int
 * @property
 */

/**
 * The bar color of the email dialog window when opened 
 *
 * @id Titanium.UI.EmailDialog.barColor
 * @type String
 * @property
 */

/**
 * Array of email bcc: recipients 
 *
 * @id Titanium.UI.EmailDialog.bccRecipients
 * @type Array
 * @property
 */

/**
 * Array of email cc: recipients 
 *
 * @id Titanium.UI.EmailDialog.ccRecipients
 * @type Array
 * @property
 */

/**
 * Boolean to indicate whether the email messagebody should be sent as html content type. defaults to false 
 *
 * @id Titanium.UI.EmailDialog.html
 * @type Boolean
 * @property
 */

/**
 * The email message body 
 *
 * @id Titanium.UI.EmailDialog.messageBody
 * @type String
 * @property
 */

/**
 * The subject line for the email 
 *
 * @id Titanium.UI.EmailDialog.subject
 * @type String
 * @property
 */

/**
 * Array of email recipients 
 *
 * @id Titanium.UI.EmailDialog.toRecipients
 * @type Array
 * @property
 */

/**
 * The sound object is returned by titanium.media.createsound and is useful for playing basic sounds. the sound object loads the entire media resource in memory before playing.  if you need to support streaming, use the titanium.media.createaudioplayer api. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Simple Example:
 * 
Simple example of playing a WAVE file from the Resources directory.

 * 
var player = Ti.UI.createSound({url:"sound.wav"});
 * player.play();
 * 

 * @id Titanium.Media.Sound
 * @type 
 * @since 0.8
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Media.Sound.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Media.Sound.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Return the current time position of the audio 
 *
 * @id Titanium.Media.Sound.getTime
 * @type Double
 */

/**
 * Return the value of the audio 
 *
 * @id Titanium.Media.Sound.getVolume
 * @type Float
 */

/**
 * Returns true if the audio will loop 
 *
 * @id Titanium.Media.Sound.isLooping
 * @type Boolean
 */

/**
 * Returns true if the audio is paused 
 *
 * @id Titanium.Media.Sound.isPaused
 * @type Boolean
 */

/**
 * Returns true if the audio is playing 
 *
 * @id Titanium.Media.Sound.isPlaying
 * @type Boolean
 */

/**
 * Temporarily pause the audio. to resume, invoke play. 
 *
 * @id Titanium.Media.Sound.pause
 * @type Void
 */

/**
 * Starting playing the source. if paused, will resume. 
 *
 * @id Titanium.Media.Sound.play
 * @type Void
 */

/**
 * Release all internal resources. this is typically unnecessary but can be useful if you load a large audio file in app.js and play it only once and you would like to release all releases after your final play to reduce memory. 
 *
 * @id Titanium.Media.Sound.release
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Media.Sound.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Reset the audio to the beginning. 
 *
 * @id Titanium.Media.Sound.reset
 * @type Void
 */

/**
 * Control whether the audio should loop 
 *
 * @id Titanium.Media.Sound.setLooping
 * @type Void
 */

/**
 * Control whether the audio is paused 
 *
 * @id Titanium.Media.Sound.setPaused
 * @type Void
 */

/**
 * Set the time position of the audio 
 *
 * @id Titanium.Media.Sound.setTime
 * @type Void
 */

/**
 * Set the volume of the audio 
 *
 * @id Titanium.Media.Sound.setVolume
 * @type Void
 */

/**
 * Stop playing the audio and reset it to the beginning. 
 *
 * @id Titanium.Media.Sound.stop
 * @type Void
 */

/**
 * Boolean to indicate if audio should continue playing even if activity is paused (android only as of 1.3.0) 
 *
 * @id Titanium.Media.Sound.allowBackground
 * @type Boolean
 * @property
 */

/**
 * The default audio session mode to be used for this player. one of titanium.media.audio_session_mode_ambient, titanium.media.audio_session_mode_solo_ambient titanium.media.audio_session_mode_playback titanium.media.audio_session_mode_record, titanium.media.audio_session_mode_play_and_record. 
 *
 * @id Titanium.Media.Sound.audioSessionMode
 * @type Int
 * @property
 */

/**
 * The duration of the audio. 
 *
 * @id Titanium.Media.Sound.duration
 * @type Float
 * @property
 */

/**
 * Boolean to indicate if the audio should loop upon completion 
 *
 * @id Titanium.Media.Sound.looping
 * @type Boolean
 * @property
 */

/**
 * Boolean to indicate if the audio is paused 
 *
 * @id Titanium.Media.Sound.paused
 * @type Boolean
 * @property
 */

/**
 * Boolean to indicate if the audio is playing 
 *
 * @id Titanium.Media.Sound.playing
 * @type Boolean
 * @property
 */

/**
 * The time position of the audio. 
 *
 * @id Titanium.Media.Sound.time
 * @type Float
 * @property
 */

/**
 * Url to the audio 
 *
 * @id Titanium.Media.Sound.url
 * @type String
 * @property
 */

/**
 * The volume of the audio. this volume only affects the media, not the device audio. 
 *
 * @id Titanium.Media.Sound.volume
 * @type Float
 * @property
 */

/**
 * A switch is created by the method titanium.ui.createswitch. Platforms: Android|Iphone|Ipad
 *
 * @code
 * Simple Switch Example:
 * 
The following is a simple example of a switch and receiving change events.

 * 
var basicSwitch = Titanium.UI.createSwitch({
 *     value:false
 * });
 * basicSwitch.addEventListener('change',function(e)
 * {
 *     Titanium.API.info('Basic Switch value = ' + e.value + ' act val ' + basicSwitch.value);
 * });
 * 

 * @id Titanium.UI.Switch
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.Switch.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.Switch.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.Switch.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.Switch.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.Switch.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.Switch.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.Switch.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.Switch.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.Switch.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.Switch.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.Switch.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.Switch.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.Switch.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.Switch.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.Switch.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.Switch.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.Switch.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.Switch.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.Switch.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Switch.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.Switch.center
 * @type Object
 * @property
 */

/**
 * Boolean for the state of the switch 
 *
 * @id Titanium.UI.Switch.enabled
 * @type Boolean
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.Switch.height
 * @type Float|String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Switch.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.Switch.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Switch.right
 * @type Float|String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.Switch.size
 * @type Object
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Switch.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.Switch.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.Switch.transform
 * @type Object
 * @property
 */

/**
 * Boolean value of the switch where true is the switch is on and false the switch if off 
 *
 * @id Titanium.UI.Switch.value
 * @type Boolean
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.Switch.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.Switch.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.Switch.zIndex
 * @type Int
 * @property
 */

/**
 * A toolbar is created by the method titanium.ui.createtoolbar.  a toolbar can be placed at the bottom of a window and contain buttons. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.Toolbar
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.Toolbar.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.Toolbar.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.Toolbar.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.Toolbar.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.Toolbar.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.Toolbar.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.Toolbar.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.Toolbar.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.Toolbar.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.Toolbar.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.Toolbar.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.Toolbar.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.Toolbar.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.Toolbar.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.Toolbar.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.Toolbar.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.Toolbar.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.Toolbar.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.Toolbar.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Toolbar.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.Toolbar.center
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.Toolbar.height
 * @type Float|String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Toolbar.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.Toolbar.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Toolbar.right
 * @type Float|String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.Toolbar.size
 * @type Object
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Toolbar.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.Toolbar.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.Toolbar.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.Toolbar.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.Toolbar.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.Toolbar.zIndex
 * @type Int
 * @property
 */

/**
 * The top level filesystem module.  the filesystem module is used for reading and saving files and 
 * directories on the device. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.Filesystem
 * @type Object
 * @since 0.1
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.Filesystem.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Create and return an instance of titanium.filesystem.file 
 *
 * @id Titanium.Filesystem.createFile
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.Filesystem.File
 * @type Object
 */

/**
 * Create temp file and return a titanium.filesystem.file 
 *
 * @id Titanium.Filesystem.createTempDirectory
 * @type Titanium.filesystem.file
 */

/**
 * Create a temp file and return a titanium.filesystem.file 
 *
 * @id Titanium.Filesystem.createTempFile
 * @type Titanium.filesystem.file
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.Filesystem.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Return a fully formed file path as a titanium.filesystem.file object 
 *
 * @id Titanium.Filesystem.getFile
 * @param {String} path one or more path arguments to form the full path joined together with the platform specific path separator. if a relative path is passed, the full path will be relative to the application resource folder.
 * @type Titanium.filesystem.file
 */

/**
 * Returns true if the device supports external storage such as an sd card 
 *
 * @id Titanium.Filesystem.isExteralStoragePresent
 * @type Boolean
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.Filesystem.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Constant for append mode for file operations 
 *
 * @id Titanium.Filesystem.MODE_APPEND
 * @type Int
 * @property
 */

/**
 * Constant for read mode for file operations 
 *
 * @id Titanium.Filesystem.MODE_READ
 * @type Int
 * @property
 */

/**
 * Constant for write mode for file operations 
 *
 * @id Titanium.Filesystem.MODE_WRITE
 * @type Int
 * @property
 */

/**
 * Readonly constant where your application data directory is located. this directory should be used to place applications-specific files. on iphone, this directory is also backed up. 
 *
 * @id Titanium.Filesystem.applicationDataDirectory
 * @type String
 * @property
 */

/**
 * Readonly constant where your application is located 
 *
 * @id Titanium.Filesystem.applicationDirectory
 * @type String
 * @property
 */

/**
 * Readonly platform specific line ending constant 
 *
 * @id Titanium.Filesystem.lineEnding
 * @type String
 * @property
 */

/**
 * Readonly constant where your application resources are located 
 *
 * @id Titanium.Filesystem.resourcesDirectory
 * @type String
 * @property
 */

/**
 * Readonly path separator constant 
 *
 * @id Titanium.Filesystem.separator
 * @type String
 * @property
 */

/**
 * Readonly constant where your application can place temporary files 
 *
 * @id Titanium.Filesystem.tempDirectory
 * @type String
 * @property
 */

/**
 * A set of constants for the position value that can be used for the position property of titanium.ui.tableview when invoking scrolltoindex. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.iPhone.TableViewScrollPosition
 * @type 
 * @since 0.9
 */

/**
 * The table view scrolls the row of interest to the bottom of the visible table view. 
 *
 * @id Titanium.UI.iPhone.TableViewScrollPosition.BOTTOM
 * @type Int
 * @property
 */

/**
 * The table view scrolls the row of interest to the middle of the visible table view. 
 *
 * @id Titanium.UI.iPhone.TableViewScrollPosition.MIDDLE
 * @type Int
 * @property
 */

/**
 * The table view scrolls the row of interest to be fully visible with a minimum of movement. if the row is already fully visible, no scrolling occurs. for example, if the row is above the visible area, the behavior is identical to that specified by top. this is the default. 
 *
 * @id Titanium.UI.iPhone.TableViewScrollPosition.NONE
 * @type Int
 * @property
 */

/**
 * The table view scrolls the row of interest to the top of the visible table view. 
 *
 * @id Titanium.UI.iPhone.TableViewScrollPosition.TOP
 * @type Int
 * @property
 */

/**
 * A navigation group implements a specialized view that manages the navigation of hierarchical content. the navigation group is created by the method titanium.ui.iphone.navigationgroup.
 * 
 * a navigation group is very similar to tab bars with the exception that they do not maintain a group of windows with a interface bar at the bottom. Platforms: Iphone|Ipad
 *
 * @code
 * Simple Navigation Group:
 * 
In this example, we open 2 windows in a navigation group.  When you run this, the initial window should be blue.  When you click the back button, you should see a window that should be red.

 * 
var win = Titanium.UI.createWindow();
 * var win1 = Titanium.UI.createWindow({
 *     backgroundColor:"red",
 *     title:"Red Window"
 * });
 * var nav = Titanium.UI.iPhone.createNavigationGroup({
 *    window: win1
 * });
 * win.add(nav);
 * win.open();
 * var win2 = Titanium.UI.createWindow({
 *     backgroundColor:"blue",
 *     title:"Blue Window"
 * });
 * nav.open(win2,{animated:true});
 * 

 * @id Titanium.UI.iPhone.NavigationGroup
 * @type 
 * @since 1.2
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Close a window and remove it from the navigation group 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.close
 * @param {Object} window window to close
 * @param {Object} properties optional dictionary. the only current property supported is animated which is a boolean to indicate if the window should be closed animated (default) or not.
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.hide
 * @type Void
 */

/**
 * Open a window within the navigation group 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.open
 * @param {Object} window window to open within the tab group
 * @param {Object} properties optional dictionary. the only current property supported is animated which is a boolean to indicate if the window should be opened animated (default) or not.
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.center
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.height
 * @type Float|String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.right
 * @type Float|String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.size
 * @type Object
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.iPhone.NavigationGroup.zIndex
 * @type Int
 * @property
 */

/**
 * The iphone/ipad specific ui capabilities.  all properties, methods and events in this namespace will only work on the apple iphone or ipad related devices. Platforms: Iphone|Ipad
 *
 * @id Titanium.UI.iPhone
 * @type Object
 * @since 0.5
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.iPhone.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Create and return an instance of titanium.ui.iphone.navigationgroup 
 *
 * @id Titanium.UI.iPhone.createNavigationGroup
 * @param {Object} parameters (optional) a dictionary object properties defined in Titanium.UI.iPhone.NavigationGroup
 * @type Object
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.iPhone.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Convenience method to hide the status bar 
 *
 * @id Titanium.UI.iPhone.hideStatusBar
 * @param {Boolean} animated boolean to indicate if the action should be animated
 * @param {Int} animationStyle the animation style
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.iPhone.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Convenience method to show the status bar 
 *
 * @id Titanium.UI.iPhone.showStatusBar
 * @param {Boolean} animated boolean to indicate if the action should be animated
 * @param {Int} animationStyle the animation style
 * @type Void
 */

/**
 * The view is presented using the same style as its parent window. this is currently only available currently on iphone/ipad and sdk 3.2+. 
 *
 * @id Titanium.UI.iPhone.MODAL_PRESENTATION_CURRENT_CONTEXT
 * @type Int
 * @property
 */

/**
 * The width and height of the presented window are smaller than those of the screen and the view is centered on the screen. if the device is in a landscape orientation and the keyboard is visible, the position of the view is adjusted upward so that the view remains visible. all uncovered areas are dimmed to prevent the user from interacting with them. this is currently only available currently on iphone/ipad and sdk 3.2+. 
 *
 * @id Titanium.UI.iPhone.MODAL_PRESENTATION_FORMSHEET
 * @type Int
 * @property
 */

/**
 * The presented window covers the screen. this is currently only available currently on iphone/ipad and sdk 3.2+. 
 *
 * @id Titanium.UI.iPhone.MODAL_PRESENTATION_FULLSCREEN
 * @type Int
 * @property
 */

/**
 * The height of the presented window is set to the height of the screen and the view's width is set to the width of the screen in a portrait orientation. any uncovered areas are dimmed to prevent the user from interacting with them. (in portrait orientations, this option is essentially the same as titanium.ui.iphone.modal_presentation_fullscreen). this is currently only available currently on iphone/ipad and sdk 3.2+. 
 *
 * @id Titanium.UI.iPhone.MODAL_PRESENTATION_PAGESHEET
 * @type Int
 * @property
 */

/**
 * When the window is presented, its view slides up from the bottom of the screen. on dismissal, the view slides back down. this is the default transition style. this is currently only available currently on iphone/ipad. 
 *
 * @id Titanium.UI.iPhone.MODAL_TRANSITION_STYLE_COVER_VERTICAL
 * @type Int
 * @property
 */

/**
 * When the window is presented, the current view fades out while the new view fades in at the same time. on dismissal, a similar type of cross-fade is used to return to the original view. this is currently only available currently on iphone/ipad. 
 *
 * @id Titanium.UI.iPhone.MODAL_TRANSITION_STYLE_CROSS_DISSOLVE
 * @type Int
 * @property
 */

/**
 * When the window is presented, the current view initiates a horizontal 3d flip from right-to-left, resulting in the revealing of the new view as if it were on the back of the previous view. on dismissal, the flip occurs from left-to-right, returning to the original view. this is currently only available currently on iphone/ipad. 
 *
 * @id Titanium.UI.iPhone.MODAL_TRANSITION_STYLE_FLIP_HORIZONTAL
 * @type Int
 * @property
 */

/**
 * When the window is presented, one corner of the current view curls up to reveal the modal view underneath. on dismissal, the curled up page unfurls itself back on top of the modal view. a modal view presented using this transition is itself prevented from presenting any additional modal views. this transition style is supported only if the window is presenting a titanium.ui.iphone.modal_presentation_fullscreen modal presentation style.  this is currently only available currently on iphone/ipad and sdk 3.2+. 
 *
 * @id Titanium.UI.iPhone.MODAL_TRANSITION_STYLE_PARTIAL_CURL
 * @type Int
 * @property
 */

/**
 * Set the application badge for the application's icon in the springboard 
 *
 * @id Titanium.UI.iPhone.appBadge
 * @type String
 * @property
 */

/**
 * Control whether the shake to edit system wide capability is enabled 
 *
 * @id Titanium.UI.iPhone.appSupportsShakeToEdit
 * @type Boolean
 * @property
 */

/**
 * Control the status bar visibility 
 *
 * @id Titanium.UI.iPhone.statusBarHidden
 * @type Boolean
 * @property
 */

/**
 * Constant that controls the status bar color style 
 *
 * @id Titanium.UI.iPhone.statusBarStyle
 * @type Int
 * @property
 */

/**
 * A slider is created by the method titanium.ui.createslider. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.UI.Slider
 * @type 
 * @since 0.8
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.Slider.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.Slider.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.Slider.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.Slider.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.Slider.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.Slider.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.Slider.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.Slider.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.Slider.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.Slider.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.Slider.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.Slider.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.Slider.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.Slider.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.Slider.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.Slider.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.Slider.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.Slider.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.Slider.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Slider.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.Slider.center
 * @type Object
 * @property
 */

/**
 * The image url of the slider left track when in the disabled state 
 *
 * @id Titanium.UI.Slider.disabledLeftTrackImage
 * @type String
 * @property
 */

/**
 * The image url of the slider right track when in the disabled state 
 *
 * @id Titanium.UI.Slider.disabledRightTrackImage
 * @type String
 * @property
 */

/**
 * The image url of the slider thumb when in the disabled state 
 *
 * @id Titanium.UI.Slider.disabledThumbImage
 * @type String
 * @property
 */

/**
 * Boolean to indicate the enabled state of the slider 
 *
 * @id Titanium.UI.Slider.enabled
 * @type Boolean
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.Slider.height
 * @type Float|String
 * @property
 */

/**
 * The image url of the slider left track when in the highlighted state 
 *
 * @id Titanium.UI.Slider.highlightedLeftTrackImage
 * @type String
 * @property
 */

/**
 * The image url of the slider right track when in the highlighted state 
 *
 * @id Titanium.UI.Slider.highlightedRightTrackImage
 * @type String
 * @property
 */

/**
 * The image url of the slider thumb when in the highlighted state 
 *
 * @id Titanium.UI.Slider.highlightedThumbImage
 * @type String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Slider.left
 * @type Float|String
 * @property
 */

/**
 * The image url of the slider left track 
 *
 * @id Titanium.UI.Slider.leftTrackImage
 * @type String
 * @property
 */

/**
 * The maximum slider value 
 *
 * @id Titanium.UI.Slider.max
 * @type Float
 * @property
 */

/**
 * The minimum slider value 
 *
 * @id Titanium.UI.Slider.min
 * @type Float
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.Slider.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Slider.right
 * @type Float|String
 * @property
 */

/**
 * The image url of the slider right track 
 *
 * @id Titanium.UI.Slider.rightTrackImage
 * @type String
 * @property
 */

/**
 * The image url of the slider left track when in the selected state 
 *
 * @id Titanium.UI.Slider.selectedLeftTrackImage
 * @type String
 * @property
 */

/**
 * The image url of the slider right track when in the selected state 
 *
 * @id Titanium.UI.Slider.selectedRightTrackImage
 * @type String
 * @property
 */

/**
 * The image url of the slider thumb when in the selected state 
 *
 * @id Titanium.UI.Slider.selectedThumbImage
 * @type String
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.Slider.size
 * @type Object
 * @property
 */

/**
 * The image url to the slider thumb 
 *
 * @id Titanium.UI.Slider.thumbImage
 * @type String
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.Slider.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.Slider.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.Slider.transform
 * @type Object
 * @property
 */

/**
 * The value of the slider 
 *
 * @id Titanium.UI.Slider.value
 * @type String
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.Slider.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.Slider.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.Slider.zIndex
 * @type Int
 * @property
 */

/**
 * The picker row object created by titanium.ui.createpickercolumn. Platforms: Android|Iphone|Ipad
 *
 * @id Titanium.UI.PickerColumn
 * @type 
 * @since 0.9
 */

/**
 * Add a child to the view hierarchy 
 *
 * @id Titanium.UI.PickerColumn.add
 * @param {Object} view the view to add to this views hiearchy
 * @type Void
 */

/**
 * Add an event listener for the instance to receive view triggered events 
 *
 * @id Titanium.UI.PickerColumn.addEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function to invoke when the event is fired
 * @type Void
 */

/**
 * A titanium.ui.pickerrow object to add to the column 
 *
 * @id Titanium.UI.PickerColumn.addRow[object]
 * @type Void
 */

/**
 * Animate the view 
 *
 * @id Titanium.UI.PickerColumn.animate
 * @param {Object} obj either a dictionary of animation properties or an Animation object
 * @param {Function} callback function to be invoked upon completion of the animation
 * @type Void
 */

/**
 * Fire a synthesized event to the views listener 
 *
 * @id Titanium.UI.PickerColumn.fireEvent
 * @param {String} name name of the event
 * @param {Object} event event object
 * @type Void
 */

/**
 * Hide the view 
 *
 * @id Titanium.UI.PickerColumn.hide
 * @type Void
 */

/**
 * Remove a previously add view from the view hiearchy 
 *
 * @id Titanium.UI.PickerColumn.remove
 * @param {Object} view the view to remove from this views hiearchy
 * @type Void
 */

/**
 * Remove a previously added event listener 
 *
 * @id Titanium.UI.PickerColumn.removeEventListener
 * @param {String} name name of the event
 * @param {Function} callback callback function passed in addEventListener
 * @type Void
 */

/**
 * A titanium.ui.pickerrow object to remove 
 *
 * @id Titanium.UI.PickerColumn.removeRow[object]
 * @type Void
 */

/**
 * Make the view visible 
 *
 * @id Titanium.UI.PickerColumn.show
 * @type Void
 */

/**
 * Return a blob image of the rendered view 
 *
 * @id Titanium.UI.PickerColumn.toImage
 * @param {Function} f function to be invoked upon completion. if non-null, this method will be performed asynchronously. if null, it will be performed immediately
 * @type Object
 */

/**
 * A dictionary with properties x and y to indicate the anchor point value. anchor specifies the position by which animation should occur. center is 0.5, 0.5 
 *
 * @id Titanium.UI.PickerColumn.anchorPoint
 * @type Object
 * @property
 */

/**
 * Read-only object with x and y properties of where the view is during animation 
 *
 * @id Titanium.UI.PickerColumn.animatedCenterPoint
 * @type Object
 * @property
 */

/**
 * The background color of the view 
 *
 * @id Titanium.UI.PickerColumn.backgroundColor
 * @type String
 * @property
 */

/**
 * A background gradient for the view with the properties: type,startpoint,endpoint,startradius,endradius,backfillstart,backfillend,colors. 
 *
 * @id Titanium.UI.PickerColumn.backgroundGradient
 * @type Object
 * @property
 */

/**
 * The background image url of the view 
 *
 * @id Titanium.UI.PickerColumn.backgroundImage
 * @type String
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the left end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the right end cap is therefore computed by adding the size of the left end cap and the middle portion together and then subtracting that value from the width of the image 
 *
 * @id Titanium.UI.PickerColumn.backgroundLeftCap
 * @type Float
 * @property
 */

/**
 * End caps specify the portion of an image that should not be resized when an image is stretched. this technique is used to implement buttons and other resizable image-based interface elements. when a button with end caps is resized, the resizing occurs only in the middle of the button, in the region between the end caps. the end caps themselves keep their original size and appearance. this property specifies the size of the top end cap. the middle (stretchable) portion is assumed to be 1 pixel wide. the bottom end cap is therefore computed by adding the size of the top end cap and the middle portion together and then subtracting that value from the height of the image 
 *
 * @id Titanium.UI.PickerColumn.backgroundTopCap
 * @type Float
 * @property
 */

/**
 * The border color of the view 
 *
 * @id Titanium.UI.PickerColumn.borderColor
 * @type String
 * @property
 */

/**
 * The border radius of the view 
 *
 * @id Titanium.UI.PickerColumn.borderRadius
 * @type Float
 * @property
 */

/**
 * The border width of the view 
 *
 * @id Titanium.UI.PickerColumn.borderWidth
 * @type Float
 * @property
 */

/**
 * Property for the view bottom position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.PickerColumn.bottom
 * @type Float|String
 * @property
 */

/**
 * A dictionary with properties x and y to indicate the center of the views position relative to the parent view 
 *
 * @id Titanium.UI.PickerColumn.center
 * @type Object
 * @property
 */

/**
 * Property for the view height. can be either float value or a string of the width. 
 *
 * @id Titanium.UI.PickerColumn.height
 * @type Float|String
 * @property
 */

/**
 * Property for the view left position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.PickerColumn.left
 * @type Float|String
 * @property
 */

/**
 * The opacity from 0.0-1.0 
 *
 * @id Titanium.UI.PickerColumn.opacity
 * @type Float
 * @property
 */

/**
 * Property for the view right position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.PickerColumn.right
 * @type Float|String
 * @property
 */

/**
 * Number of rows in the column (readonly) 
 *
 * @id Titanium.UI.PickerColumn.rowCount
 * @type Int
 * @property
 */

/**
 * An array of rows 
 *
 * @id Titanium.UI.PickerColumn.rows
 * @type Array
 * @property
 */

/**
 * The size of the view as a dictionary of width and height properties 
 *
 * @id Titanium.UI.PickerColumn.size
 * @type Object
 * @property
 */

/**
 * Property for the view top position. this position is relative to the views parent. can be either a float value or a string of the width. 
 *
 * @id Titanium.UI.PickerColumn.top
 * @type Float|String
 * @property
 */

/**
 * A boolean indicating if the view should receive touch events (true, default) or forward them to peers (false) 
 *
 * @id Titanium.UI.PickerColumn.touchEnabled
 * @type Boolean
 * @property
 */

/**
 * The transformation matrix to apply to the view 
 *
 * @id Titanium.UI.PickerColumn.transform
 * @type Object
 * @property
 */

/**
 * A boolean of the visibility of the view 
 *
 * @id Titanium.UI.PickerColumn.visible
 * @type Boolean
 * @property
 */

/**
 * Property for the view width. can either be `auto`, a float value or a string of the width. 
 *
 * @id Titanium.UI.PickerColumn.width
 * @type Float|String
 * @property
 */

/**
 * The z index position relative to other sibling views 
 *
 * @id Titanium.UI.PickerColumn.zIndex
 * @type Int
 * @property
 */

/**
 * An object which represents a group in the contacts database. Platforms: Iphone|Ipad
 *
 * @id Titanium.Contacts.Group
 * @type 
 * @since 1.4.0
 */

/**
 * Adds a person to the group 
 *
 * @id Titanium.Contacts.Group.add
 * @param {Object} person Titanium.Contacts.Person object to remove from the group
 * @type Void
 */

/**
 * The complete list of members of the group 
 *
 * @id Titanium.Contacts.Group.members
 * @type Void
 */

/**
 * Removes a person from the group 
 *
 * @id Titanium.Contacts.Group.remove
 * @param {Object} person Titanium.Contacts.Person object to remove from the group
 * @type Void
 */

/**
 * A list of sorted members 
 *
 * @id Titanium.Contacts.Group.sortedMembers
 * @param {Int} sortBy Method for sorting. Must be one of Titanium.Contacts.CONTACTS_SORT_FIRST_NAME or Titanium.Contacts.CONTACTS_SORT_LAST_NAME
 * @type Void
 */

/**
 * The name of the group 
 *
 * @id Titanium.Contacts.Group.name
 * @type String
 * @property
 */