/// <summary>Overrides the position of some or all agents in the simulation. You can decide for yourself which agents are affected.</summary>
/// <param ref="agentData">A reference to an array of AgentData objects, where each object describes the position of a single agent that you want to set.</param>
/// <param ref="nrAgents">The number of entries in the AgentData array.</param>
/// <returns>true if the operation was successful; false otherwise, i.e. if the simulation has not been initialized (correctly) yet.</returns>