group.setVelocityYEach()
Category:Groups
Sets the y direction velocity for all the sprites in a group.
A positive velocity parameter will move the sprite downward. Must be used with the draw() function containing a drawSprites(). You can also update the velocity of each sprite in a group using setSpeedAndDirectionEach(), setVelocityEach(), setVelocityXEach().
The default velocity is 0.
Examples
// The gray dots have all the same velocity.
var group1 = createGroup();
for (var i = 0; i < 10; i++) {
var sprite = createSprite(randomNumber(0, 400), 0, 5, 5);
sprite.shapeColor='red';
sprite.velocityY=randomNumber(1, 10);
group1.add(sprite);
}
var group2 = createGroup();
for (var i = 0; i < 10; i++) {
var sprite = createSprite(randomNumber(0, 400), 0, 5, 5);
group2.add(sprite);
}
group2.setVelocityYEach(randomNumber(1,10));
function draw() {
background("white");
drawSprites();
}
Syntax
group.setVelocityYEach(velocity)
Parameters
| Name | Type | Required? | Description |
|---|---|---|---|
| velocity | Number | The velocity of each sprite in the positive y direction, downward. |
Returns
No return value. Changes output in the display after drawSprites() is called.
Tips
- Changing World.frameRate will affect the velocity.
- Groups of sprites all have the same functions and you use the dot notation (combining the name of the group, followed by a dot, with the function name) to call the function for that group of sprites.
- Any changes to the properties of a sprite will not be seen until after
drawSprites()is called. - If
setColliderEach()is called for group before it is scaled, the collider is not scaled. But if a group of sprites is first scaled and then the collider set, the scale is also applied to the collider.
Found a bug in the documentation? Let us know at support@code.org.
