include/pnd_pxml.h

   1
   2 #ifndef h_pnd_pxml_h
   3 #define h_pnd_pxml_h
   4
   5 #ifdef __cplusplus
   6 extern "C" {
   7 #endif
   8
   9 // this code is for very basic PXML.xml file parsing
  10
  11 #define PXML_FILENAME "PXML.xml" /* a specification defined name */
  12 #define PXML_TAGHEAD "<PXML" /* case insensitive; allow for trailing attributes */
  13 #define PXML_TAGFOOT "</PXML>" /* case insensitive */
  14
  15 #define PXML_MAXAPPS 20 /* max number of <application>'s within a single PXML */
  16
  17 // use this handle to interact with PXML; this hides the mechanics of parsing a PXML file so that
  18 // it can be upgraded with impacting applications
  19 typedef void* pnd_pxml_handle;
  20
  21 /* pxml_fetch() will return NULL on fail, otherwise a valid handle which may be further queried
  22  */
  23 pnd_pxml_handle *pnd_pxml_fetch ( char *fullpath );
  24 pnd_pxml_handle *pnd_pxml_fetch_buffer ( char *filename, char *buffer );
  25 void pnd_pxml_delete ( pnd_pxml_handle h );
  26
  27 /* overrides() allow for customization of a PXML that persists; ie: An application might be sitting
  28  * on an SD card and popped out while we need to edit its personalized category; more to point, the
  29  * PXML itself could be in a read-only SD or packed into an ISO, or just sitting in a directory.
  30  * Rather than have a _second_ PXML in the same place or have to write back to read-only media or
  31  * worry about losing customizations when an app is temporarily deleted, we can just keep the
  32  * overrides themselves in NAND.
  33  */
  34 /* merge_override() will attempt to locate an override of the given PXML, and will modify the
  35  * PXML in-place to include any overrides found.
  36  * Returns >0 if a merge was done, 0 if no merge was done, and <0 on error
  37  * NOTE: For searchpath, should query configs for PND_PXML_OVERRIDES_KEY (or use PND_PXML_OVERRIDES_SEARCHPATH)
  38  */
  39 signed char pnd_pxml_merge_override ( pnd_pxml_handle h, char *searchpath );
  40
  41 /* these accessor functions will return READ ONLY char*s; do not free them or modify them.
  42  */
  43 char *pnd_pxml_get_app_name_en ( pnd_pxml_handle h );
  44 char *pnd_pxml_get_app_name_de ( pnd_pxml_handle h );
  45 char *pnd_pxml_get_app_name_it ( pnd_pxml_handle h );
  46 char *pnd_pxml_get_app_name_fr ( pnd_pxml_handle h );
  47 char *pnd_pxml_get_app_name ( pnd_pxml_handle h, char *iso_lang );
  48 char *pnd_pxml_get_unique_id ( pnd_pxml_handle h );
  49 char *pnd_pxml_get_standalone ( pnd_pxml_handle h );
  50 char *pnd_pxml_get_icon ( pnd_pxml_handle h );
  51 char *pnd_pxml_get_description_en ( pnd_pxml_handle h );
  52 char *pnd_pxml_get_description_de ( pnd_pxml_handle h );
  53 char *pnd_pxml_get_description_it ( pnd_pxml_handle h );
  54 char *pnd_pxml_get_description_fr ( pnd_pxml_handle h );
  55 char *pnd_pxml_get_description ( pnd_pxml_handle h, char *iso_lang);
  56 char *pnd_pxml_get_previewpic1 ( pnd_pxml_handle h );
  57 char *pnd_pxml_get_previewpic2 ( pnd_pxml_handle h );
  58 char *pnd_pxml_get_author_name ( pnd_pxml_handle h );
  59 char *pnd_pxml_get_author_website ( pnd_pxml_handle h );
  60 char *pnd_pxml_get_version_major ( pnd_pxml_handle h );
  61 char *pnd_pxml_get_version_minor ( pnd_pxml_handle h );
  62 char *pnd_pxml_get_version_release ( pnd_pxml_handle h );
  63 char *pnd_pxml_get_version_build ( pnd_pxml_handle h );
  64 char *pnd_pxml_get_exec ( pnd_pxml_handle h );
  65 char *pnd_pxml_get_execargs ( pnd_pxml_handle h );
  66 char *pnd_pxml_get_exec_option_no_x11 ( pnd_pxml_handle h );
  67 char *pnd_pxml_get_main_category ( pnd_pxml_handle h );
  68 char *pnd_pxml_get_subcategory1 ( pnd_pxml_handle h );
  69 char *pnd_pxml_get_subcategory2 ( pnd_pxml_handle h );
  70 char *pnd_pxml_get_altcategory ( pnd_pxml_handle h );
  71 char *pnd_pxml_get_altsubcategory1 ( pnd_pxml_handle h );
  72 char *pnd_pxml_get_altsubcategory2 ( pnd_pxml_handle h );
  73 char *pnd_pxml_get_osversion_major ( pnd_pxml_handle h );
  74 char *pnd_pxml_get_osversion_minor ( pnd_pxml_handle h );
  75 char *pnd_pxml_get_osversion_release ( pnd_pxml_handle h );
  76 char *pnd_pxml_get_osversion_build ( pnd_pxml_handle h );
  77 char *pnd_pxml_get_associationitem1_name ( pnd_pxml_handle h );
  78 char *pnd_pxml_get_associationitem1_filetype ( pnd_pxml_handle h );
  79 char *pnd_pxml_get_associationitem1_parameter ( pnd_pxml_handle h );
  80 char *pnd_pxml_get_associationitem2_name ( pnd_pxml_handle h );
  81 char *pnd_pxml_get_associationitem2_filetype ( pnd_pxml_handle h );
  82 char *pnd_pxml_get_associationitem2_parameter ( pnd_pxml_handle h );
  83 char *pnd_pxml_get_associationitem3_name ( pnd_pxml_handle h );
  84 char *pnd_pxml_get_associationitem3_filetype ( pnd_pxml_handle h );
  85 char *pnd_pxml_get_associationitem3_parameter ( pnd_pxml_handle h );
  86 char *pnd_pxml_get_clockspeed ( pnd_pxml_handle h );
  87 char *pnd_pxml_get_background ( pnd_pxml_handle h );
  88 char *pnd_pxml_get_startdir ( pnd_pxml_handle h );
  89 char *pnd_pxml_get_mkdir ( pnd_pxml_handle h );
  90 char *pnd_pxml_get_info_name ( pnd_pxml_handle h );
  91 char *pnd_pxml_get_info_type ( pnd_pxml_handle h );
  92 char *pnd_pxml_get_info_src ( pnd_pxml_handle h );
  93
  94 // for 'set' functions, pass NULL value to delete existing value without setting new one
  95 void pnd_pxml_set_app_name ( pnd_pxml_handle h, char *v );
  96
  97 /* utilities
  98  */
  99 typedef enum {
 100   pnd_pxml_x11_error = 0,
 101   pnd_pxml_x11_required,
 102   pnd_pxml_x11_ignored,
 103   pnd_pxml_x11_stop
 104 } pnd_pxml_x11_req_e;
 105 pnd_pxml_x11_req_e pnd_pxml_get_x11 ( char *pxmlvalue ); // returns error, required, ignored, stop hint
 106 unsigned char pnd_is_pxml_valid_app ( pnd_pxml_handle h ); // returns 1 when pxml seems like a valid application
 107 unsigned char pnd_pxml_is_affirmative ( char *v ); // return 1 for 'Y' or '!'
 108
 109 typedef struct
 110 {
 111         char *language;
 112         char *string;
 113 } pnd_localized_string_t;
 114
 115 typedef struct
 116 {
 117         unsigned char subapp_number; // 0 for 'only app'; 1+ for <application> # .. first <application> is 1.
 118         pnd_localized_string_t *titles;
 119         int titles_c;
 120         int titles_alloc_c;
 121         char *unique_id;
 122         char *standalone;
 123         char *icon;
 124         pnd_localized_string_t *descriptions;
 125         int descriptions_c;
 126         int descriptions_alloc_c;
 127         char *previewpic1;
 128         char *previewpic2;
 129         char *author_name;
 130         char *author_website;
 131         char *version_major;
 132         char *version_minor;
 133         char *version_release;
 134         char *version_build;
 135         char *exec;
 136         char *execargs;
 137         char *main_category;
 138         char *subcategory1;
 139         char *subcategory2;
 140         char *altcategory;
 141         char *altsubcategory1;
 142         char *altsubcategory2;
 143         char *osversion_major;
 144         char *osversion_minor;
 145         char *osversion_release;
 146         char *osversion_build;
 147         char *associationitem1_name;
 148         char *associationitem1_filetype;
 149         char *associationitem1_parameter;
 150         char *associationitem2_name;
 151         char *associationitem2_filetype;
 152         char *associationitem2_parameter;
 153         char *associationitem3_name;
 154         char *associationitem3_filetype;
 155         char *associationitem3_parameter;
 156         char *clockspeed;
 157         char *background;
 158         char *startdir;
 159         char *exec_no_x11;
 160         char *package_name;
 161         char *package_release_date;
 162         char *mkdir_sp; // a colon separated list of paths to be mkdir'd (silently fail) when pnd is autodiscovered. path is always relative to the root of the hosting device.
 163
 164         char *info_name;      // should be a struct..
 165         char *info_filename;
 166         char *info_type;
 167
 168 }  pnd_pxml_t;
 169
 170 #ifdef __cplusplus
 171 } /* "C" */
 172 #endif
 173
 174 #endif