UCIL_FOURCC()

#define UCIL_FOURCC(a,b,c,d) (unsigned int)((((unsigned int)d)<<24)+(((unsigned int)c)<<16)+(((unsigned int)b)<<8)+a)

ucil_check_version ()

unicap_status_t
ucil_check_version (unsigned int major,
                    unsigned int minor,
                    unsigned int micro);

ucil_set_pixel ()

void
ucil_set_pixel (unicap_data_buffer_t *data_buffer,
                ucil_color_t *color,
                int x,
                int y);

Draws a pixel on the data buffer.

ucil_set_pixel_alpha ()

void
ucil_set_pixel_alpha (unicap_data_buffer_t *data_buffer,
                      ucil_color_t *color,
                      int alpha,
                      int x,
                      int y);

Draws a pixel on the data buffer, applying an alpha ( transparency ) value to the pixel.

ucil_draw_line ()

void
ucil_draw_line (unicap_data_buffer_t *data_buffer,
                ucil_color_t *color,
                int x1,
                int y1,
                int x2,
                int y2);

Draws a line on the data buffer. The endpoints are clipped to the buffer dimensions

ucil_draw_rect ()

void
ucil_draw_rect (unicap_data_buffer_t *data_buffer,
                ucil_color_t *color,
                int x1,
                int y1,
                int x2,
                int y2);

Draws a rectangle filled with color.

ucil_fill ()

void
ucil_fill (unicap_data_buffer_t *data_buffer,
           ucil_color_t *color);

Fill the buffer with a color.

ucil_draw_box ()

void
ucil_draw_box (unicap_data_buffer_t *data_buffer,
               ucil_color_t *color,
               int x1,
               int y1,
               int x2,
               int y2);

Draws a box

ucil_draw_circle ()

void
ucil_draw_circle (unicap_data_buffer_t *dest,
                  ucil_color_t *color,
                  int cx,
                  int cy,
                  int r);

Draws a circle.

ucil_create_font_object ()

ucil_font_object_t *
ucil_create_font_object (int size,
                         const char *font);

Creates a font object required for text operations. The application must free the font object with ucil_destroy_font_object.

ucil_draw_text ()

void
ucil_draw_text (unicap_data_buffer_t *dest,
                ucil_color_t *color,
                ucil_font_object_t *fobj,
                const char *text,
                int x,
                int y);

Draws a text string onto the target buffer.

ucil_destroy_font_object ()

void
ucil_destroy_font_object (ucil_font_object_t *fobj);

Frees all resources allocated by the font object

ucil_text_get_size ()

void
ucil_text_get_size (ucil_font_object_t *fobj,
                    const char *text,
                    int *width,
                    int *height);

Determines the size in pixels a text string will take up when drawn onto a buffer.

ucil_get_pixel ()

void
ucil_get_pixel (unicap_data_buffer_t *data_buffer,
                ucil_color_t *color,
                int x,
                int y);

Reads the pixel at position (x,y) and stores the result in color.

ucil_convert_color ()

void
ucil_convert_color (ucil_color_t *src,
                    ucil_color_t *dest);

Convert colors between colorspaces. The colorspace field of dest needs to be set to the target colorspace, like in this example:

1
2
3
4
5
6

src.colorspace = UCIL_COLORSPACE_RGB24;
src.rgb24.r = 0xff;
src.rgb24.g = 0xff;
src.rgb24.b = 0xff;
dest.colorspace = UCIL_COLORSPACE_YUV;
ucil_convert_color( &dest, &src );

ucil_convert_buffer ()

unicap_status_t
ucil_convert_buffer (unicap_data_buffer_t *dest,
                     unicap_data_buffer_t *src);

Convert the colorspace of a data buffer. The colorspaces are denoted by the buffer.format.fourcc field. The dest->format.fourcc gets set to the correct value.

ucil_conversion_supported ()

int
ucil_conversion_supported (unsigned int dest_fourcc,
                           unsigned int src_fourcc);

Tests whether a specific conversion is supported.

ucil_get_colorspace_from_fourcc ()

ucil_colorspace_t
ucil_get_colorspace_from_fourcc (unsigned int fourcc);

Gets the ucil_colorspace_t that matches the fourcc.

ucil_blend_alpha ()

void
ucil_blend_alpha (unicap_data_buffer_t *dest,
                  unicap_data_buffer_t *bg,
                  unicap_data_buffer_t *fg,
                  int alpha);

Blends two buffers into a target buffer. Colorspaces of buffers should match.

ucil_create_convolution_mask ()

ucil_convolution_mask_t *
ucil_create_convolution_mask (unsigned char *array,
                              int size,
                              ucil_colorspace_t cs,
                              int mode);

ucil_create_video_file ()

ucil_video_file_object_t *
ucil_create_video_file (const char *path,
                        unicap_format_t *format,
                        const char *codec,
                        ...);

Creates a video file to be used for video recording. After creation, add frames to the video file with ucil_encode_frame.

ucil_encode_frame ()

unicap_status_t
ucil_encode_frame (ucil_video_file_object_t *vobj,
                   unicap_data_buffer_t *buffer);

Adds a frame to a video file.

ucil_close_video_file ()

unicap_status_t
ucil_close_video_file (ucil_video_file_object_t *vobj);

Close a video file created with ucil_create_video_file

ucil_open_video_file ()

unicap_status_t
ucil_open_video_file (unicap_handle_t *unicap_handle,
                      char *filename);

Opens a video file for playback. The resulting handle can be used like a video capture device.

ucil_get_video_file_extension ()

const char *
ucil_get_video_file_extension (const char *codec);

Get the file extension of a codec. Eg. for the "ogg/theora" codec, this will return "ogg". The returned string is owned by ucil and should not be freed.

ucil_rgb24_t

typedef struct _ucil_rgb24 ucil_rgb24_t;

struct ucil_rgb32

struct ucil_rgb32 {
      unsigned char r;
      unsigned char g;
      unsigned char b;
      unsigned char a;
};

ucil_rgb32_t

typedef struct _ucil_rgb32 ucil_rgb32_t;

struct ucil_yuv

struct ucil_yuv {
      unsigned char y;
      unsigned char u;
      unsigned char v;
};

ucil_yuv_t

typedef struct _ucil_yuv ucil_yuv_t;

struct ucil_y8

struct ucil_y8 {
      unsigned char y;
};

ucil_y8_t

typedef struct _ucil_y8 ucil_y8_t;

struct ucil_color

struct ucil_color {
      ucil_colorspace_t colorspace;
      
      union
      {
	    ucil_yuv_t yuv;
	    ucil_rgb24_t rgb24;
	    ucil_rgb32_t rgb32;
	    ucil_y8_t y8;
      };
};

ucil_color_t

typedef struct _ucil_color ucil_color_t;

struct ucil_convolution_mask

struct ucil_convolution_mask {
      ucil_colorspace_t colorspace;
      
      ucil_color_t *mask;
      int size;
};

Apply a convolution mask

ucil_convolution_mask_t

typedef struct _ucil_convolution_mask ucil_convolution_mask_t;

struct ucil_font_object

struct ucil_font_object {
      void *context;
      void *layout;
};

ucil_font_object_t

typedef struct _ucil_font_object ucil_font_object_t;

struct ucil_video_file_object

struct ucil_video_file_object {
};

ucil_video_file_object_t

typedef struct _ucil_video_file_object ucil_video_file_object_t;