A more accurate approach to calculating text width & text height

Originally posted on SO, but should be relevant here too.

Using the inbuilt functions textWidth(), textAscent(), and textDescent() are an easy way to get a good approximate result for the height and width of a string, but they are not exact.

Why?

  • textAscent() returns text height above the line based on the letter 'd’
  • textDescent() returns text height below the line based on the letter ‘p’.
  • textWidth() includes glyph whitespace (aka padding; ideally we want to ignore this for the first and last characters)

textAscent() + textDescent() therefore measures the maximum height of a string in a given font and font size, and not the height of a specific string. In other words, if your text doesn’t include both ‘d’ and ‘p’ characters, then using these methods to determine text height will overestimate the result (as we see in Kevin’s screenshot).


Getting the exact height

We can use this approach to get an exact result for height:

  1. Get a vector representation of each character
  2. Iterate over the vector’s vertices, finding:
    • The vertex with highest Y position
    • The vertex with lowest Y position
  3. Subtract the highest Y position from the lowest Y position to return actual string height

Code Example

Note you’ll need to explicitly create a PFont for this.

String string = "Hello world";

PFont font = createFont("Arial", 96, true); // arial, size 96
textFont(font);

float minY = Float.MAX_VALUE;
float maxY = Float.NEGATIVE_INFINITY;

for (Character c : string.toCharArray()) {
	PShape character = font.getShape(c); // create character vector
	for (int i = 0; i < character.getVertexCount(); i++) {
		minY = min(character.getVertex(i).y, minY);
		maxY = max(character.getVertex(i).y, maxY);
	}
}

final float textHeight = maxY - minY;

Result

(Note we’re still using textWidth() for width here)

text(string, mouseX, mouseY);
rect(mouseX, mouseY, textWidth("Hello world"), -textHeight);

enter image description here

Getting the exact width

Code Example

String string = "Hello world";

PFont font = createFont("Arial", 96, true); // arial, size 96
textFont(font);

float textWidth = textWidth(string); // call Processing method

whitespace = (font.width(string.charAt(string.length() - 1)) * font.getSize()
		- font.getGlyph(string.charAt(string.length() - 1)).width) / 2;
textWidth -= whitespace; // subtract whitespace of last character

whitespace = (font.width(string.charAt(0)) * font.getSize() - font.getGlyph(string.charAt(0)).width) / 2;
textWidth -= whitespace; // subtract whitespace of first character

Result

(Putting the two together…)

text(string, mouseX, mouseY);
rect(mouseX + whitespace, mouseY, textWidth, -textHeight);

enter image description here

Y-Axis Alignment

A rectangle drawn around "Hello world" happens to be aligned because none of the glyphs descend below the baseline.

With a string like @#'pdXW\, both @ and p descend below the baseline such that the rectangle, although it is the correct height, is out of alignment with the string on the y-axis, as below:

enter image description here

A programmatic way to determine the y-offset would be to find the Y-coordinate of the lowest (although remember Processing’s y-axis extends downwards so we’re actually looking for the highest value) vertex . Fortunately, this was calculated as part of finding the exact height.

We can simply use the maxY value that was calculated there to offset the text bounding box.

Result

text(string, mouseX, mouseY);
rect(mouseX + whitespace, mouseY + maxY, textWidth, -textHeight);

enter image description here

3 Likes

To compare, the naive approach…

text(string, mouseX, mouseY);
rect(mouseX, mouseY, textWidth(string), -textAscent() + textDescent());

…looks like this:

image

Oh hang on. I tried the code and think I found a bug… in adapting it slightly it doesn’t work anymore.

String string = "Hello @world";
float whitespace;
float textWidth;
float textHeight;
float minY;
float maxY;


void setup() {
  size(800, 800);
  noFill();
  stroke(255, 0, 0);
  
  PFont font = createFont("Arial", 96, true); // arial, size 96
  textFont(font);  
  textWidth = textWidth(string); // call Processing method

  float minY = Float.MAX_VALUE;
  float maxY = Float.NEGATIVE_INFINITY;

  for (Character c : string.toCharArray()) {
    PShape character = font.getShape(c); // create character vector
    for (int i = 0; i < character.getVertexCount(); i++) {
      minY = min(character.getVertex(i).y, minY);
      maxY = max(character.getVertex(i).y, maxY);
    }
  }

  textHeight = maxY - minY;

  whitespace = (font.width(string.charAt(string.length() - 1)) * font.getSize()
    - font.getGlyph(string.charAt(string.length() - 1)).width) / 2;
  textWidth -= whitespace; // subtract whitespace of last character

  whitespace = (font.width(string.charAt(0)) * font.getSize() - font.getGlyph(string.charAt(0)).width) / 2;
  textWidth -= whitespace; // subtract whitespace of first character
  
  
}

void draw() {
  background(0);
  float theX = 100;
  float theY = 200;
  
  text(string, theX, theY);
  
  fill(#E5FA08);
  ellipse(theX, theY, 4, 4);
  
  noFill();
  stroke(#FA085D);
  rect(theX + whitespace, theY + maxY, textWidth, -textHeight);
}

The bug is with your code. You’re assigning to a second maxY variable scoped within setup(), and not the one which theY + maxY references.

image

OH YES. DUR!!!

Thank you, thank you, thank you…

Hello, I seem to have come up with an even better version of doing this. As you can see in the image above, that final “d” has still a bit of whitespace to the right, which this method didn’t account for. Well, here’s my code:

PFont font;
String string = "";

void setup() {
  size(800, 600);
  font = createFont("Arial", 96, true);
  textFont(font);
}

void draw() {
  background(0);
  fill(255, 100);
  stroke(255, 0, 0);
  textWithBoxes(string, mouseX, mouseY);
}

public void textWithBoxes(String string, float x, float y) {
  float leftMost = Float.POSITIVE_INFINITY, rightMost = Float.NEGATIVE_INFINITY, topMost = Float.POSITIVE_INFINITY, bottomMost = Float.NEGATIVE_INFINITY;

  text(string, x, y);
  
  noFill();
  for (Character c : string.toCharArray()) {
    if (c != ' ') {
      PFont.Glyph glyph = font.getGlyph(c);

      float left = x + glyph.leftExtent;
      float top = y - glyph.topExtent;
      
      float right = left + glyph.width;
      float bottom = top + glyph.height;

      leftMost = left < leftMost ? left : leftMost;
      topMost = top < topMost ? top : topMost;
      rightMost = right > rightMost ? right : rightMost;
      bottomMost = bottom > bottomMost ? bottom : bottomMost;

      rect(left, top, glyph.width, glyph.height);
    }
    x += textWidth(c);
  }
  rect(leftMost, topMost, rightMost - leftMost, bottomMost - topMost);
}

I took this knowledge from the Processing source code, which uses these glyph class variables to position the letters when rendering them. This even has the advantage of being able to give you the exact bounding box of each character in the string.

There was also one slight issue with the bounding box of the space character, which was HUGE for some reason, so I omitted it. Any other inaccuracies are not my fault; it seems that some characters render off by like 1 pixel in whatever direction, requiring manual tweaking.

2 Likes