File: README

package info (click to toggle)
pigment 0.3.6-3
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 7,060 kB
  • ctags: 7,318
  • sloc: ansic: 34,269; xml: 11,990; sh: 9,155; makefile: 560; perl: 383
file content (104 lines) | stat: -rw-r--r-- 2,821 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
WHAT IT IS
----------

Pigment is a library designed to easily build user interfaces for
embedded multimedia. Its design allows to use it on several platforms,
thanks to a plugin system allowing to choose the underlying graphical
API.

WHERE TO START
--------------

We have a development website at https://code.fluendo.com/pigment/trac
You can subscribe to our mailing lists; see the website for details.
We track bugs in Trac on the website.
You can join us on IRC at #pigment on irc.freenode.org

You can generate the Pigment API documentation typing the following
command and then point your browser to docs/pgm/html/index.html.

  ./autogen.sh && make

PLATFORMS
---------

- Linux is *of course* fully supported.
- MacOSX is supported, using the autotools.
- Windows is supported, see the win32/README.txt file for more information.

INSTALLING FROM PACKAGES
------------------------

You should always prefer installing from packages first. There are Pigment
packages for a number of distributions, including Fedora, Debian, Ubuntu,
Mandrake, Gentoo, etc.

Only in cases where you:
- want to hack on Pigment
- want to verify that a bug has been fixed
- do not have a sane distribution
should you choose to build from source tarballs or SVN.

COMPILING FROM SVN
------------------

To build Pigment from repository source code, you simply do something
like this:

  svn co https://code.fluendo.com/pigment/svn/trunk pigment
  cd pigment
  ./autogen.sh --prefix=/opt/pigment
  make
  make install

You can also run Pigment uninstalled, which is recommended if you want
to develop on it. The script misc/pgm-uninstalled is helpful in
setting up your environment for this:

  svn co https://code.fluendo.com/pigment/svn/trunk pigment
  cd pigment
  ./autogen.sh
  make
  ./misc/pgm-uninstalled

OPENGL ES EMULATION WITH X11
----------------------------

To build the Pigment OpenGL ES-CM 1.X plugin for PC emulation on X11
from SVN, you first need a wrapper OpenGL ES library like the one
provided by PowerVR for instance. Then you have to correctly set your
environment to detect the headers and the library for the build:

  export CFLAGS=-I/path/to/opengl-es-pc-emulation/include
  export LDLAGS=-L/path/to/opengl-es-pc-emulation/lib

Enable the use of the emulation layer:

  ./autogen.sh --enable-opengles-pc-emulation

Then set the path to the library to detect it at run-time:

  export LD_LIBRARY_PATH=/path/to/opengl-es-pc-emulation/lib:$LD_LIBRARY_PATH

BUILD DEPENDENCIES
------------------

Ubuntu Feisty, Gutsy & Hardy:

  Core dependencies:
  - autoconf
  - automake1.7
  - libglib2.0-dev
  - libgtk2.0-dev
  - gtk-doc-tools
  - libgstreamer0.10-dev
  - libgstreamer-plugins-base0.10-dev

  OpenGL plugin:
  - libx11-dev
  - libgl1-mesa-dev
  - libpango1.0-dev
  - libcairo-dev

  Unit tests:
  - check