Since: BlackBerry 10.0.0

#include <bb/cascades/RepeatPattern>

Specifies how and if an image should be repeated within a container.

The RepeatPattern::Type is used by ImagePaint and ImagePaintDefinition to specify if and how the image should be repeated over the filled area.

The possible values are
  • Fill: stretches the image to fit assigned area without preserveing image's aspect ratio

  • X: image is repeated along X-axis and is stretched in the Y-axis direction

  • Y: image is repeated along Y-axis and is stretched in the X-axis direction

  • XY: image is repeated along X-axis and Y-axis

If repeat is set and the area dimensions are not exact multiples of the source image dimensions, the final images in the repeat sequence will be cut off in order to preserve the area.

The provided image must also have a width and height that is a power of two in order to be tileable (for example, 4x4, 8x8, 16x16, 32x32, 64x64, 128x128, 256x256, 128x64, 32x16). It also needs to have the "repeatable: true|false" property set in the asset metadata file. The asset metadata file is an .amd file with the same name as the image itself. This file can also contain nine-slicing attributes, however the tiling of nine-sliced images is not currently supported.

Here's an example of an .amd file called tiled_image.amd that has the repeatable property set to true.

 #RimCascadesAssetMetaData version=1.0
 source: "tiled_image.png"
 repeatable: true


Public Types Index

enum Type

Fill 0x0, X 0x1, Y 0x2, XY 0x3

Public Types


The different repeat methods.


BlackBerry 10.0.0

Fill 0x0

Image is stretched to fill the area without preserving aspect ratio.

X 0x1

Image is repeated along the X-axis, stretched along Y-axis.


BlackBerry 10.0.0

Y 0x2

Image is repeated along the Y-axis, stretched along X-axis.


BlackBerry 10.0.0

XY 0x3

Image is repeated along both the X- and Y-axis.


BlackBerry 10.0.0

Last modified: 2014-09-30

Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus