Terminal - Histórico de revisão

Rodrigogml: /* Entradas de Valores (Inputs) */

2024-09-08T17:44:29Z

Entradas de Valores (Inputs)

← Edição anterior		Edição das 17h44min de 8 de setembro de 2024
Linha 198:		Linha 198:

	= Entradas de Valores (Inputs) =		= Entradas de Valores (Inputs) =

			== Captura Direta de Entrada ==

			A captura direta de entrada no terminal pode ser realizada de forma simples e eficiente utilizando o '''System.console()'''. Essa abordagem é ideal para aplicações que interagem com o usuário diretamente no terminal ou prompt de comando, onde a entrada de dados pode ser capturada como texto ou senha, garantindo flexibilidade e segurança.

			Abaixo estão os métodos disponíveis para captura de entrada direta:

			<syntaxhighlight lang="java">
			String userInput = null;

			userInput = Terminal.readLine(); // Captura uma linha de texto

			userInput = Terminal.readLine("Digite seu nome: "); // Captura uma linha de texto com prompt

			userInput = Terminal.readPassword(); // Captura uma senha sem exibir os caracteres

			userInput = Terminal.readPassword("Digite sua senha: "); // Captura uma senha com um prompt personalizado
			</syntaxhighlight>

			Esses métodos utilizam diretamente o '''System.console()''', garantindo que a entrada seja feita de forma segura e controlada. Os métodos '''readLine()''' permitem a captura de texto livre, enquanto os métodos '''readPassword()''' são ideais para capturar senhas, sem exibir os caracteres digitados. Lembre-se de que '''System.console()''' pode retornar '''null''' quando a aplicação é executada em alguns ambientes, como IDEs. Portanto, recomenda-se utilizar o terminal ou prompt de comando para garantir a funcionalidade correta.

Rodrigogml em 16h16min de 8 de setembro de 2024

2024-09-08T16:16:51Z

← Edição anterior		Edição das 16h16min de 8 de setembro de 2024
Linha 1:		Linha 1:
	A classe <code>Terminal</code> do projeto <code>RFW.Terminal</code> fornece uma interface abrangente para o controle do terminal em aplicações de linha de comando, permitindo manipulação avançada de '''formatação''', '''controle de cursor''', '''manipulação de cores''', entre outras funcionalidades.		A classe <code>Terminal</code> do projeto <code>RFW.Terminal</code> fornece uma interface abrangente para o controle do terminal em aplicações de linha de comando, permitindo manipulação avançada de '''formatação''', '''controle de cursor''', '''manipulação de cores''', entre outras funcionalidades.

			= Aparência e Controle do Terminal =

	= Formatação de Texto =		== Formatação de Texto ==

	A formatação de texto na classe <code>Terminal</code> permite ao desenvolvedor modificar de forma simples a cor do texto e do fundo, além de aplicar estilos como negrito, sublinhado e outros. As cores de texto e de fundo podem ser ativadas e desativadas independentemente, oferecendo grande flexibilidade.		A formatação de texto na classe <code>Terminal</code> permite ao desenvolvedor modificar de forma simples a cor do texto e do fundo, além de aplicar estilos como negrito, sublinhado e outros. As cores de texto e de fundo podem ser ativadas e desativadas independentemente, oferecendo grande flexibilidade.
Linha 30:		Linha 31:


	= Cores Estendidas (256 Cores) =		== Cores Estendidas (256 Cores) ==

	Além das cores básicas para texto e fundo, a classe <code>Terminal</code> também suporta a paleta de '''256 cores estendidas''', que permite uma gama maior de personalização visual. A paleta é dividida em três seções principais: cores padrão, cores de alta intensidade, e uma série de cores definidas por uma matriz de 6x6x6 de vermelho, verde e azul (RGB), além de 24 níveis de cinza.		Além das cores básicas para texto e fundo, a classe <code>Terminal</code> também suporta a paleta de '''256 cores estendidas''', que permite uma gama maior de personalização visual. A paleta é dividida em três seções principais: cores padrão, cores de alta intensidade, e uma série de cores definidas por uma matriz de 6x6x6 de vermelho, verde e azul (RGB), além de 24 níveis de cinza.
Linha 45:		Linha 46:
	</syntaxhighlight>		</syntaxhighlight>

	= Paleta de Cores Estendidas ==		== Paleta de Cores Estendidas ===

	A paleta de cores estendidas segue a seguinte estrutura:		A paleta de cores estendidas segue a seguinte estrutura:
Linha 60:		Linha 61:


	= Limpeza de Tela e Linhas =		== Limpeza de Tela e Linhas ==

	A classe <code>Terminal</code> oferece uma série de métodos de limpeza (clear) que permitem remover o conteúdo da tela ou de linhas específicas no terminal. Esses métodos podem ser utilizados para limpar porções específicas da tela, desde o cursor até o fim da linha ou da tela, ou para limpar toda a tela.		A classe <code>Terminal</code> oferece uma série de métodos de limpeza (clear) que permitem remover o conteúdo da tela ou de linhas específicas no terminal. Esses métodos podem ser utilizados para limpar porções específicas da tela, desde o cursor até o fim da linha ou da tela, ou para limpar toda a tela.
Linha 89:		Linha 90:


	= Movimentação do Cursor =		== Movimentação do Cursor ==

	A classe <code>Terminal</code> oferece controle completo sobre a posição do cursor no terminal, permitindo mover o cursor de forma absoluta ou relativa. Isso inclui salvar e restaurar a posição atual do cursor, além de permitir a ocultação e exibição do mesmo. Essas funcionalidades são úteis para criar interfaces mais interativas e manipuláveis no terminal.		A classe <code>Terminal</code> oferece controle completo sobre a posição do cursor no terminal, permitindo mover o cursor de forma absoluta ou relativa. Isso inclui salvar e restaurar a posição atual do cursor, além de permitir a ocultação e exibição do mesmo. Essas funcionalidades são úteis para criar interfaces mais interativas e manipuláveis no terminal.
Linha 114:		Linha 115:


	= Modo Gráfico do Terminal =		== Modo Gráfico do Terminal ==

	A classe <code>Terminal</code> também oferece suporte para ativar e desativar o '''Modo Gráfico''', que permite a utilização de caracteres especiais para desenhar formas e estruturas no terminal, como caixas, linhas e bordas. Esse modo é útil para a construção de interfaces visuais mais ricas, utilizando apenas caracteres ASCII.		A classe <code>Terminal</code> também oferece suporte para ativar e desativar o '''Modo Gráfico''', que permite a utilização de caracteres especiais para desenhar formas e estruturas no terminal, como caixas, linhas e bordas. Esse modo é útil para a construção de interfaces visuais mais ricas, utilizando apenas caracteres ASCII.

	== Habilitando e Desabilitando o Modo Gráfico ==		=== Habilitando e Desabilitando o Modo Gráfico ===

	O modo gráfico pode ser ativado para desenhar usando os caracteres especiais, e pode ser desativado a qualquer momento para retornar ao modo de texto normal. Aqui estão os métodos para habilitar e desabilitar o modo gráfico:		O modo gráfico pode ser ativado para desenhar usando os caracteres especiais, e pode ser desativado a qualquer momento para retornar ao modo de texto normal. Aqui estão os métodos para habilitar e desabilitar o modo gráfico:
Linha 127:		Linha 128:
	</syntaxhighlight>		</syntaxhighlight>

	== Visualizando os Caracteres Gráficos Disponíveis ==		=== Visualizando os Caracteres Gráficos Disponíveis ===

	A classe <code>Terminal</code> também fornece um método auxiliar para imprimir os caracteres gráficos disponíveis, permitindo que o desenvolvedor visualize os códigos gráficos que podem ser utilizados para desenhar no terminal:		A classe <code>Terminal</code> também fornece um método auxiliar para imprimir os caracteres gráficos disponíveis, permitindo que o desenvolvedor visualize os códigos gráficos que podem ser utilizados para desenhar no terminal:
Linha 144:		Linha 145:


	= Inserção de Linhas Vazias =		== Inserção de Linhas Vazias ==

	A classe <code>Terminal</code> oferece o método <code>emptyLines()</code>, que permite a inserção de múltiplas linhas vazias no terminal. Este método é útil para criar separações visuais, organizar a saída e manter a cor de fundo definida ao longo do terminal.		A classe <code>Terminal</code> oferece o método <code>emptyLines()</code>, que permite a inserção de múltiplas linhas vazias no terminal. Este método é útil para criar separações visuais, organizar a saída e manter a cor de fundo definida ao longo do terminal.
Linha 157:		Linha 158:
	{{nota\|Dica para Layout\|Use <code>emptyLines()</code> para organizar a saída no terminal e garantir que o fundo mantenha a cor definida, mesmo em áreas "em branco".}}		{{nota\|Dica para Layout\|Use <code>emptyLines()</code> para organizar a saída no terminal e garantir que o fundo mantenha a cor definida, mesmo em áreas "em branco".}}

	= Controle de Scroll =		== Controle de Scroll ==

	A classe <code>Terminal</code> permite controlar a rolagem do conteúdo da tela, oferecendo métodos para mover o conteúdo para cima e para baixo, além de permitir a definição de regiões específicas de rolagem.		A classe <code>Terminal</code> permite controlar a rolagem do conteúdo da tela, oferecendo métodos para mover o conteúdo para cima e para baixo, além de permitir a definição de regiões específicas de rolagem.
Linha 171:		Linha 172:
	Esses métodos são úteis para interfaces de terminal mais complexas, onde é necessário controlar a visualização do conteúdo exibido.		Esses métodos são úteis para interfaces de terminal mais complexas, onde é necessário controlar a visualização do conteúdo exibido.

	= Método de Beep =		== Método de Beep ==

	O método <code>beep()</code> faz o terminal emitir um som (beep). Esse recurso pode ser utilizado em situações onde você deseja chamar a atenção do usuário, como após uma operação importante ou em casos de erro.		O método <code>beep()</code> faz o terminal emitir um som (beep). Esse recurso pode ser utilizado em situações onde você deseja chamar a atenção do usuário, como após uma operação importante ou em casos de erro.
Linha 182:		Linha 183:
	Este método é simples, mas pode ser eficaz para melhorar a interatividade da aplicação, principalmente em terminais com suporte para som.		Este método é simples, mas pode ser eficaz para melhorar a interatividade da aplicação, principalmente em terminais com suporte para som.

	= Reset Geral do Terminal =		== Reset Geral do Terminal ==

	O método <code>reset()</code> serve para restaurar o terminal ao estado padrão, removendo qualquer formatação ou cor que tenha sido aplicada durante a execução. Ele é particularmente útil para garantir que o terminal retorne ao estado original ao final da execução do programa, evitando que cores ou formatações indesejadas permaneçam.		O método <code>reset()</code> serve para restaurar o terminal ao estado padrão, removendo qualquer formatação ou cor que tenha sido aplicada durante a execução. Ele é particularmente útil para garantir que o terminal retorne ao estado original ao final da execução do programa, evitando que cores ou formatações indesejadas permaneçam.
Linha 194:		Linha 195:

	{{nota\|Definindo Cor de Fundo antes do Reset\|Antes de usar o método <code>reset()</code>, você pode definir uma cor de fundo com o comando <code>setTextBackgroundColor()</code>. Isso garantirá que todo o terminal seja preenchido com a cor de fundo pré-definida, criando um visual mais uniforme.}}		{{nota\|Definindo Cor de Fundo antes do Reset\|Antes de usar o método <code>reset()</code>, você pode definir uma cor de fundo com o comando <code>setTextBackgroundColor()</code>. Isso garantirá que todo o terminal seja preenchido com a cor de fundo pré-definida, criando um visual mais uniforme.}}


			= Entradas de Valores (Inputs) =

Rodrigogml em 16h14min de 8 de setembro de 2024

2024-09-08T16:14:23Z

@@ Linha 36: / Linha 36: @@
 Para definir uma cor estendida no texto ou no fundo, utiliza-se um código ANSI específico. O código ANSI para cores estendidas utiliza o formato <code>\u001B[38;5;&lt;color_code&gt;m</code> para texto e <code>\u001B[48;5;&lt;color_code&gt;m</code> para o fundo, onde <code>&lt;color_code&gt;</code> é o valor de 0 a 255.
 <syntaxhighlight lang="java">
@@ Linha 143: / Linha 142: @@
 O modo gráfico oferece uma maneira prática de criar elementos visuais em terminais de texto, utilizando caracteres especiais para desenhar diretamente no terminal.

Rodrigogml: /* Terminal */

2024-09-08T16:02:28Z

Terminal

Mostrar alterações

Rodrigogml: /* Formatação de Texto */

2024-09-08T15:40:17Z

Formatação de Texto

← Edição anterior		Edição das 15h40min de 8 de setembro de 2024
Linha 30:		Linha 30:

	Esses métodos são suficientes para manipular e restaurar as cores do terminal de forma simples e direta.		Esses métodos são suficientes para manipular e restaurar as cores do terminal de forma simples e direta.


			== Movimentação do Cursor ==

			A classe `Terminal` oferece controle completo sobre a posição do cursor no terminal, permitindo mover o cursor de forma absoluta ou relativa. Isso inclui salvar e restaurar a posição atual do cursor, além de permitir a ocultação e exibição do mesmo. Essas funcionalidades são úteis para criar interfaces mais interativas e manipuláveis no terminal.

			<syntaxhighlight lang="java">
			Terminal.moveCursor(5, 10); // Move o cursor para a linha 5, coluna 10

			Terminal.moveCursorUp(3); // Move o cursor 3 linhas para cima
			Terminal.moveCursorDown(2); // Move o cursor 2 linhas para baixo
			Terminal.moveCursorLeft(5); // Move o cursor 5 colunas para a esquerda
			Terminal.moveCursorRight(7); // Move o cursor 7 colunas para a direita

			Terminal.saveCursorPosition(); // Salva a posição atual do cursor
			Terminal.restoreCursorPosition(); // Restaura a posição salva do cursor

			Terminal.hideCursor(); // Oculta o cursor
			Terminal.showCursor(); // Exibe o cursor

			Terminal.returnToStartOfLine(); // Move o cursor para o início da linha atual
			</syntaxhighlight>

			Esses métodos fornecem a flexibilidade necessária para controlar o cursor no terminal, permitindo uma navegação precisa e eficiente.


			== Limpeza de Tela e Linhas ==

			A classe `Terminal` oferece uma série de métodos de limpeza (clear) que permitem remover o conteúdo da tela ou de linhas específicas no terminal. Esses métodos podem ser utilizados para limpar porções específicas da tela, desde o cursor até o fim da linha ou da tela, ou para limpar toda a tela.



			{{nota\|Definindo a Cor de Fundo\|Uma dica útil é definir a cor de fundo antes de utilizar os métodos `clear()`. Isso fará com que a cor de fundo selecionada seja aplicada a todas as áreas limpas no terminal, proporcionando um efeito visual personalizado.}}



			<syntaxhighlight lang="java">
			Terminal.setTextBackgroundColor(TextBackgroundColor.GREEN); // Define o fundo verde

			Terminal.clearRemainingLine(); // Limpa do cursor até o fim da linha

			Terminal.clearLineFromStart(); // Limpa do início da linha até o cursor

			Terminal.clearLine(); // Limpa a linha atual completamente

			Terminal.clearScreenFromCursor(); // Limpa a tela do cursor até o final da tela

			Terminal.clearScreenToCursor(); // Limpa a tela do início até o cursor

			Terminal.clearScreen(); // Limpa a tela inteira
			</syntaxhighlight>

			Esses métodos são essenciais para manter a tela do terminal organizada e com um visual limpo. Ao combinar a limpeza com a definição de cores de fundo, é possível criar um ambiente visual consistente e controlado no terminal.

Rodrigogml: Criou página com '= Terminal = A classe `Terminal` do projeto `RFW.Terminal` fornece uma interface abrangente para o controle do terminal em aplicações de linha de comando, permitindo manipulação avançada de '''formatação''', '''controle de cursor''', '''manipulação de cores''', entre outras funcionalidades. == Formatação de Texto == A formatação de texto na classe `Terminal` permite ao desenvolvedor modificar de forma simples a cor do texto e do fun...'

2024-09-08T15:30:59Z

Criou página com '= Terminal = A classe <code>Terminal</code> do projeto <code>RFW.Terminal</code> fornece uma interface abrangente para o controle do terminal em aplicações de linha de comando, permitindo manipulação avançada de '''formatação''', '''controle de cursor''', '''manipulação de cores''', entre outras funcionalidades. == Formatação de Texto == A formatação de texto na classe `Terminal` permite ao desenvolvedor modificar de forma simples a cor do texto e do fun...'

Página nova

= Terminal =

A classe <code>Terminal</code> do projeto <code>RFW.Terminal</code> fornece uma interface abrangente para o controle do terminal em aplicações de linha de comando, permitindo manipulação avançada de '''formatação''', '''controle de cursor''', '''manipulação de cores''', entre outras funcionalidades.

== Formatação de Texto ==

A formatação de texto na classe `Terminal` permite ao desenvolvedor modificar de forma simples a cor do texto e do fundo, além de aplicar estilos como negrito, sublinhado e outros. As cores de texto e de fundo podem ser ativadas e desativadas independentemente, oferecendo grande flexibilidade.

Para alterar a cor do texto e do fundo no terminal, a classe `Terminal` utiliza as enumerações `TextColor` e `TextBackgroundColor`. Estas permitem aplicar cores específicas tanto para o texto quanto para o fundo, e também oferecem métodos para resetar essas cores de volta aos padrões do terminal.

<syntaxhighlight lang="java">
Terminal.setTextColor(TextColor.RED); // Define a cor do texto para vermelho

Terminal.setTextBackgroundColor(TextBackgroundColor.BLUE); // Define o fundo como azul

Terminal.resetTextColor(); // Reseta a cor do texto para o padrão do terminal

Terminal.resetTextBackgroundColor(); // Reseta a cor de fundo para o padrão do terminal

Terminal.setTextFormat(TextFormat.BOLD); // Aplica negrito
Terminal.setTextFormat(TextFormat.UNDERLINE); // Aplica sublinhado
Terminal.removeTextFormat(TextFormat.BOLD); // Remove o negrito
Terminal.removeTextFormat(TextFormat.UNDERLINE); // Remove o sublinhado

Terminal.setTextFormat(TextFormat.BOLD, TextFormat.UNDERLINE); // Aplica negrito e sublinhado
Terminal.removeTextFormat(TextFormat.BOLD, TextFormat.UNDERLINE); // Remove negrito e sublinhado
</syntaxhighlight>

Esses métodos são suficientes para manipular e restaurar as cores do terminal de forma simples e direta.