Changeset 2139 for libcacaTweet

Timestamp:

Dec 16, 2007, 12:54:02 PM (15 years ago)

Author:

Sam Hocevar

Message:

• Implemented caca_set_display_driver() to change driver at runtime.

Location:

libcaca/trunk

Files:

• caca/caca.c (modified) (8 diffs)
• caca/caca.h (modified) (1 diff)
• examples/driver.c (modified) (3 diffs)

libcaca/trunk/caca/caca.c

@@ -43 +43 @@
 
 static int caca_can_resize(caca_display_t *);
+static int caca_install_driver(caca_display_t *, char const *);
+static int caca_uninstall_driver(caca_display_t *);
 static int caca_select_driver(caca_display_t *, char const *);
 #if defined(USE_PLUGINS)
@@ -73 +75 @@
 }
 
-/** \brief Attach a caca graphical context to a cucul canvas.
+/** \brief Attach a specific caca graphical context to a cucul canvas.
  *
  *  Create a graphical context using device-dependent features (ncurses for
@@ -83 +85 @@
  *  retrieved using caca_get_canvas() and it is automatically destroyed when
  *  caca_free_display() is called.
+ *
+ *  If no driver name is provided, \e libcaca will try to autodetect the best
+ *  output driver it can.
  *
  *  See also caca_create_display().
@@ -122 +127 @@
     }
 
-#if defined(USE_PLUGINS)
-    dp->plugin = NULL;
-#endif
-
-    if(caca_select_driver(dp, driver))
-    {
-#if defined(USE_PLUGINS)
-        if(dp->plugin)
-            dlclose(dp->plugin);
-#endif
+    if(caca_install_driver(dp, driver))
+    {
         cucul_unmanage_canvas(cv, (int (*)(void *))caca_can_resize, (void *)dp);
         if(dp->autorelease)
@@ -140 +137 @@
     }
 
-    if(dp->drv.init_graphics(dp))
+    return dp;
+}
+
+/** \brief Get available display drivers
+ *
+ *  Return a list of available display drivers. The list is a NULL-terminated
+ *  array of strings, interleaving a string containing the internal value for
+ *  the display driver, and a string containing the natural language
+ *  description for that driver.
+ *
+ *  This function never fails.
+ *
+ *  \param dp Display object.
+ *  \return An array of strings.
+ */
+char const * const * caca_get_display_driver_list(void)
+{
+    static char const * const list[] =
+    {
+#if defined(USE_COCOA)
+        "cocoa", "Mac OS X Cocoa",
+#endif
+#if defined(USE_WIN32)
+        "win32", "Windows console",
+#endif
+#if defined(USE_CONIO)
+        "conio", "MS-DOS conio",
+#endif
+#if defined(USE_X11)
+        "x11", "X11 graphical window",
+#endif
+#if defined(USE_GL)
+        "gl", "OpenGL window",
+#endif
+#if defined(USE_SLANG)
+        "slang", "S-Lang console library",
+#endif
+#if defined(USE_NCURSES)
+        "ncurses", "ncurses console library",
+#endif
+#if defined(USE_VGA)
+        "vga", "direct VGA memory",
+#endif
+#if !defined(__KERNEL__)
+        "raw", "raw libcaca output",
+#endif
+        NULL, NULL
+    };
+
+    return list;
+}
+
+/** \brief Return a caca graphical context's current output driver.
+ *
+ *  Return the given display's current output driver.
+ *
+ *  This function never fails.
+ *
+ *  \param dp The caca display.
+ *  \return A static string.
+ */
+char const * caca_get_display_driver(caca_display_t *dp)
+{
+    return dp->drv.driver;
+}
+
+/** \brief Set the output driver.
+ *
+ *  Dynamically change the given display's output driver.
+ *
+ *  FIXME: decide what to do in case of failure
+ *
+ *  \param dp The caca display.
+ *  \param driver A string describing the desired output driver or NULL to
+ *                choose the best driver automatically.
+ *  \return 0 in case of success, -1 if an error occurred.
+ */
+int caca_set_display_driver(caca_display_t *dp, char const *driver)
+{
+    caca_uninstall_driver(dp);
+    if(caca_install_driver(dp, driver))
+    {
+        seterrno(ENODEV);
+        return -1;
+    }
+
+    return 0;
+}
+
+/** \brief Detach a caca graphical context from a cucul backend context.
+ *
+ *  Detach a graphical context from its cucul backend and destroy it. The
+ *  libcucul canvas continues to exist and other graphical contexts can be
+ *  attached to it afterwards.
+ *
+ *  If the cucul canvas was automatically created by caca_create_display(),
+ *  it is automatically destroyed and any handle to it becomes invalid.
+ *
+ *  This function never fails.
+ *
+ *  \param dp The libcaca graphical context.
+ *  \return This function always returns 0.
+ */
+int caca_free_display(caca_display_t *dp)
+{
+    caca_uninstall_driver(dp);
+    cucul_unmanage_canvas(dp->cv, (int (*)(void *))caca_can_resize, (void *)dp);
+    if(dp->autorelease)
+        cucul_free_canvas(dp->cv);
+    free(dp);
+
+    return 0;
+}
+
+/** \brief Get the canvas attached to a caca graphical context.
+ *
+ *  Return a handle on the \e cucul_canvas_t object that was either attached
+ *  or created by caca_create_display().
+ *
+ *  This function never fails.
+ *
+ *  \param dp The libcaca graphical context.
+ *  \return The libcucul canvas.
+ */
+cucul_canvas_t * caca_get_canvas(caca_display_t *dp)
+{
+    return dp->cv;
+}
+
+/** \brief Return the \e libcaca version.
+ *
+ *  Return a read-only string with the \e libcaca version information.
+ *
+ *  This function never fails.
+ *
+ *  \return The \e libcaca version information.
+ */
+char const * caca_get_version(void)
+{
+    return VERSION;
+}
+
+/*
+ * XXX: The following functions are local.
+ */
+
+static int caca_can_resize(caca_display_t *dp)
+{
+    return dp->resize.allow;
+}
+
+static int caca_install_driver(caca_display_t *dp, char const *driver)
+{
+#if defined(USE_PLUGINS)
+    dp->plugin = NULL;
+#endif
+
+    if(caca_select_driver(dp, driver))
     {
 #if defined(USE_PLUGINS)
@@ -146 +300 @@
             dlclose(dp->plugin);
 #endif
-        cucul_unmanage_canvas(cv, (int (*)(void *))caca_can_resize, (void *)dp);
-        if(dp->autorelease)
-            cucul_free_canvas(dp->cv);
-        free(dp);
-        seterrno(ENODEV);
-        return NULL;
+        return -1;
+    }
+
+    if(dp->drv.init_graphics(dp))
+    {
+#if defined(USE_PLUGINS)
+        if(dp->plugin)
+            dlclose(dp->plugin);
+#endif
+        return -1;
     }
 
@@ -182 +340 @@
     dp->resize.allow = 0;
 
-    return dp;
-}
-
-/** \brief Return the current output driver
- *
- *  Return the given display's current output driver.
- *
- *  This function never fails.
- *
- *  \param dp The caca display.
- *  \return A static string.
- */
-char const * caca_get_display_driver(caca_display_t *dp)
-{
-    return dp->drv.driver;
-}
-
-/** \brief Detach a caca graphical context from a cucul backend context.
- *
- *  Detach a graphical context from its cucul backend and destroy it. The
- *  libcucul canvas continues to exist and other graphical contexts can be
- *  attached to it afterwards.
- *
- *  If the cucul canvas was automatically created by caca_create_display(),
- *  it is automatically destroyed and any handle to it becomes invalid.
- *
- *  This function never fails.
- *
- *  \param dp The libcaca graphical context.
- *  \return This function always returns 0.
- */
-int caca_free_display(caca_display_t *dp)
+    return 0;
+}
+
+static int caca_uninstall_driver(caca_display_t *dp)
 {
     dp->drv.end_graphics(dp);
@@ -220 +350 @@
         dlclose(dp->plugin);
 #endif
-    cucul_unmanage_canvas(dp->cv, (int (*)(void *))caca_can_resize, (void *)dp);
-    if(dp->autorelease)
-        cucul_free_canvas(dp->cv);
-    free(dp);
 
     return 0;
-}
-
-/** \brief Get the canvas attached to a caca graphical context.
- *
- *  Return a handle on the \e cucul_canvas_t object that was either attached
- *  or created by caca_create_display().
- *
- *  This function never fails.
- *
- *  \param dp The libcaca graphical context.
- *  \return The libcucul canvas.
- */
-cucul_canvas_t * caca_get_canvas(caca_display_t *dp)
-{
-    return dp->cv;
-}
-
-/** \brief Return the \e libcaca version.
- *
- *  Return a read-only string with the \e libcaca version information.
- *
- *  This function never fails.
- *
- *  \return The \e libcaca version information.
- */
-char const * caca_get_version(void)
-{
-    return VERSION;
-}
-
-/** \brief Get available display drivers
- *
- *  Return a list of available display drivers. The list is a NULL-terminated
- *  array of strings, interleaving a string containing the internal value for
- *  the display driver, and a string containing the natural language
- *  description for that driver.
- *
- *  This function never fails.
- *
- *  \param dp Display object.
- *  \return An array of strings.
- */
-char const * const * caca_get_display_driver_list(void)
-{
-    static char const * const list[] =
-    {
-#if defined(USE_COCOA)
-        "cocoa", "Mac OS X Cocoa",
-#endif
-#if defined(USE_WIN32)
-        "win32", "Windows console",
-#endif
-#if defined(USE_CONIO)
-        "conio", "MS-DOS conio",
-#endif
-#if defined(USE_X11)
-        "x11", "X11 graphical window",
-#endif
-#if defined(USE_GL)
-        "gl", "OpenGL window",
-#endif
-#if !defined(__KERNEL__)
-        "raw", "raw libcaca output",
-#endif
-#if defined(USE_SLANG)
-        "slang", "S-Lang console library",
-#endif
-#if defined(USE_NCURSES)
-        "ncurses", "ncurses console library",
-#endif
-#if defined(USE_VGA)
-        "vga", "direct VGA memory",
-#endif
-        NULL, NULL
-    };
-
-    return list;
-}
-
-/*
- * XXX: The following functions are local.
- */
-
-static int caca_can_resize(caca_display_t *dp)
-{
-    return dp->resize.allow;
 }
 

libcaca/trunk/caca/caca.h

@@ -157 +157 @@
 __extern caca_display_t * caca_create_display_with_driver(cucul_canvas_t *,
                                                           char const *);
+__extern char const * const * caca_get_display_driver_list(void);
 __extern char const * caca_get_display_driver(caca_display_t *);
+__extern int caca_set_display_driver(caca_display_t *, char const *);
 __extern int caca_free_display(caca_display_t *);
 __extern cucul_canvas_t * caca_get_canvas(caca_display_t *);
 __extern int caca_refresh_display(caca_display_t *);
-__extern char const * const * caca_get_display_driver_list(void);
 __extern int caca_set_display_time(caca_display_t *, unsigned int);
 __extern unsigned int caca_get_display_time(caca_display_t const *);

libcaca/trunk/examples/driver.c

@@ -17 +17 @@
 
 #if !defined(__KERNEL__)
+#   include <string.h>
 #   include <stdio.h>
 #endif
@@ -25 +26 @@
 int main(int argc, char *argv[])
 {
-    char const * const * list;
+    char const * const *list;
     caca_display_t *dp;
     cucul_canvas_t *cv;
 
     list = caca_get_display_driver_list();
-    if(argc <= 1)
-    {
-        printf("Available drivers:\n");
 
-        while(*list)
-        {
-            printf("  %s (%s)\n", list[0], list[1]);
-            list += 2;
-        }
-
-        return 0;
-    }
-
-    cv = cucul_create_canvas(0, 0);
-    if(cv == NULL)
-    {
-        printf("cannot create canvas\n");
-        return -1;
-    }
-    dp = caca_create_display_with_driver(cv, argv[1]);
+    dp = caca_create_display(NULL);
     if(dp == NULL)
     {
@@ -56 +39 @@
     }
 
-    cucul_set_color_ansi(cv, CUCUL_WHITE, CUCUL_BLUE);
-    cucul_draw_line(cv, 0, 0, 9999, 0, ' ');
-    cucul_printf(cv, 1, 0, "Current driver: %s", argv[1]);
+    cv = caca_get_canvas(dp);
+    cucul_set_color_ansi(cv, CUCUL_WHITE, CUCUL_BLACK);
 
-    caca_refresh_display(dp);
+    while(1)
+    {
+        char const *driver;
+        int i, cur = 0;
 
-    caca_get_event(dp, CACA_EVENT_KEY_PRESS, NULL, -1);
+        cucul_put_str(cv, 1, 0, "Available drivers:");
+
+        driver = caca_get_display_driver(dp);
+
+        for(i = 0; list[i]; i += 2)
+        {
+            int match = !strcmp(list[i], driver);
+
+            if(match)
+                cur = i;
+            cucul_draw_line(cv, 0, i + 2, 9999, i + 2, ' ');
+            cucul_printf(cv, 2, i + 2, "%c %s (%s)",
+                         match ? '*' : ' ', list[i], list[i + 1]);
+        }
+
+        cucul_put_str(cv, 1, i + 2, "Switching driver in 5 seconds");
+
+        caca_refresh_display(dp);
+
+        if(caca_get_event(dp, CACA_EVENT_KEY_PRESS, NULL, 5000000))
+            break;
+
+        do
+        {
+            cur += 2;
+            if(list[cur] && !strcmp(list[cur], "raw"))
+                cur += 2;
+            if(!list[cur])
+                cur = 0;
+        }
+        while(caca_set_display_driver(dp, list[cur]));
+    }
 
     caca_free_display(dp);
-    cucul_free_canvas(cv);
 
     return 0;