Alex Kost
655af4024e
Update README
|
il y a 8 ans | |
|---|---|---|
| build-aux | il y a 8 ans | |
| doc | il y a 8 ans | |
| examples | il y a 8 ans | |
| modules | il y a 8 ans | |
| src | il y a 8 ans | |
| .gitignore | il y a 8 ans | |
| AUTHORS | il y a 8 ans | |
| COPYING | il y a 8 ans | |
| INSTALL | il y a 8 ans | |
| Makefile.am | il y a 8 ans | |
| README | il y a 8 ans | |
| README.org | il y a 8 ans | |
| autogen.sh | il y a 8 ans | |
| configure.ac | il y a 8 ans | |
| pre-inst-env.in | il y a 8 ans |
README
-*- mode: org -*-
* About
Guile-XOSD provides the Guile bindings for [[http://sourceforge.net/projects/libxosd/][libxosd]] library.
Guile-XOSD is the reincarnation of [[https://github.com/sigma/lisposd][lisposd]]. The C file with the Guile
bindings was written at the time (2004-2005) by Yann Hodique, and the
rest (GNU Build System infrastructure, guile modules, documentation and
examples) was added as a part of Guile-XOSD in 2016 by Alex Kost.
* Usage
From the following screenshots you can get the idea how Guile-XOSD may
be used:
- [[http://i.imgur.com/vNbFrDm.png]]
- [[http://i.imgur.com/XCn4ysP.png]]
And here is the code to display the OSD from the second screenshot:
#+BEGIN_SRC scheme
(use-modules (xosd))
(define osd (xosd-create 2))
(xosd-set-pos! osd 'top)
(xosd-set-align! osd 'center)
(xosd-set-font! osd "-*-ubuntu-bold-r-normal--*-500-*-*-p-*-*-1")
(xosd-set-colour! osd "dark green")
(xosd-set-outline-offset! osd 1)
(xosd-set-outline-colour! osd "white")
(define (display-percentage percent)
(xosd-display-string osd 0 (format #f "~a%" percent))
(xosd-display-percentage osd 1 percent))
(display-percentage 73)
#+END_SRC
The full documentation (texinfo manual) and a couple of other examples
can be found in the source tree (and in the installed package).
* Building from Git
Along with the obvious requirements for Guile-XOSD:
- [[http://gnu.org/software/guile/][GNU Guile]]
- [[http://sourceforge.net/projects/libxosd/][XOSD]] library
to build it from git, you also need:
- [[http://gnu.org/software/autoconf/][GNU Autoconf]]
- [[http://gnu.org/software/automake/][GNU Automake]]
- [[http://gnu.org/software/help2man/][GNU Help2man]]
Run =./autogen.sh= to generate the build system infrastructure. After
that, the program can be built and installed with the usual sequence of
commands of the GNU Build System:
#+BEGIN_SRC sh
$ ./configure
$ make
# make install
#+END_SRC
It is possible to use/test Guile-XOSD without installing (i.e., after
running =make= but before running =make install=) with the help of
=pre-inst-env= script in the top build tree, like this:
#+BEGIN_SRC sh
$ ./pre-inst-env guile
scheme@(guile-user)> ,use(xosd)
#+END_SRC
* About
Guile-XOSD provides the Guile bindings for [[http://sourceforge.net/projects/libxosd/][libxosd]] library.
Guile-XOSD is the reincarnation of [[https://github.com/sigma/lisposd][lisposd]]. The C file with the Guile
bindings was written at the time (2004-2005) by Yann Hodique, and the
rest (GNU Build System infrastructure, guile modules, documentation and
examples) was added as a part of Guile-XOSD in 2016 by Alex Kost.
* Usage
From the following screenshots you can get the idea how Guile-XOSD may
be used:
- [[http://i.imgur.com/vNbFrDm.png]]
- [[http://i.imgur.com/XCn4ysP.png]]
And here is the code to display the OSD from the second screenshot:
#+BEGIN_SRC scheme
(use-modules (xosd))
(define osd (xosd-create 2))
(xosd-set-pos! osd 'top)
(xosd-set-align! osd 'center)
(xosd-set-font! osd "-*-ubuntu-bold-r-normal--*-500-*-*-p-*-*-1")
(xosd-set-colour! osd "dark green")
(xosd-set-outline-offset! osd 1)
(xosd-set-outline-colour! osd "white")
(define (display-percentage percent)
(xosd-display-string osd 0 (format #f "~a%" percent))
(xosd-display-percentage osd 1 percent))
(display-percentage 73)
#+END_SRC
The full documentation (texinfo manual) and a couple of other examples
can be found in the source tree (and in the installed package).
* Building from Git
Along with the obvious requirements for Guile-XOSD:
- [[http://gnu.org/software/guile/][GNU Guile]]
- [[http://sourceforge.net/projects/libxosd/][XOSD]] library
to build it from git, you also need:
- [[http://gnu.org/software/autoconf/][GNU Autoconf]]
- [[http://gnu.org/software/automake/][GNU Automake]]
- [[http://gnu.org/software/help2man/][GNU Help2man]]
Run =./autogen.sh= to generate the build system infrastructure. After
that, the program can be built and installed with the usual sequence of
commands of the GNU Build System:
#+BEGIN_SRC sh
$ ./configure
$ make
# make install
#+END_SRC
It is possible to use/test Guile-XOSD without installing (i.e., after
running =make= but before running =make install=) with the help of
=pre-inst-env= script in the top build tree, like this:
#+BEGIN_SRC sh
$ ./pre-inst-env guile
scheme@(guile-user)> ,use(xosd)
#+END_SRC