画像を表します。描画操作の対象となったり他のサーフェス上に描 画するときのソースになったりします。サーフェスに描画するため には、Cairo::Context.newに対象にしたいサーフェスを渡してコン テキストを作ります。
サーフェスには異なる描画バックエンドのために異なる種類があり ます。例えば、Cairo::ImageSurface.newはメモリ上にビットマッ プ画像を作ります。
clonedupcontentcreate_similar(content, width, height)selfとできるだけ互換性のある新しいサーフェスを生 成します。例えば、新しいサーフェスはselfと同じフォー ルバック解像度とフォントオプションを持っています。通常、 新しいサーフェスはできるだけselfと同じバックエンド を使います。
最初はサーフェスの内容はすべて0です。（透明度を持ってい れば透明、そうでなければ黒です。）
device_offset[x_offset, y_offset]
finishサーフェスを終了し、全ての外部資源を開放します。このメ ソッドを呼んだ後は、サーフェスに対して何の操作もできま せん。描画操作は効果がなく、代わりに例外 Cairo::SurfaceFinishedErrorが発生します。
rcairoではサーフェスがGCされると自動的に Cairo::Surface#finishが呼ばれます。
flushfont_optionsmark_dirtyset_device_offset(x_offset, y_offset)サーフェスに描画するときにCTMで決定する装置座標に補正値 を追加します。このメソッドは例えばこんなサーフェスを作 りたいときに使えます。それは画面上のサーフェスの一部と して描かれているものを画面上にはない別のサーフェスに転 送するサーフェスです。ある意味で、これは完全にcairoの APIのユーザには見えないところです。 Cairo::Context#transformで変換を設定することでは十分で はありません。なぜならCairo::Context#device_to_userのよ うなメソッドが隠れた補正値を外に出してしまうからです。
補正値はソースパターンとしてサーフェスを使ってサーフェ スを描画したときにも影響があることに注意してください。
fallback_resolution[x_pixels_per_inch, y_pixels_per_inch]
set_fallback_resolution(x_pixels_per_inch, y_pixels_per_inch)代替画像の水平方向と垂直方向の解像度を設定します。
バックエンドがサポートしていない特定の操作を行う場合、 cairoは画像（Cairo::ImageSurface）に対して描画操作を行い、 その画像を出力します。ベクトル系のバックエンドは、このメ ソッドで設定した解像度をその代替画像を生成するときに使 います。（大きな値だと詳細な画像になりますが、ファイル サイズが大きくなります。）
PostScript, PDF, SVGバックエンドがベクトル系のバックエ ンドです。
ラスタ系のバックエンドでも代替画像を使うことはできます が、それらのバックエンドでは常にそのバックエンドの装置 解像度を使います。そのため、ラスタ系のバックエンドでは このメソッドは意味がありません。
注: 代替解像度はページを完成させるとき （Cairo::Context#show_pageかCairo::Context#copy_page）に 使います。そのため、現在は各ページにひとつの代替解像度 しか使えません。
代替解像度のデフォルト値は水平・垂直方向とも1インチあた り300ピクセルです。
write_to_png(stream)write_to_png(filename)サーフェスの内容をPNG画像として書き出します。
引数がwriteメソッドを持っている場合はそのオブジェクトの writeメソッドを使ってPNG画像を出力します。形式のデータを 取得します。ない場合は引数をファイル名として扱い、その ファイルへPNG画像を出力します。
copy_pageshow_pagedestroySince 1.7: Cairo::Surfaceを破棄します。この Cairo::Surfaceはもう使えません。
通常はRubyのGC時に破棄されるので、このメソッドを意識す る必要はありません。
コンストラクタ（Cairo::ImageSurface.newなど）をブロック 付きで呼ぶことも検討してみてください。