View source

{{ToolRef Particles TOC}}
{{ToolRef ToolHeader
|name=pCustom
|abbreviation=pCu
|image=Icon_pCustom.png
|description= 
The pCustom tool is used to create custom expressions that affect the properties of particles. This tool is almost identical to the [[Eyeon:Manual/Tool Reference/Misc/Custom Tool|Custom]] tool, except that the calculations affect properties of the particles rather than the properties of a pixel.
}}
[[Image:F5_MANUAL_BOOK-780.jpg]]

The following particle properties are exposed to the pCustom control :

<table cellpadding=10 cellspacing=0 border=1>
<tr><td>px, py, pz</td><td>particle position on the x, y, and z axis</td></tr>
<tr><td>vx, vy, vz</td><td>particle velocity on the x, y and z axis</td></tr>
<tr><td>rx, ry, rz</td><td>particle rotation on the x, y, and z axis</td></tr>
<tr><td>sx, sy, sz</td><td>particle spin on the x, y, and z axis</td></tr>
<tr><td>pxi1, pyi1</td><td>the 2D position of a particle, corrected for image 1's aspect</td></tr>
<tr><td>pxi2, pyi2</td><td>the 2D position of a particle, corrected for image 2's aspect</td></tr>
<tr><td>mass</td><td>not currently used by anything</td></tr>
<tr><td>size</td><td>The current size of a particle</td></tr>
<tr><td>id</td><td>''(5.2)'' The particle's identifier</td></tr>
<tr><td>r, g, b, a</td><td>The particles Red, Green, Blue and Alpha color values</td></tr>
<tr><td>rgnhit</td><td>This value is 1 if the particle hit the pCustom tools defined region</td></tr>
<tr><td>rgndist</td><td>This variable contains the particles distance from the region</td></tr>
<tr><td>condscale</td><td>The "strength" of the region at the particle's position</td></tr>
<tr><td>rgnix, rgniy, rgniz</td><td>Values representing where on the region the particle hit</td></tr>
<tr><td>rgnnx, rgnny, rgnnz</td><td>region surface normal of the particle when it hit the region</td></tr>
<tr><td>w1, h1</td><td>Image 1 width and height</td></tr>
<tr><td>w2 h2</td><td>Image 2 width and height</td></tr>
<tr><td>i1, i2, i3, i4</td><td>The result of the intermediate calculations 1 through 4</td></tr>
<tr><td>s1, s2, s3, s4</td><td>The result of the setup calculations 1 through 4</td></tr>
<tr><td>n1..n8</td><td>The values of numeric inputs 1 through 8</td></tr>
<tr><td>p1x, p1y, p1z .. p4x, p4y, p4z</td><td>The values of position inputs 1 through 4</td></tr>
<tr><td>time</td><td>The current time or frame of the compositions</td></tr>
<tr><td>age</td><td>The current age of the particle</td></tr>
<tr><td>lifespan</td><td>The lifespan of the current particle</td></tr>
</table>

Additional information on the custom class of tools can be found in documentation for the [[Eyeon:Manual/Tool Reference/Misc/Custom Tool|Custom]] tool. All of the operators, functions and conditional statements described for that tool apply to pCustom as well, including pixel-read functions for the two image inputs (e.g. getr1w(x,y), getz2b(x,y) etc).

{{EmbedTips}}

{{eyeon_copyright}}

[[Category:Fusion 5 Tool Reference]]