Graphics クラスの draw_dash_dotted_line インターフェイス¶

インターフェイス概要¶

draw_dash_dotted_lineインターフェイスはシンプルな一点鎖線の直線を描画します。

このインターフェイスはdot_settingやdash_setting、round_dot_setting、dash_dot_settingの引数や属性設定を無視します。

基本的な使い方¶

draw_dash_dotted_lineインターフェイスは基本的な座標指定の引数としてx_start、y_start、x_end、y_endの引数を持っています。加えて、短い点線部分のサイズとしてのdot_size引数、長い破線部分のサイズとしてのdash_size引数、そしてそれぞれの点線と破線の間のスペースとしてspace_sizeの引数が必要になります。

import apysc as ap

ap.Stage(
    background_color=ap.Color("#333"),
    stage_width=250,
    stage_height=130,
    stage_elem_id="stage",
)
sprite: ap.Sprite = ap.Sprite()

# Set 2-pixel dot size and 6-pixel dash size and draw the line.
sprite.graphics.line_style(color=ap.Color("#0af"), thickness=5)
sprite.graphics.draw_dash_dotted_line(
    x_start=50, y_start=50, x_end=200, y_end=50, dot_size=2, dash_size=6, space_size=5
)

# Set 5-pixel dot size and 10-pixel dash size and draw the line.
sprite.graphics.draw_dash_dotted_line(
    x_start=50, y_start=80, x_end=200, y_end=80, dot_size=5, dash_size=10, space_size=5
)

ap.save_overall_html(dest_dir_path="graphics_draw_dash_dotted_line_basic_usage/")

draw_dash_dotted_line API¶

特記事項: このAPIドキュメントはドキュメントビルド用のスクリプトによって自動で生成・同期されています。そのためもしかしたらこの節の内容は前節までの内容と重複している場合があります。

[インターフェイスの構造] draw_dash_dotted_line(self, *, x_start: Union[float, apysc._type.number.Number], y_start: Union[float, apysc._type.number.Number], x_end: Union[float, apysc._type.number.Number], y_end: Union[float, apysc._type.number.Number], dot_size: Union[int, apysc._type.int.Int], dash_size: Union[int, apysc._type.int.Int], space_size: Union[int, apysc._type.int.Int], variable_name_suffix: str = '') -> '_line.Line'

[インターフェイス概要]

一点鎖線のベクターグラフィックスの線を描画します。

[引数]

• x_start: float or Number

  • 線の開始位置のX座標。

• y_start: float or Number

  • 線の開始位置のY座標。

• x_end: float or Number

  • 線の終了位置のX座標。

• y_end: float or Number

  • 線の終了位置のY座標。

• dot_size: Int or int

  • ドットのサイズ。

• dash_size: Int or int

  • 破線部分のサイズ。

• space_size: Int or int

  • ドット（点線）や破線間の空白スペースのサイズ。

• variable_name_suffix: str, default “”

  • JavaScript上の変数のサフィックスの設定です。この設定はJavaScriptのデバッグ時に役立つことがあります。

[返却値]

• line: Line

  • 生成された線のグラフィックスのインスタンス。

[コードサンプル]

>>> import apysc as ap
>>> stage: ap.Stage = ap.Stage()
>>> sprite: ap.Sprite = ap.Sprite()
>>> sprite.graphics.line_style(color=ap.Color("#fff"), thickness=5)
>>> line: ap.Line = sprite.graphics.draw_dash_dotted_line(
...     x_start=50,
...     y_start=50,
...     x_end=150,
...     y_end=50,
...     dot_size=2,
...     dash_size=5,
...     space_size=3,
... )
>>> line.line_color
Color("#ffffff")

>>> line.line_dash_dot_setting.dot_size
Int(2)

>>> line.line_dash_dot_setting.dash_size
Int(5)

>>> line.line_dash_dot_setting.space_size
Int(3)