<?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>CreateObject</title>
    <category>Objects</category>
    <subcat>Creation</subcat>
    <version>5.1 OC</version>
    <syntax>
      <rtype>object</rtype>
      <params>
        <param>
          <type>id</type>
          <name>id</name>
          <desc>Type of object to be created.</desc>
        </param>
        <param>
          <type>int</type>
          <name>xoffset</name>
          <desc>X coordinate</desc>
        </param>
        <param>
          <type>int</type>
          <name>yoffset</name>
          <desc>Y coordinate</desc>
        </param>
        <param>
          <type>int</type>
          <name>owner</name>
          <desc>Owner of the new object. Either a valid player number or <code><funclink>NO_OWNER</funclink></code> for no owner. If not specified the owner is the controller (see <funclink>GetController</funclink>) of the calling object or <code>NO_OWNER</code> if the call is made without object context.</desc>
		  <optional />
        </param>
      </params>
    </syntax>
    <desc>Creates an object of the specified type at the specified position. The position will be the center of the new object, so that the object is exactly at the specified coordinates if it is created in global context. xoffset and yoffset are relative to the calling object in local calls, otherwise global.</desc>
    <examples>
      <example>
        <code>CreateObject(Wipf, 100,100, <funclink>NO_OWNER</funclink>);</code>
        <text>Creates a wipf at coordinates 100/100 with no owner.</text>
      </example>
    </examples>
	<remark>
	The function behaviour has changed since version 6.0 OC: The offset of the object is now created at the specified position, not the bottom center. The old behaviour is used in <code><funclink>CreateObjectAbove</funclink></code>.
	</remark>
    <related>
      <funclink>CreateConstruction</funclink>
      <funclink>CreateContents</funclink>
      <funclink>CreateObjectAbove</funclink>
      <funclink>RemoveObject</funclink>
    </related>
  </func>
  <author>springer</author><date>2002-04</date>
  <author>Marky</author><date>2015-01</date>
</funcs>
