Changeset 1066Tweet

Timestamp:

Sep 19, 2006, 6:07:13 PM (14 years ago)

Author:

Sam Hocevar

Message:

• Implemented cucul_getchar(). Useful because you don’t necessarily know what you are importing.

Location:

libcaca/trunk/cucul

Files:

• canvas.c (modified) (1 diff)
• cucul.h (modified) (1 diff)

libcaca/trunk/cucul/canvas.c

@@ -73 +73 @@
 
     return 0;
+}
+
+/** \brief Get the Unicode character at the given coordinates.
+ *
+ *  This function gets the ASCII or Unicode value of the character at
+ *  the given coordinates. If the value is less or equal to 127 (0x7f),
+ *  the character can be printed as ASCII. Otherise, it must be handled
+ *  as a UTF-32 value.
+ *
+ *  If the coordinates are outside the canvas boundaries, a space (0x20)
+ *  is returned.
+ *
+ *  This function never fails.
+ *
+ *  \param cv A handle to the libcucul canvas.
+ *  \param x X coordinate.
+ *  \param y Y coordinate.
+ *  \param ch The requested character value.
+ *  \return The character always returns 0.
+ */
+unsigned long int cucul_getchar(cucul_canvas_t *cv, int x, int y)
+{
+    if(x < 0 || x >= (int)cv->width || y < 0 || y >= (int)cv->height)
+        return 0;
+
+    return (unsigned long int)cv->chars[x + y * cv->width];
 }
 

libcaca/trunk/cucul/cucul.h

@@ -102 +102 @@
 char const *cucul_get_color_name(unsigned int);
 int cucul_putchar(cucul_canvas_t *, int, int, unsigned long int);
+unsigned long int cucul_getchar(cucul_canvas_t *, int, int);
 int cucul_putstr(cucul_canvas_t *, int, int, char const *);
 int cucul_printf(cucul_canvas_t *, int, int, char const *, ...);