README.rdoc

Path: README.rdoc
Last Update: Thu Dec 01 15:39:21 +0000 2011

README

Name

rcairo

Description

Ruby bindings for cairo // cairo extension for Ruby

cairographics.org/

Dependencies

  • ruby >= 1.8 (1.9.2 also supported!)
  • cairo >= 1.2.0 (1.10.0 also supported!)

Install

Package

This way is recommended.

  # gem install cairo

Self build

For experimental users.

Download rcairo-X.Y.Z.tar.gz from cairographics.org/releases/

Extracting:

  % tar xvzf rcairo-X.Y.Z.tar.gz

Compiling:

  % cd rcairo-X.Y.Z
  % ruby extconf.rb    # to check for dependencies and create Makefiles
  % make               # to compile

  # make install       # to install the cairo extension.
                       # The samples in the samples folder should be able
                       # to run before installation except text-on-path.rb
                       # and text2.rb. They uses Ruby/Pango with rcairo
                       # support. So you need to install rcairo and build
                       # Ruby/Pango with it before you run them.

Options to extconf.rb:

  * --without-vendor-override: Use system libraries instead of those found in
                               vendor/local for compiling

Windows

cairo-X.Y.Z-x86-mswin32.gem includes cairo related binaries.

  • cairo related binaries: ftp.gnome.org/pub/gnome/binaries/win32/dependencies/
    • cairo-X.Y.Z-a_win32.zip
    • cairo-dev-X.Y.Z-a_win32.zip
    • libpng-X.Y.Z-a_win32.zip
    • zlib-X.Y.Z-a_win32.zip
    • expat_X.Y.Z-a_win32.zip
    • fontconfig_X.Y.Z-a_win32.zip
    • freetype_X.Y.Z-a_win32.zip

Documents

Source

There is the rcairo repository at GitHub: github.com/rcairo/rcairo

Mailing list

If you have trouble with cairo or rcairo, or you have some ideas for how it could be improved, please feel free to send a message to the cairo mailinglist at cairo@cairographics.org , which is archived at

cairographics.org/cgi-bin/mailman/listinfo/cairo

Thanks

  • Yoshinao Muramatsu: win32 surface support patch.
  • NANKI Haruo: some bug fix patches.
  • Paul van Tilburg:
    • some patches that support ruby 1.9.
    • some suggestions.
  • Binzo: some bug reports and fixed that.
  • kimura wataru:
    • some advices for RubyCocoa.
    • reports a bug.
  • OBATA Akio:
    • reports a bug.
    • some suggestions.
  • James Healy: reports bugs.
  • Carsten Bormann: A suggestion.
  • Davide Rambaldi: A suggestion.
  • Yusuke ENDOH: reports a bug.
  • Yuta Taniguchi: a bug fix patch.
  • kimura wataru:
    • reports a bug.
    • some patches.
  • Masayas TARUI:
    • Windows support.
  • Stefan Salewski: reports a bug.
  • Mamoru Tasaka: reports a bug.
  • Nikolai Weibull: reports problems.
  • Will Bryant: reports a bug.

[Validate]