Translated the mask chapter

Thiago Franco de Moraes
1 parent 4a286457
Showing 2 changed files with 67 additions and 64 deletions Show diff stats
docs/user_guide_en_source/cap_masc.tex
docs/user_guide_pt_BR_source/cap_masc.tex
@@ -3,185 +3,188 @@
 \section{Boolean operations}
-Após efetuar segmentações, é possível realizar operações booleanas entre as máscaras. As operações booleanas suportadas são:\
+After segmenting it's possible to perform some boolean operations between masks. The boolean operations supported by InVesalius are:\
 \\
-\textbf{União}, realiza a união de duas máscaras;\\
-\textbf{Diferença}, realiza a diferença entre a primeira máscara com a segunda;\\
-\textbf{Intersecção}, para apagar marcadores de objeto ou fundo.\\
-\textbf{Disjunção exclusiva}, também é conhecida como XOR, mantém as regiões de ambas as máscara que possuem diferença.\\
+\textbf{Union}, perform union between two masks;\\
+\textbf{Difference}, perform difference from the first mask to the second one;\\
+\textbf{Intersection}, keeps what is common in both masks.\\
+\textbf{Exclusive disjunction}, also known as XOR, keeps the regions of the first mask wich are not in the second mask and regions from the second mask which are no in the first mask.\\
-Para ativar essa ferramenta é necessário ir no menu \textbf{Ferramentas}, \textbf{Operações boolenas}, como é exibido na figura~\ref{fig:booleano_menu} 
+To use this tool go to menu \textbf{Tools}, \textbf{Mask}, \textbf{Boolean operations} as shown in the figure~\ref{fig:booleano_menu}.
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.5]{mask_operation_boolean_menu_pt.png}
-\caption{Menu para ativar a ferramenta de operações booleanas.}
+\caption{Menu to open boolean operations tool.}
 \label{fig:booleano_menu}
 \end{figure}
-É necessário selecionar a primeira máscara, a operação a ser realizada e a segunda máscara conforme mostra a figura~\ref{fig:booleano_janela}. Em seguida é necessário clicar no botão \textbf{Ok}.
+It's necessary to select the select the first mask, the operation to be performed and the second mask as shown in the figure~\ref{fig:booleano_janela}. Then click on the \textbf{Ok} button.
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.5]{mask_boolean_dialog_pt.png}
-\caption{Ferramenta de operações booleanas.}
+\caption{Boolean operations tool.}
 \label{fig:booleano_janela}
 \end{figure}
-Na figura~\ref{fig:op_boolana}, apresentamos um exemplo de utilização da ferramenta.
+The figure~\ref{fig:op_boolana} shows some examples of utilization of boolean operations tool.
 \begin{figure}[!htb]
   \centering
-  \subfloat[Máscara A]{\includegraphics[width=0.332\textwidth]{booleano_m_a.png}}                
+  \subfloat[Mask A]{\includegraphics[width=0.332\textwidth]{booleano_m_a.png}}
   \hfill
-  \subfloat[Máscara B]{\includegraphics[width=0.332\textwidth]{booleano_m_b.png}}	
-  \hfill  
-  \subfloat[União (A $\cup$ B)]{\includegraphics[width=0.332\textwidth]{booleano_uniao.png}}
-  \hfill  
-  \subfloat[Diferença (A - B)]{\includegraphics[width=0.332\textwidth]{booleano_dif.png}}
-  \hfill  
-  \subfloat[Intersecção (A $\cap$ B)]{\includegraphics[width=0.332\textwidth]{booleano_interc.png}}
-  \hfill  
-  \subfloat[Disjunção exclusiva (A $\oplus$ B)]{\includegraphics[width=0.332\textwidth]{booleano_disj_exc.png}}
-  \caption{Exemplo de operações booleanas.}
+  \subfloat[Mask B]{\includegraphics[width=0.332\textwidth]{booleano_m_b.png}}
+  \hfill
+  \subfloat[Union (A $\cup$ B)]{\includegraphics[width=0.332\textwidth]{booleano_uniao.png}}
+  \hfill
+  \subfloat[Difference (A - B)]{\includegraphics[width=0.332\textwidth]{booleano_dif.png}}
+  \hfill
+  \subfloat[Intersection (A $\cap$ B)]{\includegraphics[width=0.332\textwidth]{booleano_interc.png}}
+  \hfill
+  \subfloat[Exclusive disjunction (A $\oplus$ B)]{\includegraphics[width=0.332\textwidth]{booleano_disj_exc.png}}
+  \caption{example of boolean operations.}
   \label{fig:op_boolana}
 \end{figure}
-\section{Limpeza total da máscara}
+\section{Mask cleaning}
 \label{cap:limpeza_mascara}
-Pode-se efetuar a limpeza total da máscara (figura~\ref{fig:limpeza_mascara}), isso é recomendado antes de iniciar a inserção de marcadores de Watershed. A ferramenta está localizada no menu, \textbf{Ferramentas}, \textbf{Máscara}, \textbf{Limpar máscara}, também é possível executa-la pressionando as teclas \textbf{CTRL+SHIFT+A}.
+It's possible to clean a mask (figure~\ref{fig:limpeza_mascara}). This is recommended before starting to insert Watershed markers. This tool is located on menu \textbf{Tools}, \textbf{Mask}, \textbf{Clean mask}. Also, it possible to use keyboard shortcut \textbf{CTRL+SHIFT+A}.
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.5]{mask_clean_menu_pt.png}
-\caption{Limpeza de máscara}
+\caption{Mask cleaning}
 \label{fig:limpeza_mascara}
 \end{figure}
-\section{Fechar buracos manualmente}
+\section{Fill holes manually}
-Ao realizar a segmentação é possível que pequenas partes (buracos) que deseja-se ser selecionadas não sejam e ao gerar a superfície para a impressão 3D pode ser que ocorra inconsistências por causa desses buracos, para evitar esse tipo de problema é recomendável preenche-los. Para isso é basta acessar o menu \textbf{Ferramentas}, \textbf{Máscara} e por último clicar em \textbf{Fechar buracos manualmente} (figura~\ref{fig:menu_mask_manual_fill_holes}). Em seguida será exibido uma tela (figura~\ref{fig:mask_manual_fill_holes_window}) para configurar os parâmetros.
+Segmentation may leave some unwanted holes. It's recommended to fill them because the surface generated from this mask may have some inconsistencies. To do this access the menu \textbf{Tools}, \textbf{Mask}, \textbf{Fill holes manually} (figure~\ref{fig:menu_mask_manual_fill_holes}). A dialog window will be shown (figure~\ref{fig:mask_manual_fill_holes_window}) to configure the parameters.
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.4]{menu_mask_manual_fill_holes_pt.png}
-\caption{Menu para acessa a ferramenta de fechamento de buracos manual.}
+\caption{Menu to access the tool to fill holes manually.}
 \label{fig:menu_mask_manual_fill_holes}
 \end{figure}
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.7]{mask_manual_fill_holes_window_pt.png}
-\caption{Tela para configurar parâmetros de fechamento de buracos.}
+\caption{Dialog to configure the parameters of Fill holes manually tool.}
 \label{fig:mask_manual_fill_holes_window}
 \end{figure}
-Entre os parâmetros existe a opção de realizar o fechamento de buraco levando em consideração somente a fatia atual (\textbf{2D - Fatia Atual}) ou todas as fatias (\textbf{3D - Todas as fatias}) e suas respectivas conectividades, no caso 2D, conectividade $4$ ou $8$, conectividade $6$,$18$ ou $26$. No caso 3D se houver conectividade no buraco em diferentes fatias ele irá expandir para as demais fatias.
+It's possible to fill hole on a mask slice (\textbf{2D - Actual slice}) or on all slices, selecting the option \textbf{3D - All slices}. It's also possible to configure the connectivity used. It may be $4$ or $8$ to 2D and $6$, $18$ and $26$ to 3D.
-Quando os parâmetros estiverem configurados, clique com o \textbf{botão esquerdo} do mouse sobre o buraco que deseja-se fechar.
+After configuring the desired parameters click with the \textbf{left-button} of the mouse on holes to fill them.
-Podemos observar na imagem~\ref{fig:mask_fill_hole}.a, um exemplo de uma máscara sem preenchimento de buracos e outra com os buracos preenchidos (imagem~\ref{fig:mask_fill_hole}.b). Após o uso da ferramenta, para sair clique no botão \textbf{fechar ou close} no canto inferior direito da janela de configuração de parâmetros.
+The figure~\ref{fig:mask_fill_hole}.a shows mask with some holes and other mask with the holes filled (figure~\ref{fig:mask_fill_hole}.b). Click on the \textbf{close} button or close the dialog to deactivate this tool.
 \begin{figure}[!htb]
   \centering
-  \subfloat[Buracos]{\includegraphics[width=0.4\textwidth]{mask_axial_with_hole.png}}  \qquad
-  \subfloat[Buracos fechados]{\includegraphics[width=0.4\textwidth]{mask_axial_filled_hole.png}}
+  \subfloat[Holes]{\includegraphics[width=0.4\textwidth]{mask_axial_with_hole.png}}  \qquad
+  \subfloat[Holes filled]{\includegraphics[width=0.4\textwidth]{mask_axial_filled_hole.png}}
   \hfill
-  \caption{Exemplo de máscara com buracos e buracos preenchidos.}
+  \caption{Example of mask with holes filled.}
   \label{fig:mask_fill_hole}
 \end{figure}
-\section{Fechar buracos automaticamente}
+\section{Fill holes automatically}
-Para abrir a ferramenta, no menu do InVesalius clique em \textbf{Ferramentas}, \textbf{Máscara} e por fim \textbf{Fechar buracos automaticamente} (figura~\ref{fig:menu_mask_automatic_fill_holes}), será aberto uma janela para configurar os parâmetros dos buracos que deseja-se fechar. A ferramenta não requer que o usuário clique nos buracos que deseja fechar, ela leva em consideração o tamanho do buraco em voxels que é configurado na janela de configuração de parâmetros (figura~\ref{fig:mask_automatic_fill_holes_window})
+To open this tool go to the menu \textbf{Tools}, \textbf{Mask}, \textbf{Fill holes automatically} (figure~\ref{fig:menu_mask_automatic_fill_holes}). It'll open a dialog to configure the parameters. This tool doesn't require the user to click on holes he desire to fill. This tool will fill the holes based on the \textbf{max hole size parameter} given in number of voxels (figure~\ref{fig:mask_automatic_fill_holes_window}).
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.4]{menu_mask_automatic_fill_holes_pt.png}
-\caption{Menu para acessar a ferramenta de fechamento de buracos automático.}
+\caption{Menu to open the Fill holes automatically tool.}
 \label{fig:menu_mask_automatic_fill_holes}
 \end{figure}
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.7]{mask_automatic_fill_holes_window_pt.png}
-\caption{Tela para configurar parâmetros de fechamento de buracos.}
+\caption{Dialog to configure the parameters used to fill the holes.}
 \label{fig:mask_automatic_fill_holes_window}
 \end{figure}
-Entre os parâmetros existe a opção de realizar o fechamento de buraco levando em consideração somente a fatia atual (\textbf{2D - Fatia Atual}) ou todas as fatias (\textbf{3D - Todas as fatias}) e suas respectivas conectividades, no caso 2D, conectividade $4$ ou $8$, conectividade $6$,$18$ ou $26$. No caso 2D é necessário indicar qual a janela será aplicado o fechamento de buracos, sendo axial, coronal ou sagital. No caso 3D se houver conectividade no buraco em diferentes fatias ele irá expandir para as demais fatias. 
+It's possible to fill hole on a mask slice (\textbf{2D - Actual slice}) or on all slices, selecting the option \textbf{3D - All slices}. It's also possible to configure the connectivity used. It may be $4$ or $8$ to 2D and $6$, $18$ and $26$ to 3D. In 2D case it's needed to indicate in which orientation window the holes will be filled.
+
+After setting the parameters click in \textbf{Apply} button. If the result is not suitable set other hole size value or try other connectivity. Click on \textbf{Close} button to close this tool.
-Com os parâmetros configurados, clique no botão \textbf{Aplicar ou Apply}, caso o resultado não seja satisfatório, reconfigure o tamanho do buraco ou outros parâmetros como conectividade e aplique novamente. Para sair clique no botão \textbf{Sair ou Close}.
+\section{Remove parts}
-\section{Remover partes}
+After generating a surface is recommended to remove the unwanted disconnected parts from mask. In this way the surface generation will use less RAM and the process will be quicker.  To remove the unwanted parts go the menu  \textbf{Tools}, \textbf{Mask} e \textbf{Remove Parts} (figure~\ref{fig:menu_mask_remove_part}). A dialog will be shown to configure the parameters of selection (figure~\ref{fig:mask_remove_parts_window}).
-Antes de gerar a superfície é recomendável remover as partes desconexas não desejadas na máscara, dessa forma ao gerar a superfície será utilizada menores quantidades de memória RAM e o processo será mais rápido. Para remover as partes não desejáveis é necessário abrir a ferramenta de remover partes, clicando no menu \textbf{Ferramentas}, \textbf{Máscara} e \textbf{Remover Partes} (figura~\ref{fig:menu_mask_remove_part}). Em seguida irá ser exibido uma janela para configurar os parâmetros de seleção (figura~\ref{fig:mask_remove_parts_window}). É possível selecionar partes desconectas apenas na máscara 2D (\textbf{2D - Fatia atual}) ou em todo o conjunto de imagens, selecionando a opção \textbf{3D - Todas as fatias}. Também é possível selecionar suas respectivas conectividades, no caso 2D, conectividade $4$ ou $8$, conectividade $6$,$18$ ou $26$.
+It's possible to select disconnected part only on a mask slice (\textbf{2D - Actual slice}) or on all slices, selecting the option \textbf{3D - All slices}. It's also possible to configure the connectivity used. It may be $4$ or $8$ to 2D and $6$, $18$ and $26$ to 3D.
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.4]{menu_mask_remove_part_pt.png}
-\caption{Menu para acessar a ferramenta de remoção de partes.}
+\caption{Menu to open the Remove parts tool.}
 \label{fig:menu_mask_remove_part}
 \end{figure}
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.7]{mask_remove_parts_window.png}
-\caption{Tela para configurar parâmetros de remoção de partes.}
+\caption{Dialog to configure the parameters used in Remove parts.}
 \label{fig:mask_remove_parts_window}
 \end{figure}
-Selecionado os parâmetros desejados, basta clicar com o \textbf{botão direito do mouse} sobre a região que deseja remover. A figura~\ref{fig:mask_removed_part} apresenta uma exemplo de parte removida e não removida. Para sair da ferramenta clique no botão \textbf{Sair ou Close}.
+After selecting the desired parameters click with the \textbf{left-button} of the mouse on the region you want to remove. The figure~\ref{fig:mask_removed_part} an example of mask before and after remove a disconnected part. Click on \textbf{Close} button to close this tool.
 \begin{figure}[!htb]
   \centering
-  \subfloat[Imagem de entrada]{\includegraphics[width=0.45\textwidth]{mask_axial_complete.png}}  \qquad
-  \subfloat[Imagem com suporte do tomografo removido]{\includegraphics[width=0.45\textwidth]{mask_axial_selected_part.png}}
+  \subfloat[Input image]{\includegraphics[width=0.45\textwidth]{mask_axial_complete.png}}  \qquad
+  \subfloat[Remove the tomograph support]{\includegraphics[width=0.45\textwidth]{mask_axial_selected_part.png}}
   \hfill
-  \caption{Exemplo de região removida na máscara.}
+  \caption{Example of region remove from a mask.}
   \label{fig:mask_removed_part}
 \end{figure}
-\section{Selecionar partes}
+\section{Select parts}
+
+To open Select parts tool go to menu \textbf{Tools}, \textbf{Mask}, \textbf{Select parts} (figure~\ref{fig:menu_mask_select_part}). A dialog will be shown to configure the parameters which are the name of the new mask and the connectivity ($6$, $18$ or $26$).
-Para abrir a ferramenta de seleção de partes desconexas é necessário ir ao menu, \textbf{Ferramentas}, \textbf{Máscara} e por fim \textbf{Selecionar Partes} (figura~\ref{fig:menu_mask_select_part}). A ferramenta irá apresentar uma tela de configuração de parâmetros que consiste em qual conectividade será levada em consideração (figura~\ref{fig:mask_select_part}), podendo ser $6$, $18$ ou $26$ e o nome da nova máscara que irá ter a imagem resultante.
+Click with \textbf{left-button} of the mouse on the wanted pixel of the region you want to select. It's possible to select more than one region. The selected region(s) will be shown with a red mask. After selecting all the wanted regions click on the \textbf{Ok} button to create a new mask with regions selected. The figure~\ref{fig:mask_selected_part}.a shows a region selected in red color. The figure~\ref{fig:mask_selected_part}.b shows the selected region in a new mask.
-Todas as imagens a região que tem conectividade com o pixel selecionado. Para selecionar o pixel, é necessário clicar com o \textbf{botão esquerdo do mouse} em sobre o pixel desejado, o objeto irá ficar da cor vermelha, é possível selecionar vários objetos. Após a seleção é necessário clicar no \textbf{botão Ok}. A figura~\ref{fig:mask_selected_part}.a apresenta um objeto selecionado na cor vermelha e a figura~\ref{fig:mask_selected_part}.b  somente o objeto após ter fechado a ferramenta (\textbf{botão Ok}).
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.4]{menu_mask_select_part_pt.png}
-\caption{Menu para acessar a ferramenta de seleção de partes.}
+\caption{Menu to open the Select parts tool.}
 \label{fig:menu_mask_select_part}
 \end{figure}
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.7]{mask_select_part_pt.png}
-\caption{Tela para configurar parâmetros de seleção de partes.}
+\caption{Dialog to configure the parameters of Select parts tool.}
 \label{fig:mask_select_part}
 \end{figure}
 \begin{figure}[!htb]
   \centering
-  \subfloat[Região selecionada em vermelho]{\includegraphics[width=0.45\textwidth]{mask_axial_select_part_pt.png}}  \qquad
-  \subfloat[Imagem final, somente com a região selecionada]{\includegraphics[width=0.45\textwidth]{mask_axial_selected_part_pt.png}}
+  \subfloat[Region selected in red]{\includegraphics[width=0.45\textwidth]{mask_axial_select_part_pt.png}}  \qquad
+  \subfloat[Final image with only the selected region]{\includegraphics[width=0.45\textwidth]{mask_axial_selected_part_pt.png}}
   \hfill
-  \caption{Exemplo de região selecionada na máscara.}
+  \caption{Example of mask region selection.}
   \label{fig:mask_selected_part}
 \end{figure}
-\section{Cortar}
+\section{Crop}
-É possível cortar parte da máscara afim de selecionar uma região de interesse, isso pode ajudar reduzindo a quantidade de informações a ser processadas ao gerar superfície. Para abrir a ferramenta é necessário ir no menu \textbf{Ferramentas}, \textbf{Máscara} e por último \textbf{Cortar} (figura~\ref{fig:menu_mask_crop}).
+It's possible to cut part of a mask in order to select an region of interest. This may reduce the amount of information to processed when generating a surface. To open this tool go to the menu \textbf{Tool}, \textbf{Mask}, \textbf{Crop} (figure~\ref{fig:menu_mask_crop}).
 \begin{figure}[!htb]
 \centering
 \includegraphics[scale=0.4]{menu_mask_crop_pt.png}
-\caption{Menu para acessar a ferramenta de corte.}
+\caption{Menu open the Crop tool.}
 \label{fig:menu_mask_crop}
 \end{figure}
-Será exibida uma caixa delimitadora em cada janela das orientações axial, coronal e sagital.
+It will be shown a bounding boxes in each orientation window.
@@ -10,7 +10,7 @@ Após efetuar segmentações, é possível realizar operações booleanas entre 
 \textbf{Intersecção}, para apagar marcadores de objeto ou fundo.\\
 \textbf{Disjunção exclusiva}, também é conhecida como XOR, mantém as regiões de ambas as máscara que possuem diferença.\\
-Para ativar essa ferramenta é necessário ir no menu \textbf{Ferramentas}, \textbf{Operações boolenas}, como é exibido na figura~\ref{fig:booleano_menu} 
+Para ativar essa ferramenta é necessário ir no menu \textbf{Ferramentas}, \textbf{Máscara}, \textbf{Operações boolenas}, como é exibido na figura~\ref{fig:booleano_menu} 
 \begin{figure}[!htb]
 \centering
@@ -50,7 +50,7 @@ Na figura~\ref{fig:op_boolana}, apresentamos um exemplo de utilização da ferra
 \section{Limpeza total da máscara}
 \label{cap:limpeza_mascara}
-Pode-se efetuar a limpeza total da máscara (figura~\ref{fig:limpeza_mascara}), isso é recomendado antes de iniciar a inserção de marcadores de Watershed. A ferramenta está localizada no menu, \textbf{Ferramentas}, \textbf{Máscara}, \textbf{Limpar máscara}, também é possível executa-la pressionando as teclas \textbf{CTRL+SHIFT+A}.
+Pode-se efetuar a limpeza total da máscara (figura~\ref{fig:limpeza_mascara}). Isso é recomendado antes de iniciar a inserção de marcadores de Watershed. A ferramenta está localizada no menu \textbf{Ferramentas}, \textbf{Máscara}, \textbf{Limpar máscara}. Também é possível executa-la pressionando as teclas \textbf{CTRL+SHIFT+A}.
 \begin{figure}[!htb]
 \centering
@@ -133,7 +133,7 @@ Antes de gerar a superfície é recomendável remover as partes desconexas não 
 \label{fig:mask_remove_parts_window}
 \end{figure}
-Selecionado os parâmetros desejados, basta clicar com o \textbf{botão direito do mouse} sobre a região que deseja remover. A figura~\ref{fig:mask_removed_part} apresenta uma exemplo de parte removida e não removida. Para sair da ferramenta clique no botão \textbf{Sair ou Close}.
+Selecionado os parâmetros desejados, basta clicar com o \textbf{botão esquerdo do mouse} sobre a região que deseja remover. A figura~\ref{fig:mask_removed_part} apresenta uma exemplo de parte removida e não removida. Para sair da ferramenta clique no botão \textbf{Sair ou Close}.
 \begin{figure}[!htb]
   \centering
@@ -184,4 +184,4 @@ Todas as imagens a região que tem conectividade com o pixel selecionado. Para s
 \label{fig:menu_mask_crop}
 \end{figure}
-Será exibida uma caixa delimitadora em cada janela das orientações axial, coronal e sagital.
 \ No newline at end of file
+Será exibida uma caixa delimitadora em cada janela das orientações axial, coronal e sagital.