colobot-data 0.1.7 - en to pt_PT translation catalogue (36 entries)

note: type: Title-text
en: Remote control #3
pt_PT: Controle remoto #3

note: type: Resume-text
en: Remote control a bot without using an information exchange post by using a string.
pt_PT: Controle remotamente um robô sem usar um posto de troca de informações, mas sim uma string.

note: type: ScriptName-text
en: Remote3
pt_PT: Remoto3

note: type: \b; header
en: Exercice
pt_PT: Exercício

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. You must use a <a cbot|string>string</a> to pass the orders to the slave bot. This string contains the order the slave shoud execute, for exemple <code>"move(20)"</code>. You can see that this is the same syntax as used in the CBOT language but we could have chosen any other syntax for exemple something like <code>"advance=20"</code>. The string will be a <code><a cbot|static>static</a></code> class member that will be used to communicate from the master to the slave.
pt_PT: Controle remotamente um robô escravo sem usar um <a object|exchange>posto de troca de informações</a>. O robô deve passar pelas 6 cruzes azuis. Você deve usar uma <a cbot|string>string</a> para passar as ordens para o robô escravo. Esta string contém a ordem que o escravo deve executar, por exemplo <code>"move (20)"</code>. Você pode ver que esta é a mesma sintaxe usada na linguagem CBOT, mas poderíamos ter escolhido qualquer outra sintaxe para exemplo algo como <code>"avance = 20" </ code>. A string será um membro de classe <code><a cbot|static>static</a></code> que será usada para se comunicar do mestre para o escravo.

note: type: Plain text
en: The two main actors of this exercise are:
pt_PT: Os dois principais atores deste exercício são:

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.
pt_PT: O <a object|botgr>agarrador com rodas</a> sem uma célula de energia e, portanto, imóvel. Este é o mestre que você deve programar para transmitir ordens ao escravo.

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.
pt_PT: O <a object|bottr>robô de prática</a> escravo que já está programado e apenas aguarda ordens do mestre.

note: type: \b; header
en: The slave
pt_PT: O escravo

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>exchange</code> contains the mechanism for exchaning the orders. We declare a <code><a cbot|static>static</a></code> class member <code>m_order</code> which will contain the order to be executed. The word <code>static</code> insures that the member <code>m_order</code> is shared between all instances of the <a cbot|class>class</a> exchange.
pt_PT: Primeiro de tudo, devemos entender como funciona o programa do escravo. A <a cbot|class>classe</a> <code>troca</code> contém o mecanismo de troca dos pedidos. Nós declaramos um <code>membro de classe <a cbot|static>estático</a></code> <code>m_ordem</code> que conterá a ordem a ser executada. A palavra <code>static</code> assegura que o membro <code>m_ordem</code> seja compartilhado entre todas as instâncias da classe <a cbot|class>troca</a>.

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

note: type: Source code
en: {
    	<a cbot|static>static</a> <a cbot|private>private</a> <a cbot|string>string</a> m_order = "";
pt_PT: {
    	<a cbot|static>static</a> <a cbot|private>private</a> <a cbot|string>string</a> m_ordem = "";

note: type: Plain text
en: <n/>The <code>put</code> method will be used by the master robot for transmitting an order. As long as the string <code>m_order</code> is not empty, the slave has not finished the order and the <code>put</code> method will return <code>false</code> and will do nothing.
pt_PT: <n/> O método <code>colocar</code> será usado pelo robô mestre para transmitir um pedido. Contanto que a string <code>m_ordem</code> não esteja vazia, o escravo não terminou a ordem e o método <code>colocar</ code> retornará <code>false</code> e não fará nada....

note: type: Plain text
en: <c/><s/>	<a cbot|synchro>synchronized</a> <a cbot|bool>bool</a> put(string order)
pt_PT: <c/><s/>	<a cbot|synchro>synchronized</a> <a cbot|bool>bool</a> colocar(string ordem)

note: type: Source code
en: 	{
    		if ( m_order == "" )
    		{
    			m_order = order;
    			return true;
    		}
    		else
    		{
    			return false;
    		}
    	}
pt_PT: 	{
    		if ( m_ordem == "" )
    		{
    			m_ordem = ordem;
    			return true;
    		}
    		else
    		{
    			return false;
    		}
    	}

note: type: Plain text
en: Another method <code>get</code> will be used by the slave to retrieve the orders. This method returns the string contained in <code>m_order</code> and empties it, so a new order can be accepted:
pt_PT: Outro método <code>pegar</code> será usado pelo escravo para recuperar as ordens. Este método retorna a string contida em <code>m_ordem</code> e a esvazia, então um novo pedido pode ser aceito:

note: type: Plain text
en: <c/><s/>	<a cbot|synchro>synchronized</a> string get()
pt_PT: <c/><s/>	<a cbot|synchro>synchronized</a> string pegar()

note: type: Source code
en: 	{
    		string ret = m_order;
    		m_order = "";
    		return ret;
    	}
    }
pt_PT: 	{
    		string retorno = m_ordem;
    		m_ordem = "";
    		return retorno;
    	}
    }

note: type: Plain text
en: The main program of the slave contains an instance of the class <code>exchange</code> called <code>list</code>.
pt_PT: O programa principal do escravo contém uma instância da classe <code>troca</code> chamada <code>lista</code>.

note: type: Plain text
en: <c/><s/><a cbot|extern>extern</a> void object::Slave3( )
pt_PT: <c/><s/><a cbot|extern>extern</a> void object::Escravo3( )

note: type: Source code
en: {
    	exchange list();
    	string   todo;
pt_PT: {
    	troca lista();
    	string   para_fazer;

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 non empty string, the while loop stops.
pt_PT: O laço externo <code>while</code> dura para sempre. O laço interno <code>while</code> espera por uma ordem usando o método <code>pegar</code> da classe <code>troca</code>. Assim que <code>pegar</code> retorna uma string não vazia, o laço while para.

note: type: Source code
en: 	{
    		<a cbot|while>while</a> ( true )
    		{
    			todo = list.get();
    			if ( todo != "" )  break;
    			wait(1);
    		}
pt_PT: 	{
    		<a cbot|while>while</a> ( true )
    		{
    			para_fazer = lista.pegar();
    			if ( para_fazer != "" )  break;
    			wait(1);
    		}

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:
pt_PT: Agora recebemos a ordem na variável <code>para_fazer</code>. Tudo o que temos a fazer é executá-la:

note: type: Plain text
en: <c/><s/>		if ( <a cbot|strfind>strfind</a>(todo, "move") == 0 )
pt_PT: <c/><s/>		if ( <a cbot|strfind>strfind</a>(para_fazer, "move") == 0 )

note: type: Source code
en: 		{
    			move(<a cbot|strval>strval</a>(<a cbot|strmid>strmid</a>(todo,5)));
    		}
    		if ( strfind(todo, "turn") == 0 )
    		{
    			turn(strval(strmid(todo,5)));
    		}
    	}
    }
pt_PT: 		{
    			move(<a cbot|strval>strval</a>(<a cbot|strmid>strmid</a>(para_fazer,5)));
    		}
    		if ( strfind(para_fazer, "turn") == 0 )
    		{
    			turn(strval(strmid(para_fazer,5)));
    		}
    	}
    }

note: type: \b; header
en: The master
pt_PT: O mestre

note: type: Plain text
en: In the master we write an function called <code>SendOrder</code> which will send an order to the slave:
pt_PT: No mestre nós escrevemos uma função chamada <code>EnviarOrdem</code> que irá enviar um pedido para o escravo:

note: type: Plain text
en: <c/><s/>void object::SendOrder(string order)
pt_PT: <c/><s/>void object::EnviarOrdem(string ordem)

note: type: Source code
en: {
    	exchange list();
    	
    	while ( list.put(order) == false )
    	{
    		wait(1);
    	}
    }
pt_PT: {
    	troca lista();
    	
    	while ( lista.colocar(ordem) == false )
    	{
    		wait(1);
    	}
    }

note: type: Plain text
en: The <code>while</code> loop waits until a pending order has been terminated, that is the slaved has exited from the <code>get</code> method.
    Now the main program of the master is very simple:
pt_PT: O laço <code>while</code> aguarda até que uma ordem pendente seja terminada, ou seja, o escravo saiu do método <code>pegar</code>. 
    Agora o programa principal do mestre é muito simples:

note: type: Plain text
en: <c/><s/>extern void object::Remote3( )
pt_PT: <c/><s/>extern void object::Remoto3( )

note: type: Source code
en: {
    	SendOrder("move(20)");
    	SendOrder("turn(90)");
    	SendOrder("move(20)");
    	SendOrder("turn(90)");
    	SendOrder("move(10)");
    	SendOrder("turn(90)");
    	SendOrder("move(10)");
    	SendOrder("turn(-90)");
    	SendOrder("move(10)");
    }
pt_PT: {
    	EnviarOrdem("move(20)");
    	EnviarOrdem("turn(90)");
    	EnviarOrdem("move(20)");
    	EnviarOrdem("turn(90)");
    	EnviarOrdem("move(10)");
    	EnviarOrdem("turn(90)");
    	EnviarOrdem("move(10)");
    	EnviarOrdem("turn(-90)");
    	EnviarOrdem("move(10)");
    }

note: type: Plain text
en: <format key><key help/></format> show these instruction at any time.
pt_PT: <format key><key help/></format> mostra essas instruções a qualquer momento.

note: type: \t; header
en: See also
pt_PT: Veja também

note: type: Plain text
en: <a command>Controls</a> and <a cbot>programming</a>.
pt_PT: <a command>Controles e <a cbot>Linguagem CBOT</a>
