Function GetDisplayPosition

TombEngine/Scripting/Internal/TEN/Util/Util.cpp:80–89

Get the projected display space position of a 3D world position. Returns nil if the world position is behind the camera view. @function GetDisplayPosition @tparam Vec3 worldPos 3D world position. @treturn Vec2 Projected display space position in percent. @usage -- Example: Display a string at the player's position. local displayPos = TEN.Util.GetDisplayPosition(Lara:GetPosition()) local str = TEN.

	// local str = TEN.Strings.DisplayString('You are here!', displayPos)
	// TEN.Strings.ShowString(str, 4)
	static sol::optional<Vec2> GetDisplayPosition(const Vec3& worldPos)
	{
		auto displayPos = g_Renderer.Get2DPosition(worldPos.ToVector3());
		if (!displayPos.has_value())
			return sol::nullopt;

		return Vec2(
			(displayPos->x / DISPLAY_SPACE_RES.x) * 100,
			(displayPos->y / DISPLAY_SPACE_RES.y) * 100);
	}

	/// Translate a pair display position coordinates to pixel coordinates.<br>
	// To be used with `Strings.DisplayString` and `Strings.DisplayString:SetPosition`.