Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Support configurable inter-word spacing limits during justified line breaking

Aperta
  • Qualcosa non va?
#1,619 0 commenti 1 reazione 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
38/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
java
Ambito
backend

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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
Lingua principale
Java
Stelle
4.4k
Fork
714
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di LibrePDF/OpenPDF

Tutte le issue di LibrePDF/OpenPDF

Issue simili

Altre issue su Java

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.