libxputty  0.1
A damn tiny abstraction Layer to create X11 window/widgets with cairo surfaces

A damn tiny abstraction Layer to create X11 window/widgets with cairo surfaces

This repository contain the examples, to check out libxputty as plain library go to:

libxputty

Features

  • easy creation of widgets and windows within the xlib windows system
  • easy handling of multiple windows including multiple widgets
  • easy to use main struct to handle the lifetime of all widgets and windows
    • Xputty main;
    • main_init(&main);
    • create_windows();
    • main_run(&main);
    • main_quit(&main);
  • easy connection to event handlers by simply overwriting the defaults with you own handlers
  • double buffered cairo surfaces to enable transparent drawing on child widgets
  • easy to use x/y adjustments to create your own controller widgets like sliders, knobs, buttons or a trackball
  • full documented API Documentation
  • static linking to create position independent applications

Here is the usual hello world:

simple-example

produced by this code:

#include "xputty.h"
/** your own expose function */
static void draw_window(void *w_, void* user_data) {
Widget_t *w = (Widget_t*)w_;
cairo_set_source_rgb (w->crb, 1, 1, 1);
cairo_paint (w->crb);
}
int main (int argc, char ** argv)
{
/** acces the main struct */
Xputty app;
/** init the main struct */
main_init(&app);
/** create a Window on default root window */
Widget_t *w = create_window(&app, DefaultRootWindow(app.dpy), 0, 0, 300, 200);
/** acces Xlib function */
XStoreName(app.dpy, w->widget, "Hello world");
/** overwrite event handler with your own */
w->func.expose_callback = draw_window;
/** map the Window to display */
/** run the event loop */
main_run(&app);
/** clean up after the event loop is finished */
main_quit(&app);
return 0;
}

Here are a bit more advanced examples:

Theme-example    xgain

midikeyboard

File-selector

check out the example folder for more examples.

License

     0BSD 

BSD Zero Clause License

Xputty
Xputty - the main struct. It should be declared before any other call to a Xputty function....
Definition: xputty.h:177
main_run
void main_run(Xputty *main)
main_run - start the main event loop. It should be start after your Widget_t's been created....
Definition: xputty.c:40
Func_t::expose_callback
xevfunc expose_callback
Definition: xwidget.h:80
main_quit
void main_quit(Xputty *main)
main_quit - destroy all remaining Widget_t's from the main->childlist. Free all resources which may...
Definition: xputty.c:142
Widget_t::crb
cairo_t * crb
Definition: xwidget.h:318
xputty.h
Xputty::dpy
Display * dpy
Definition: xputty.h:181
Widget_t::widget
Window widget
Definition: xwidget.h:302
Widget_t
Widget_t - struct to hold the basic Widget_t info.
Definition: xwidget.h:298
main_init
void main_init(Xputty *main)
main_init - open the Display and init the main->childlist. Set the bool run to true....
Definition: xputty.c:24
create_window
Widget_t * create_window(Xputty *app, Window win, int x, int y, int width, int height)
*create_window - create a Window You need to create as least minimun one Window to get started....
Definition: xwidget.c:145
Widget_t::func
Func_t func
Definition: xwidget.h:310
widget_show_all
void widget_show_all(Widget_t *w)
widget_show_all - map/show Widget_t with all childs
Definition: xwidget.c:405