Editing XML/Splash particle

Jump to navigation Jump to search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
−
[[XML|Back to XML Overview ]]
 
−
 
−
Splash [[particle]] systems are most commonly used to create special effects from a unit being attacked.
 
−
 
−
 
−
==XML==
 
−
<syntaxhighlight lang="xml">
 
 
<?xml version="1.0" standalone="yes"?>
 
<?xml version="1.0" standalone="yes"?>
−
<splash-particle-system>
+
*<splash-particle-system>
−
<texture value="true" path=".../texture_name.bmp" luminance="true" />
+
**    <texture value="true|false" path=".../texture_name.bmp" luminance="true"/>
−
<model value="true" path=".../model_name.g3d" />
+
**    <model value="true|false" path=".../model_name.g3d"/>
−
<primitive value="quad" />
+
** <primitive value="quad|line"/>
−
<mode value="normal" />
+
** <offset x="0" y="0" z="0"/> ??
−
<offset x="0" y="0" z="0" />
+
** <color red="0.0" green="0.0" blue="1.0" alpha="0.5" /> Colors at epicentre
−
<color red="0.0" green="0.0" blue="1.0" alpha="0.5" />
+
** <color-no-energy red="1.0" green="1.0" blue="1.0" alpha="0.0" /> Colors at edge
−
<color-no-energy red="1.0" green="1.0" blue="1.0" alpha="0.0" />
+
**    <size value="1" /> Particle start size (center)
−
<size value="1" />
+
**    <size-no-energy value="2" /> Ending particle size
−
<size-no-energy value="2" />
+
**    <speed value="5" /> The Maximum Radius of the explosion
−
<speed value="5" />
+
** <gravity value="0"/> Gravity effects
−
<gravity value="0" />
+
**    <emission-rate value="20" /> How many particles are emitted
−
<emission-rate value="20" />
+
**    <energy-max value="30" /> Energy
−
<energy-max value="30" />
+
**    <energy-var value="10" /> Variation
−
<energy-var value="10" />
+
** <emission-rate-fade value="1"/> Particles last longer with a lower number / disappear quicker with a higher number
−
<emission-rate-fade value="1" />
+
** <vertical-spread a="0" b="0"/> ??
−
<vertical-spread a="0" b="0" />
+
** <horizontal-spread a="1" b="0"/> ??
−
<horizontal-spread a="1" b="0" />
+
*</splash-particle-system>
−
</splash-particle-system>
 
−
</syntaxhighlight>
 
−
 
 
−
==Documentation==
 
−
[[File:Luminance.png|thumb|Comparison of luminance on and off, using the texture at the top-right corner.]]
 
−
===texture===
 
−
Particles can use textures to shape how the particles should look. If luminance is turned on, the image file used as a texture will simply work to define the intensity of the colors. If luminance is turned off, the colors in the image file will be used in the particle. The path is the path to the image.
 
−
 
 
−
===model===
 
−
If true, the path to the model which will be used as the attack projectile. Animated models will only show the last frame.
 
−
 
 
−
===primitive===
 
−
Particles have two methods of creation: either <tt>quad</tt> (renders a set of four particles in a dot style) or <tt>line</tt> (creates solid lines). Quad is the most commonly used, as it creates the fuzzy style of particles that would be used for flames, explosions, smoke, etc, while lines are generally only used for projectiles such as an arrow. Note that you cannot have more than one particle effect linked to a projectile or splash (though you can for unit particle effects) yet, so it is not possible to mix particles (such as a line and flaming particles for a flaming arrow).
 
−
 
 
−
===mode===
 
−
Particles have two modes of rendering, either <tt>normal</tt> which uses colors, or as <tt>black</tt> which allows the usage of black particles. If not specified, it defaults to normal.
 
−
 
 
−
===color and color-no-energy===
 
−
If luminance is off, the colors of the texture will be used to color the particles. If luminance is on, the colors defined in the XML are used, though the intensity and shape will be defined by the texture. There are two colors values, the first which is the color at the start of the particle's life, and the second which defines the color when the particle is dead. Thus, the particles can transition in color. Colors are rendered by mixing red, green, and blue, as well as you can set the alpha channel. Each parameter is from 0 - 1, where 1 means there is 100% of that color. With the alpha, 1 would mean the color is almost completely transparent while 0 would be completely opaque.
 
−
 
 
−
===size and size-no-energy===
 
−
While the shape - and thus some degree of the size - is defined by the texture, the size is also affected by the size parameter passed into the XML, which will define the size in game units. Like the color, there are two size values that define the starting and ending sizes. As a result, the particles can seem to shrink or grow over their life.
 
−
 
 
−
===gravity===
 
−
Glest has a simple gravity system which can also cause particles to sink downwards - or float upwards - over their life. The value is the degree of sink - or in the case of a negative number, the degree of rise.
 
−
 
 
−
===emission-rate===
 
−
The number of individual particles that are emitted.
 
−
 
 
−
===energy-max===
 
−
The starting energy of the particles.
 
−
 
 
−
===energy-var===
 
−
A variance to add or subtract from energy-max to make particles more random.
 
−
 
 
−
===emission-fade-rate===
 
−
The rate at which the particles disappear. A lower number will have particles lasting longer, while a higher number will have shorter lasting particles.
 
−
 
 
−
===vertical-spread and horizontal-spread===
 
−
{{See|Particles/Spread}}
 
−
 
 
−
==See also==
 
−
*[[XMLs]]
 
−
 
 
−
==External links==
 
−
*[http://www.gehacktes.net/2010/01/alphablending-with-opengl/ OpenGL blending types]
 
−
[[Category:XMLs]]
 

Please note that all contributions to MegaGlest are considered to be released under the Creative Commons Attribution Share Alike (see MegaGlest:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)

Template used on this page:

Retrieved from "https://docs.megaglest.org/index.php?title=XML/Splash_particle"