<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!DOCTYPE funcs
  SYSTEM '../../../clonk.dtd'>
<?xml-stylesheet type="text/xsl" href="../../../clonk.xsl"?>
<funcs>
  <func>
    <title>GetPhysical</title>
    <category>Objects</category>
    <subcat>Status</subcat>
    <version>5.1 OC</version>
    <syntax>
      <rtype>int</rtype>
      <params>
        <param>
          <type>string</type>
          <name>physical</name>
          <desc>Name of the physical property requested.</desc>
        </param>
        <param>
          <type>int</type>
          <name>mode</name>
          <desc>
            Change mode:<br/>
            <table>
              <rowh>
                <col>Constant</col>
                <col>Value</col>
                <col>Meaning</col>
              </rowh>
              <row>
                <col>PHYS_Current</col>
                <col>0</col>
                <col>In object context: The properties are queried in the currently active mode (temporary or permanent) of the object. This mode is the only one working also for objects without object info. In definition context: The standard values of the definitions are queried.</col>
              </row>
              <row>
                <col>PHYS_Permanent</col>
                <col>1</col>
                <col>The permanent properties stored in the player file are queried. This is only possible for player crew members.</col>
              </row>
              <row>
                <col>PHYS_Temporary</col>
                <col>2</col>
                <col>The temporary properties are queried if they exist.</col>
              </row>
            </table>

          </desc>
        </param>
      </params>
    </syntax>
    <desc>Returns physical properties of the object or the definition in the calling context</desc>
    <examples>
      <example>
        <code><funclink>if</funclink> (<funclink>GetCursor</funclink>()-&gt;GetPhysical(&quot;Magic&quot;)) <funclink>GetCursor</funclink>()-&gt;<funclink>Message</funclink>(&quot;I can do magic!&quot;);</code>
        <text>The selected clonk is happy if he's currently able to accept magical energy.</text>
      </example>
    </examples>
    <related>
      <funclink>SetPhysical</funclink>
      <funclink>TrainPhysical</funclink>
      <funclink>ResetPhysical</funclink>
    </related>
  </func>
  <author>jwk</author><date>2002-06</date>
  <author>Sven2</author><date>2003-06</date>
</funcs>
