Precipitation {documentation world editor adding objects} - LuisAntonRebollo/Torque-3D-Wiki-Test GitHub Wiki

The Torque 3D World Editor allows you to quickly add different types of precipitation to your level. However, Precipitation is used as a general term meaning any type of particle moving downward. The ability to quickly add rain, snow, or even a sandstorm to your level is built into the editor.

To add Precipitation to a level, switch to the Library tab in the Scene Tree panel. Click on the Level tab amd double-click the Environment folder. Locate the Precipitation entry.

Double-click the Precipitation entry.The Create Object dialog will appear.

Enter a name for your Precipitation object. The Precipitation data field allows you to choose a datablock to start with as the basis for your new object. Click the drop down box for a list of available datablocks.

For the Full template, your only choice is HeavyRain so select it then click Create New. Your new Precipitation object will be added to your level, and rain will start falling automatically. The stock datablock for HeavyRain simulates a light shower, so you may not see much rain falling:

(click to enlarge)

The HeavyRain datablock is located in the game/art/datablocks/environment.cs file. Its initial data contains the following:

datablock PrecipitationData(HeavyRain)
{
soundProfile = "HeavyRainSound";
dropTexture = "art/environment/precipitation/rain";
splashTexture = "art/environment/precipitation/water_splash";
dropSize = 0.35;
splashSize = 0.1;
useTrueBillboards = false;
splashMS = 500;
};

We will get into manipulating the datablock later.

Additional properties can be changed with the Inspector pane. To change a Precipitation objects properties using the Inspector Pane click the Scene tab, then click the name of your new Precipitation object. The Inspector pane will update to display the current properties of your new sun.

Hover over each section in the image below to see a description of the fields within it:

When you add a Precipitation object to a level from the Library, you are adding the actual precipitation object. In order for the object to work however it must be assigned a datablock. Datablocks have their own set of properties which are transmitted over a server to each client. When creating or editing a PrecipitationData datablock, you will be modifying the following properties:

(hover over image for descriptions

Of all the objects you can add to a level, Precipitation has the widest range of applications. Remember, this object is not limited to rain. Anything that can fall from the sky or float in the air over large areas can be simulated with Precipitation: snow, sandstorms, falling ash and rock, fireflies, and so on. Take the time to experiment with this to see what you can come up with.