Mesh class
The Mesh class allows free form deformations of a BitmapData instance by using triangles to form an arbitrary shape.
The vertices of the triangles are shared between different triangles. Therefore you should define the vertices first and afterwards define the triangles with the index number of the vertices. Each triangle needs three indices, so the number of indices is three times the number of triangles.
To get a better understanding, let's take a look at two simple meshes: The left mesh uses 9 vertices and 8 triangles (24 indices). The right mesh uses 7 vertices and 6 triangles (18 indices).
0─────1─────2 0───────1
│ / │ / │ / \ / \
│ / │ / │ / \ / \
│ / │ / │ / \ / \
3─────4─────5 5───────6───────2
│ / │ / │ \ / \ /
│ / │ / │ \ / \ /
│ / │ / │ \ / \ /
6─────7─────8 4───────3
Use the setVertex and setTriangleIndices methods to form the mesh. A vertex is defined by the XY and UV values. The XY values define the position of the vertex in the local coordinate system of the Display Object. The UV values define the pixel location in a 0.0 to 1.0 coordinate system of the BitmapData.
- Inheritance
Constructors
- Mesh(BitmapData bitmapData, int vertexCount, int triangleCount)
- Create a new Mesh with vertexCount vertices and triangleCount triangles.
- Mesh.fromGrid(BitmapData bitmapData, int columns, int rows)
-
Create a new grid shaped Mesh with the desired number of
columns
androws
. A 2x2 grid will create 9 vertices.factory
Properties
- alpha ↔ num
-
The alpha transparency value of the object specified.
getter/setter pairinherited
- bitmapData ↔ BitmapData
-
getter/setter pair
- blendMode ↔ BlendMode?
-
A value from the BlendMode class that specifies which blend mode to use.
getter/setter pairinherited
-
bounds
→ Rectangle<
num> -
Returns a rectangle that defines the area of this display object in
this display object's local coordinates.
no setteroverride
-
boundsTransformed
→ Rectangle<
num> -
Returns a rectangle that defines the area of this display object in
this display object's parent coordinates.
no setterinherited
- cache → RenderTextureQuad?
-
This getter gives you access to the underlying RenderTextureQuad if
a cache is applied to this display object. If no cache is applied this
value is ´null´.
no setterinherited
- displayObjectID → int
-
finalinherited
-
filters
↔ List<
BitmapFilter> -
The filters currently associated with this display object.
getter/setter pairinherited
- globalTransformationMatrix → Matrix
-
The global 2D transformation matrix of this display object.
no setterinherited
- globalTransformationMatrix3D → Matrix3D
-
The global 3D transformation matrix of this display object.
no setterinherited
- hashCode → int
-
The hash code for this object.
no setterinherited
- height ↔ num
-
The height of this display object with the applied transformation.
getter/setter pairinherited
- indexCount → int
-
final
- ixList → Int16List
-
final
- mask ↔ Mask?
-
The calling display object is masked by the specified mask object.
getter/setter pairinherited
-
mousePosition
→ Point<
num> ? -
The position of the mouse relative to the local coordinate system of
the display object.
no setterinherited
- mouseX → num
-
The x-coordinate of the mouse relative to the local coordinate system of
the display object.
no setterinherited
- mouseY → num
-
The y-coordinate of the mouse relative to the local coordinate system of
the display object.
no setterinherited
- name ↔ String
-
The instance name of this display object.
getter/setter pairinherited
- off ↔ bool
-
The availability and visibility of the display object.
getter/setter pairinherited
-
onAdded
→ EventStream<
Event> -
Dispatched when a display object is added to the display list.
no setterinherited
-
onAddedToStage
→ EventStream<
Event> -
Dispatched when a display object is added to the on stage display list,
either directly or through the addition of a sub tree in which the display
object is contained.
no setterinherited
-
onEnterFrame
→ EventStream<
EnterFrameEvent> -
Dispatched when a frame is entered.
no setterinherited
-
onExitFrame
→ EventStream<
ExitFrameEvent> -
Dispatched when a frame is exited. All frame scripts have been run.
no setterinherited
-
onRemoved
→ EventStream<
Event> -
Dispatched when a display object is about to be removed from the display
list.
no setterinherited
-
onRemovedFromStage
→ EventStream<
Event> -
Dispatched when a display object is about to be removed from the display
list, either directly or through the removal of a sub tree in which the
display object is contained.
no setterinherited
-
onRender
→ EventStream<
RenderEvent> -
Dispatched when the display list is about to be updated and rendered.
no setterinherited
-
parent
→ DisplayObjectParent<
DisplayObject> ? -
The DisplayObjectContainer object that contains this display object.
no setterinherited
- pivotX ↔ num
-
The x-coordinate of the pivot point of this display object.
getter/setter pairinherited
- pivotY ↔ num
-
The y-coordinate of the pivot point of this display object.
getter/setter pairinherited
- root → DisplayObject
-
The top-most display object in the portion of the display list's tree
structure.
no setterinherited
- rotation ↔ num
-
The rotation of this display object, in radians, from its original
orientation.
getter/setter pairinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- scaleX ↔ num
-
The horizontal scale (percentage) of the object as applied from the
pivot point.
getter/setter pairinherited
- scaleY ↔ num
-
The vertical scale (percentage) of the object as applied from the
pivot point.
getter/setter pairinherited
- skewX ↔ num
-
The horizontal skew of this object.
getter/setter pairinherited
- skewY ↔ num
-
The vertical skew of this object.
getter/setter pairinherited
- stage → Stage?
-
The Stage of this display object.
no setterinherited
- transformationMatrix → Matrix
-
The transformation matrix of this display object relative to
this display object's parent.
no setterinherited
- triangleCount → int
-
final
- userData ↔ dynamic
-
The user-defined data associated with this display object.
getter/setter pairinherited
- vertexCount → int
-
final
- visible ↔ bool
-
The visibility and availability of the display object.
getter/setter pairinherited
- vxList → Float32List
-
final
- width ↔ num
-
The width of this display object with the applied transformation.
getter/setter pairinherited
- x ↔ num
-
The x-coordinate of is display object relative to the
local coordinates of the parent DisplayObjectContainer.
getter/setter pairinherited
- y ↔ num
-
The y-coordinate of this display object relative to the
local coordinates of the parent DisplayObjectContainer.
getter/setter pairinherited
Methods
-
addEventListener<
T extends Event> (String eventType, EventListener< T> eventListener, {bool useCapture = false, int priority = 0}) → StreamSubscription<T> -
Adds an event listener to receive events.
inherited
-
addTo(
DisplayObjectParent< DisplayObject> parent) → void -
Add this display object to the specified
parent
.inherited -
alignPivot(
[HorizontalAlign hAlign = HorizontalAlign.Center, VerticalAlign vAlign = VerticalAlign.Center]) → void -
Aligns the display object's pivot point relative to the current bounds.
inherited
-
applyCache(
num x, num y, num width, num height, {bool debugBorder = false, num pixelRatio = 1.0}) → void -
Draws the specified area of this display object to an internal render
texture and the engine will use this texture to optimize performance.
inherited
-
dispatchEvent(
Event event) → void -
Dispatches the
event
to all listening subscribers.inherited -
dispatchEventRaw(
Event event, EventDispatcher target, EventPhase eventPhase) → void -
Do not use the dispatchEventRaw method unless you want to override the
way how events are dispatched for display list object. Please use
dispatchEvent instead.
inherited
-
getBounds(
DisplayObject targetSpace) → Rectangle< num> -
Returns the bounds of this display object relative to the specified
targetSpace
.inherited -
getTransformationMatrix(
DisplayObject targetSpace) → Matrix -
The 2D transformation matrix relative to the given
targetSpace
.inherited -
getTransformationMatrix3D(
DisplayObject targetSpace) → Matrix3D -
The 3D transformation matrix relative to the given
targetSpace
.inherited -
globalToLocal(
Point< num> globalPoint, [Point<num> ? returnPoint]) → Point<num> -
Converts the point object from the Stage's global coordinates to this
display object's local coordinates.
inherited
-
hasEventListener(
String eventType, {bool useCapture = false}) → bool -
Returns true if the EventDispatcher has event listeners. The
useCapture
paramenter defines if the event listeners should be registered for the capturing event phase or not.inherited -
hitTestInput(
num localX, num localY) → DisplayObject? -
Evaluates this display object to see if the coordinates
localX
andlocalY
are inside this display object.override -
hitTestObject(
DisplayObject other) → bool -
Evaluates this display object to see if it overlaps or intersects with
the bounding box of the
other
display object.inherited -
hitTestPoint(
num x, num y, [bool shapeFlag = false]) → bool -
Evaluates this display object to see if it overlaps or intersects with
the point specified by the
x
andy
parameters.inherited -
localToGlobal(
Point< num> localPoint, [Point<num> ? returnPoint]) → Point<num> -
Converts the point object from this display object's local coordinates
to the Stage global coordinates.
inherited
-
localToParent(
Point< num> localPoint, [Point<num> ? returnPoint]) → Point<num> -
Converts the point object from this display object's local coordinates
to this display object's parent coordinates.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
on<
T extends Event> (String eventType) → EventStream< T> -
Returns an event stream of type
eventType
.inherited -
parentToLocal(
Point< num> parentPoint, [Point<num> ? returnPoint]) → Point<num> -
Converts the point object from this display object's parent coordinates
to this display object's local coordinates.
inherited
-
refreshCache(
) → void -
Refreshes the cached area of this display object.
inherited
-
removeCache(
) → void -
Removes the previously cached area of this display object.
inherited
-
removeEventListener<
T extends Event> (String eventType, EventListener< T> eventListener, {bool useCapture = false}) → void -
Removes an event listener to stop receiving events.
inherited
-
removeEventListeners(
String eventType) → void -
Removes all event listeners of a given event type.
inherited
-
removeFromParent(
) → void -
Removes this display object from its parent.
inherited
-
render(
RenderState renderState) → void -
Renders this display object with the given
renderState
. The display object is rendered without its filters.override -
renderFiltered(
RenderState renderState) → void -
Renders this display object with the given
renderState
. The display object is rendered with its filters.inherited -
setIndex(
int index, int vertex) → void - Set the corresponding vertex for an index.
-
setTransform(
num x, num y, [num scaleX = 1, num scaleY = 1, num rotation = 0, num skewX = 0, num skewY = 0, num pivotX = 0, num pivotY = 0]) → void -
Sets transformation properties.
inherited
-
setTriangleIndices(
int triangle, int v1, int v2, int v3) → void - Set the corresponding vertices for the triangle indices.
-
setVertex(
int vertex, num x, num y, num u, num v) → void - Set the XY and UV values of a vertex.
-
setVertexUV(
int vertex, num u, num v) → void - Set the UV values of a vertex.
-
setVertexXY(
int vertex, num x, num y) → void - Set the XY values of a vertex.
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited