GraphicsBase rotation_around_center interface

This page explains the GraphicsBase class (base class of each graphic, such as the Rectangle) rotation_around_center property interface.

What interface is this?

The rotation_around_center property interface can set the rotation angle to its instance (rotation value around its center point).

Basic usage

The rotation_around_center interface accepts the int or Int value.

import apysc as ap

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

# Set the cyan fill color and draw the rectangle.
sprite.graphics.begin_fill(color=ap.Color("#0af"), alpha=0.5)
cyan_rect: ap.Rectangle = sprite.graphics.draw_rect(x=50, y=50, width=50, height=50)
cyan_rect.rotation_around_center = ap.Int(30)

# Set the magenta fill color and draw the rectangle.
sprite.graphics.begin_fill(color=ap.Color("#f0a"), alpha=0.5)
magenta_rect: ap.Rectangle = sprite.graphics.draw_rect(x=50, y=50, width=50, height=50)
# Append the rotation angle with the incremental addition (the result
# rotation will be 60 degrees).
magenta_rect.rotation_around_center += ap.Int(30)
magenta_rect.rotation_around_center += ap.Int(30)

ap.save_overall_html(dest_dir_path="graphics_base_rotation_around_center_basic_usage/")

Notes

This interface supports only the graphics instances currently. The container instances, such as the Sprite instance, are not supported (due to the HTML (SVG) specification).

rotation_around_center property API

Note: the document build script generates and updates this API document section automatically. Maybe this section is duplicated compared with previous sections.

[Interface summary]

Get a rotation value around the center of this instance.

[Returns]

  • rotation_around_center: Int

    • Rotation value around the center of this instance.

[Examples]

>>> import apysc as ap
>>> stage: ap.Stage = ap.Stage()
>>> sprite: ap.Sprite = ap.Sprite()
>>> sprite.graphics.begin_fill(color=ap.Color("#0af"))
>>> rectangle: ap.Rectangle = sprite.graphics.draw_rect(
...     x=50, y=50, width=50, height=50
... )
>>> rectangle.rotation_around_center = ap.Int(45)
>>> rectangle.rotation_around_center
Int(45)