View source for Control Point (particles)

{{otherlang2
|zh-cn= Control Point (particles):zh-cn
}}
{{toc-right}}

'''Control Points''' are used to pass data into and between [[:Category:Particle System|particle systems]]. A system can have up to 64, each of which can store the following:

* An [[ParticleAttachment_t|attachment type]]
* An attachment point
* An [[Vector|origin]]
* A [[matrix3x4_t|matrix]] (usually for rotation)
* An associated [[entity]]

The meanings of these values are flexible however, and "cheats" such storing an [[RGB]] colour in the origin value are supported.

Particle systems inherit the control points of their parents.

{{note|Control Points 0 (<code>vecOrigin</code>) and 1 (<code>vecStart</code>) are defined when dispatching from the server. Be aware of this when choosing which CPs to use in your system.}}

== Defining ==

=== Within a particle system ===

Use one of these Operators:

* [[Set Control Point Positions]]
* [[Set Control Point To Particles' Center]]
* [[Set Control Point To Player]]
* [[Set child control points from particle positions]]
* [[Movement Match Particle Velocities]]

=== In a map ===

Fill in the fields of the [[info_particle_system]] used to spawn the system. CP0 is the origin of the entity.

=== In code ===

See [[Particles In Code#Control points]].

=== In a QC ===

{{confirm|It is not possible to configure control points when [[compiling a model]].}} However, see the [[Position on Model Random]] initializer.

== Mapping to other values ==

<div style="display:inline-block;width:49%;vertical-align:top;">
=== Mapping functions ===
; Operators
: [[Remap Control Point to Scalar]]
: [[Remap Distance to Control Point to Scalar]]
: [[Remap Distance Between Two Control Points to Scalar]]
; Initializers
: [[Remap Control Point to Vector]] {{note|There is no 'CP to Vector' operator, just this initializer. The reasons for this omission are not clear.}}
: [[Remap Control Point to Scalar]]
: [[Remap Initial Distance to Control Point to Scalar]]
</div>

<div style="display:inline-block;width:49%;vertical-align:top;">
=== Potential targets ===
<div style="display:inline-block;width:49%;vertical-align:top;">
; Scalar
: Lifespan
: Creation time
: Radius
: Roll speed
: Alpha
: Alpha alternate
: Sequence number
: Sequence number 1
: Trail length
: Particle ID
: Yaw
</div>
<div style="display:inline-block;width:49%;vertical-align:top;">
; Vector
: Position
: Roll
: RGB Colour ([[normal]]ised)
</div>
</div>

=== Other ===

These sample values from CPs rather than remapping their literal values:

* [[Color Light from Control Point]]
* [[Velocity Inherit from Control Point]]

== Spawning children at control points ==

By default, child systems spawn at their parent's origin. To change this, use one of the "Position" Initializers with a reference to the appropriate CP number.

[[Category:Particle System]]
[[Category:Glossary]]