Clipboard

Clipboard carries values from one emitter to others. Tick the rows to carry, press Copy on the tuned emitter, select the others, and press Paste. Clipboard is a tab of the PropertyTools panel, beside Shifter.

What it makes possible:

• Nine emitters matched to a tuned tenth. Tick the Motion category, press Copy, select the nine, press Paste.
• A fade carried to another type. Copy the Transparency graph of a Part emitter and paste it onto a stock ParticleEmitter.
• One event setup, such as OnDeath, copied to a set of emitters with nothing else touched.
• A set of Blender states copied from one Beam emitter to another.

Opening and closing

To	Do this
Open the panel	Press ≡, then Tools, then PropertyTools. Click the Clipboard tab if Shifter is showing.
Close the panel	Press PropertyTools again, or press X in the header.
Fold the panel away	Press the minimise button beside X. A chip reading PropertyTools appears in a row under the HUD.
Bring the panel back	Click the chip.

The panel folds away by itself when nothing the plugin can edit is selected, and returns when an emitter is selected again. The shortcut action Toggle Clipboard brings the tab forward. Panels describes tabs and folding in full.

The controls

Control	Kind	Starts at	What it does
Copy	Button		Stores the value of every ticked row, read from the selection.
Paste	Button		Writes the stored values to every selected emitter, for the rows ticked now.
Search…	Box	Empty	Narrows the list to the rows that match.
Properties list	List of rows, each with a tick box	Every row unticked, every category folded	Chooses which rows are copied and pasted.

The list

The list shows the rows of the selected emitters, grouped in categories. With nothing selected the list is empty.

• A row appears when at least one selected emitter type has it.
• A row that several types share appears once.
• The categories follow the Properties panel: Emission, Appearance (or Light, or Scale), Blender, Spawn, Shape, Texture, Motion, Flipbook, Mesh Frames.
• After those come the categories of single types, such as Bolt, Impact, Shake, Rope, Sound, Field and Screen.
• Events and Advanced come last.
• Rows carry the names the Properties panel shows, such as Linger, Anim. Steps, Hollow, Reverse Motion and Displacement X.
• Each event has its own row in Events: OnEmit, OnDeath, OnDestruction and OnHit.
• The HUD boxes appear as EmitCount, EmitDelay and EmitDuration.

A stock ParticleEmitter shows these rows:

Category	Rows
Emission	Rate, Lifetime, TimeScale, EmitCount, EmitDelay, EmitDuration
Spawn	ZOffset
Motion	SpreadAngle, Speed, Acceleration, Drag, Rotation, RotSpeed, VelocityInheritance, WindAffectsDrag
Appearance	Color, Brightness, Size, Transparency, Squash, LightEmission, LightInfluence
Flipbook	FlipbookFramerate, FlipbookBlendFrames

Ticking rows

To	Do this
Tick or untick one row	Click the row. Its box changes between ☐ and ☑.
Tick a run of rows	Press on a row and drag across the others. Each row crossed takes the state of the first.
Tick a whole category	Click the category’s name. Every row in it is ticked and the category opens.
Untick a whole category	Click the name again. Every row is unticked and the category folds.
Open a category without changing its ticks	Click the small arrow beside the name.
Tick or untick everything	Click the name of the Properties header.

The box of a category, and of the Properties header, shows ☑ only when every row under it is ticked.

Search

Enter text in Search… to narrow the list. A row matches when the text starts its label, or starts any word of its label. Capitals do not matter. A category with no matching row is hidden. Clearing the box brings the list back as it was.

size finds Size X. It does not find a label that holds those letters in the middle of a word.

Copy

Step	Control	Action	Result
1	Explorer	Select the emitter to copy from	The list shows its rows.
2	Clipboard ▸ list	Click each row to copy	Each clicked row shows ☑.
3	Clipboard ▸ Copy	Press	The values are stored. Output prints Part-Icles: Clipboard copied.

One value is stored for each ticked row. Select one emitter to copy from, so that the value comes from a known place.

With several emitters selected, each value is read from the first selected emitter of one type. The first type present in this order is used: Part, Beam, stock Beam, Light, Sound, stock Trail, Trail emitter, Highlight, Attachment, Model. After those come Lightning, Camera Shake, Rocks, Rope, Distortion, Blur, Bloom, ColorCorrection, Atmosphere, ImageLabel and stock ParticleEmitter.

If no row is ticked, or nothing usable is selected, the earlier copy is kept. Output prints Part-Icles: Clipboard copy skipped (empty selection).

The copy survives a change of selection and the closing of the panel. It is lost when the plugin is switched off or Studio closes.

NOTE

The two messages print only while Settings ▸ Console Output is on. See Settings.

Paste

Step	Control	Action	Result
1	Explorer	Select the emitters to paste onto	The list shows their rows.
2	Clipboard ▸ list	Click any wanted row that shows ☐	Every row to paste shows ☑.
3	Clipboard ▸ Paste	Press	Every selected emitter that has a ticked row takes the copied value.

A row is pasted only if it is in the copy and ticked at the moment of the press. The value is written to every selected emitter, of every type, that has a row of that name. The whole paste is one step in Studio’s undo history, named Part-Icles: Clip Paste.

With no row ticked, or with nothing copied, Paste does nothing.

CAUTION

A row left unticked is not pasted, even when it was copied. Look at the ticks before pressing Paste.

Between different emitter types

A row of the same name can hold a different kind of value on another type. Speed is a graph on a Part emitter and two numbers on a stock ParticleEmitter.

Copied	Pasted onto	Result
Any value	A row of the same kind	Copied as it is.
One number	A row of two numbers	Both numbers take the value. 2 becomes 2, 2.
Two numbers	A row of one number	The row takes the average. 1, 3 becomes 2.
Anything but a graph	A graph row	Skipped, with no message.
A graph	A row of one number	Skipped, with no message.
Anything but a gradient	A colour row	Skipped, with no message.
One number for Lifetime	A stock ParticleEmitter	Both numbers of its Lifetime take the value.

Some rows carry more than one value:

Row	What is copied
Material	The material of the particle, as the Properties panel shows it.
Blender	Every state of the Beam emitter. The states of the emitter pasted onto are replaced.
OnEmit, OnDeath, OnDestruction, OnHit	The whole setup of that event. An event the other type does not have is skipped.
EmitCount, EmitDelay, EmitDuration	The values of the HUD boxes Emit, Delay and Duration.

Limits

• One value is stored for each row. Clipboard cannot hold two emitters’ values for the same row at once.
• A copied Blender state carries its Time, its Transparency and its Color. It does not carry its Transition.
• A value of the wrong kind is skipped without a message. Check the row on the emitter after pasting between types.
• Clipboard sets rows to a copied value. To multiply or add to the values already there, use Shifter.