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

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

note: type: Resume-text
en: Remote control a bot without using an information exchange post by storing the orders.
pt_PT: Controle remotamente um robô sem usar um posto de troca de informações armazenando os pedidos.

note: type: ScriptName-text
en: Remote5
pt_PT: Remoto5

note: type: \b; header
en: Exercise
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.
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.

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: 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.
pt_PT: As ordens devem ser armazenadas, para que o mestre possa transmitir várias ordens sem esperar que cada pedido seja processado. Usamos uma <a cbot|array>matriz</a> para essa finalidade.

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>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:
pt_PT: Primeiro de tudo, devemos entender como funciona o programa do escravo. A classe <a cbot|class>classe</a> <code>ordem</code> contém dois membros: <code>m_tipo</code> é a ordem para executar (mover ou girar) e <code>m_param</code > é a distância para se mover ou o ângulo de rotação:

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

note: type: Source code
en: {
    	<a cbot|int>int</a>    m_type;
    	<a cbot|float>float</a>  m_param;
    }
pt_PT: {
    	<a cbot|int>int</a>    m_tipo;
    	<a cbot|float>float</a>  m_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.
pt_PT: Uma segunda <a cbot|class>classe</a> <code>troca</ code> contém o mecanismo para trocar as ordens. Nós declaramos um membro de classe <code><a cbot|static>estático</a></code>  <code>m_fila</code> que conterá a lista de ordens a serem executadas. A palavra <code>static</code> assegura que o membro <code>m_fila</code> seja compartilhado entre todas as instâncias da classe <a cbot|class>troca</a>.

note: type: Source code
en: 	<a cbot|static>static</a> <a cbot|private>private</a> order m_fifo[] = null;
pt_PT: 	<a cbot|static>static</a> <a cbot|private>private</a> ordem m_fila[] = 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:
pt_PT: O método <code>colocar</code> será usado pelo robô mestre para transmitir um pedido. A ordem será simplesmente adicionada no final da matriz <code>m_fila</code>:

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

note: type: Source code
en: 	{
    		m_fifo[sizeof(m_fifo)] = a;
    	}
pt_PT: 	{
    		m_fila[sizeof(m_fila)] = 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>:
pt_PT: Outro método <code>pegar</code> será usado pelo escravo para recuperar as ordens. Este método retorna o pedido a ser executado. Se a lista estiver vazia, <code>null</code> será retornado e o robô deve esperar por mais pedidos. Caso contrário, o primeiro pedido na lista deve ser retornado e os pedidos restantes devem ser "rolados para cima". Como uma matriz não pode ser "encurtada", usamos uma matriz temporário <code>copia</code>:

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

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;
    	}
pt_PT: 	{
    		if ( sizeof(m_fila) == 0 )  return null;
    
    		ordem a = m_fila[0];
    		ordem copia[] = null;
    		for ( int i=1 ; i<sizeof(m_fila) ; i++ )
    		{
    			copia[i-1] = m_fila[i];
    		}
    		m_fila = copia;
    		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>.
pt_PT: O programa principal do escravo contém uma instância da classe <code>troca</code> chamada <code>lista</code>. Nós colocamos () depois da palavra <code>lista</code> para criar uma instância da classe <code>troca</code>.

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

note: type: Source code
en: {
    	exchange list();
    	order    todo;
pt_PT: {
    	troca lista();
    	ordem    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 value different from <code>null</code>, 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 um valor diferente de <code>null</code>, o laço while para	.

note: type: Source code
en: 	{
    		<a cbot|while>while</a> ( true )
    		{
    			todo = list.get();
    			if ( todo != null )  break;
    			wait(1);
    		}
pt_PT: 	{
    		<a cbot|while>while</a> ( true )
    		{
    			para_fazer = lista.pegar();
    			if ( para_fazer != null )  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 ( todo.m_type == 1 )
pt_PT: <c/><s/>		if ( para_fazer.m_tipo == 1 )

note: type: Source code
en: 		{
    			move(todo.m_param);
    		}
    		else if ( todo.m_type == 2 )
    		{
    			turn(todo.m_param);
    		}
    		else
    		{
    			message("Unknown order");
    		}
    	}
    }
pt_PT: 		{
    			move(para_fazer.m_param);
    		}
    		else if ( para_fazer.m_tipo == 2 )
    		{
    			turn(para_fazer.m_param);
    		}
    		else
    		{
    			message("Ordem desconhecida");
    		}
    	}
    }

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

note: type: Plain text
en: In the master we write a 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 uma ordem para o escravo:

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

note: type: Source code
en: {
    	exchange list();
    	order    todo();
    	
    	todo.m_type = order;
    	todo.m_param = param;
    	list.put(todo);
    }
pt_PT: {
    	troca lista();
    	ordem    para_fazer();
    	
    	para_fazer.m_tipo = ordem;
    	para_fazer.m_param = param;
    	lista.colocar(para_fazer);
    }

note: type: Plain text
en: Now the main program of the master is very simple:
pt_PT: Agora o programa principal do mestre é muito simples:

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

note: type: Source code
en: {
    	SendOrder(1, 20);  // move(20);
    	SendOrder(2, 90);  // turn(90);
    	SendOrder(1, 20);  // move(20);
    	SendOrder(2, 90);  // turn(90);
    	SendOrder(1, 10);  // move(10);
    	SendOrder(2, 90);  // turn(90);
    	SendOrder(1, 10);  // move(10);
    	SendOrder(2,-90);  // turn(-90);
    	SendOrder(1, 10);  // move(10);
    }
pt_PT: {
    	EnviarOrdem(1, 20);  // move(20);
    	EnviarOrdem(2, 90);  // turn(90);
    	EnviarOrdem(1, 20);  // move(20);
    	EnviarOrdem(2, 90);  // turn(90);
    	EnviarOrdem(1, 10);  // move(10);
    	EnviarOrdem(2, 90);  // turn(90);
    	EnviarOrdem(1, 10);  // move(10);
    	EnviarOrdem(2,-90);  // turn(-90);
    	EnviarOrdem(1, 10);  // 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>
