Layer that displays a rotated bitmap image.
A RotBitmapLayer is like a BitmapLayer but has the ability to be rotated (by default, around its center). The amount of rotation is specified using rot_bitmap_layer_set_angle() or rot_bitmap_layer_increment_angle(). The rotation argument to those functions is specified as an amount of clockwise rotation, where the value 0x10000 represents a full 360 degree rotation and 0 represent no rotation, and it scales linearly between those values, just like sin_lookup.
The center of rotation in the source bitmap is always placed at the center of the RotBitmapLayer and the size of the RotBitmapLayer is automatically calculated so that the entire Bitmap can fit in at all rotation angles.
For example, if the image is 10px wide and high, the RotBitmapLayer will be 14px wide ( sqrt(10^2+10^2) ).
By default, the center of rotation in the source bitmap is the center of the bitmap but you can call rot_bitmap_set_src_ic() to change the center of rotation.
Creates a new RotBitmapLayer on the heap and initializes it with the default values:
Angle: 0
Compositing mode: GCompOpAssign
Corner clip color: GColorClear
The bitmap to display in this RotBitmapLayer
A pointer to the RotBitmapLayer. NULL if the RotBitmapLayer could not be created
Destroys a RotBitmapLayer and frees all associated memory.
It is the developer responsibility to free the GBitmap.
The RotBitmapLayer to destroy.
Defines what color to use in areas that are not covered by the source bitmap. By default this is GColorClear.
The RotBitmapLayer on which to change the corner clip color
The corner clip color
Sets the rotation angle of this RotBitmapLayer.
The RotBitmapLayer on which to change the rotation
Rotation is an integer between 0 (no rotation) and 0x10000 (360 degree rotation).
Change the rotation angle of this RotBitmapLayer.
The RotBitmapLayer on which to change the rotation
The rotation angle change
Defines the only point that will not be affected by the rotation in the source bitmap.
For example, if you pass GPoint(0, 0), the image will rotate around the top-left corner.
This point is always projected at the center of the RotBitmapLayer. Calling this function automatically adjusts the width and height of the RotBitmapLayer so that the entire bitmap can fit inside the layer at all rotation angles.
The RotBitmapLayer on which to change the rotation
The only point in the original image that will not be affected by the rotation.
Sets the compositing mode of how the bitmap image is composited onto what has been drawn beneath the RotBitmapLayer. By default this is GCompOpAssign. The RotBitmapLayer is automatically marked dirty after this operation.
The RotBitmapLayer on which to change the rotation
The compositing mode to set
Do you have questions about the Pebble SDK?
Do you need some help understanding something on this page?
You can either take advantage of our awesome developer community and check out the SDK Help forums, or you can send us a message through the website!