Dibujar un párrafo completo

Para poder dibujar un párrafo completo no se puede usar únicamente la clase TextLayout, ya que ésta sólo escribe una línea de texto. Para un párrafo es necesaria otra clase más, la clase LineBreakMeasurer, con la que se crean y se dibujan líneas de texto (objetos TextLayout) que se ajustan a la anchura que se desee.

En el siguiente código se dibujan varias líneas de texto sobre una ventana, y el resultado puede apreciarse en la figura 4.4:

import java.awt.*;

import java.util.*;

import java.text.*;

import java.awt.font.*;

publicclass Texto extends JFrame {

privatestaticfinal Hashtable mapa = new Hashtable();

privatestatic AttributedString trabalenguas;

static {

mapa.put(TextAttribute.SIZE, new Float(18.0)); trabalenguas = new AttributedString(

"Tres tristes tigres comieron trigo "

+ "en un trigal. Un tigre, dos tigres, tres tigres. "

+ "Pablito clavó un clavito, ¿qué clavito clavó Pablito?", mapa);

}

public Texto() {

super("Texto");

super.setBackground(Color.white);

PanelIteradorSobreLineas panel = new PanelIteradorSobreLineas(); add(panel, BorderLayout.CENTER);

}

class PanelIteradorSobreLineas extends JPanel {

private LineBreakMeasurer lineMeasurer;

privateintcomienzoParrafo;

privateintfinParrafo;

public PanelIteradorSobreLineas() {

AttributedCharacterIterator parrafo = trabalenguas.getIterator();

comienzoParrafo = parrafo.getBeginIndex();

finParrafo = parrafo.getEndIndex();

lineMeasurer = new LineBreakMeasurer(parrafo,

new FontRenderContext(null, false, false)); }

publicvoid paint(Graphics g) {

Graphics2D graphics2D = (Graphics2D) g;

Figura 4.4. Dibujo de un

párrafo de texto con una anchura ajustada a la de la ventana

Dimension tamaño = getSize();

float anchodelinea = (float) tamaño.width;

float pintaPosY = 0;

float pintaPosX;

lineMeasurer.setPosition(comienzoParrafo);

while (lineMeasurer.getPosition() < finParrafo) {

TextLayout layout = lineMeasurer.nextLayout(anchodelinea); pintaPosY += layout.getAscent();

if (layout.isLeftToRight()) pintaPosX = 0;

else

pintaPosX = anchodelinea - layout.getAdvance(); layout.draw(graphics2D, pintaPosX, pintaPosY); pintaPosY += layout.getDescent() + layout.getLeading(); }

} }

publicstaticvoid main(String[] args) { Texto v = new Texto();

v.setSize(new Dimension(400, 250));

v.setDefaultCloseOperation(EXIT_ON_CLOSE); v.setVisible(true);

} }

Vamos a analizar el brevemente el programa recién creado. En primer lugar, puede apreciarse perfectamente que el código es totalmente distinto al de los ejemplos en que se dibujaba una única línea y, por ende, más complejo. La variable mapa, es la que permite asignarle los atributos de diseño de fuente al objeto de tipo AttributedString (esta clase se tratará más adelante en el epígrafe 4.4; por ahora basta saber que contiene una cadena de caracteres en la que cada carácter puede tener sus propios atributos de color, fuente, etc.). A través de esta variable es posible cambiar cualquier aspecto de la fuente tipográfica. Un ejemplo de ello es que si, por ejemplo, se sustituye la sentencia:

mapa.put(TextAttribute.SIZE, new Float(18.0)); por esta otra:

mapa.put(TextAttribute.FONT,

Font.getFont("Fuente", new Font("Vivaldi", Font.PLAIN, 40))); se obtendrá el resultado de la figura 4.5. El resultado queda bien patente: se ha modificado la fuente, el estilo y el tamaño de la misma con tan solo cambiar una línea de código.

En la clase PanelIteradorSobreLineas se ajusta el texto para que después pueda trabajarse sobre él: se crea un iterador que se utiliza para definir los límites del

texto y para crear un manejador de líneas, lineMeasurer de la clase LineBreakMeasurer, que será quien se encarge de coger las líneas del párrafo, una por una y pintarlas en el objeto Graphics2D.

Finalmente, en el método paint() se realiza el dibujo del texto, teniendo en cuenta las medidas de la ventana y de las líneas, tanto horizontal como verticalmente. Para poder entender el trozo de código completamente es necesario entender ciertos conceptos acerca de las métricas de las fuentes: la distancia llamada ascent es la distancia desde la base del carácter a la línea ascendente, es decir, la distancia entre la base del carácter a la altura máxima que pueda tener cualquier símbolo de la misma fuente (por ejemplo la “b” alcanza la altura máxima). La distancia descent es la distancia desde la base del carácter hasta la línea descendente, es decir, hasta la profundidad mínima a la que puede descender cualquier símbolo de la fuente (un ejemplo de ello es la letra “g”). Finalmente, la distancia de interlineado (leading) es la distancia recomendada desde el fondo de la línea descendente hasta la ascendente de la línea inferior. La figura 4.6 ilustra visualmente estos conceptos.

Haciendo uso de estos componentes tipográficos, se puede observar como la variable lineMeasurer es la encargada de obtener cada una de las líneas, mientras que pintaPosY y pintaPosX son las que se encargan de posicionar la línea que se está gestionando en cada momento: pintaPosY sitúa correctamente la línea verticalmente y pintaPosX se encarga de situar la línea conforme al ancho de línea marcado.

Figura 4.5. Dibujo de un párrafo de texto con una fuente distinta

a la de por defecto. El texto se ajusta a los márgenes de la ventana

Figura 4.6. Elementos tipográficos a considerar en el

En la siguiente tabla se muestran los métodos implicados en este apartado:

Método Descripción

AttributedString(String, Map) constructor de clase

Crea una cadena con atributos a partir de un String y un mapa de atributos

TextLayout.getAscent() Devuelve la línea ascendente del texto TextLayout.getDescent() Devuelve la línea descendente del texto

TextLayout.getLeading() Devuelve el espacio entre la línea descendente y la línea siguiente

TextLayout.getAdvance() Avanza dentro de una línea del párrafo LineBreakMeasurer(

AttributedString, FontRenderContext) constructor de clase

Crea un manejador de texto de más de una línea

LineBreakMeasurer. getPosition()

Obtiene la posición actual del objeto LineBreakMeasurer

LineBreakMeasurer. setPosition(Float x)

Coloca el objeto LineBreakMeasurer en la posición x del texto

LineBreakMeasurer. nextLayout(Float x)

Avanza una línea del párrafo, marcada por x