openclonk/docs/sdk/script/fn/SetMass.xml

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<!DOCTYPE funcs SYSTEM "../../../clonk.dtd">
<?xml-stylesheet type="text/xsl" href="../../../clonk.xsl"?>
<funcs>
	<func>
		<title>SetMass</title>
		<category>Objekte</category><subcat>Status</subcat>
		<version>4.9.1.0 GWE</version>
		<syntax>
			<rtype>void</rtype>
			<params>
				<param><type>int</type><name>mass</name><desc>Neue Eigenmasse</desc></param>
			</params>
		</syntax>
		<desc><EFBFBD>ndert die Eigenmasse des aufrufenden Objekts. Die Eigenmasse entspricht dem in der <emlink href="definition/DefCore.html">DefCore.txt</emlink> angegebenen Wert unter [DefCore], Mass. Die tats<74>chliche Objektmasse ergibt sich durch Hinzurechnen der Masse aller enthaltenen Objekte.</desc>
		<examples>
			<example>

<code>private func GetOwnMass(clonk)
  {
  var mass=clonk-><funclink>GetMass</funclink>(), i, obj;
  <funclink>while</funclink>(obj = clonk-><funclink>Contents</funclink>(i++)) mass -= obj-><funclink>GetMass</funclink>();
  <funclink>return</funclink>(mass);
  }

protected func Activate(pByClonk)
  {
  [Essen]
  pByClonk->SetMass(GetOwnMass(pByClonk) + 100);
  pByClonk-><funclink>Sound</funclink>("ClonkMunch");
  <funclink>return</funclink>(<funclink>RemoveObject</funclink>());
  }</code>

				<text>Script f<>r einen Keks: Beim Essen nimmt die Masse des Clonks zu.</text>
			</example>
		</examples>
		<related>
			<funclink>GetMass</funclink>
		</related>
	</func>
	<author>Sven2</author><date>Juni 2003</date>
</funcs>