Managing application resources.
Resources are data files that are bundled with your application binary and can be loaded at runtime. You use resources to embed images or custom fonts in your app, but also to embed any data file. Resources are always read-only.
Resources are stored on Pebble’s flash memory and only loaded in RAM when you load them. This means that you can have a large number of resources embedded inside your app, even though Pebble’s RAM memory is very limited.
See App Resources in the Pebble Developer Guides for information on how to embed resources into your app's bundle.
Gets the resource handle for a file identifier.
The resource IDs are auto-generated by the Pebble build process, based on the appinfo.json
. The "name" field of each resource is prefixed by RESOURCE_ID_
and made visible to the application (through the build/src/resource_ids.auto.h
header which is automatically included).
For example, given the following fragment of appinfo.json
:
...
"resources" : {
"media": [
{
"name": "MY_ICON",
"file": "img/icon.png",
"type": "png",
},
...
RESOURCE_ID_MY_ICON
. To get a resource handle for that resource write: ResHandle rh = resource_get_handle(RESOURCE_ID_MY_ICON);
The resource ID
Copies the bytes for the resource with a given handle from flash storage into a given buffer.
The handle to the resource
The buffer to load the resource data into
The maximum number of bytes to copy
The number of bytes actually copied
Copies a range of bytes from a resource with a given handle into a given buffer.
The handle to the resource
The offset in bytes at which to start reading from the resource
The buffer to load the resource data into
The maximum number of bytes to copy
The number of bytes actually copied
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!