{"id":1508,"date":"2024-11-20T22:31:19","date_gmt":"2024-11-20T13:31:19","guid":{"rendered":"https:\/\/heyyocg.link\/?p=1508"},"modified":"2024-11-20T22:31:20","modified_gmt":"2024-11-20T13:31:20","slug":"ue4-26-niagara-advanced-particle-attribute-reader-basic","status":"publish","type":"post","link":"https:\/\/heyyocg.link\/en\/ue4-26-niagara-advanced-particle-attribute-reader-basic\/","title":{"rendered":"Niagara Advanced Guide – Particle Attribute Reader"},"content":{"rendered":"\n

Epic Games distributes a project called \u201cContent Examples,\u201d which is a collection of various sample projects showcasing different features of Unreal Engine. Since UE4.26, there is a map called Niagara Advanced<\/em>.<\/p>\n\n\n\n

This map contains a wealth of useful samples, including examples of new Niagara features and practical applications. Upon reviewing the implementations, there\u2019s a lot to learn.<\/p>\n\n\n\n

This article will break down these samples into multiple parts for detailed explanations.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

By the way, Content Examples<\/em> can be downloaded from this link<\/a> in Fab. Please note that the content may vary depending on the version of UE.<\/p>\n\n\n\n

\u203bNote: This blog is written based on UE4.26 Contents Example, so it might differ from the latest version in small details, but the concept itself explained here won’t change<\/p>\n\n\n\n

TLDR;)<\/h2>\n\n\n\n
    \n
  • With the Particle Attribute Reader, you can obtain attribute information from the same emitter or another emitter’s particles.<\/li>\n\n\n\n
  • To fetch the information, you need to specify which particle’s data to retrieve using either the Execution Index or Particle ID.<\/li>\n\n\n\n
  • The reader and the data source must be the same Sim Target.<\/li>\n<\/ul>\n\n\n\n

    Introduction<\/h2>\n\n\n\n

    This article will explain the Particle Attribute Reader.<\/p>\n\n\n\n

    The Particle Attribute Reader has been available since version 4.25, but in version 4.26, it has more samples and has become a very useful feature. In this article, I will explain it in more detail.<\/p>\n\n\n\n

    As the name suggests, it allows you to retrieve attribute data from other emitters or the same emitter\u2019s particles by specifying the Execution Index or ID.<\/p>\n\n\n\n

    In this explanation, we will go over three samples in Niagara Advanced: \u201c2.1 Particle Attribute Reader,\u201d \u201c2.2 Follow The Leader 1.0,\u201d and \u201c2.3 Spawn Particles Another Emitter,\u201d to help you understand the basics of this feature.<\/p>\n\n\n\n

    The Particle Attribute Reader can be used in both CPU Sim and GPU Sim, but the reader and the target particle must share the same Sim Target.<\/p>\n\n\n\n

    2.1 Particle Attribute Reader<\/h2>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    Note: The GIF image above shows two Niagara Systems: one at the top and the Ring at the bottom. Since the top one is simple, we will focus on explaining the Ring at the bottom.<\/p>\n\n\n\n

    A particle orbits along a circle, and its color changes as it passes through certain points.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    The system consists of two emitters: Leader and Ring.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    The Leader emitter has a single sprite that continuously rotates in a circle. It completes a full rotation during its lifetime, and its color is randomly set upon spawning.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    The Ring emitter has particles evenly distributed in a circle. When no Leader is present, these particles remain white. By retrieving and applying the Leader’s color attribute, the particles change color accordingly.<\/p>\n\n\n\n

    By the way, to distribute the particles evenly in a circle, the Torus Location module is used. The Distribution is set to Direct Mode, with the Radius Position set to a constant and U Position using the Return Normalized Exec Index. This is a handy piece of information.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Now, for the important part: the Particle Attribute Reader. It is initialized at Emitter Spawn. By specifying the name of the emitter you want to read from in the Emitter Name, you can target the emitter.\u3002<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Then, using the \u201cRead Color from Emitter\u201d (Scratch Pad module), it reads and applies the color data from the Leader.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    Using the \u201cGet {Data Type} By Index\u201d node, you input the Particle Attribute Reader and Particle Index, and specify the attribute name you wish to retrieve.<\/p>\n\n\n\n

    The Index is the same as the Execution Index. Since the Leader only has one particle, entering 0 will retrieve the data from that particle.<\/p>\n\n\n\n

    In other parts of the Scratch Pad, the distance between the current particle\u2019s position and the Leader\u2019s position is checked. If it\u2019s smaller than a set threshold, the current particle\u2019s color is changed to match the Leader’s color.<\/p>\n\n\n\n

    This creates the effect where particles change color as the Leader passes by.<\/p>\n\n\n\n

    It\u2019s a simple but foundational concept.<\/p>\n\n\n\n

    2.2 Follow The Leader 1.0<\/h2>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    In this sample, red particles float around, and green particles maintain a certain distance while following them.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Like the previous example, it consists of two emitters: Leader and Followers.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    The Leader is a red floating object. It spawns 22 particles using Spawn Burst Instantaneous and is kept floating with forces like Curl Noise Force and Vortex Force.<\/p>\n\n\n\n

    One key point to note is that the Emitter Properties have the \u201cRequires Persistent IDs\u201d checkbox enabled. This ensures that when the Particle Attribute Reader retrieves data, it uses Particle ID instead of Execution Index.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Execution Index refers to the order in which the processing is done. When particles are continuously born and die, new particles might get the same Execution Index as dead particles. On the other hand, Particle ID is unique and remains consistent, so there\u2019s no risk of overlap.<\/p>\n\n\n\n

    Depending on the situation, you need to decide whether to use Execution Index or Particle ID.<\/p>\n\n\n\n

    Next, let\u2019s look at the Followers. As with the previous sample, Particle Attribute Reader is initialized at Emitter Spawn.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    An Attribute called “Offset” is created, which stores a random vector of a specific length. This is used to maintain a set distance from the Leader.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    In the Initialize Followers section, the Particle ID of the Leader is determined, and in the Update Followers section, the particle follows the Leader\u2019s movement. Both are Scratch Pad Module.<\/p>\n\n\n\n

    Let\u2019s focus on Initialize Followers.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    First, from the Particle Attribute Reader, \u201cGet Num Particles\u201d retrieves the total number of particles in the emitter at that moment. Since there are 22 particles, subtracting 1 gives an index range of 0 to 21. Using \u201cCalculate Random Range Index,\u201d a random index between 0 and 21 is selected.<\/p>\n\n\n\n

    This index is then used with \u201cGet ID at Spawn Index\u201d to retrieve the Particle ID.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    That Particle ID is saved as the Leader\u2019s ID. This allows the particle to determine which Leader to follow.<\/p>\n\n\n\n

    Now, using this ID, \u201cGet Vector by ID\u201d fetches the Leader\u2019s position (Attribute Name is None in the picture but it’s just a mistake and should be Position). The previously set Offset value is added to it to define the follower’s position.<\/p>\n\n\n\n

    Next, in the Update Followers section, Each of particles retrieves Position of the Leader particle it follows by LeaderID which was set in Initialize Followers and adds velocity towards the position added by Offset.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    Instead of directly overwriting the position, the velocity is used, adding a bit of \u201cplay\u201d to make the following motion feel more natural.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Finally, since velocity is used, be sure to include the Solve Forces and Velocity module to move the particle.<\/p>\n\n\n\n

    2.3 Spawn Particles Another Emitter<\/h2>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    Finally, let\u2019s look at the \u201cSpawn Particles Another Emitter\u201d sample. In this system, particles are randomly emitted, and new particles are spawned along their trajectory, creating an effect similar to Ribbon Renderer.<\/p>\n\n\n\n

    However, since Ribbon Renderer does not work in GPU Sim, this approach is noteworthy because it achieves a similar effect in GPU Sim.<\/p>\n\n\n\n

    Also, unlike the previous examples, this sample doesn\u2019t require implementing Scratch Pad manually. Instead, UE provides specialized modules that work with other emitters to control particle behavior.<\/p>\n\n\n\n

    Let\u2019s take a closer look.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    As usual, it consists of two emitters: Leaders and Followers.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    The Leaders emitter simply releases particles upward at random. We won\u2019t go into detail here.<\/p>\n\n\n\n

    The important part with the Followers is the use of two modules: \u201cSpawn Particles from Other Emitter\u201d and \u201cSample Particles from Other Emitter.\u201d These two modules must be used together.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    First, let\u2019s look at the \u201cSpawn Particles from Other Emitter.\u201d<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    You input the name of the emitter that will be the source of the particles.<\/p>\n\n\n\n

    The Spawn Rate defines how many particles to spawn per second, and if you check \u201cCalculate Spawn Rate Per Particle,\u201d the spawn rate will be applied per particle of the source emitter. In this case, 22 x 50 = 1100 particles will be spawned per second.<\/p>\n\n\n\n

    \u201cSpawn Rate Per Particle Cap\u201d sets the upper limit of particles spawned per source particle.<\/p>\n\n\n\n

    Next, let\u2019s look at \u201cSample Particles from Other Emitter.\u201d<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Emitter Sampling Mode has two options: Sequential and Random. Choosing Random will spawn particles from randomly selected particles of the source emitter. Sequential will select them in order.<\/p>\n\n\n\n

    The Filtering section allows you to filter source particles with three settings.<\/p>\n\n\n\n

    The other options pertain to the particle’s basic attributes, like Position, Color, Velocity, and Mass, and you can choose whether to inherit values from the source emitter.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    When you click the dropdown, you can select from Disabled, Apply to Attribute, or Output Only. Choosing Apply to Attribute will apply the source particle\u2019s value to the spawned particle\u2019s attributes. Output Only will keep the value as an output attribute without applying it.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    This is useful when you only need the data without modifying the particle.<\/p>\n\n\n\n

    With these settings, it\u2019s easy to spawn new particles from another emitter\u2019s particles and inherit their attributes.<\/p>\n\n\n\n

    Conclusion<\/h2>\n\n\n\n

    The need to retrieve data from other particles is quite common, and thanks to the Particle Attribute Reader, it\u2019s now much easier to do.<\/p>\n\n\n\n

    In the past, we would use an Event Handler to trigger an event and retrieve data from other particles, but using the Particle Attribute Reader is simpler and more performance-friendly.<\/p>\n\n\n\n

    I think this is a great feature, and as expected from Niagara.<\/p>\n\n\n\n

    Enjoy your CG journey!<\/p>\n","protected":false},"excerpt":{"rendered":"

    Epic Games distributes a project called \u201cContent Examples,\u201d which is a collection of various sample projects showcasing different features of Unreal Engine. Since UE4.26, there is a map called Niagara Advanced. This map contains a wealth of useful samples, including examples of new Niagara features and practical applications. Upon reviewing the implementations, there\u2019s a lot to […]<\/p>\n","protected":false},"author":1,"featured_media":385,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_lmt_disableupdate":"no","_lmt_disable":"","_mi_skip_tracking":false,"footnotes":"","_locale":"en_US","_original_post":"http:\/\/heyyocg.link\/?p=383"},"categories":[17,31],"tags":[32,15,30],"modified_by":"yohanashima","_links":{"self":[{"href":"https:\/\/heyyocg.link\/wp-json\/wp\/v2\/posts\/1508"}],"collection":[{"href":"https:\/\/heyyocg.link\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/heyyocg.link\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/heyyocg.link\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/heyyocg.link\/wp-json\/wp\/v2\/comments?post=1508"}],"version-history":[{"count":1,"href":"https:\/\/heyyocg.link\/wp-json\/wp\/v2\/posts\/1508\/revisions"}],"predecessor-version":[{"id":1509,"href":"https:\/\/heyyocg.link\/wp-json\/wp\/v2\/posts\/1508\/revisions\/1509"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/heyyocg.link\/wp-json\/wp\/v2\/media\/385"}],"wp:attachment":[{"href":"https:\/\/heyyocg.link\/wp-json\/wp\/v2\/media?parent=1508"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/heyyocg.link\/wp-json\/wp\/v2\/categories?post=1508"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/heyyocg.link\/wp-json\/wp\/v2\/tags?post=1508"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}