Improve Image alignment documentation for inline image placement

[Copilot]

Description of the new Feature/Bugfix

Issue #1255 reports users cannot place seal images inline with text—the functionality exists via TEXTWRAP and UNDERLYING flags but documentation was minimal ("this is a kind of image alignment").

Changes:

• Enhanced JavaDoc in Image.java:

  • Documented TEXTWRAP flag enables text wrapping around images for inline placement
  • Documented UNDERLYING flag places images behind text (watermarks/seals)
  • Added usage examples with bitwise OR combinations to setAlignment() method
  • Added flag inspection examples to getAlignment() method

• Added InlineImageWithText.java example:

  • Seal inline with signature: image.setAlignment(Image.RIGHT | Image.TEXTWRAP)
  • Stamp behind text: image.setAlignment(Image.RIGHT | Image.UNDERLYING)
  • Multiple signatures with seals (issue The issue of relative position of images. version:1.3.43 #1255 use case)

Usage:

Image sealImage = Image.getInstance("seal.png");
sealImage.scaleToFit(80f, 80f);
sealImage.setAlignment(Image.RIGHT | Image.TEXTWRAP);
document.add(sealImage);
document.add(new Paragraph("Signature: John Smith\nDate: 2025-01-01"));
// Seal appears inline with signature text

Unit-Tests for the new Feature/Bugfix

• Unit-Tests added to reproduce the bug
• Unit-Tests added to the added feature

No unit tests added—changes are documentation-only. Example code compiles and demonstrates correct usage.

Compatibilities Issues

None. Documentation-only changes with no API modifications.

Your real name

GitHub Copilot Agent (andreasrosdal)

Testing details

Verified by compiling Image.java and InlineImageWithText.java with Java 21. Code review and CodeQL security scan passed.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• github-production-user-asset-6210df.s3.amazonaws.com
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud