[[http://www.siedler-games.de|{{:sg-link.jpg|}}]]

==== Punkt in Blick- (Bau-) richtung einer Entity====
[[http://www.siedler-portal.de/vb3/sendmessage.php?do=mailmember&u=2060|Robert]]


Diese Funktion gibt den den Punkt zurück der im gewählten relativen Abstand zu einer Entity ist.

Die Parameter (_entity, _range[, _currPos]) \\ \\ 
<file>
_entity  : Ist die Person, Gebäude zu deren Blickrichtung ein Punkt erwünscht ist. 
_range   : Ist die Entfernung 
_currPos : Die Position auf der man sich befindet.</file>
Rückgabe ist der Punkt. Siehe Anwendungsbeispiel.
<code lua>function ZurEntity(_entity, _range, _currPos) 
	if type (_entity) == "table" then 
		Message("Keine Position sondern Entity angeben")  -- ein Punkt hat keine Blickrichtung
		return nil
	end
	if type (_entity) == "string" then
		_entity = GetEntityId(_entity);
	end
	local tPos = GetPosition(_entity)
	if _currPos == nil then 
		_currPos = tPos
	elseif type (_currPos) == "string" or type (_currPos) == "number"  then
		_currPos = GetPosition(_currPos)
	end
	local nEntityAngle=Logic.GetEntityOrientation(_entity);
	local nSin=math.sin((math.rad(nEntityAngle)));
	local nCos=math.cos((math.rad(nEntityAngle)));
	local tPos = GetPosition(_entity)
	return {X=_currPos.X-nCos*_range,Y=_currPos.Y-nSin*_range}; -- Rückgabe = neue Position
end
</code>

=== Anwendungsbeispiel und Erläuterung ===

  -  Einfachste Anwendung: \\ Auf einem Punkt vor einem Bauernhof soll ein Serf erscheinen. Man hat aber keine ScriptEntity.<code lua>
CreateEntity(1, Entities.PU_Serf , ZurEntity("BauernHof_XYZ",-1500),"Serf1")
</code>Jetzt erscheint ein Serf im Abstand von 1500 in der Mitte **vor** dem Bauernhof. Egal wie der Bauernhof steht.
  -  Mit allen Parametern: \\ Ein Serf soll von seiner jetztigen Position aus (er kann ja rechts oder links stehen) zum gewünschten Abstand vom Bauernhof laufen. Nehmen wir jetzt die erste Variante, dann läuft er im Abstand zum Bauernhof aber genau in der Mitte. Das wollen wir aber nicht. Also: <code lua>
Move ("Serf1", ZurEntity("BauernHof_XYZ",-1500,"Serf1"))
</code>Jetzt läuft er zu dem Punkt der 1500 vor dem Bauernhof ist, aber relativ von seiner Position.