en to fr translation catalogue (31 entries)

note: type: Title-text
en: Remote control #5
fr: Télécommande #5

note: type: Resume-text
en: Remote control a bot without using an information exchange post by storing the orders.
fr: Télécommandez un robot en mémorisant tous les ordres.

note: type: \b; header
en: Exercise
fr: Exercice

note: type: Plain text
en: Remote control a slave robot without using an <a object|exchange>information exchange post</a>. The robot should pass over the 6 blue crosses.
fr: Télécommandez un robot, sans utiliser une <a object|exchange>station relais</a>, pour qu'il passe par les 6 croix bleues.

note: type: Plain text
en: The two main actors of this exercise are:
fr: Les 2 acteurs principaux de cet exercice sont:

note: type: Bullet: '1)'
en: The <a object|botgr>wheeled grabber</a> without an energy pack and therefore immobile. This is the master you should program so it will transmit orders to the slave.
fr: Un <a object|botgr>robot préhenseur</a> sans batterie, donc immobile. C'est lui l'émetteur que vous devez programmer.

note: type: Bullet: '2)'
en: The slave <a object|bottr>practice bot</a> which is already programmed and just waits for orders from the master.
fr: Un <a object|bottr>robot d'entraînement</a> qui attend les ordres. Ce robot est déjà programmé.

note: type: Plain text
en: The orders shall be stored, so the master will be able to transmit several orders without waiting for each order being processed. We use an <a cbot|array>array</a> for this purpose.
fr: Il faudra mémoriser les ordres, afin que le robot émetteur puisse donner tous les ordres sans attendre. Pour cela, le plus simple est d'utiliser un <a cbot|array>tableau</a> d'ordres.

note: type: \b; header
en: The slave
fr: Le robot récepteur

note: type: Plain text
en: First of all we must understand how the program of the slave works. The <a cbot|class>class</a> <code>order</code> contains two members: <code>m_type</code> is the order to execute (move or turn) and <code>m_param</code> is the distance to move or the rotation angle:
fr: Pour commencer, il faut comprendre le programme du robot d'entraînement qui attend les ordres.
    Une <a cbot|class>classe</a> <code>order</code> contient deux variables: <code>global_type</code> détermine l'ordre à effectuer (avancer ou tourner) et <code>global_param</code> détermine la distance à avancer ou l'angle de rotation:

note: type: Source code
en: {
    	<a cbot|int>int</a>    m_type;
    	<a cbot|float>float</a>  m_param;
    }
fr: {
    	<a cbot|int>int</a>    global_type;
    	<a cbot|float>float</a>  global_param;
    }

note: type: Plain text
en: A second <a cbot|class>class</a> <code>exchange</code> contains the mechanism for exchanging the orders. We declare a <code><a cbot|static>static</a></code> class member <code>m_fifo</code> which will contain the list of orders to be executed. The word <code>static</code> insures that the member <code>m_fifo</code> is shared between all instances of the <a cbot|class>class</a> exchange.
fr: Une deuxième <a cbot|class>classe</a> <code>exchange</code> contient le mécanisme d'échange et de mémorisation des ordres. Il faut d'abord déclarer une variable <code><a cbot|static>static</a></code> appelée ici <code>global_fifo[]</code>. Cette variable contient une liste d'ordres à effectuer. Les accolades <code>[]</code> indiquent qu'il s'agit d'un <a cbot|array>tableau</a>. L'instruction <code>static</code> permet à tous les robots d'accéder à la même variable unique.

note: type: Plain text
en: <c/><s/>{
fr: <c/><s/><a cbot|public>public</a> <a cbot|class>class</a> exchange

note: type: Source code
en: 	<a cbot|static>static</a> <a cbot|private>private</a> order m_fifo[] = null;
fr: {
    	<a cbot|static>static</a> <a cbot|private>private</a> order global_fifo[] = null;

note: type: Plain text
en: The <code>put</code> method will be used by the master robot for transmitting an order. The order will simply be added at the end of the <code>m_fifo</code> array:
fr: Une première méthode <code>put</code> sera utilisée par le robot émetteur pour donner un ordre. L'ordre est simplement ajouté à la fin du tableau:

note: type: Source code
en: 	{
    		m_fifo[sizeof(m_fifo)] = a;
    	}
fr: 	{
    		global_fifo[sizeof(global_fifo)] = a;
    	}

note: type: Plain text
en: Another method <code>get</code> will be used by the slave to retrieve the orders. This method returns the order to be executed. If the list is empty, <code>null</code> will be returned and the robot must wait for more orders. Otherwise the first order in the list must be returned and the remaining orders must be "scrolled up". As an array can not be "shortened" we use a temporary array <code>copy</code>:
fr: Une deuxième méthode <code>get</code> sera utilisée par le robot récepteur pour prendre connaissance d'un ordre à effectuer. Si la liste est vide, on retourne <code>null</code> et le robot devra attendre. Dans le cas contraire, il faut retourner le premier ordre de la liste, et décaler tout le contenu de la liste vers le haut. Pour cela, il est nécessaire d'utiliser une nouvelle liste intermédiaire <code>copy</code>, car une liste existante n'est jamais raccourcie:

note: type: Source code
en: 	{
    		if ( sizeof(m_fifo) == 0 )  return null;
    
    		order a = m_fifo[0];
    		order copy[] = null;
    		for ( int i=1 ; i<sizeof(m_fifo) ; i++ )
    		{
    			copy[i-1] = m_fifo[i];
    		}
    		m_fifo = copy;
    		return a;
    	}
fr: 	{
    		if ( sizeof(global_fifo) == 0 )  return null;
    
    		order a = global_fifo[0];
    		order copy[] = null;
    		for ( int i=1 ; i<sizeof(global_fifo) ; i++ )
    		{
    			copy[i-1] = global_fifo[i];
    		}
    		global_fifo = copy;
    		return a;
    	}

note: type: Plain text
en: The main program of the slave contains an instance of the class <code>exchange</code> called <code>list</code>. We put () after the word <code>list</code> in order to create an instance of the class <code>exchange</code>.
fr: Le programme principal peut maintenant exister. La variable <code>list</code> est de type <code>exchange</code>, qui est une <a cbot|class>classe</a>. Il faut utiliser l'instruction <code><a cbot|new>new</a></code> pour créer immédiatement une instance.

note: type: Source code
en: {
    	exchange list();
    	order    todo;
fr: {
    	exchange list = new exchange();
    	order    todo;

note: type: Plain text
en: The outer <code>while</code> loop lasts for ever. The inner <code>while</code> loop waits for an order by using the <code>get</code> method of the <code>exchange</code> class. As soon as <code>get</code> returns a value different from <code>null</code>, the while loop stops.
fr: La première boucle <code>while</code> exécute les ordres à l'infini. La deuxième boucle <code>while</code> attend un ordre en exécutant la méthode <code>get</code> de la classe <code>exchange</code>. Dès qu'un ordre contenant une valeur différente de <code>null</code> est reçu, la boucle est stoppée.

note: type: Plain text
en: Now we have received the order in the <code>todo</code> variable. All we have to do is execute it:
fr: Il ne reste plus qu'à exécuter l'ordre reçu:

note: type: Plain text
en: <c/><s/>		if ( todo.m_type == 1 )
fr: <c/><s/>		if ( todo.global_type == 1 )

note: type: Source code
en: 		{
    			move(todo.m_param);
    		}
    		else if ( todo.m_type == 2 )
    		{
    			turn(todo.m_param);
    		}
    		else
    		{
    			message("Unknown order");
    		}
    	}
    }
fr: 		{
    			move(todo.global_param);
    		}
    		else if ( todo.global_type == 2 )
    		{
    			turn(todo.global_param);
    		}
    		else
    		{
    			message("Unknown order");
    		}
    	}
    }

note: type: \b; header
en: The master
fr: Le robot émetteur

note: type: Plain text
en: In the master we write a function called <code>SendOrder</code> which will send an order to the slave:
fr: Dans le robot émetteur, il est plus simple d'écrire une procédure <code>SendOrder</code> qui se charge d'envoyer un ordre au robot récepteur. Il n'est pas nécessaire d'attendre, puisque tous les ordres sont stockés dans une liste:

note: type: Source code
en: {
    	exchange list();
    	order    todo();
    	
    	todo.m_type = order;
    	todo.m_param = param;
    	list.put(todo);
    }
fr: {
    	exchange list = new exchange();
    	order    todo();
    	
    	todo.global_type = order;
    	todo.global_param = param;
    	list.put(todo);
    }

note: type: Plain text
en: Now the main program of the master is very simple:
fr: Le programme principal est finalement d'une simplicité enfantine:

note: type: Plain text
en: <format key><key help/></format> show these instruction at any time.
fr: <format key><key help/></format> permet de revoir ces instructions en tout temps!

note: type: \t; header
en: See also
fr: Voir aussi

note: type: Plain text
en: <a command>Controls</a> and <a cbot>programming</a>.
fr: <a tremote4>Exercice précédent</a> et <a cbot>programmation</a>.
