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
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.
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.