Drawing and Animation

Drawing and Animation Components" typically refer to software libraries or frameworks that provide tools and functionalities for creating graphical content, illustrations, and animations in applications. These components are essential for developers who want to enhance the visual appeal and interactivity of their software.

About the component


Image Description
  •  Last Update 25 Oct, 2023
  •  Component Version : 2.0.0
  •  API 21, Android 5.0 Lollipop
  •  29 Blocks Available

Ball

The Ball component is a round sprite that can be placed on a Canvas, where it can react to touches and drags, interact with other sprites (ImageSprite and other Ball components), and move according to its property values.

Overview

A visible component that's a round sprite, capable of movement and interaction within a Canvas.

Events

Image Description
Events

CollidedWith

  • Event handler called when a %type% collides with another sprite (Ball or ImageSprite).

    • # Name Type(s) Default Value
    1 other Sprite
    Image Description
    Events

    Dragged

  • Event handler called when a %type% is dragged. On all calls, the starting coordinates are where the screen was first touched, and the "current" coordinates describe the endpoint of the current line segment. On the first call within a given drag, the "previous" coordinates are the same as the starting coordinates; subsequently, they are the "current" coordinates from the prior call.

    • # Name Type(s) Default Value
    1 startX float
    2 startY float
    3 prevX float
    4 prevY float
    5 currentX float
    6 currentY float
    Image Description
    Events

    EdgeReached

  • Event handler called when the %type% reaches an edge of the screen.

    • # Name Type(s) Default Value
    1 edge number
    Image Description
    Events

    Flung

  • Event handler called when a fling gesture (quick swipe) is made on an enabled %type%.

    • # Name Type(s) Default Value
    1 x float
    2 y float
    3 speed float
    4 heading float
    5 xvel float
    6 yvel float
    Image Description
    Events

    NoLongerCollidingWith

  • Event handler called when a pair of sprites (Balls and ImageSprites) are no longer colliding.

    • # Name Type(s) Default Value
    1 other Sprite
    Image Description
    Events

    TouchDown

  • Event handler called when the user begins touching an enabled %type% (placing their finger on a %type% and leaving it there).

    • # Name Type(s) Default Value
    1 x float
    2 y float
    Image Description
    Events

    TouchUp

  • Event handler called when the user stops touching an enabled %type% (lifting their finger after a TouchDown event).

    • # Name Type(s) Default Value
    1 x float
    2 y float
    Image Description
    Events

    Touched

  • Event handler called when the user touches an enabled %type% and then immediately lifts their finger.

    • # Name Type(s) Default Value
    1 x float
    2 y float

    Methods

    Image Description
    Methods

    Bounce

  • Makes the %type% bounce, as if off a wall. For normal bouncing, the edge argument should be the one returned by EdgeReached.

    • # Name Type(s) Default Value
    1 edge int
    Image Description
    Methods

    CollidingWith

  • Indicates whether a collision has been registered between this %type% and the passed sprite (Ball or ImageSprite).

    • # Name Type(s) Default Value
    1 other Sprite
    Image Description
    Methods

    MoveIntoBounds

  • Moves the %type% back in bounds if part of it extends out of bounds, having no effect otherwise. If the %type% is too wide to fit on the canvas, this aligns its left edge with the left edge of the canvas. If the %type% is too tall to fit on the canvas, this aligns its top edge with the top edge of the canvas.

    • Image Description
    Methods

    MoveTo

  • Moves the %type% so that its left top corner is at the specfied x and y coordinates.

    • # Name Type(s) Default Value
    1 x number
    2 y number
    Image Description
    Methods

    MoveToPoint

  • Moves the origin of %type% to the position of the coordinates given by the list formatted as [x-coordinate, y-coordinate].

    • # Name Type(s) Default Value
    Image Description
    Methods

    PointInDirection

  • Sets the heading of the %type% toward the point with the coordinates (x, y).

    • # Name Type(s) Default Value
    1 x number
    2 y number
    Image Description
    Methods

    PointTowards

  • Turns the %type% to point towards a designated target sprite (Ball or ImageSprite). The new heading will be parallel to the line joining the center points of the two sprites.

    • # Name Type(s) Default Value
    1 target Sprite

    Properties

    Image Description
    Image Description
    Properties

    Enabled

  • Returns whether the %type% is enabled.

  • Specifies whether the %type% should move and be affected by collisions.

    • # Name Type(s) Default Value
    1 Enabled boolean
    2 Enabled boolean True
    Image Description
    Image Description
    Properties

    Heading

  • Returns the %type%'s heading in degrees above the positive x-axis. Zero degrees is toward the right of the screen; 90 degrees is toward the top of the screen.

  • The direction in which the %type% is headed. Note that this may be different from the direction the %type% is moving, if its speed is non-zero.

    • # Name Type(s) Default Value
    1 Heading number
    2 Heading number 0.0
    Image Description
    Image Description
    Properties

    Interval

  • Returns the interval.

  • The interval, in milliseconds, between times that the sprite, image, or ball moves.

    • # Name Type(s) Default Value
    1 Interval number
    2 Interval number 100
    Image Description
    Image Description
    Properties

    PaintColor

  • Returns the paint color.


  • Specifies the paint color of the Ball.

    • # Name Type(s) Default Value
    1 PaintColor Color
    2 PaintColor Color Black
    Image Description
    Image Description
    Properties

    Radius

  • Returns the radius of the Ball.


  • The distance from the edge of the Ball to its center.

    • # Name Type(s) Default Value
    1 Radius number
    2 Radius number 5
    Image Description
    Image Description
    Properties

    Speed

  • Gets the speed.


  • The number of pixels that the %type% should move every interval, if enabled.

    • # Name Type(s) Default Value
    1 Speed float
    2 Speed float 0.0
    Image Description
    Image Description
    Properties

    X

  • Returns The horizontal coordinate of the Ball, increasing as the Ball moves right. If the property OriginAtCenter is true, the coordinate is for the center of the Ball; otherwise, it is for the leftmost point of the Ball.


  • The horizontal coordinate of the %type%, increasing as the %type% moves to the right. If the property OriginAtCenter is true, the coordinate is for the center of the %type%; otherwise, it is for the leftmost point of the %type%.

    • # Name Type(s) Default Value
    1 X number
    2 X number 0.0
    Image Description
    Image Description
    Properties

    Y

  • Returns The vertical coordinate of the Ball, increasing as the Ball moves down. If the property OriginAtCenter is true, the coordinate is for the center of the Ball; otherwise, it is for the uppermost point of the Ball.


  • The vertical coordinate of the %type%, increasing as the %type% moves down. If the property OriginAtCenter is true, the coordinate is for the center of the %type%; otherwise, it is for the uppermost point of the %type%.

    • # Name Type(s) Default Value
    1 Y number
    2 Y number 0.0
    Image Description
    Image Description
    Properties

    Z

  • Return how the %type% should be layered relative to other Balls and ImageSprites, with higher-numbered layers in front of lower-numbered layers.

  • How the %type% should be layered relative to other Balls and ImageSprites, with higher-numbered layers in front of lower-numbered layers.

    • # Name Type(s) Default Value
    1 Z number
    2 Z number 1.0