Constructor
new Emitter(xopt, yopt, widthopt, heightopt, optionsopt)
Creates a new Emitter object.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
x |
number |
<optional> |
The emitter x-position. |
y |
number |
<optional> |
The emitter y-position. |
width |
number |
<optional> |
The emitter width. |
height |
number |
<optional> |
The emitter height. |
options |
Object |
<optional> |
Emitter settings. |
- Source:
Extends
Members
active :boolean
Whether the object should be automatically updated by its parent object.
Inactive objects are still rendered. the default value is true.
Type:
- boolean
- Inherited From:
- Default Value:
- true
- Source:
allowCollisions :number
Describes the type of collision to which the object responds.
Type:
- number
- Inherited From:
- Default Value:
- rune.physics.Space.ANY
- Source:
alpha :number
Indicates the alpha transparency value of the object specified. Valid
values are 0 (fully transparent) to 1 (fully opaque). The default value
is 1. Display objects with alpha set to 0 are active, even though they
are invisible.
Type:
- number
- Inherited From:
- Default Value:
- 1.0
- Source:
(readonly) application :rune.system.Application
Reference to the application's entry point class, ie. the main class of the
application. Useful for accessing the application's subsystem.
Type:
- Inherited From:
- Source:
backgroundColor :DOMString
The color of the display object background. The default value is ""
(0x00000000).
Type:
- DOMString
- Inherited From:
- Source:
bottom :number
The sum of the y and height properties.
Type:
- number
- Inherited From:
- Source:
bottomLeft :rune.geom.Rectangle
The location of the Rectangle object's bottom-left corner, determined by the
values of the left and bottom properties.
Type:
- Inherited From:
- Source:
bottomRight :rune.geom.Rectangle
The location of the Rectangle object's bottom-right corner, determined by the
values of the right and bottom properties.
Type:
- Inherited From:
- Source:
(readonly) cached :boolean
Whether or not a cached version of the object's graphic state exists.
If there is no cache, the object must be rendered.
Type:
- boolean
- Inherited From:
- Source:
(readonly) canvas :rune.display.Canvas
Used to draw and store the graphical representation (ie bitmap data)
for display objects.
Type:
- Inherited From:
- Source:
center :rune.geom.Point
The center point of the rectangle object.
Type:
- Inherited From:
- Source:
centerX :number
The x coordinate of the center of the object.
Type:
- number
- Inherited From:
- Source:
centerY :number
The y coordinate of the center of the object.
Type:
- number
- Inherited From:
- Source:
debug :boolean
Whether the display object should be in debug mode (true) or not (false).
Type:
- boolean
- Inherited From:
- Source:
debugColor :string
Color used to visualize the entire display object's bounds in debug mode.
Changing the color invalidates parent buffers containing the debug outline.
Type:
- string
- Inherited From:
- Default Value:
- rune.util.Palette.WHITE
- Source:
(readonly) flicker :rune.display.Flicker
A subsystem for flicker effects. Use this reference to start and stop
flicker effects on the current display object.
Type:
- Inherited From:
- Source:
flippedX :boolean
Whether the object is flipped on the x axis.
Type:
- boolean
- Inherited From:
- Source:
flippedY :boolean
Whether the object is flipped on the y axis.
Type:
- boolean
- Inherited From:
- Source:
(readonly) gamepads :rune.input.Gamepads
Reference to the application's subsystem for connected gamepad devices.
Type:
- Inherited From:
- Source:
(readonly) glitch :rune.display.Glitch
Optional glitch effect. Created on first access and managed by this object.
Displacements are measured in local pixels before scale and rotation.
Type:
- Inherited From:
- Source:
(readonly) globalX :number
Returns the object's absolute x position, ie coordinates that are relative
to the stage's coordinate system and not the object's parent. Useful when
you want to know the position of an object regardless of its place in the
display list.
Type:
- number
- Inherited From:
- Source:
(readonly) globalY :number
Returns the object's absolute y position, ie coordinates that are relative
to the stage's coordinate system and not the object's parent. Useful when
you want to know the position of an object regardless of its place in the
display list.
Type:
- number
- Inherited From:
- Source:
(readonly) group :number
Reference to possible display group. The reference is null if the object is
not part of a group.
Type:
- number
- Inherited From:
- Source:
height :number
Indicates the height of the object, in pixels.
Type:
- number
- Inherited From:
- Source:
(readonly) hidden :boolean
Indicates whether the display object is rendered or not. A visible object
may still be invisible due to other factors such as flicker effects.
Type:
- boolean
- Inherited From:
- Source:
(readonly) hitbox :rune.display.Hitbox
Represents a boundary box used for collision detection. Use the object's
set() method to specify position and size. By default, it is positioned at
0, 0 and has the same size as the interactive object.
Type:
- Inherited From:
- Source:
immovable :boolean
Whether the object may change position when it collides with another
object.
Type:
- boolean
- Inherited From:
- Source:
(readonly) interval :boolean
Whether the emitter creates particles via a predetermined time interval.
Type:
- boolean
- Source:
(readonly) keyboard :rune.input.Keyboard
Reference to the keyboard manager. Use this reference to read the state of
any keyboard key.
Type:
- Inherited From:
- Source:
left :number
The x coordinate of the top-left corner of the rectangle.
Type:
- number
- Inherited From:
- Source:
(readonly) numParticles :number
The number of active particles, i.e. particles visible on the screen.
Type:
- number
- Source:
(readonly) options :rune.particle.EmitterOptions
Reference to the settings object.
Type:
- Source:
(readonly) parent :rune.display.DisplayObjectContainer
Indicates the DisplayObjectContainer object that contains this display
object. Use the parent property to specify a relative path to display
objects that are above the current display object in the display list
hierarchy.
Type:
- Inherited From:
- Source:
pivotX :number
The local x coordinate of the object's pivot point.
Type:
- number
- Inherited From:
- Source:
pivotY :number
The local y coordinate of the object's pivot point.
Type:
- number
- Inherited From:
- Source:
right :number
The sum of the x and width properties.
Type:
- number
- Inherited From:
- Source:
rotation :number
Indicates the rotation of the DisplayObject instance, in degrees, from its
original orientation.
Type:
- number
- Inherited From:
- Source:
scaleX :number
Indicates the horizontal scale (percentage) of the object as applied from
the registration point (0,0).
Type:
- number
- Inherited From:
- Source:
scaleY :number
Indicates the vertical scale (percentage) of an object as applied from the
registration point of the object (0,0).
Type:
- number
- Inherited From:
- Source:
size :rune.geom.Point
The size of the Rectangle object, expressed as a Point object with the values
of the width and height properties.
Type:
- Inherited From:
- Source:
(readonly) stage :rune.display.Stage
Returns the current stage. This reference returns null if the object is not
part of the display list, ie has not been added with addChild.
Type:
- Inherited From:
- Source:
(readonly) states :rune.state.States
A finite-state machine. Use this reference to apply isolated behavioral
states to the object.
Type:
- Inherited From:
- Source:
sticky :boolean
Used in collision handling. If an object is sticky, other objects
placed on top of the object may follow its movement. This is useful
when developing platform games as a player can, for example, ride on
moving platforms or other objects.
Type:
- boolean
- Inherited From:
- Default Value:
- false
- Source:
top :number
The y coordinate of the top-left corner of the rectangle.
Type:
- number
- Inherited From:
- Source:
topLeft :rune.geom.Point
The location of the Rectangle object's top-left corner, determined by the x
and y coordinates of the point.
Type:
- Inherited From:
- Source:
topRight :rune.geom.Point
The location of the Rectangle object's top-right corner, determined by the x
and y coordinates of the point.
Type:
- Inherited From:
- Source:
(readonly) touched :number
Whether the object touched another object in the previous update. See
touching for more
information.
Type:
- number
- Inherited From:
- Source:
- See:
touching :number
Whether the object touches another object and in such cases in which
directions. The value is represented by a bit field and thus several
directions can be true at the same time.
Type:
- number
- Inherited From:
- Source:
- See:
unscaledHeight :number
The height of the display object regardless of scale.
Type:
- number
- Inherited From:
- Source:
unscaledWidth :number
The width of the display object regardless of scale.
Type:
- number
- Inherited From:
- Source:
(readonly) velocity :rune.physics.Velocity
The velocity of the object. This object is used to calculate the object's
direction of travel, as well as its speed. Note that the object is only
used when the movable property is set to true.
Type:
- Inherited From:
- Source:
visible :boolean
Whether or not the display object is visible.
Type:
- boolean
- Inherited From:
- Default Value:
- true
- Source:
width :number
Indicates the width of the object, in pixels.
Type:
- number
- Inherited From:
- Source:
x :number
Indicates the x coordinate of the DisplayObject instance relative to the
local coordinates of the parent DisplayObjectContainer.
Type:
- number
- Inherited From:
- Source:
y :number
Indicates the y coordinate of the DisplayObject instance relative to the
local coordinates of the parent DisplayObjectContainer.
Type:
- number
- Inherited From:
- Source:
Methods
angleTo(target) → {number}
Returns the direction from this point to a target in radians, between -pi
and pi. Zero points along positive x. With screen coordinates, positive
angles turn toward positive y. Neither point is modified.
Returns zero when both points have the same coordinates.
Parameters:
| Name | Type | Description |
|---|---|---|
target |
rune.geom.Point | Target point. |
- Inherited From:
- Source:
Returns:
Direction to the target in radians.
- Type
- number
applyImpulse(x, y) → {undefined}
Adds an impulse to the object's velocity without changing its position.
Positive values push right and down; negative values push left and up.
The velocity change is independent of mass. Drag, speed limits and collisions
are handled by the normal movement update.
Parameters:
| Name | Type | Description |
|---|---|---|
x |
number | Horizontal velocity change. |
y |
number | Vertical velocity change. |
- Inherited From:
- Source:
Returns:
- Type
- undefined
centerIn(bounds, horizontalopt, verticalopt) → {rune.display.DisplayObject}
Centers the rendered rectangle within bounds, once, without resizing it.
Accounts for scale, pivot, rotation, reflection and container buffer offsets.
Transparent pixels inside the rendered rectangle are included.
Bounds must use the same coordinate system as this object's position, normally
its parent's local coordinates. For a child centered inside its own parent,
pass a rectangle at (0, 0) with the parent's local width and height. Passing a
sibling uses that sibling's x, y, width and height without its rotation.
Larger objects extend equally beyond opposite edges. Disabled axes retain
their positions. Call again after changes that should affect the placement.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
bounds |
rune.geom.Rectangle | Area in parent coordinates. | ||
horizontal |
boolean |
<optional> |
true | Whether to center horizontally. |
vertical |
boolean |
<optional> |
true | Whether to center vertically. |
- Inherited From:
- Source:
Returns:
This object.
clear(disposeopt) → {undefined}
Removes current (active) particles.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
dispose |
boolean |
<optional> |
false | Whether the particles are to be destroyed. |
- Source:
Returns:
- Type
- undefined
clearInterval(cleanupopt, disposeopt) → {undefined}
Stops the current time interval.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
cleanup |
boolean |
<optional> |
false | Whether or not current particles should be removed when the interval is stopped. |
dispose |
boolean |
<optional> |
false | Whether the particle objects should be destroyed when they are removed. |
- Source:
Returns:
- Type
- undefined
containsPoint(point) → {boolean}
Determines whether the specified point is contained within the rectangular
region defined by this Rectangle object.
Parameters:
| Name | Type | Description |
|---|---|---|
point |
rune.geom.Point | The point, as represented by its x and y coordinates. |
- Inherited From:
- Source:
Returns:
A value of true if the Rectangle object contains the specified point; otherwise false.
- Type
- boolean
containsRectangle(rect) → {boolean}
Determines whether the Rectangle object specified by the rect parameter is
contained within this Rectangle object. A Rectangle object is said to contain
another if the second Rectangle object falls entirely within the boundaries
of the first.
Parameters:
| Name | Type | Description |
|---|---|---|
rect |
rune.geom.Rectangle | The Rectangle object being checked. |
- Inherited From:
- Source:
Returns:
A value of true if the Rectangle object that you specify is contained by this Rectangle object; otherwise false.
- Type
- boolean
copyFrom(point) → {rune.geom.Point}
Copies the coordinates of the specified point to this point.
Parameters:
| Name | Type | Description |
|---|---|---|
point |
rune.geom.Point | The point to copy coordinates from. |
- Inherited From:
- Source:
Returns:
This point.
- Type
- rune.geom.Point
dispose() → {undefined}
Process that prepares the object for removal. All internal processes are
stopped and allocated memory will be cleared by the garbage collector at
the next sweep.
- Overrides:
- Source:
Returns:
- Type
- undefined
distance(point) → {number}
Returns the distance between the current and specified point.
Parameters:
| Name | Type | Description |
|---|---|---|
point |
rune.geom.Point | The specified point. |
- Inherited From:
- Source:
Returns:
- Type
- number
distanceSquared(point) → {number}
Returns the squared distance between the current and specified point without
calculating a square root. Compare the result against a squared distance.
Parameters:
| Name | Type | Description |
|---|---|---|
point |
rune.geom.Point | The specified point. |
- Inherited From:
- Source:
Returns:
The squared distance between the points.
- Type
- number
emit(amountopt) → {undefined}
Emits new particles.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
amount |
number |
<optional> |
1 | The number of particles to be emitted. |
- Source:
Returns:
- Type
- undefined
fini() → {undefined}
Method that is called automatically when the object is removed from the
current display list hierarchy, ie. then its parent becomes null. The
method should never perform, or activate any deallocation process
(use the DISPOSE method for that purpose). This method should never be
called manually.
- Inherited From:
- Source:
Returns:
- Type
- undefined
getCenter(outputopt) → {rune.geom.Point}
Returns the exact geometric center of this rectangle without rounding.
Supply an output point to reuse an existing object instead of creating one.
Unlike the center property, fractional coordinates are preserved.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
output |
rune.geom.Point |
<optional> |
The point to store the center coordinates in. |
- Inherited From:
- Source:
Returns:
The point containing the center coordinates.
- Type
- rune.geom.Point
getGlobalRect(rectopt) → {rune.geom.Rectangle}
Creates a Rectangle object that represents the display object with absolute
coordinates, ie coordinates that are relative to the stage and not the
parent of the display object. This is useful if, for example, you want to
collision test two display objects that exist in different branches of the
display list. Note that this method is based on the visual representation of
the display object and not the size of its hitbox.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
rect |
rune.geom.Rectangle |
<optional> |
Rectangle to overwrite, if none is specified, a new Rectangle object is created. |
- Inherited From:
- Source:
Returns:
- Type
- rune.geom.Rectangle
getParticles(activeopt, listopt) → {Array.<rune.particle.Particle>}
Gets a list of the emitter's particles. This is useful if, for example,
you want to collision test if particles collide with other display objects.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
active |
boolean |
<optional> |
false | Whether only active particles should be included in the list, i.e. particles that are currently visible and thus active. |
list |
Array |
<optional> |
null | Reference to existing list where particles can be added. If no reference is specified, a new list is created. |
- Source:
Returns:
- Type
- Array.<rune.particle.Particle>
hitTest(obj, callbackopt, scopeopt) → {boolean}
Evaluates whether the object's hitbox overlaps or intersects with the
parameter object's hitbox.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
obj |
rune.display.Stage | rune.display.InteractiveObject | rune.display.DisplayGroup | rune.display.TileGraphic | rune.tilemap.TilemapLayer | rune.geom.Point | Array | The object to be evaluated. | |
callback |
function |
<optional> |
Executed for each detected collision. |
scope |
Object |
<optional> |
Scope of execution for the callback method. |
- Inherited From:
- Source:
Returns:
- Type
- boolean
hitTestAndSeparate(obj, callbackopt, scopeopt) → {boolean}
Evaluates and resolves collision between the object's hitbox and the given
argument object.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
obj |
rune.display.Stage | rune.display.InteractiveObject | rune.display.DisplayGroup | rune.display.TileGraphic | rune.tilemap.TilemapLayer | Array | The object to be evaluated. | |
callback |
function |
<optional> |
Executed automatically in case of overlap. |
scope |
Object |
<optional> |
Scope within the callback method must be executed. |
- Inherited From:
- Source:
Returns:
- Type
- boolean
hitTestAndSeparateChildrenOf(parent, callbackopt, scopeopt) → {boolean}
Evaluates and resolves collision between this object's hitbox and the
hitbox of all children of the specified argument object. Note that this
method does not include the actual argument object, only its children.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
parent |
rune.display.DisplayObjectContainer | The container object to be evaluated. | |
callback |
function |
<optional> |
Executed automatically in case of overlap. |
scope |
Object |
<optional> |
Scope within the callback method must be executed. |
- Inherited From:
- Source:
Returns:
- Type
- boolean
hitTestAndSeparateContentOf(array, callbackopt, scopeopt) → {boolean}
Evaluates and resolves hitbox-based collision between the object
and other objects in a list structure (array).
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
array |
Array | The array object to be evaluated. | |
callback |
function |
<optional> |
Executed automatically in case of overlap. |
scope |
Object |
<optional> |
Scope within the callback method must be executed. |
- Inherited From:
- Source:
Returns:
- Type
- boolean
hitTestAndSeparateGroup(group, callbackopt, scopeopt) → {boolean}
Evaluates whether this object's hitbox overlaps or intersects any hitbox of
the members of the specified group object.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
group |
rune.display.DisplayGroup | Group to evaluate. | ||
callback |
function |
<optional> |
null | Executed in case of collision. |
scope |
Object |
<optional> |
this | Scope of execution for callback method. |
- Inherited From:
- Source:
Returns:
True if there was a collision, otherwise false.
- Type
- boolean
hitTestAndSeparateObject(obj, callbackopt, scopeopt) → {boolean}
Evaluates whether the object's bounding box overlaps a bounding box of
another object and in the event of a collision, the objects are separated
in order to resolve the collision.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
obj |
rune.display.InteractiveObject | The interactive object to test against. | ||
callback |
function |
<optional> |
null | Executed in case of collision. |
scope |
Object |
<optional> |
this | Scope of execution for callback method. |
- Inherited From:
- Source:
Returns:
True if there was a collision, otherwise false.
- Type
- boolean
hitTestAndSeparateParticlesTilemapLayer(layer, callbackopt, scopeopt) → {boolean}
Tests and separates emitted, active particles against a tilemap layer.
Uses the particle register directly without creating a temporary list.
Call after particle movement has been updated. The emitter's own hitbox
is not tested, and particles returned to the pool are skipped.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
layer |
rune.tilemap.TilemapLayer | Tilemap layer to evaluate. | |
callback |
function |
<optional> |
Receives the particle and tile after separation. |
scope |
Object |
<optional> |
Callback scope; defaults to the colliding particle. |
- Source:
Returns:
True if any particle collision was detected.
- Type
- boolean
hitTestAndSeparateTilemapLayer(layer, callbackopt, scopeopt) → {boolean}
Evaluates, and resolves, collision between this object's hitbox and any
solid tile within the specified tilemap layer.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
layer |
rune.tilemap.TilemapLayer | Layer to evaluate. | ||
callback |
function |
<optional> |
null | Executed in case of collision. |
scope |
Object |
<optional> |
this | Scope of execution for callback method. |
- Inherited From:
- Source:
Returns:
True if there was a collision, otherwise false.
- Type
- boolean
hitTestChildrenOf(parent, callbackopt, scopeopt) → {boolean}
Evaluates the bounding box of the interactive object to see if it overlaps
or intersects the bounding box of any of the container object's children.
The method returns true if this happens to any of the children. The callback
method is activated for each child that is overlapped.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
parent |
rune.display.DisplayObjectContainer | Container object whose children are to be checked. | |
callback |
function |
<optional> |
Executed for each detected collision. |
scope |
Object |
<optional> |
Scope of execution for the callback method. |
- Inherited From:
- Source:
Throws:
-
If the specified argument is not of type DisplayObjectContainer.
- Type
- Error
Returns:
If any of the container object's children are overlapped by this object, true is returned, otherwise false.
- Type
- boolean
hitTestContentOf(array, callbackopt, scopeopt) → {boolean}
Evaluates whether the object's hitbox overlaps or intersects the
hitbox of any other object in the specified list. The list can
contain a mixture of data types, provided that each data type is
supported by the hitTest method.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
array |
Array | Container object whose children are to be checked. | |
callback |
function |
<optional> |
Executed for each detected collision. |
scope |
Object |
<optional> |
Scope of execution for the callback method. |
- Inherited From:
- Source:
Throws:
-
If the specified argument is not of type DisplayObjectContainer.
- Type
- Error
Returns:
If any of the container object's children are overlapped by this object, true is returned, otherwise false.
- Type
- boolean
hitTestGroup(group, callbackopt, scopeopt) → {boolean}
Evaluates whether the object's hitbox overlaps or intersects the hitbox of
any member of a group. The evaluation is carried out against all members of
the group. The method returns true if there was an overlap, false otherwise.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
group |
rune.display.DisplayGroup | Group to evaluate. | |
callback |
function |
<optional> |
Executed automatically in case of overlap. |
scope |
Object |
<optional> |
Scope within the callback method must be executed. |
- Inherited From:
- Source:
Returns:
- Type
- boolean
hitTestObject(obj, callbackopt, scopeopt) → {boolean}
Evaluates the bounding box of the interactive object to see if it overlaps
or intersects with the bounding box of the obj interactive object.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
obj |
rune.display.InteractiveObject | The interactive object to test against. | |
callback |
function |
<optional> |
Executed in case of collision. |
scope |
Object |
<optional> |
Scope of execution for callback method. |
- Inherited From:
- Source:
Returns:
true if the bounding boxes of the interactive objects intersect; false if not.
- Type
- boolean
hitTestPoint(point, callbackopt, scopeopt) → {boolean}
Evaluates the bounding box of the interactive object to see if it overlaps
or intersects with a point object.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
point |
rune.geom.Point | The point object to test against. | |
callback |
function |
<optional> |
Executed in case of collision. |
scope |
Object |
<optional> |
Scope of execution for callback method. |
- Inherited From:
- Source:
Returns:
true if the display object overlaps or intersects with the specified point; false otherwise.
- Type
- boolean
hitTestTilemapLayer(layer, callbackopt, scopeopt) → {boolean}
Evaluates whether the object's hitbox overlaps or intersects a solid tile
within a tilemap layer.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
layer |
rune.tilemap.TilemapLayer | Layer to evaluate. | |
callback |
function |
<optional> |
Executed automatically in case of overlap. |
scope |
Object |
<optional> |
Scope within the callback method must be executed. |
- Inherited From:
- Source:
Returns:
- Type
- boolean
inflate(dx, dy) → {rune.geom.Rectangle}
Expands this rectangle by dx on both horizontal sides and dy on both vertical
sides, preserving its geometric center. Negative values shrink the rectangle.
Width and height are not clamped and may become negative if the rectangle is
shrunk beyond its current size.
Parameters:
| Name | Type | Description |
|---|---|---|
dx |
number | The amount to add to each horizontal side. |
dy |
number | The amount to add to each vertical side. |
- Inherited From:
- Source:
Returns:
This rectangle.
- Type
- rune.geom.Rectangle
init() → {undefined}
Method that is called automatically when the display object is added to the
display list hierarchy, ie. when the object becomes a child of a parent
object. This method should never be called manually.
- Inherited From:
- Source:
Returns:
- Type
- undefined
interpolate(point, fractionopt, outputopt) → {rune.geom.Point}
Determines a point between two specified points. The parameter fraction
determines where the new interpolated point is located relative to the two
end points.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
point |
rune.geom.Point | The second point. | |
fraction |
number |
<optional> |
The level of interpolation between the two points. |
output |
rune.geom.Point |
<optional> |
Save results to this object. |
- Inherited From:
- Source:
Returns:
The new, interpolated point.
- Type
- rune.geom.Point
intersection(toIntersect, outputopt) → {rune.geom.Rectangle}
If the Rectangle object specified in the toIntersect parameter intersects
with this Rectangle object, returns the area of intersection as a Rectangle
object. If the rectangles do not intersect, this method returns an empty
Rectangle object with its properties set to 0.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
toIntersect |
rune.geom.Rectangle | The Rectangle object to compare against to see if it intersects with this Rectangle object. | |
output |
rune.geom.Rectangle |
<optional> |
A Rectangle object to store the intersection results in. |
- Inherited From:
- Source:
Returns:
A Rectangle object that equals the area of intersection.
- Type
- rune.geom.Rectangle
intersects(toIntersect) → {boolean}
Determines whether the specified rectangle overlaps this rectangle with
positive area. Edge and corner contact and empty rectangles return false.
Parameters:
| Name | Type | Description |
|---|---|---|
toIntersect |
rune.geom.Rectangle | The Rectangle object to compare against this Rectangle object. |
- Inherited From:
- Source:
Returns:
A value of true if the specified object intersects with this Rectangle object; otherwise false.
- Type
- boolean
isTouching(direction) → {boolean}
Test whether the object touches another object in one or more directions.
The test does not tell what the object touches, only whether it does so
(true) or not (false).
Parameters:
| Name | Type | Description |
|---|---|---|
direction |
number | Bit field with directions to check. |
- Inherited From:
- Source:
Returns:
- Type
- boolean
justTouched(direction) → {boolean}
Tests if the object touched other objects during the previous update.
Parameters:
| Name | Type | Description |
|---|---|---|
direction |
number | Bit field with directions to check. |
- Inherited From:
- Source:
Returns:
- Type
- boolean
moveTo(x, y) → {undefined}
Moves an object to the specified position (x and y coordinates). This method
can be used when an object needs to be moved without physical limitations.
Parameters:
| Name | Type | Description |
|---|---|---|
x |
number | X coordinate to move to. |
y |
number | Y coordinate to move to. |
- Inherited From:
- Source:
Returns:
- Type
- undefined
moveTowards(target, distance) → {rune.geom.Point}
Moves this point toward a target by at most the specified distance without
passing it. The target is not modified. A distance of zero or less leaves
this point unchanged. All coordinates and the distance use the same units.
Parameters:
| Name | Type | Description |
|---|---|---|
target |
rune.geom.Point | Target point. |
distance |
number | Maximum distance to move for this call. |
- Inherited From:
- Source:
Returns:
This point.
- Type
- rune.geom.Point
postUpdate(step) → {undefined}
This method is activated immediately after the object's main update loop is
completed. The method performs certain processes that sum up the current
update, but also has the purpose of protecting these processes from being
deactivated when the update method is overridden.
Parameters:
| Name | Type | Description |
|---|---|---|
step |
number | Fixed time step. |
- Inherited From:
- Source:
Returns:
- Type
- undefined
preUpdate(step) → {undefined}
This method is activated before the object's main update loop and ensures
that the object is ready for the update. The purpose is to protect certain
processes from being disabled when overriding the main update loop. This
method can also be overridden, but it should be done with caution.
Parameters:
| Name | Type | Description |
|---|---|---|
step |
number | Fixed time step. |
- Inherited From:
- Source:
Returns:
- Type
- undefined
removeFromParent(disposeopt) → {rune.display.DisplayObject}
Removes this object from its current parent display object container.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
dispose |
boolean |
<optional> |
false | Whether this object should be destroyed when it is removed. |
- Inherited From:
- Source:
Returns:
set(x, y) → {rune.geom.Point}
Sets the horizontal and vertical coordinates of this point.
Parameters:
| Name | Type | Description |
|---|---|---|
x |
number | The horizontal coordinate. |
y |
number | The vertical coordinate. |
- Inherited From:
- Source:
Returns:
This point.
- Type
- rune.geom.Point
setInterval(amount, delay, repeat) → {undefined}
Emits new particles at a fixed time interval.
Parameters:
| Name | Type | Description |
|---|---|---|
amount |
number | The number of particles to be emitted. |
delay |
number | The time, in milliseconds, between particle emissions. |
repeat |
number | The number of repetitions. |
- Source:
Returns:
- Type
- undefined
toString() → {string}
Returns a string representation of the hitbox. Useful for troubleshooting.
- Inherited From:
- Source:
Returns:
- Type
- string
union(rect, outputopt) → {rune.geom.Rectangle}
Returns the smallest rectangle that contains this rectangle and the specified
rectangle, including any space between them. The original rectangles remain
unchanged unless one is supplied as output. Zero-sized rectangles contribute
their coordinates to the bounds.
Parameters:
| Name | Type | Attributes | Description |
|---|---|---|---|
rect |
rune.geom.Rectangle | The rectangle to combine with this rectangle. | |
output |
rune.geom.Rectangle |
<optional> |
Store results in this object. May be either input rectangle. |
- Inherited From:
- Source:
Returns:
The rectangle enclosing both rectangles.
- Type
- rune.geom.Rectangle
update(step) → {undefined}
Override this method to update your interactive object's position and
appearance.
Parameters:
| Name | Type | Description |
|---|---|---|
step |
number | Fixed time step. |
- Overrides:
- Source:
Returns:
- Type
- undefined