389 lines
13 KiB
Plaintext
389 lines
13 KiB
Plaintext
# Copyright (C) 2016 Free Software Foundation, Inc.
|
|
# This file is distributed under the same license as the PACKAGE package.
|
|
# José Robson Mariano Alves <jose.alves@ifto.edu.br>, 2018.
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: colobot-data 0.1.7\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: DATE\n"
|
|
"PO-Revision-Date: 2018-03-11 16:57+0100\n"
|
|
"Last-Translator: José Robson Mariano Alves <jose.alves@ifto.edu.br>\n"
|
|
"Language: pt_BR\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
|
|
"X-Generator: Lokalize 2.0\n"
|
|
|
|
#. type: Title-text
|
|
#: ../scene.txt:1
|
|
#, no-wrap
|
|
msgid "Remote control #5"
|
|
msgstr "Télécommande #5"
|
|
|
|
#. type: Resume-text
|
|
#: ../scene.txt:2
|
|
#, no-wrap
|
|
msgid "Remote control a bot without using an information exchange post by storing the orders."
|
|
msgstr "Télécommandez un robot en mémorisant tous les ordres."
|
|
|
|
#. type: ScriptName-text
|
|
#: ../scene.txt:3
|
|
#, no-wrap
|
|
msgid "Remote5"
|
|
msgstr "Remote5"
|
|
|
|
#. type: \b; header
|
|
#: ../help/help.E.txt:1
|
|
#, no-wrap
|
|
msgid "Exercise"
|
|
msgstr "Exercice"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:2
|
|
#, no-wrap
|
|
msgid "Remote control a slave robot without using an <a object|exchange>information exchange post</a>. The robot should pass over the 6 blue crosses. "
|
|
msgstr "Télécommandez un robot, sans utiliser une <a object|exchange>borne d'information</a>, pour qu'il passe par les 6 croix bleues."
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:4
|
|
#, no-wrap
|
|
msgid "The two main actors of this exercise are:"
|
|
msgstr "Les 2 acteurs principaux de cet exercice sont:"
|
|
|
|
#. type: Bullet: '1)'
|
|
#: ../help/help.E.txt:5
|
|
#, no-wrap
|
|
msgid "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."
|
|
msgstr "Un <a object|botgr>robot déménageur</a> sans pile, donc immobile. C'est lui l'émetteur que vous devez programmer."
|
|
|
|
#. type: Bullet: '2)'
|
|
#: ../help/help.E.txt:6
|
|
#, no-wrap
|
|
msgid "The slave <a object|bottr>practice bot</a> which is already programmed and just waits for orders from the master."
|
|
msgstr "Un <a object|bottr>robot d'entraînement</a> qui attend les ordres. Ce robot est déjà programmé."
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:8
|
|
#, no-wrap
|
|
msgid "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."
|
|
msgstr "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."
|
|
|
|
#. type: \b; header
|
|
#: ../help/help.E.txt:10
|
|
#, no-wrap
|
|
msgid "The slave"
|
|
msgstr "Le robot récepteur"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:11
|
|
#, no-wrap
|
|
msgid "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:"
|
|
msgstr ""
|
|
"Pour commencer, il faut comprendre le programme du robot d'entraînement qui attend les ordres.\n"
|
|
"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:"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:13
|
|
#, no-wrap
|
|
msgid "<c/><s/><a cbot|public>public</a> <a cbot|class>class</a> order"
|
|
msgstr "<c/><s/><a cbot|public>public</a> <a cbot|class>class</a> order"
|
|
|
|
#. type: Source code
|
|
#: ../help/help.E.txt:14
|
|
#, no-wrap
|
|
msgid ""
|
|
"{\n"
|
|
"\t<a cbot|int>int</a> m_type;\n"
|
|
"\t<a cbot|float>float</a> m_param;\n"
|
|
"}"
|
|
msgstr ""
|
|
"{\n"
|
|
"\t<a cbot|int>int</a> global_type;\n"
|
|
"\t<a cbot|float>float</a> global_param;\n"
|
|
"}"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:19
|
|
#, no-wrap
|
|
msgid "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."
|
|
msgstr "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."
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:21
|
|
#, no-wrap
|
|
msgid "<c/><s/>{"
|
|
msgstr "<c/><s/><a cbot|public>public</a> <a cbot|class>class</a> exchange"
|
|
|
|
#. type: Source code
|
|
#: ../help/help.E.txt:22
|
|
#, no-wrap
|
|
msgid "\t<a cbot|static>static</a> <a cbot|private>private</a> order m_fifo[] = null;"
|
|
msgstr ""
|
|
"{\n"
|
|
"\t<a cbot|static>static</a> <a cbot|private>private</a> order global_fifo[] = null;"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:24
|
|
#, no-wrap
|
|
msgid "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:"
|
|
msgstr "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:"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:26
|
|
#, no-wrap
|
|
msgid "<c/><s/>\t<a cbot|synchro>synchronized</a> void put(order a)"
|
|
msgstr "<c/><s/>\t<a cbot|synchro>synchronized</a> void put(order a)"
|
|
|
|
#. type: Source code
|
|
#: ../help/help.E.txt:27
|
|
#, no-wrap
|
|
msgid ""
|
|
"\t{\n"
|
|
"\t\tm_fifo[sizeof(m_fifo)] = a;\n"
|
|
"\t}"
|
|
msgstr ""
|
|
"\t{\n"
|
|
"\t\tglobal_fifo[sizeof(global_fifo)] = a;\n"
|
|
"\t}"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:31
|
|
#, no-wrap
|
|
msgid "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>:"
|
|
msgstr "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:"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:33
|
|
#, no-wrap
|
|
msgid "<c/><s/>\t<a cbot|synchro>synchronized</a> order get()"
|
|
msgstr "<c/><s/>\t<a cbot|synchro>synchronized</a> order get()"
|
|
|
|
#. type: Source code
|
|
#: ../help/help.E.txt:34
|
|
#, no-wrap
|
|
msgid ""
|
|
"\t{\n"
|
|
"\t\tif ( sizeof(m_fifo) == 0 ) return null;\n"
|
|
"\n"
|
|
"\t\torder a = m_fifo[0];\n"
|
|
"\t\torder copy[] = null;\n"
|
|
"\t\tfor ( int i=1 ; i<sizeof(m_fifo) ; i++ )\n"
|
|
"\t\t{\n"
|
|
"\t\t\tcopy[i-1] = m_fifo[i];\n"
|
|
"\t\t}\n"
|
|
"\t\tm_fifo = copy;\n"
|
|
"\t\treturn a;\n"
|
|
"\t}"
|
|
msgstr ""
|
|
"\t{\n"
|
|
"\t\tif ( sizeof(global_fifo) == 0 ) return null;\n"
|
|
"\n"
|
|
"\t\torder a = global_fifo[0];\n"
|
|
"\t\torder copy[] = null;\n"
|
|
"\t\tfor ( int i=1 ; i<sizeof(global_fifo) ; i++ )\n"
|
|
"\t\t{\n"
|
|
"\t\t\tcopy[i-1] = global_fifo[i];\n"
|
|
"\t\t}\n"
|
|
"\t\tglobal_fifo = copy;\n"
|
|
"\t\treturn a;\n"
|
|
"\t}"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:47
|
|
#, no-wrap
|
|
msgid "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>."
|
|
msgstr "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."
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:49
|
|
#, no-wrap
|
|
msgid "<c/><s/><a cbot|extern>extern</a> void object::Slave5( )"
|
|
msgstr "<c/><s/><a cbot|extern>extern</a> void object::Slave5( )"
|
|
|
|
#. type: Source code
|
|
#: ../help/help.E.txt:50
|
|
#, no-wrap
|
|
msgid ""
|
|
"{\n"
|
|
"\texchange list();\n"
|
|
"\torder todo;"
|
|
msgstr ""
|
|
"{\n"
|
|
"\texchange list = new exchange();\n"
|
|
"\torder todo;"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:54
|
|
#, no-wrap
|
|
msgid "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."
|
|
msgstr "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."
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:56
|
|
#, no-wrap
|
|
msgid "<c/><s/>\t<a cbot|while>while</a> ( true )"
|
|
msgstr "<c/><s/>\t<a cbot|while>while</a> ( true )"
|
|
|
|
#. type: Source code
|
|
#: ../help/help.E.txt:57
|
|
#, no-wrap
|
|
msgid ""
|
|
"\t{\n"
|
|
"\t\t<a cbot|while>while</a> ( true )\n"
|
|
"\t\t{\n"
|
|
"\t\t\ttodo = list.get();\n"
|
|
"\t\t\tif ( todo != null ) break;\n"
|
|
"\t\t\twait(1);\n"
|
|
"\t\t}"
|
|
msgstr ""
|
|
"\t{\n"
|
|
"\t\t<a cbot|while>while</a> ( true )\n"
|
|
"\t\t{\n"
|
|
"\t\t\ttodo = list.get();\n"
|
|
"\t\t\tif ( todo != null ) break;\n"
|
|
"\t\t\twait(1);\n"
|
|
"\t\t}"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:65
|
|
#, no-wrap
|
|
msgid "Now we have received the order in the <code>todo</code> variable. All we have to do is execute it:"
|
|
msgstr "Il ne reste plus qu'à exécuter l'ordre reçu:"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:67
|
|
#, no-wrap
|
|
msgid "<c/><s/>\t\tif ( todo.m_type == 1 )"
|
|
msgstr "<c/><s/>\t\tif ( todo.global_type == 1 )"
|
|
|
|
#. type: Source code
|
|
#: ../help/help.E.txt:68
|
|
#, no-wrap
|
|
msgid ""
|
|
"\t\t{\n"
|
|
"\t\t\tmove(todo.m_param);\n"
|
|
"\t\t}\n"
|
|
"\t\telse if ( todo.m_type == 2 )\n"
|
|
"\t\t{\n"
|
|
"\t\t\tturn(todo.m_param);\n"
|
|
"\t\t}\n"
|
|
"\t\telse\n"
|
|
"\t\t{\n"
|
|
"\t\t\tmessage(\"Unknown order\");\n"
|
|
"\t\t}\n"
|
|
"\t}\n"
|
|
"}"
|
|
msgstr ""
|
|
"\t\t{\n"
|
|
"\t\t\tmove(todo.global_param);\n"
|
|
"\t\t}\n"
|
|
"\t\telse if ( todo.global_type == 2 )\n"
|
|
"\t\t{\n"
|
|
"\t\t\tturn(todo.global_param);\n"
|
|
"\t\t}\n"
|
|
"\t\telse\n"
|
|
"\t\t{\n"
|
|
"\t\t\tmessage(\"Unknown order\");\n"
|
|
"\t\t}\n"
|
|
"\t}\n"
|
|
"}"
|
|
|
|
#. type: \b; header
|
|
#: ../help/help.E.txt:82
|
|
#, no-wrap
|
|
msgid "The master"
|
|
msgstr "Le robot émetteur"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:83
|
|
#, no-wrap
|
|
msgid "In the master we write a function called <code>SendOrder</code> which will send an order to the slave:"
|
|
msgstr "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:"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:85
|
|
#, no-wrap
|
|
msgid "<c/><s/>void object::SendOrder(float order, float param)"
|
|
msgstr "<c/><s/>void object::SendOrder(float order, float param)"
|
|
|
|
#. type: Source code
|
|
#: ../help/help.E.txt:86
|
|
#, no-wrap
|
|
msgid ""
|
|
"{\n"
|
|
"\texchange list();\n"
|
|
"\torder todo();\n"
|
|
"\t\n"
|
|
"\ttodo.m_type = order;\n"
|
|
"\ttodo.m_param = param;\n"
|
|
"\tlist.put(todo);\n"
|
|
"}"
|
|
msgstr ""
|
|
"{\n"
|
|
"\texchange list = new exchange();\n"
|
|
"\torder todo();\n"
|
|
"\t\n"
|
|
"\ttodo.global_type = order;\n"
|
|
"\ttodo.global_param = param;\n"
|
|
"\tlist.put(todo);\n"
|
|
"}"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:95
|
|
#, no-wrap
|
|
msgid "Now the main program of the master is very simple:"
|
|
msgstr "Le programme principal est finalement d'une simplicité enfantine:"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:97
|
|
#, no-wrap
|
|
msgid "<c/><s/>extern void object::Remote5( )"
|
|
msgstr "<c/><s/>extern void object::Remote5( )"
|
|
|
|
#. type: Source code
|
|
#: ../help/help.E.txt:98
|
|
#, no-wrap
|
|
msgid ""
|
|
"{\n"
|
|
"\tSendOrder(1, 20); // move(20);\n"
|
|
"\tSendOrder(2, 90); // turn(90);\n"
|
|
"\tSendOrder(1, 20); // move(20);\n"
|
|
"\tSendOrder(2, 90); // turn(90);\n"
|
|
"\tSendOrder(1, 10); // move(10);\n"
|
|
"\tSendOrder(2, 90); // turn(90);\n"
|
|
"\tSendOrder(1, 10); // move(10);\n"
|
|
"\tSendOrder(2,-90); // turn(-90);\n"
|
|
"\tSendOrder(1, 10); // move(10);\n"
|
|
"}"
|
|
msgstr ""
|
|
"{\n"
|
|
"\tSendOrder(1, 20); // move(20);\n"
|
|
"\tSendOrder(2, 90); // turn(90);\n"
|
|
"\tSendOrder(1, 20); // move(20);\n"
|
|
"\tSendOrder(2, 90); // turn(90);\n"
|
|
"\tSendOrder(1, 10); // move(10);\n"
|
|
"\tSendOrder(2, 90); // turn(90);\n"
|
|
"\tSendOrder(1, 10); // move(10);\n"
|
|
"\tSendOrder(2,-90); // turn(-90);\n"
|
|
"\tSendOrder(1, 10); // move(10);\n"
|
|
"}"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:110
|
|
#, no-wrap
|
|
msgid "<format key><key help/></format> show these instruction at any time."
|
|
msgstr "<format key><key help/></format> permet de revoir ces instructions en tout temps!"
|
|
|
|
#. type: \t; header
|
|
#: ../help/help.E.txt:112
|
|
#, no-wrap
|
|
msgid "See also"
|
|
msgstr "Voir aussi"
|
|
|
|
#. type: Plain text
|
|
#: ../help/help.E.txt:113
|
|
#, no-wrap
|
|
msgid "<a command>Controls</a> and <a cbot>programming</a>."
|
|
msgstr "<a tremote4>Exercice précédent</a> et <a cbot>programmation</a>."
|