File: particle_info.rst

package info (click to toggle)
blender-doc 4.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 253,604 kB
  • sloc: python: 13,030; javascript: 322; makefile: 113; sh: 107
file content (55 lines) | stat: -rw-r--r-- 1,369 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
.. _bpy.types.ShaderNodeParticleInfo:

******************
Particle Info Node
******************

:guilabel:`Cycles Only`

.. figure:: /images/node-types_ShaderNodeParticleInfo.webp
   :align: right
   :alt: Particle Info Node.

The *Particle Info* node can be used in the material node tree for objects that are used as the instancing objects,
when you use *Object* or *Collection* :doc:`Render mode </physics/particles/emitter/render>` of a particle system.

This node gives access to the data of the particle that spawned the object instance.
It can be useful to give some variation to a single material assigned to multiple instances of instancing object.

.. note::

   This node currently only supports parent particles. Info from child particles is not available.


Inputs
======

This node has no inputs.


Properties
==========

This node has no properties.


Outputs
=======

Index
   Index number of the particle (from 0 to number of particles).
Random
   A random per-particle value in the range from 0 to 1.
   It can for example be used in combination with a color ramp, to randomize the particle color.
Age
   Age of the particle in frames.
Lifetime
   Total lifespan of the particle in frames.
Location
   Location of the particle.
Size
   Size of the particle.
Velocity
   Velocity of the particle.
Angular Velocity
   Angular velocity of the particle.