pebble/devsite/source/_guides/app-resources/raw-data-files.md

title	description	guide_group	order	platform_choice
Raw Data Files	How to add raw data resources to a project and read them in your app.	app-resources	7	true

Some kinds of apps will require extra data that is not a font or an image. In these cases, the file can be included in a Pebble project as a raw resource. When a file is included as a raw resource, it is not modified in any way from the original when the app is built.

Applications of this resource type can be found in the Pebble SDK for APIs such as GDrawCommand and GBitmapSequence, which both use raw resources as input files. Other possible applications include localized string dictionaries, CSV data files, etc.

Adding Raw Data Files

{% platform local %} To add a file as a raw resource, specify its type as raw in package.json. An example is shown below:

"resources": {
  "media": [
    {
      "type": "raw",
      "name": "EXAMPLE_DATA_FILE",
      "file": "data.bin"
    }
  ]
}

{% endplatform %}

{% platform cloudpebble %} To add a file as a raw resource, click 'Add New' in the Resources section of the sidebar, and set the 'Resource Type' as 'raw binary blob'. {% endplatform %}

Reading Bytes and Byte Ranges

Once a raw resource has been added to a project, it can be loaded at runtime in a manner similar to other resources types:

// Get resource handle
ResHandle handle = resource_get_handle(RESOURCE_ID_DATA);

With a handle to the resource now available in the app, the size of the resource can be determined:

// Get size of the resource in bytes
size_t res_size = resource_size(handle);

To read bytes from the resource, create an appropriate byte buffer and copy data into it:

// Create a buffer the exact size of the raw resource
uint8_t *s_buffer = (uint8_t*)malloc(res_size);

The example below copies the entire resource into a uint8_t buffer:

// Copy all bytes to a buffer
resource_load(handle, s_buffer, res_size);

It is also possible to read a specific range of bytes from a given offset into the buffer:

// Read the second set of 8 bytes
resource_load_byte_range(handle, 8, s_buffer, 8);