A file manager is an application which can manage the filesystem's content. It does not have any restriction on its user interface, but needs to expose an integration service with the standardized methods and notifications described in this document.
Applications can indicate themselves as file manager by specifying an SYS_FMAN service in their manifest. They rely on file openers to open files.
The end user chooses a single file manager (called the default file manager) between all available ones, whose service will be used by other applications.
Open a filesystem item.
Arguments:
Answer:
None
Errors:
0x3000: Invalid FMP0x3001: Could not find the provided item0x4000: User cancelled the opening0x4001: Could not find an application to open the provided item0x4002: Failed to open the provided item due to an I/O error0x4FFF: Unspecified error
Check if a filesystem item could be opened without user interaction.
Arguments:
Answer:
0x02if the file could be opened without user interaction,0x01if it couldn't,0x00if the file couldn't be opened at all
Errors:
0x3000: Invalid FMP0x3001: Could not find the provided item0x4000: Unspecified error
Get the thumbnail for a specific 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.
The thumbnail can be requested to have a specific width and height. The returned thumbnail may not have the correct size, but this will require the system to resize the picture.
Arguments:
- Refresh mode (1 byte):
0x00to get the current thumbnail or a cached one,0x01to force generating a new thumbnail for the item - Filesystem path
- Requested thumbnail width (2 bytes) and height (2 bytes) in pixels, or
0if no request
Answer:
- Thumbnail as a bitmap image
Errors:
0x3000: Invalid FMP0x3001: Could not find the provided item0x4000: The thumbnail generator failed0x4FFF: Unspecified error
Get the video preview for a specific item.
The preview should be generated using the sys::fsh system service, which will provide the cached preview (if any) and else ask for a preview buffer, which will be put in the cache if relevant.
The preview can be requested to have a specific width and height. The returned preview may not have the correct size, but this will require the system to resize the video.
Arguments:
- Refresh mode (1 byte):
0x00to get the current preview or a cached one,0x01to force generating a new preview for the item - Filesystem path
- Requested preview width (2 bytes) and height (2 bytes) in pixels, or
0if no request
Answer:
- Preview as a bitmap video
Errors:
0x3000: Invalid FMP0x3001: Could not find the provided item0x4000: The preview generator failed0x4FFF: Unspecified error
Generate a context menu for a specific filesystem item. Used by the DEA.
Arguments:
Answer:
- Interface window identifier (8 bytes)
Errors:
0x3000: Invalid FMP0x3001: Could not find the provided item0x4000: User cancelled the opening0x3001: Could not find an application to open the provided item0x4002: Failed to open the provided item due to an I/O error0x4FFF: Unspecified error