Spatial

Spatial commands query document content based on physical position on a page. Find nodes within a bounding box region or list all bounding boxes on a page.

Subcommands

Command	Description
`spatial find`	Find nodes within a bounding box region
`spatial bbox`	List bounding boxes for nodes on a page

Spatial Find

Find content nodes within a rectangular region on a specific page.

kdx document spatial find <file.kddb> --page N --region x1,y1,x2,y2 [flags]

Flags

Flag	Description	Default
`--page N`	Page number (1-based, required)
`--region x1,y1,x2,y2`	Region coordinates (required)
`--type`	Filter by node type
`--tag`	Filter by tag name
`--max N`	Maximum results	0 (unlimited)
`--pretty`	Pretty-print JSON output	false

Example

kdx document spatial find doc.kddb --page 1 --region 0,0,300,100 --type line

{"nodeId":15,"type":"line","content":"Invoice Number: INV-2024-001","page":1,"bbox":{"x1":72,"y1":50,"x2":280,"y2":62}}
{"nodeId":16,"type":"line","content":"Date: January 15, 2024","page":1,"bbox":{"x1":72,"y1":65,"x2":250,"y2":77}}

Spatial Bbox

List all bounding boxes on a page, useful for understanding page layout.

kdx document spatial bbox <file.kddb> --page N [flags]

Flags

Flag	Description	Default
`--page N`	Page number (1-based, required)
`--type`	Filter by node type
`--pretty`	Pretty-print JSON output	false

Example

kdx document spatial bbox doc.kddb --page 1 --type line --pretty

{
  "nodeId": 15,
  "type": "line",
  "content": "Invoice Number: INV-2024-001",
  "x1": 72.0,
  "y1": 50.0,
  "x2": 280.0,
  "y2": 62.0
}

Use spatial find to extract content from specific regions of a page, such as headers, footers, or specific form fields.

Use spatial bbox to understand the layout of a page before targeting specific regions with spatial find.

Delta Native Files

⌘I

Getting Started

Core Operations

Sync & GitOps

Operational Commands

Document Commands

Subcommands

Spatial Find

Flags

Example

Spatial Bbox

Flags

Example

​Subcommands

​Spatial Find

​Flags

​Example

​Spatial Bbox

​Flags

​Example

Subcommands

Spatial Find

Flags

Example

Spatial Bbox

Flags

Example