https://github.com/vitovan/pango-cairo-wasm
PangoCairo on the Web
https://github.com/vitovan/pango-cairo-wasm
cairo emscripten pango sdl2 wasm webassembly
Last synced: 8 months ago
JSON representation
PangoCairo on the Web
- Host: GitHub
- URL: https://github.com/vitovan/pango-cairo-wasm
- Owner: VitoVan
- License: wtfpl
- Created: 2023-04-22T02:54:23.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-10T02:06:22.000Z (over 1 year ago)
- Last Synced: 2025-08-23T05:04:24.972Z (10 months ago)
- Topics: cairo, emscripten, pango, sdl2, wasm, webassembly
- Language: Shell
- Homepage: https://vitovan.com/pango-cairo-wasm/
- Size: 2.07 MB
- Stars: 13
- Watchers: 4
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# PangoCairo on the Web
[](https://github.com/VitoVan/pango-cairo-wasm/actions/workflows/docker.yml) []() [](https://github.com/VitoVan/pango-cairo-wasm/actions/workflows/gh-pages.yml)
Compile [Cairo](https://www.cairographics.org/) / [Pango](https://docs.gtk.org/Pango/index.html) / [PangoCairo](https://docs.gtk.org/PangoCairo) based applications from C to WebAssembly?
Try it online (1.5 ~ 3.5 MB data transfer):
**Cairo**: https://vitovan.com/pango-cairo-wasm/hello-cairo.html
**PangoCairo**: The pthreads used by Pango requires Web Workers require extra [HTTP HEADERS](https://web.dev/coop-coep/), and the [workarounds](https://dev.to/stefnotch/enabling-coop-coep-without-touching-the-server-2d3n) would break other pages on my website. So, please [download](https://github.com/VitoVan/pango-cairo-wasm/archive/refs/heads/gh-pages.zip) the files and [serve](https://github.com/VitoVan/pango-cairo-wasm/blob/main/wasm-server) them locally.
Preview:
## Usage
### Setup emcc & pkg-config
#### with pre-built Docker
```bash
alias emcc="docker run --rm --name pcwa -v $(pwd):/app -w=/app vitovan/pango-cairo-wasm emcc"
alias pkg-config="docker run --rm --name pcwa -v $(pwd):/app -w=/app vitovan/pango-cairo-wasm pkg-config"
# give it a try
emcc --help
pkg-config --libs --cflags pangocairo
```
#### build from source
This build.sh only compiles on **Fedora 38** (due to the good old [c2man](https://github.com/fribidi/c2man) dependency), if you can't get one, please use Docker to build.
```bash
git clone https://github.com/VitoVan/pango-cairo-wasm.git
cd pango-cairo-wasm
git submodule init
git submodule update
echo -e "export magicdir=$(pwd)\n$(cat env.sh)" > env.sh
bash build.sh
```
Wait for 20 minutes or more. If all went well, execute:
```bash
. env.sh
# give it a try
emcc --help
pkg-config --libs --cflags pangocairo
```
### Compile C Code
#### Cairo with no pthread
```bash
export CAIRO_FLAGS="$(pkg-config --libs --cflags glib-2.0, gobject-2.0, cairo, pixman-1, freetype2, fontconfig, cairo, expat, harfbuzz) -s USE_SDL=2 -s USE_PTHREADS=0 -s ASYNCIFY"
curl -LO https://raw.githubusercontent.com/VitoVan/pango-cairo-wasm/main/hello-cairo.c
emcc $CAIRO_FLAGS hello-cairo.c -o hello-cairo.html
```
#### PangoCairo with pthread
```bash
export PANGOCAIRO_FLAGS="$(pkg-config --libs --cflags glib-2.0, gobject-2.0, cairo, pixman-1, freetype2, fontconfig, cairo, expat, harfbuzz, pangocairo) -s USE_SDL=2 -s EMULATE_FUNCTION_POINTER_CASTS -s PTHREAD_POOL_SIZE=10 -s USE_PTHREADS=1 -s ASYNCIFY"
curl -LO https://raw.githubusercontent.com/VitoVan/pango-cairo-wasm/main/hello-pangocairo.c
# get yourself the fonts
mkdir ./fonts
cd fonts
curl -LO https://raw.githubusercontent.com/VitoVan/pango-cairo-wasm/main/fonts/OpenSans-VariableFont_wdth,wght.ttf
curl -LO https://raw.githubusercontent.com/VitoVan/pango-cairo-wasm/main/fonts/OpenSans-Italic-VariableFont_wdth,wght.ttf
cd ..
# compile
emcc $PANGOCAIRO_FLAGS --embed-file ./fonts@/usr/share/fonts/ hello-pangocairo.c -o hello-pangocairo.html
```
#### Start the debug server
```bash
curl -LO https://raw.githubusercontent.com/VitoVan/pango-cairo-wasm/main/wasm-server
chmod +x wasm-server
./wasm-server
```
open the following links in your browser:
- http://localhost:4242/hello-cairo.html
- http://localhost:4242/hello-pangocairo.html
## TODO
- upgrade dependencies to newer version
- make this script working on modern system (> Fedora 38)
- make this script working on Debian-based system
## License
DO WHAT THE FUCK YOU WANT TO.
## Contributing
I don't have time to fix my shit, and I don't have time to read your shit.
If you want to add anything to this repo, make sure:
1. don't break the old working code, no matter how ugly it is.
2. don't change the sub-module remote url, unless the upstream repo changed.
3. don't add binaries.
4. make sure your modified version just work, don't add any switches/options unless it is super necessary and discussed before writing them down.
*just work* = no need to change this readme