Location : Home > Languages > Perl > Package Title : Math::Bezier::Convert

名称

　Math::Bezier::Convert - ３次ベジエ曲線と２次ベジエ曲線を相互に変換

概要

use Math::Bezier::Convert;

@new_cubic = divide_cubic($cx1, $cy1, $cx2, $cy2, $cx3, $cy3, $cx4, $cy4, $t);
@new_quad  = divide_quadratic($cx1, $cy1, $cx2, $cy2, $cx3, $cy3, $t);
@quad = cubic_to_quadratic(@cubic);
@cubic = quadratic_to_cubic(@quad);
@lines = cubic_to_lines(@cubic);
@lines = quadratic_to_lines(@cubic);

説明

　Math::Bezier::Convert は２次ベジエ曲線を３次ベジエ曲線に、近似３次ベジエ曲線を２次ベジエ曲線に、近似３次ベジエ曲線・２次曲線を線分群に変換する関数を提供する。

　各関数はベジエ曲線の制御点の座標の配列を引数としてとる。
　３次ベジエ曲線は、１つの錨制御点（anchor control point）・２つの導制御点（director control points）・１つの錨制御点・２つの導制御点…最後の錨制御点からなる。
　２次ベジエ曲線は１つの錨制御点・１つの導制御点…最後の錨制御点からなる。
　曲線は錨制点は通過するが、導制御点は通過しない。
　各点は X 及び Y 座標からなる。これらは ($x1, $y1, $x2, $y2, ...) のように単純に曲線の配列並べられている。

divide_cubic( $cx1, $cy1, $cx2, $cy2, $cx3, $cy3, $cx4, $cy4, $t )

　比率 $t において３次ベジエ曲線を分割し、２つの線分（７つの点）を返す。

divide_quadratic( $cx1, $cy1, $cx2, $cy2, $cx3, $cy3, $t )

　比率 $t において２次ベジエ曲線を分割し、２つの線分（５つの点）を返す。

cubic_to_quadratic( @cubic )

　近似３次ベジエ曲線を２次ベジエ曲線に変換し、２次ベジエ曲線の制御点の配列を返す。

quadratic_to_cubic( @quadratic )

　２次ベジエ曲線を３次ベジエ曲線に変換し、３次ベジエ曲線の制御点の配列を返す。

cubic_to_lines( @cubic )

　近似３次ベジエ曲線を線分群に変換し、終点の配列を返す。

quadratic_to_lines( @cubic )

　近似２次ベジエ曲線を線分群に変換し、終点の配列を返す。

グローバル変数

$Math::Bezier::Convert::APPROX_QUADRATIC_TOLERANCE
$Math::Bezier::Convert::APPROX_LINE_TOLERANCE

　３次ベジエ曲線上の点と近似点の間の距離の許容範囲。デフォルトは１。

$Math::Bezier::Convert::CTRL_PT_TOLERANCE

　２次から３次への変換時における錨制御点−導制御点の間の距離比率の許容範囲。デフォルトは３。この値は1.5以上でなければならない。

エクスポート

　デフォルトではない。
　ただし ':all' タグが指定された場合にはあらゆる関数はエクスポートされる。
　あらゆるグローバル変数はいかなる場合にもエクスポートされない。

著作権

　Copyright 2000 Yasuhiro Sasama (ySas), ysas@nmt.ne.jp

　本ライブラリはフリーソフトウェアであり、Perl 本体と同等の条件で修正／再配布してもよい。

参考資料

　perl(1)

Updated : 2007/04/03