# Cairo for Smalltalk/X

**stx:goodies/libcairo** is a Smalltalk/X package providing integration of [Cairo graphics library][1]. 
It contains a drop-in replacement for native GC ([DeviceGraphicsContext][5]) to switch 
rendering of some or all windows to Cairo. 

## Features

* Full access to Cairo API
* Integration with Smalltalk/X graphics API
* Correct transformations (native GC does it wrong)
* Supports images with alpha channel such as .png icons (not supported by native GC)
* Supports arbitrary (and correct) transformations, including rotation (not supported by native GC)

## Starting Points

**For the impatient**
Following code will install [CairoGraphicsContext][6] as graphics 
device's default graphics context so new windows will be rendered using Cairo:

    Screen current graphicsContextClass: CairoGraphicsContext.

To revert back to standard rendering, evaluate: 

    Screen current graphicsContextClass: Screen current class graphicsContextClass

For more defailts, see:

* [Wiki][7]
* [Examples][8] in particular

## Supported versions of Smalltalk/X

**stx:goodies/libcairo** is available for [Smalltalk/X "jv branch"][2], both
**Windows and Linux**, 32bit and 64bit. 

Should you need Cairo on any other version of Smalltalk/X, please contact the author by email. 

## Author

Jan Vrany `<jan.vrany [at] fit.cvut.cz>`

## License

![CC-BY-NC](https://i.creativecommons.org/l/by-nc/4.0/88x31.png)

This software is licensed under [Creative Commons Attribution-NonCommercial 4.0 International License][3]. You may find a full license text in `LICENSE.txt`.

In short, you are free to:

* **Share** — copy and redistribute the material in any medium or format,
* **Adapt** — remix, transform, and build upon the material,

under the following terms: 

* **Attribution** — You must give appropriate credit, provide a link to the license, and indicate if changes were made, 
* **NonCommercial** — You may not use the software for commercial purposes.

For permissions beyond the scope of this license see [Licensing][4].

[1]: http://www.cairographics.org
[2]: https://swing.fit.cvut.cz/projects/stx-jv/
[3]: http://creativecommons.org/licenses/by-nc/4.0/
[4]: https://bitbucket.org/janvrany/stx-goodies-libcairo/wiki/Licensing
[5]: http://swing.fit.cvut.cz/hg/stx.libview/file/jv/DeviceGraphicsContext.st
[6]: https://bitbucket.org/janvrany/stx-goodies-libcairo/src/default/CairoGraphicsContext.st
[7]: https://bitbucket.org/janvrany/stx-goodies-libcairo/wiki/Home
[8]: https://bitbucket.org/janvrany/stx-goodies-libcairo/wiki/Examples