The hero image lives in {@code examples/src/main/resources/engine-hero.png} + * and is loaded over the classpath so the example runs without any + * filesystem path assumptions.
+ * + *Output: + * {@code examples/target/generated-pdfs/flagships/engine-showcase.pdf} + * — page 1 is rasterised by {@link com.demcha.examples.support.PdfPageRasterizer} + * into {@code assets/readme/repository_showcase_render.png}.
+ * + * @author Artem Demchyshyn + * @since 1.6.6 + */ +public final class EngineShowcase { + + // ── Theme palette — cinematic navy + electric accent ───────── + private static final DocumentColor PAPER = DocumentColor.rgb(248, 247, 242); + private static final DocumentColor NAVY = DocumentColor.rgb(18, 26, 56); + private static final DocumentColor NAVY_DARK = DocumentColor.rgb(10, 14, 36); + private static final DocumentColor ACCENT = DocumentColor.rgb(255, 138, 36); + private static final DocumentColor ACCENT_SOFT = DocumentColor.rgb(255, 198, 138); + private static final DocumentColor INK = DocumentColor.rgb(20, 24, 38); + private static final DocumentColor MUTED = DocumentColor.rgb(110, 116, 132); + private static final DocumentColor RULE = DocumentColor.rgb(220, 218, 210); + private static final DocumentColor CARD_RING = DocumentColor.rgb(232, 226, 212); + private static final DocumentColor PANEL_TINT = DocumentColor.rgb(232, 234, 246); + private static final DocumentColor PANEL_RING = DocumentColor.rgb(208, 214, 234); + + private EngineShowcase() { + } + + public static Path generate() throws Exception { + Path output = ExampleOutputPaths.prepare("flagships", "engine-showcase.pdf"); + DocumentImageData hero = loadHeroImage(); + + try (DocumentSession document = GraphCompose.document(output) + .pageSize(DocumentPageSize.A4) + .pageBackground(PAPER) + .margin(36, 38, 32, 38) + .create()) { + + document.pageFlow() + .name("EngineShowcase") + .spacing(14) + + // ── Marquee band: brand + version ────────────── + .addRow("Marquee", row -> row + .spacing(0) + .weights(1, 1) + .addSection("MarqueeLeft", section -> section + .addParagraph(p -> p + .text("GRAPHCOMPOSE") + .textStyle(bandLeft()) + .margin(DocumentInsets.zero()))) + .addSection("MarqueeRight", section -> section + .addParagraph(p -> p + .text("v1.6 · MAVEN CENTRAL") + .textStyle(bandRight()) + .align(TextAlign.RIGHT) + .margin(DocumentInsets.zero())))) + + // ── Thin orange rule ────────────────────────── + .addShape(s -> s.size(516, 1.2).fillColor(ACCENT) + .margin(DocumentInsets.zero())) + + // ── Hero frame: nested rounded shapes form a thick + // orange border around the brand artwork (avoids the + // stroke-on-rounded-path corner artifact at thick + // stroke widths). Outer = ACCENT fill, inner = NAVY + // fill clipped to round, image clipped inside that. + .addContainer(frame -> frame + .name("HeroFrame") + .roundedRect(519, 287, 16) + .fillColor(ACCENT) + .center(new com.demcha.compose.document.dsl.ShapeContainerBuilder() + .name("HeroInner") + .roundedRect(513, 281, 13) + .fillColor(NAVY_DARK) + .clipPolicy(ClipPolicy.CLIP_PATH) + .center(new com.demcha.compose.document.dsl.ImageBuilder() + .name("HeroImage") + .source(hero) + .size(509, 277) + .fitMode(DocumentImageFitMode.COVER) + .build()) + .build())) + + // ── Magazine-headline lockup ────────────────── + .addSection("Lockup", section -> section + .padding(new DocumentInsets(8, 4, 0, 4)) + .spacing(2) + .addParagraph(p -> p + .text("One engine.") + .textStyle(headline()) + .margin(DocumentInsets.zero())) + .addParagraph(p -> p + .text("Every PDF you ship.") + .textStyle(headlineAccent()) + .margin(DocumentInsets.zero())) + .addParagraph(p -> p + .text("A declarative Java engine for production PDFs. Semantic graph compiles to deterministic layout, paginates predictably, and renders through PDFBox — without leaking PDFBox into your app.") + .textStyle(tagline()) + .lineSpacing(1.35) + .margin(new DocumentInsets(6, 0, 0, 0)))) + + // ── Three KPI cards — engine capability counts ─ + .addRow("KpiRow", row -> row + .spacing(12) + .weights(1, 1, 1) + .addSection("KpiPresets", section -> kpiCard(section, + "31", "V2 Presets", + "Layered CV + cover-letter preset architecture — data · theme · components · widgets, swap one without rewriting the others.")) + .addSection("KpiTests", section -> kpiCard(section, + "1,033", "Tests · 0 failures", + "Snapshot baselines, japicmp binary-compat gate, parallel-session stress harness, JMH benchmark suite.")) + .addSection("KpiNodes", section -> kpiCard(section, + "17", "Semantic Primitives", + "Modules, sections, paragraphs, lists, tables, rows, shapes, images — every node is themable and snapshot-tested."))) + + // ── Capability columns ──────────────────────── + .addRow("Capabilities", row -> row + .spacing(14) + .weights(1, 1, 1) + .addSection("CapDsl", section -> capabilityColumn(section, + "DECLARATIVE BY DESIGN", + "Compose by intent — modules, sections, rows. Zero PDFBox imports in your application code.")) + .addSection("CapDeterm", section -> capabilityColumn(section, + "DETERMINISTIC RENDER", + "Identical input, identical PDF — byte-comparable. Layout snapshots, JMH-benchmarked hot paths.")) + .addSection("CapTheme", section -> capabilityColumn(section, + "CINEMATIC THEMING", + "BusinessTheme · CvTheme palettes, component-level tokens, v2 layered preset architecture."))) + + // ── Footer brand stripe ─────────────────────── + .addShape(s -> s.size(516, 0.6).fillColor(RULE) + .margin(new DocumentInsets(8, 0, 0, 0))) + .addRow("Footer", row -> row + .spacing(0) + .weights(2, 1) + .addSection("FooterLeft", section -> section + .addParagraph(p -> p + .text("graphcompose.dev · github.com/DemchaAV/GraphCompose") + .textStyle(footer()) + .margin(DocumentInsets.zero()))) + .addSection("FooterRight", section -> section + .addParagraph(p -> p + .text("Java · PDFBox · MIT") + .textStyle(footer()) + .align(TextAlign.RIGHT) + .margin(DocumentInsets.zero())))) + + .build(); + + document.buildPdf(); + } + return output; + } + + private static DocumentImageData loadHeroImage() throws Exception { + try (InputStream is = Objects.requireNonNull( + EngineShowcase.class.getResourceAsStream("/engine-hero.png"), + "engine-hero.png missing from examples/src/main/resources/")) { + return DocumentImageData.fromBytes(is.readAllBytes()); + } + } + + // ── Helpers ────────────────────────────────────────────────── + + private static void kpiCard(com.demcha.compose.document.dsl.SectionBuilder section, + String value, String label, String detail) { + section + .softPanel(DocumentColor.WHITE, 8, 12) + .stroke(DocumentStroke.of(CARD_RING, 0.5)) + .spacing(2) + .addParagraph(p -> p + .text(value) + .textStyle(kpiValue()) + .margin(DocumentInsets.zero())) + .addParagraph(p -> p + .text(label) + .textStyle(kpiLabel()) + .margin(new DocumentInsets(0, 0, 0, 0))) + .addParagraph(p -> p + .text(detail) + .textStyle(kpiDetail()) + .lineSpacing(1.25) + .margin(new DocumentInsets(4, 0, 0, 0))); + } + + private static void capabilityColumn(com.demcha.compose.document.dsl.SectionBuilder section, + String label, String prose) { + section + // Tab-on-left callout: round only the right corners so + // the accent rule on the left sits flush against a + // straight edge — square cap on the rule matches a + // square left side without crossing a rounded curve. + .softPanel(PANEL_TINT, DocumentCornerRadius.right(6), 0) + .accentLeft(ACCENT, 3.0f) + .padding(new DocumentInsets(12, 12, 12, 16)) + .spacing(3) + .addParagraph(p -> p + .text(label) + .textStyle(capLabel()) + .margin(DocumentInsets.zero())) + .addParagraph(p -> p + .text(prose) + .textStyle(capProse()) + .lineSpacing(1.3) + .margin(new DocumentInsets(2, 0, 0, 0))); + } + + // ── Text styles ────────────────────────────────────────────── + + private static DocumentTextStyle bandLeft() { + return DocumentTextStyle.builder() + .fontName(FontName.HELVETICA_BOLD) + .size(10) + .color(NAVY) + .build(); + } + + private static DocumentTextStyle bandRight() { + return DocumentTextStyle.builder() + .fontName(FontName.HELVETICA) + .size(9) + .color(MUTED) + .build(); + } + + private static DocumentTextStyle headline() { + return DocumentTextStyle.builder() + .fontName(FontName.TIMES_BOLD) + .size(38) + .color(INK) + .build(); + } + + private static DocumentTextStyle headlineAccent() { + return DocumentTextStyle.builder() + .fontName(FontName.TIMES_BOLD_ITALIC) + .size(38) + .color(ACCENT) + .build(); + } + + private static DocumentTextStyle tagline() { + return DocumentTextStyle.builder() + .fontName(FontName.HELVETICA) + .size(11) + .color(INK) + .build(); + } + + private static DocumentTextStyle kpiValue() { + return DocumentTextStyle.builder() + .fontName(FontName.TIMES_BOLD) + .size(26) + .color(NAVY) + .build(); + } + + private static DocumentTextStyle kpiLabel() { + return DocumentTextStyle.builder() + .fontName(FontName.HELVETICA_BOLD) + .size(9) + .color(ACCENT) + .build(); + } + + private static DocumentTextStyle kpiDetail() { + return DocumentTextStyle.builder() + .fontName(FontName.HELVETICA) + .size(8) + .color(MUTED) + .build(); + } + + private static DocumentTextStyle capLabel() { + return DocumentTextStyle.builder() + .fontName(FontName.HELVETICA_BOLD) + .size(9) + .color(NAVY) + .build(); + } + + private static DocumentTextStyle capProse() { + return DocumentTextStyle.builder() + .fontName(FontName.HELVETICA) + .size(9) + .color(INK) + .build(); + } + + private static DocumentTextStyle footer() { + return DocumentTextStyle.builder() + .fontName(FontName.HELVETICA) + .size(8) + .color(MUTED) + .build(); + } + + public static void main(String[] args) throws Exception { + System.out.println("Generated: " + generate()); + } +} diff --git a/examples/src/main/java/com/demcha/examples/support/PdfPageRasterizer.java b/examples/src/main/java/com/demcha/examples/support/PdfPageRasterizer.java new file mode 100644 index 00000000..17ef1f5a --- /dev/null +++ b/examples/src/main/java/com/demcha/examples/support/PdfPageRasterizer.java @@ -0,0 +1,73 @@ +package com.demcha.examples.support; + +import org.apache.pdfbox.Loader; +import org.apache.pdfbox.pdmodel.PDDocument; +import org.apache.pdfbox.rendering.ImageType; +import org.apache.pdfbox.rendering.PDFRenderer; + +import javax.imageio.ImageIO; +import java.awt.image.BufferedImage; +import java.io.File; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.Paths; + +/** + * Rasterises one page of a PDF into a PNG at a chosen DPI. Tiny CLI built + * on top of PDFBox so this repo never has to depend on Ghostscript / + * pdftoppm / ImageMagick for README hero asset regeneration. Used during + * v1.6.6 release prep to produce the new {@code repository_showcase_render.png} + * (CV mint-editorial page 1 hero) without an external rasterizer. + * + *Usage:
+ *+ * ./mvnw -B -ntp -f examples/pom.xml -DskipTests exec:java \ + * -Dexec.mainClass=com.demcha.examples.support.PdfPageRasterizer \ + * -Dexec.args="<inputPdf> <outputPng> [pageIndex0=0] [dpi=200]" + *+ * + *
Defaults: page index 0 (first page), 200 DPI (~1654 × 2339 for A4 — + * comfortable for README hero quality).
+ * + * @author Artem Demchyshyn + * @since 1.6.6 + */ +public final class PdfPageRasterizer { + + private PdfPageRasterizer() { + } + + public static void main(String[] args) throws Exception { + if (args.length < 2) { + System.err.println("Usage: PdfPageRasterizer