File openers

A file opener is an application which can associate open specific items. It exposes an integration service with the standardized methods and notifications described in this document.

The list of openers can be viewed and modified through the sys::fsh.

They are essentially used by the default file manager.

Methods

0x1000 OPEN_ITEM

Open a filesystem item.

Arguments:

Answer:

None

Errors:

  • 0x3000: Invalid FMP
  • 0x3001: Could not find the provided item
  • 0x3002: User cancelled the opening
  • 0x3003: Could not find an application to open the provided item
  • 0x3004: Failed to open the provided item due to an I/O error
  • 0x3FFF: Unspecified error

0x2000 GENERATE_THUMBNAIL

Generate a thumbnail for a given filesystem item.

The thumbnail should be generated using the sys::fsh system service, which will provide the cached thumbnail (if any) and else ask for a thumbnail buffer, which will be put in the cache if relevant.

Arguments:

Answer:

Errors:

  • 0x3000: Invalid FMP
  • 0x3001: Could not find the provided item
  • 0x3002: This application does not support thumbnail generation for this item type
  • 0x3003: Thumbnail could not be generated from the item as its content is invalid
  • 0x3FFF: Unspecified error

0x2001 CAN_GENERATE_THUMBNAIL

Check if the application can generate a thumbnail for a specific filesystem item.
If it cannot, the default file manager will be in charge of providing a placeholder or using an alternative thumbnail generator.

Arguments:

Answer:

  • 0x01 if the application can generate a thumbnail for the provided filesystem item, 0x00 else

Errors:

  • 0x3000: Invalid FMP
  • 0x3001: Could not find the provided item
  • 0x3002: Thumbnail could not be generated from the item as its content is invalid
  • 0x3FFF: Unspecified error