get_page_image
Render a datasheet element, caption, region, or full page as a PNG image so an agent can read printed values; choose elements or regions at 300–600 dpi to limit input cost.
Instructions
The original as a PNG image: an element, a caption, a region or a full page. Read the values from this image. An element, a caption or a region is rendered at 300 to 600 dpi: prefer them, because a full page costs more input. A full page is correct for a table that fills the page. It is rendered at the resolution that fits max_px. Gives a line with the page, the region, the dpi and the size, and the image.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbox | No | Or a region [x0, y0, x1, y1] in pt, origin at the top left of the page (the units of get_page_map). Needs page. | |
| page | No | The page number, from 1. Not necessary with element. | |
| max_px | No | The maximum long edge of a full-page image in pixels (256 to 8000). 1600 is enough for a table that fills the page. Use more for small print or a fine drawing. | |
| caption | No | Or a caption label, for example "Table 57" or "Figure 3-1": the image shows this table or figure. A table that continues on the next pages gives one image for each page. | |
| element | No | An element ID from get_page_map or list_items, for example p7.T1: the image shows this element. | |
| document | Yes | The document: its reference from list_documents, project_status or add_document (the first 12 characters of its SHA-256). A longer SHA-256 prefix or the numeric document ID also works. |