Tonyhilliam at 02:07, 17 January 2018

2018-01-17T02:07:10Z

← Older revision		Revision as of 02:07, 17 January 2018
Line 53:		Line 53:
	Turning them on and off and, if you wish, changing the texture that they use is just about all that you can do with coronas. Size and frequency are preset in ''config.txt'' and can't be altered by script.<br><br>		Turning them on and off and, if you wish, changing the texture that they use is just about all that you can do with coronas. Size and frequency are preset in ''config.txt'' and can't be altered by script.<br><br>
	Next Tutorial: [[Playing Sounds.]]<br>		Next Tutorial: [[Playing Sounds.]]<br>

			[[Getting_Started_in_TrainzScript\|Back to Getting Started]]

Windwalkr: 1 revision

2010-02-03T13:59:00Z

1 revision

← Older revision	Revision as of 13:59, 3 February 2010
(No difference)

Andi06: /* Handling Corona Effects */

2008-07-11T22:56:15Z

Handling Corona Effects

New page

You will have noticed the call ''SetFXCoronaTexture("corona",null);'' in the previous code examples. Corona effects specified in config.txt will be turned on when the object is loaded. This call turns the corona off to begin with since it won't be needed until the doors start to open. To deal with coronas we need to add some code, new sections are in blue.

include "Buildable.gs"

class Tutorial isclass Buildable {

bool doorsOpen = false;

public void Init(void) {
inherited();
SetFXCoronaTexture("corona",null);
AddHandler(me,"Object","","ObjectHandler");
}

/* GetCorona is a utility method that will read the ''texture-kuid'' tag from the
''config.txt'' of our shed. When we turned the corona off in Init() the reference
to the KUID of the corona was lost and there is no easy way to reset it. This
method retrieves the value and returns it as a corona asset. Code which reads data
from a Soup, which is the Trainz word for database, is often very convoluted and
difficult to follow. I have split the code into different calls here, and made
it a separate method in order to keep it readable, but it could have been written
as one long statement.*/ 

Asset GetCorona(string mesh, string effect) {
Soup meshtable = GetAsset().GetConfigSoup().GetNamedSoup("mesh-table");
Soup effects = meshtable.GetNamedSoup(mesh).GetNamedSoup("effects");
KUID kuid = effects.GetNamedSoup(effect).GetNamedTagAsKUID("texture-kuid");
return World.FindAsset(kuid);
}

/* We can use the same mechanism to control the coronas that we are using to open
and close the shed doors, we just need to add the appropriate statements. */

void ObjectHandler(Message msg) {
Vehicle vehicle = cast<Vehicle>msg.src;
if (!vehicle) return;
if (msg.minor == "InnerEnter") {
doorsOpen = true;
SetMeshAnimationState("default", true);
SetFXCoronaTexture("corona",GetCorona("default","corona"));
}
else if (msg.minor == "InnerLeave") {
doorsOpen = false;
SetMeshAnimationState("default", false);
SetFXCoronaTexture("corona",null);
}
}

};

Accessing ''texture-kuid'' requires a lot of words but you should not be misled by this. Soups are very powerful and flexible and you will come across them quite frequently. If you look at the ''config.txt'' structure you will see that the method GetCorona() needed to access a value in a database which is nested four levels deep!

Turning them on and off and, if you wish, changing the texture that they use is just about all that you can do with coronas. Size and frequency are preset in ''config.txt'' and can't be altered by script. 
Next Tutorial: [[Playing Sounds.]]

Handling Corona Effects. - Revision history

Tonyhilliam at 02:07, 17 January 2018

Windwalkr: 1 revision

Andi06: /* Handling Corona Effects */