Cairo::Patternクラス

サーフェス上に描画するときのソースを表します。ソースの種類によっていくつかサブクラスがあります。例えば、 Cairo::SolidPatternは単色のパターンを作ります。

オブジェクト階層

Object
- Cairo::Pattern

クラスメソッド

Cairo::Pattern.new: 使えません。

インタンスメソッド

__extend__

Object#extendの別名です。

現在の引き延ばしモードを返します。各引き延ばしモードの意味の詳細はCairo::Extendを見てください。

戻り値: Cairo::Extendに定義されている定数のどれか。

extend=(extend)

set_extend(extend)

パターンの外側の領域を描画するときに使うモードを指定します。各引き延ばしモードの意味の詳細はCairo::Extendを見てください。

extend: :noneや:repeatなどCairo::Extendに定義されている定数名と同じもの。大文字小文字は関係ありません。また、シンボルではなくて文字列で "none"のように指定することもできます。もちろん、 Cairo::Extendに定義されている定数を指定することもできます。

現在のフィルタを返します。各フィルタの詳細は Cairo::Filterを見てください。

戻り値: パターンの大きさを変えるときに使う現在のフィルタ。

filter=(filter)

set_filter(filter)

パターンの大きさを変えるときに使う現在のフィルタを設定します。各フィルタの詳細はCairo::Filterを見てください。

filter: :fastや:gaussianなどCairo::Filterに定義されている定数名と同じもの。大文字小文字は関係ありません。また、シンボルではなくて文字列で "fast"のように指定することもできます。もちろん、 Cairo::Filterに定義されている定数を指定することもできます。

パターンの変換行列を返します。

戻り値: Cairo::Matrixオブジェクト。

matrix=(matrix)

set_matrix(matrix)

パターンの変換行列を指定します。この行列はユーザ空間からパターン空間に変換するときに使います。

パターンを作ったときはいつも単位行列です。これは最初はパターン空間はユーザ空間と同じであるということです。

重要: ユーザ空間からパターン空間への変換行列の方向に注意してください。これは、パターンからユーザ空間（そして装置空間）という流れの場合、座標はパターン行列の逆行列で変換されるということです。

例えば、2倍の大きさのパターンを作りたいとしたら、以下が正しいコードです。

pattern.matrix = Cairo::Matrix.scale(0.5, 0.5)

一方、上記のコードで0.5ではなく2.0を使うとパターンは半分の大きさになります。

Cairo::Context#set_sourceのユーザ空間ロック動作の議論にも注意してください。

matrix: Cairo::Matrixオブジェクト。

参考

索引

変更履歴

2007-05-22: kou: スタート。