physics_particle_draw_ext

Draw a set of particles using a sprite with the default values.

Syntax:

physics_particle_draw_ext(typemask, category, sprite, subimg, xscale, yscale, ang, col, alpha)


Argument Description
typemask The mask to compare the particles flags with.
category The user defined category to draw (use 0 to draw all categories).
sprite The sprite to use for each particle.
subimg The image_index of the sprite to draw.
xscale The scale factor to apply to the sprite along the x axis.
yscale The scale factor to apply to the sprite along the y axis.
ang The angle (in degrees) to draw the sprite at.
col The colour to blend with the sprite (default is c_white).
alpha The alpha value to use when drawing (0 - 1).


Returns: N/A


Description

This function will draw a sprite at the position of all the particles that share the same user defined category value, and that have flags which coincide with those set for the mask. The mask value is defined in the same way as you would define the flags when creating the particles (see the functions physics_particle_create for an example), ie: using the bitwise or "|" to mask off the appropriate bits for each flag.

NOTE: This function will draw all particles in the physics simulation with flags that coincide with those of the mask, whether they are individual particles or groups, if the user category is the same.

The drawn particle will ignore the colour and alpha values set when you created it, and will instead be drawn using the scale, angle, colour and alpha parameters given in this function. Note that this is purely for drawing a sprite at the particle position and in no way affects the behaviour of the particle.


Example:

var flags = phy_particle_flag_water | phy_particle_flag_viscous | phy_particle_flag_tensile;
physics_particle_draw_ext(flags, 2, sprBlob, 0, 2, 2, 0, c_white, 0.5);

The above code will draw a sprite for all the particles in the user defined category "2" which have the same flags as the given mask, scaled by 2 along both axis and with an alpha of 0.5.


Back: Soft Body Particles
Next: physics_particle_count
© Copyright YoYo Games Ltd. 2019 All Rights Reserved