talk.c helper functions to voice a filename, in a more generic way

than from tree.c
Voice a file or dir's thumbnail from path components,
or spell last path component. Ability to prefix the thumbnail or
spelling with some talk ids.

This is the talk_file patch from FS#6323, just refactored a bit.


git-svn-id: svn://svn.rockbox.org/rockbox/trunk@18048 a1c6a512-1295-4272-9138-f99709370657

apps/talk.c

@@ -655,7 +655,9 @@ void talk_force_enqueue_next(void)
 }
 
 /* play a thumbnail from file */
-int talk_file(const char* filename, bool enqueue)
+/* Returns size of spoken thumbnail, so >0 means something is spoken,
+   <=0 means something went wrong. */
+static int _talk_file(const char* filename, long *prefix_ids, bool enqueue)
 {
     int fd;
     int size;
@@ -713,6 +715,11 @@ int talk_file(const char* filename, bool enqueue)
 #if CONFIG_CODEC != SWCODEC && !defined(SIMULATOR)
         bitswap(p_thumbnail, size);
 #endif
+        if(prefix_ids)
+            /* prefix thumbnail by speaking these ids, but only now
+               that we know there's actually a thumbnail to be
+               spoken. */
+            talk_idarray(prefix_ids, true);
         talk_queue_lock();
         thumbnail_buf_used = thumb_used +size;
         talk_queue_unlock();
@@ -722,6 +729,105 @@ int talk_file(const char* filename, bool enqueue)
     return size;
 }
 
+int
+talk_file(const char *root, const char *dir, const char *file,
+          const char *ext, long *prefix_ids, bool enqueue)
+/* Play a thumbnail file */
+{
+    char buf[MAX_PATH];
+    /* Does root end with a slash */
+    char *slash = (root && root[0]
+                   && root[strlen(root)-1] != '/') ? "/" : "";
+    snprintf(buf, MAX_PATH, "%s%s%s%s%s%s",
+             root ? root : "", slash,
+             dir ? dir : "", dir ? "/" : "",
+             file ? file : "",
+             ext ? ext : "");
+    return _talk_file(buf, prefix_ids, enqueue);
+}
+
+static int
+talk_spell_basename(const char *path,
+                    long *prefix_ids, bool enqueue)
+{
+    if(prefix_ids)
+    {
+        talk_idarray(prefix_ids, enqueue);
+        enqueue = true;
+    }
+    char buf[MAX_PATH];
+    /* Spell only the path component after the last slash */
+    strncpy(buf, path, MAX_PATH);
+    if(strlen(buf) >1 && buf[strlen(buf)-1] == '/')
+        /* strip trailing slash */
+        buf[strlen(buf)-1] = '\0';
+    char *ptr = strrchr(buf, '/');
+    if(ptr && strlen(buf) >1)
+        ++ptr;
+    else ptr = buf;
+    return talk_spell(ptr, enqueue);
+}
+
+/* Play a file's .talk thumbnail, fallback to spelling the filename, or
+   go straight to spelling depending on settings. */
+int talk_file_or_spell(const char *dirname, const char *filename,
+                       long *prefix_ids, bool enqueue)
+{
+    if (global_settings.talk_file_clip)
+    {   /* .talk clips enabled */
+        if(talk_file(dirname, NULL, filename, file_thumbnail_ext,
+                              prefix_ids, enqueue) >0)
+            return 0;
+    }
+    if (global_settings.talk_file == 2)
+        /* Either .talk clips are disabled, or as a fallback */
+        return talk_spell_basename(filename, prefix_ids, enqueue);
+    return 0;
+}
+
+/* Play a directory's .talk thumbnail, fallback to spelling the filename, or
+   go straight to spelling depending on settings. */
+int talk_dir_or_spell(const char* dirname,
+                       long *prefix_ids, bool enqueue)
+{
+    if (global_settings.talk_dir_clip)
+    {   /* .talk clips enabled */
+        if(talk_file(dirname, NULL, dir_thumbnail_name, NULL,
+                              prefix_ids, enqueue) >0)
+            return 0;
+    }
+    if (global_settings.talk_dir == 2)
+        /* Either .talk clips disabled or as a fallback */
+        return talk_spell_basename(dirname, prefix_ids, enqueue);
+    return 0;
+}
+
+/* Speak thumbnail for each component of a full path, again falling
+   back or going straight to spelling depending on settings. */
+int talk_fullpath(const char* path, bool enqueue)
+{
+    if (!enqueue)
+        talk_shutup();
+    if(path[0] != '/')
+        /* path ought to start with /... */
+        return talk_spell(path, true);
+    talk_id(VOICE_CHAR_SLASH, true);
+    char buf[MAX_PATH];
+    strncpy(buf, path, MAX_PATH);
+    char *start = buf+1; /* start of current component */
+    char *ptr = strchr(start, '/'); /* end of current component */
+    while(ptr) { /* There are more slashes ahead */
+        /* temporarily poke a NULL at end of component to truncate string */
+        *ptr = '\0';
+        talk_dir_or_spell(buf, NULL, true);
+        *ptr = '/'; /* restore string */
+        talk_id(VOICE_CHAR_SLASH, true);
+        start = ptr+1; /* setup for next component */
+        ptr = strchr(start, '/');
+    }
+    /* no more slashes, final component is a filename */
+    return talk_file_or_spell(NULL, buf, NULL, true);
+}
 
 /* say a numeric value, this word ordering works for english,
    but not necessarily for other languages (e.g. german) */
@@ -964,6 +1070,8 @@ int talk_spell(const char* spell, bool enqueue)
             talk_id(VOICE_DOT, true); 
         else if (c == ' ')
             talk_id(VOICE_PAUSE, true);
+        else if (c == '/')
+            talk_id(VOICE_CHAR_SLASH, true);
     }
 
     return 0;