How to center a text using PDFBox

Ok, I found the answer myself. Here is how to center some text on a page:

String title = "This is my wonderful title!"; // Or whatever title you want.
int marginTop = 30; // Or whatever margin you want.

PDDocument document = new PDDocument();
PDPage page = new PDPage();
PDPageContentStream stream = new PDPageContentStream(document, page);
PDFont font = PDType1Font.HELVETICA_BOLD; // Or whatever font you want.

int fontSize = 16; // Or whatever font size you want.
float titleWidth = font.getStringWidth(title) / 1000 * fontSize;
float titleHeight = font.getFontDescriptor().getFontBoundingBox().getHeight() / 1000 * fontSize;

stream.beginText();
stream.setFont(font, fontSize);
// Deprecated, only before 2.0:
// stream.moveTextPositionByAmount((page.getMediaBox().getWidth() - titleWidth) / 2, page.getMediaBox().getHeight() - marginTop - titleHeight);
// From 2.0 and beyond:
stream.newLineAtOffset((page.getMediaBox().getWidth() - titleWidth) / 2, page.getMediaBox().getHeight() - marginTop - titleHeight);
stream.drawString(title);
stream.endText();
stream.close();

This adds centered text to pages in portrait as well as landscape format:

void addCenteredText(String text, PDFont font, int fontSize, PDPageContentStream content, PDPage page, Point2D.Float offset) throws IOException {
    content.setFont(font, fontSize);
    content.beginText();

    // Rotate the text according to the page orientation
    boolean pageIsLandscape = isLandscape(page);
    Point2D.Float pageCenter = getCenter(page);

    // We use the text's width to place it at the center of the page
    float stringWidth = getStringWidth(text, font, fontSize);
    if (pageIsLandscape) {
        float textX = pageCenter.x - stringWidth / 2F + offset.x;
        float textY = pageCenter.y - offset.y;
        // Swap X and Y due to the rotation
        content.setTextMatrix(Matrix.getRotateInstance(Math.PI / 2, textY, textX));
    } else {
        float textX = pageCenter.x - stringWidth / 2F + offset.x;
        float textY = pageCenter.y + offset.y;
        content.setTextMatrix(Matrix.getTranslateInstance(textX, textY));
    }

    content.showText(text);
    content.endText();
}

boolean isLandscape(PDPage page) {
    int rotation = page.getRotation();
    final boolean isLandscape;
    if (rotation == 90 || rotation == 270) {
        isLandscape = true;
    } else if (rotation == 0 || rotation == 360 || rotation == 180) {
        isLandscape = false;
    } else {
        LOG.warn("Can only handle pages that are rotated in 90 degree steps. This page is rotated {} degrees. Will treat the page as in portrait format", rotation);
        isLandscape = false;
    }
    return isLandscape;
}

Point2D.Float getCenter(PDPage page) {
    PDRectangle pageSize = page.getMediaBox();
    boolean rotated = isLandscape(page);
    float pageWidth = rotated ? pageSize.getHeight() : pageSize.getWidth();
    float pageHeight = rotated ? pageSize.getWidth() : pageSize.getHeight();

    return new Point2D.Float(pageWidth / 2F, pageHeight / 2F);
}

float getStringWidth(String text, PDFont font, int fontSize) throws IOException {
    return font.getStringWidth(text) * fontSize / 1000F;
}

This is how you create a PDF with centered text on a rotated page:

PDDocument pdf = new PDDocument();
// A5 page in landscape format
PDPage page = new PDPage(PDRectangle.A5);
page.setRotation(90);

pdf.addPage(page);
try (PDPageContentStream content = new PDPageContentStream(pdf, page)) {
    int fontSize = 36;

    // Put the text at the page's center, no offset
    Point2D.Float center = new Point2D.Float(0, 0);
    addCenteredText("PDFBox", PDType1Font.HELVETICA_BOLD, fontSize, content, page, center);

    // Put the text centered at the lower end of the page
    Point2D.Float lowerCenter = new Point2D.Float(0, -165);
    addCenteredText("Hi there!", PDType1Font.HELVETICA, fontSize, content, page, lowerCenter);

} catch (IOException e) {
    LOG.warn("Exception while creating content", e);
}

The resulting PDF:

resulting PDF

I used PDFBox 2.0.0-RC2 for creating this PDF.