Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Support configurable inter-word spacing limits during justified line breaking

Abierto
  • ¿Algo no está bien?
#1,619 0 comentarios 1 reacción 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
38/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
java
Área
backend

Línea de trabajo

Start with BidiLine.processLine() and PdfDocument.writeLineToContent(), the two entry points named in the issue. Trace how candidate breakpoints and remaining width determine word spacing, then check the existing line breaking tests. Done means an opt-in policy selects legal breaks within the configured spacing limits while preserving default behavior and natural spacing on the last paragraph line.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

enhancement

Is your feature request related to a problem? Please describe.
When rendering justified, hyphenated paragraphs, OpenPDF chooses line breaks using text at its natural width. Once the line has been broken, the remaining width is distributed during justification.

This allows inter-word spacing to be increased, but the line-breaking algorithm does not consider placing an additional word on the line by reducing inter-word spacing.

For example, suppose two possible breaks produce:

  • A hyphenated line requiring 130% inter-word spacing
  • A line containing the complete next word requiring 90% inter-word spacing

The second result is typographically closer to the natural 100% spacing, but OpenPDF currently selects the first because the complete word does not fit at its natural width.

PDF supports negative word-spacing adjustments through the Tw operator, so the output format can represent the desired result. The limitation appears to be in line breaking, particularly BidiLine.processLine().

Describe the solution you'd like
Provide an optional justified line-breaking policy with configurable inter-word spacing limits, for example:

columnText.setMinimumWordSpacingRatio(0.70f);
columnText.setMaximumWordSpacingRatio(1.35f);
columnText.setPreferredWordSpacingRatio(1.00f);

For each line, the line breaker would evaluate legal breakpoints at:

  • Word boundaries
  • Available hyphenation points

For each candidate, it would calculate the inter-word spacing required to fill the line:
required spacing ratio = (available line width - glyph width) / natural space width

Candidates outside the configured minimum and maximum would be rejected. Among the remaining candidates, OpenPDF would select the one closest to the preferred ratio. A hyphenation penalty could optionally be applied so that otherwise similar candidates prefer an unhyphenated break. The last line of a paragraph would continue to use natural spacing, as it does currently. This should be opt-in, preserving the existing line-breaking behavior by default.

Describe alternatives you've considered
The alternatives appear to be:

  1. Forking OpenPDF and modifying BidiLine.
  2. Performing paragraph layout externally and drawing every line directly through PdfContentByte.

External layout would duplicate much of OpenPDF's handling of mixed fonts, inline formatting, bidirectional text, links, superscripts, hyphenation, and page/column transitions. A configurable implementation within OpenPDF's line breaker seems more reusable.

Your real name
Ioannis Rigopoulos

Additional context
The relevant behavior can be seen in:

  • BidiLine.processLine(), which stops scanning when the next character exceeds the available natural width
  • PdfDocument.writeLineToContent(), which calculates the final word and character spacing

The rendering stage already appears capable of emitting negative word spacing if a PdfLine has negative remaining width. The main change may therefore be to retain and score candidate breakpoints beyond the natural line width.

One possible initial implementation would compare:

  • The existing word/hyphen break before overflow
  • Hyphenation candidates
  • The next complete-word boundary, if it fits within the configured minimum spacing

A paragraph-wide optimization could be considered later, but even a line-by-line candidate comparison would improve the current result considerably.

Example requirement:

  • Minimum inter-word spacing: 70%
  • Maximum inter-word spacing: 135%
  • Preferred inter-word spacing: 100%
  • Hyphenation enabled
Lenguaje dominante
Java
Estrellas
4.4k
Forks
714
Sin PR fusionados en 30 d

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de LibrePDF/OpenPDF

Todos los issues de LibrePDF/OpenPDF

Issues similares

Más issues de Java

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.