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
|
## libgdiplus: An Open Source implementation of the GDI+ API.
This is part of the [Mono project](http://www.mono-project.com/).
Build status:
[](https://dev.azure.com/dnceng/public/_build/latest?definitionId=617&branchName=main)
### Requirements:
This requires the libraries used by the Cairo vector graphics library to build (freetype2, fontconfig, Xft2 and libpng).
On **OSX** you can use [Homebrew](https://brew.sh/) to install the dependencies:
brew install glib cairo libexif libjpeg giflib libtiff autoconf libtool automake pango pkg-config
brew link gettext --force
On **Debian-based Linux distributions** you can use `apt-get` to install the dependencies:
sudo apt-get install libgif-dev autoconf libtool automake build-essential gettext libglib2.0-dev libcairo2-dev libtiff-dev libexif-dev
On **Windows** you can use [Vcpkg](https://github.com/Microsoft/vcpkg) to install the dependencies. Run the following commands from the root of the repository from an admin command prompt:
bootstrap-vcpkg.bat
vcpkg.exe install giflib libjpeg-turbo libpng cairo glib tiff libexif pango --triplet x86-windows
vcpkg.exe install giflib libjpeg-turbo libpng cairo glib tiff libexif pango --triplet x64-windows
vcpkg.exe integrate install
### Build instructions
To build on **OSX** without X11:
./autogen.sh --without-x11 --prefix=YOUR_PREFIX
make
To build on **OSX with X11** (e.g. from XQuartz):
PKG_CONFIG_PATH=/opt/X11/lib/pkgconfig ./autogen.sh --prefix=YOUR_PREFIX
make
To build on **Linux**:
./autogen.sh --prefix=YOUR_PREFIX
make
To build on **Windows**, open `libgdiplus.sln`.
### Running the unit tests
Run the following command from the root of the repository:
make check
To run the tests with Clang sanitizers, run the following command from the root of the repository:
./autogen.sh --enable-asan
make check
To run the unit tests with leak sanitizers, run the following command from the root of the repository:
./autogen.sh --enable-asan
export ASAN_OPTIONS=detect_leaks=1:fast_unwind_on_malloc=0
export LSAN_OPTIONS=suppressions=lsansuppressions.txt
make check
### Code coverage
Code coverage stats are generated with `lcov`. You can use [Homebrew](https://brew.sh/) on **OSX** to install the dependencies:
brew install lcov
To run the tests with code coverage, run the following commands from the root of the repository:
./autogen.sh --enable-coverage
make check
lcov --capture --directory src --output-file coverage.info
genhtml coverage.info --output-directory coverage
To view the coverage report, navigate to the `coverage` directory in the root of the repository and open `index.html`.
### Installing libgdiplus
Run the following command from the root of the repository:
make install
### Optional build options
--with-pango
This builds libgdiplus using Pango to render (measure and draw)
all of it's text. This requires Pango version 1.38 (or later).
|
