Using the <CODE>photo</CODE> Region

# Using the photo Region

## Introduction

This page summarizes information related to the `photo` region, which is used to save photo data captured from the Nintendo DSi Menu or Nintendo DSi Camera.

## The photo Region

The Nintendo DSi Menu and the photos captured with Nintendo DSi Camera are stored in the `photo` region in system (NAND) memory. You can write photo data in the `photo` region to an SD Card or load photo data from an SD Card to the `photo` region through the Nintendo DSi Camera. Accessing this `photo` region with the TCL library allows developers to use photo data captured using the Nintendo DSi Camera (or some other means) from within applications, and to save photo data captured from applications to the `photo` region, where it can then be viewed using the Nintendo DSi Camera's Album functionality. Note that as of TWL-SDK 5.1, the `photo` region can no longer be accessed if the RSF file is not configured appropriately. It is also prohibited to access the `photo` region without using the TCL library.

## Data That Can Be Saved in the photo Region

To prevent the `photo` region from being used to store illegal data, from being taken over by an application, or from being put to some other purpose, a digital signature must be attached to all photo data stored in the `photo` region. As a result, an application must always attach a digital signature to photo data saved to the `photo` region. However, application developers do not need to pay particular attention to this when using the TCL library as long as the RSF file is configured properly, as described in the next section.

## RSF File Settings

To access the `photo` region using the TCL library, you must set access rights to the `photo` region (described in The `photo` Region) and set the signature key for attaching a signature to photo data (described in Data That Can Be Saved in the `photo` Region). Specifically, add the following items to the `Property` section of the RSF file in environments that use TWL-SDK 5.2 or later.

- Applications that can only read photo data:
  `PhotoAccess Read`
- Applications that can read and write photo data:
  `PhotoAccess ReadWrite`

## Other Notes

##### The PhotoChecker Tool

The PhotoChecker tool has been provided to check for inappropriate data created in the `photo` region. You can use this tool to confirm that inappropriate data is not being created while developing an application that uses the `photo` region.

##### Photo Data Shown as Wallpaper on the Nintendo DSi Menu

A photo can be shown as the wallpaper for the Nintendo DSi Menu only if it was captured from the Nintendo DSi Menu or if it was captured from the Nintendo DSi Camera and is marked as a favorite (labeled with a "star" sticker). Consequently, photos saved by an application cannot be shown as the wallpaper for the Nintendo DSi Menu.
Note: However, a photo saved by an application can be shown unchanged as the wallpaper for the Nintendo DSi Menu if Edit is selected for that photo from the Album menu in the Nintendo DSi Camera and the photo is saved without being modified.

## Revision History

2009/04/13 Initial version.

CONFIDENTIAL