---
name: visual-assets
description: "Produce project-ready Document Studio visual assets from page art direction: connected explanatory scenes, editorial illustrations, pictogram families and targeted image edits. Use when meaningful asset production is needed; return actual files, provenance and inspected placement regions without taking over document layout."
---

# Meaningful document assets

The [accepted guide baseline](../report-html-pptx/references/accepted-composition-default.md) makes meaningful visual explanation routine in new documents. Follow concrete cover/body image jobs through to actual files and integration; adapt the scene to this topic rather than copying the guide paper metaphor. Preserve factual originals, native labels and concept status.

Consume the current brief and designer's concrete visual job. Do not restart document intake or invent an argument. Reuse content/visual-assets.json when present; its six core fields are asset_id, section_ids, purpose, semantic_constraints, production and delivery. [Asset contract](references/asset-contract.md) applies for integration/multi-asset jobs; a small standalone request can use the equivalent short brief.

Receive the supported meaning/subjects, final frame, image role, protected crop, view, quiet overlay region, adjacent caption, reference role, actual/concept state and selected expression. Resolve only a required original or a semantic gap that changes the visual. Routine aesthetic details are chosen and produced within the authorized request, without per-image approvals.

| Actual job | Production |
|---|---|
| Rich scene, original illustration or raster edit | Available native image-generation tool with its imagegen instructions |
| Exact simple diagram or geometric motif | Native SVG/HTML shapes; keep important labels/connectors in the document |
| Coherent pictogram family | Licensed supplied SVGs or a consistent vector extension |
| Actual logo, packaging, character or factual photo | Verified original with the accepted identity preserved |
| Exact quantitative chart | Design/data owner for editable accurate encoding |

If the selected job depends on convincing depth, architecture, perspective, organic subjects, material, lighting or an editorial scene, produce an actual image asset when generation is available. Do not downgrade it to CSS-like icon blocks merely because HTML is the final container. Conversely, do not generate an image for a text-first cover, exact chart or simple editable diagram. Mixed scenes can use a generated background and sourced identity assets with native text/motion overlays. See design's [medium selection](../document-design/references/visual-medium-selection.md) only when the method is ambiguous.

For v4.2, carry the designer's `medium` and `reason` from the **existing page map** into the six-field asset record only when production is needed. If image generation cannot finish, retain `partial`/`blocked` with the missing image job; never relabel unproduced concept art as a verified native diagram. A real logo or package remains blocked until an authorized original is available, even if a generated lookalike feels plausible. Exact labels/data and motion belong to HTML overlays, not the generated pixels.

Use [expression](../report-html-pptx/references/design-expression.md) from production.expression or brief.design_expression. For [body jobs](../report-html-pptx/references/body-composition.md), the asset can connect subjects, support one paragraph, dominate a mosaic or supply a whole/detail view. Carry that relationship into production instead of using a generic cover prompt. Connected scenes need meaningful spatial grouping; an isolated stock-like object is insufficient for an integrated explanatory world. Quiet/inventive and rich/conventional are valid combinations.

Apply the chosen [explanation job](../report-html-pptx/references/visual-expression-and-rhythm.md) to the actual body asset: annotated subject/detail, mechanism, activity sequence, before/after concept or connected scene. Produce and place useful images instead of returning an image suggestion only. Repeated page decoration and a cover image cannot substitute for body explanation. Preserve factual originals, concept disclosure and native business text; coordinate exact diagram/chart jobs with design rather than baking them into an illustrative image.

Keep one compact family specification/reference anchor for projection, optical size, shape, palette, light and people proportions. Vary subjects and composition purposefully rather than appending every result as a style reference. Use [style families](references/style-families.md), [pictograms](references/pictograms.md), [image production](references/image-production.md) or [prompt patterns](references/prompt-patterns.md) only for the current production issue. Dramatic light/texture/3D/color are available when useful; avoid making glossy floating objects, blank margins or pale cards universal defaults.

Native generation follows supported per-asset calls; do not invent seed/batch/style-lock parameters. Keep important titles, quantities, labels, conditions and meaningful arrows native in HTML. Explicit embedded text requires exact wording and actual inspection. Generated scenes never stand in for real facilities or completed activity. Detail crops from one image remain one source and cannot imply different sites/tests.

Inspect each actual returned image at intended size for subjects, relationships, palette/projection, transparency, focal/crop regions and unrequested additions. Inspect the integrated page when overlays affect meaning/readability. Report actual regions, not prompt-coordinate guesses. Repair only affected items using the stable anchor; preserve accepted original identity.

Copy usable outputs into the current project, normally html/assets. Return actual dimensions/format/transparency, source kind, prompts/reference roles, final paths and scoped review limits. Update delivery in the existing asset record and preserve unrelated fields. A preview/default generation directory alone is not a delivered asset. [Reference provenance](references/reference-index.md) is conditional; no need to load all ESG sources or an offline comparison helper for ordinary production.