# Titanium.Android.BigPictureStyle

> Helper object for generating large-format notifications that include a large image attachment.

- Source: https://titaniumsdk.com/docs/sdk/12.5.0/Titanium.Android.BigPictureStyle
- Titanium SDK version: 12.5.0
- Kind: proxy
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Extends: Titanium.Proxy
- Inheritance: Titanium.Proxy

If the platform does not provide large-format notifications, this style helper has no effect.
The user will always see the normal notification view.

This style object attaches to a [Titanium.UI.Notification](https://titaniumsdk.com/docs/sdk/Titanium.UI.Notification.md) object and modifies its behavior.

## Example: Big picture style Example

This example will be use image that placed in one of the density-specific folder
under `Resources/android/images`

``` js
var bigPictureStyle = Titanium.Android.createBigPictureStyle({
    bigPicture: "/images/bigPicture.png",
    bigContentTitle: "Title for big picture",
    summaryText: "Summary for big picture"
});
```

Create big image style notification

``` js
var notification = Titanium.Android.createNotification({
    contentTitle: 'Something Happened',
    contentText : 'Click to return to the application.',
    style: bigPictureStyle,
    time: Date.now()
});
```

Send the notification.

``` js
Titanium.Android.NotificationManager.notify(1, notification);
```

## Properties

### bigContentTitle

- Type: String
- Platforms: Android
- Default: `<Titanium.Android.Notification.contentTitle>`

Overrides [Titanium.Android.Notification.contentTitle](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#contentTitle) in the big form of the notification. This defaults to the value passed to [Titanium.Android.Notification.contentTitle](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#contentTitle).

### bigLargeIcon

- Type: Number | String
- Platforms: Android

Override the [Titanium.Android.Notification.largeIcon](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#largeIcon) when the big notification is shown.

If specified as a URL, the icon must be placed in one of the density-specific
folders under `Resources/android/images`. For example, if your icon is called
`my_big_large_icon.png`, you would create high- and medium-density versions of the icons
with the following paths:

```
Resources/android/images/res-hdpi/my_big_large_icon.png
Resources/android/images/res-mdpi/my_big_large_icon.png
```

To access this icon, you'd use the URL '/images/my_big_large_icon.png'.

To access the same icon using an Android resource ID, place the icon in:

```
platform/android/res/drawable/my_big_large_icon.png
```

This icon's resource ID can be referenced through the [Titanium.App.Android.R](https://titaniumsdk.com/docs/sdk/Titanium.App.Android.md#R)
object:

``` js
icon: Ti.App.Android.R.drawable.my_big_large_icon,
```

See [Titanium.App.Android.R](https://titaniumsdk.com/docs/sdk/Titanium.App.Android.md#R) for more information on accessing
Android resources by ID.

### bigPicture

- Type: Number | String | Titanium.Blob | Titanium.Filesystem.File
- Platforms: Android

Provide the bitmap to be used as the payload for the BigPicture notification.

Image to display, defined using a local filesystem path, a `File` object, a remote URL,
or a `Blob` object containing image data.

If there is a redirect and change in protocol, it will not follow. For example,
from http to https and vice versa. See [Java Bug Database](https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4620571)
for more information.

If specified as a local URL, the bigPicture must be placed in one of the density-specific
folders under `Resources/android/images`. For example, if your bigPicture is called
`my_big_picture.png`, you would create high- and medium-density versions of the bigPicture
with the following paths:

```
Resources/android/images/res-hdpi/my_big_picture.png
Resources/android/images/res-mdpi/my_big_picture.png
```

To access this bigPicture, you'd use the URL '/images/my_big_picture.png'.

To access the same bigPicture using an Android resource ID, place the bigPicture in:

```
platform/android/res/drawable/my_big_picture.png
```

This bigPicture's resource ID can be referenced through the [Titanium.App.Android.R](https://titaniumsdk.com/docs/sdk/Titanium.App.Android.md#R)
object:

``` js
bigPicture: Ti.App.Android.R.drawable.my_big_picture,
```

See [Titanium.App.Android.R](https://titaniumsdk.com/docs/sdk/Titanium.App.Android.md#R) for more information on accessing
Android resources by ID.

### decodeRetries

- Type: Number
- Platforms: Android
- Default: `2`

Number of times to retry decoding the bitmap at bigPicture URL.

Defaults to 2 on Titanium 10.1.0 and higher. Defaults to 5 on older SDK versions.

### summaryText

- Type: String
- Platforms: Android

Set the first line of text after the detail section in the big form of the notification.

## Inherited members

7 members are inherited. Each is documented on the type that declares it.

- [Titanium.Proxy](https://titaniumsdk.com/docs/sdk/12.5.0/Titanium.Proxy.md): `addEventListener`, `apiName`, `applyProperties`, `bubbleParent`, `fireEvent`, `lifecycleContainer`, `removeEventListener`

---

- This corpus documents Titanium SDK 13.4.1. Anything here that does not name a version describes 13.4.1.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.