Figlet

Utilitário de Figlet Fonts

A classe `Figlet` é um utilitário que permite a geração de texto em ASCII Art utilizando a biblioteca Figlet4J. Com suporte a diversas fontes, ela possibilita a conversão de texto comum para estilos artísticos, podendo ser utilizada em aplicações de terminal, interfaces de linha de comando e exportação para HTML.

Funcionalidades Principais

• **Geração de ASCII Art** a partir de um texto com fonte padrão ou personalizada.
• **Exportação de portfólio HTML** contendo exemplos de todas as fontes disponíveis.
• **Centralização de texto** para melhor apresentação em diferentes espaçamentos.

Como Utilizar

Dependências Requeridas

A classe utiliza a biblioteca Figlet4J. Certifique-se de que a dependência está presente no projeto:

<dependency>
    <groupId>com.github.lalyos</groupId>
    <artifactId>jfiglet</artifactId>
    <version>0.0.9</version>
</dependency>

Geração de ASCII Art

Para converter um texto em ASCII Art utilizando a fonte padrão:

String asciiText = Figlet.generate("Hello, World!");
System.out.println(asciiText);

Para utilizar uma fonte específica:

String asciiText = Figlet.generateWithFont("Hello, World!", Figlet.FigletFontType.STANDARD);
System.out.println(asciiText);

Exportação de Portfólio HTML

Para gerar um arquivo HTML contendo exemplos de todas as fontes:

Figlet.exportFigletPortfolioHTML("Exemplo", "output/figlet_portfolio.html");

Isso criará um arquivo HTML exibindo cada fonte aplicada ao texto "Exemplo".

Centralização de Texto ASCII

Para centralizar um texto gerado:

String asciiText = Figlet.generate("Hello");
String centeredText = Figlet.centralize(asciiText, 80);
System.out.println(centeredText);

Fontes Disponíveis

A classe `FigletFontType` define uma enumeração com diversas fontes disponíveis. A lista completa pode ser visualizada na página Figlet Fonts.

Exemplo de Saída

 _   _      _ _         
| | | |    | | |        
| |_| | ___| | | ___    
|  _  |/ _ \ | |/ _ \   
| | | |  __/ | | (_) |  
\_| |_/\___|_|_|\___/

Possíveis Exceções

A classe pode lançar exceções caso ocorra algum problema:

• `RFWException` - Se houver erro ao processar a conversão do texto.
• `IOException` - Se houver falha ao escrever o arquivo HTML.
• `RFWCriticalException` - Para falhas críticas no sistema.

Conclusão

A classe `Figlet` é um recurso poderoso para quem deseja adicionar arte ASCII a suas aplicações. Seja para estética, branding ou exibição em terminais, ela oferece uma forma simples e eficaz de transformar textos em algo visualmente atrativo.