Skip to content

RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.

13.1 KB
Raw Blame
//go:build cgo

// Package pdfparser provides pdf_oxide-based PDF types and functions.
//
// This file wraps github.com/yfedoseev/pdf_oxide/go (pdf_oxide) to provide
// pdfplumber-style character extraction, page rendering, and RAGFlow-compatible
// utility functions. It is maintained as a standalone adapter layer so that
// the pdfplumber compatibility code can be modified independently of the
// pdf_oxide backend.
//
// Originally derived from github.com/yingfeng/pdfplumber-go.

package pdfoxide

import (
	"fmt"
	"image"
	"image/color"
	"math"
	"sort"
	"strings"

	pdfoxide "github.com/yfedoseev/pdf_oxide/go"

	pdfsync "ragflow/internal/deepdoc/parser/pdf/pdfsync"
)

// ── pdf_oxide-based types ──────────────────────────────────────────

// Char represents a single character extracted from a PDF page,
// matching pdfplumber's char dict format.
type char struct {
	Text             string     `json:"text"`
	Fontname         string     `json:"fontname"`
	Size             float64    `json:"size"`
	X0               float64    `json:"x0"`
	X1               float64    `json:"x1"`
	Top              float64    `json:"top"`
	Bottom           float64    `json:"bottom"`
	Width            float64    `json:"width"`
	Height           float64    `json:"height"`
	Doctop           float64    `json:"doctop"`
	Matrix           [6]float64 `json:"matrix"`
	Upright          bool       `json:"upright"`
	StrokingColor    string     `json:"stroking_color"`
	NonStrokingColor string     `json:"non_stroking_color"`
	Ncs              string     `json:"ncs"`
	Adv              float64    `json:"adv"`
	PageNumber       int        `json:"page_number"`
}

// Document wraps pdf_oxide's PdfDocument with pdf_oxide-based methods.
type Document struct {
	Inner *pdfoxide.PdfDocument
}

// RenderResult holds the result of rendering a PDF page.
type RenderResult struct {
	Data     []byte
	Width    int
	Height   int
	Channels int
}

// ── Document methods ─────────────────────────────────────────────────────

// Open opens a PDF file from a file path.
func Open(path string) (*Document, error) {
	var doc *pdfoxide.PdfDocument
	var oerr error
	pdfsync.With(func() {
		doc, oerr = pdfoxide.Open(path)
	})
	if oerr != nil {
		return nil, fmt.Errorf("pdfplumber: open %s: %w", path, oerr)
	}
	return &Document{Inner: doc}, nil
}

// OpenBytes opens a PDF from raw bytes in memory.
func OpenBytes(data []byte) (*Document, error) {
	var doc *pdfoxide.PdfDocument
	var oerr error
	pdfsync.With(func() {
		doc, oerr = pdfoxide.OpenFromBytes(data)
	})
	if oerr != nil {
		return nil, fmt.Errorf("pdfplumber: open from bytes: %w", oerr)
	}
	return &Document{Inner: doc}, nil
}

// Close releases the document handle.
func (d *Document) Close() {
	if d.Inner != nil {
		pdfsync.With(func() {
			d.Inner.Close()
		})
		d.Inner = nil
	}
}

// PageCount returns the number of pages in the document.
func (d *Document) PageCount() (int, error) {
	if d.Inner == nil {
		return 0, fmt.Errorf("pdfplumber: document is closed")
	}
	var n int
	var perr error
	pdfsync.With(func() {
		n, perr = d.Inner.PageCount()
	})
	if perr != nil {
		return 0, perr
	}
	return n, nil
}

// PageSize returns the pre-rotation page dimensions from pdf_oxide in PDF
// points (1/72 inch).  For a page with /Rotate 90, this returns the original
// (unrotated) MediaBox dimensions — not the post-rotation visual size.
// Compare with pdfium.PageSize to detect rotation.
func (d *Document) PageSize(pageIdx int) (width, height float64, err error) {
	if d.Inner == nil {
		return 0, 0, fmt.Errorf("pdfplumber: document is closed")
	}
	pdfsync.With(func() {
		info, e := d.Inner.PageInfo(pageIdx)
		if e != nil {
			err = e
			return
		}
		width, height = float64(info.Width), float64(info.Height)
	})
	return
}

// GetPageChars returns all characters on a page (0-indexed).
//
// The whole body runs under pdfsync.Mu so the native ExtractChars / PageInfo
// calls never interleave with pdfium (the two bindings share one PDFium
// instance). Note it calls d.Inner.PageCount() directly rather than the
// guarded Document.PageCount, because this method already holds the lock and
// sync.Mutex is not reentrant.
func (d *Document) GetPageChars(pageIdx int) (chars []char, err error) {
	if d.Inner == nil {
		return nil, fmt.Errorf("pdfplumber: document is closed")
	}
	pdfsync.With(func() {
		n, e := d.Inner.PageCount()
		if e != nil {
			err = fmt.Errorf("pdfplumber: page count: %w", e)
			return
		}
		if pageIdx < 0 || pageIdx >= n {
			err = fmt.Errorf("pdfplumber: page index %d out of range (pages: %d)", pageIdx, n)
			return
		}
		raw, e := d.Inner.ExtractChars(pageIdx)
		if e != nil {
			err = fmt.Errorf("pdfplumber: extract chars page %d: %w", pageIdx, e)
			return
		}

		// pdf_oxide returns Y in PDF coordinate system (origin bottom-left, Y↑).
		// Python pdfplumber internally flips to top-left origin (Y↓), matching
		// "top" = distance from page top.  We replicate that here so that
		// FinalReadingOrderMerge produces top-to-bottom reading order.
		info, e := d.Inner.PageInfo(pageIdx)
		if e != nil {
			err = fmt.Errorf("pdfplumber: page info %d: %w", pageIdx, e)
			return
		}
		// Page height: use CropBox (matches pdfplumber's page.height).
		// pdf_oxide bbox: [baseline, baseline + font_size] — no descent
		// below baseline.  pdfplumber bbox: [baseline - descent, baseline
		// + ascent].  Both have height = font_size, but the Y origin
		// differs.  We keep the raw pdf_oxide bbox and sort by Bottom
		// (= pageHeight - c.Y) in groupCharsToLines so all chars on the
		// same baseline share the same sort key regardless of font size.
		pageHeight := float64(info.CropBox.Height)
		if pageHeight <= 0 {
			pageHeight = float64(info.Height) // fallback
		}

		chars = make([]char, len(raw))
		for i, c := range raw {
			x0 := float64(c.X)
			fs := float64(c.FontSize)
			top := pageHeight - float64(c.Y) - float64(c.Height)
			w := float64(c.Width)
			h := float64(c.Height)
			chars[i] = char{
				Text:             string(c.Char),
				Fontname:         c.FontName,
				Size:             fs,
				X0:               x0,
				X1:               x0 + w,
				Top:              top,
				Bottom:           top + h,
				Width:            w,
				Height:           h,
				Doctop:           top,
				Matrix:           [6]float64{fs, 0, 0, fs, x0, top},
				Upright:          true,
				StrokingColor:    "",
				NonStrokingColor: "",
				Ncs:              "",
				Adv:              fs * 0.5,
				PageNumber:       pageIdx + 1,
			}
		}
	})
	return
}

// GetDedupePageChars returns deduplicated characters on a page (0-indexed).
// tolerance controls how close two chars must be to be considered duplicates.
func (d *Document) GetDedupePageChars(pageIdx int, tolerance float64) ([]char, error) {
	chars, err := d.GetPageChars(pageIdx)
	if err != nil {
		return nil, err
	}
	return dedupeChars(chars, tolerance), nil
}

// GetPageText extracts plain text from a page (0-indexed), in reading order (top → x0).
func (d *Document) GetPageText(pageIdx int) (string, error) {
	chars, err := d.GetPageChars(pageIdx)
	if err != nil {
		return "", err
	}
	if len(chars) == 0 {
		return "", nil
	}
	sorted := make([]char, len(chars))
	copy(sorted, chars)
	sort.Slice(sorted, func(i, j int) bool {
		if sorted[i].Top != sorted[j].Top {
			return sorted[i].Top < sorted[j].Top
		}
		return sorted[i].X0 < sorted[j].X0
	})
	var b strings.Builder
	for i, c := range sorted {
		b.WriteString(c.Text)
		if i+1 < len(sorted) {
			next := sorted[i+1]
			if math.Abs(next.Top-c.Top) < 0.5 {
				gap := next.X0 - c.X1
				if gap > c.Width*0.3 {
					b.WriteByte(' ')
				}
			} else {
				b.WriteByte('\n')
			}
		}
	}
	return b.String(), nil
}

// ── Deduplication ────────────────────────────────────────────────────────
func dedupeChars(chars []char, tolerance float64) []char {
	if len(chars) == 0 {
		return nil
	}

	// Sort by X0 so we only need a sliding window of nearby chars.
	sorted := make([]char, len(chars))
	copy(sorted, chars)
	sort.Slice(sorted, func(i, j int) bool { return sorted[i].X0 < sorted[j].X0 })

	result := make([]char, 0, len(sorted))
	// maxCharWidth is the maximum X-span we've seen; chars further apart
	// than this cannot overlap. Update as we go.
	maxCharWidth := 0.0

	for _, ch := range sorted {
		cw := ch.X1 - ch.X0
		if cw > maxCharWidth {
			maxCharWidth = cw
		}

		dup := false
		// Only scan backwards within maxCharWidth; chars further away
		// cannot possibly overlap.
		for i := len(result) - 1; i >= 0; i-- {
			existing := &result[i]
			if ch.X0-existing.X1 > maxCharWidth {
				break // too far left to overlap
			}
			ox := math.Max(0, math.Min(ch.X1, existing.X1)-math.Max(ch.X0, existing.X0))
			oy := math.Max(0, math.Min(ch.Bottom, existing.Bottom)-math.Max(ch.Top, existing.Top))
			oa := ox * oy
			if oa <= 0 {
				continue
			}
			ca := cw * (ch.Bottom - ch.Top)
			ea := (existing.X1 - existing.X0) * (existing.Bottom - existing.Top)
			maxA := math.Max(ca, ea)
			ratio := oa / maxA
			sameFont := ch.Fontname == existing.Fontname
			sameSize := math.Abs(ch.Size-existing.Size) <= tolerance
			if ratio > 0.5 && sameFont && sameSize {
				dup = true
				break
			}
		}
		if !dup {
			result = append(result, ch)
		}
	}
	return result
}

// ── Rendering ────────────────────────────────────────────────────────────

// RenderPage renders a PDF page to RGBA pixels using pdf_oxide.
// pdfData must be the raw PDF bytes, pageIdx is 0-based, dpi is the resolution.
// Prefer Document.RenderPage when you already have an open Document to avoid re-parsing.
func RenderPage(pdfData []byte, pageIdx int, dpi float64) (*RenderResult, error) {
	if len(pdfData) == 0 {
		return nil, fmt.Errorf("pdfplumber: empty PDF data for rendering")
	}
	var res *RenderResult
	var rerr error
	pdfsync.With(func() {
		doc, e := pdfoxide.OpenFromBytes(pdfData)
		if e != nil {
			rerr = fmt.Errorf("pdfplumber: open for render: %w", e)
			return
		}
		defer doc.Close()
		res, rerr = renderPageFromDoc(doc, pageIdx, dpi)
	})
	return res, rerr
}

// RenderPage renders a single page using the already-open document.
// Unlike the standalone RenderPage function, this reuses the open handle
// and does not re-parse the PDF on every call.
func (d *Document) RenderPage(pageIdx int, dpi float64) (*RenderResult, error) {
	if d.Inner == nil {
		return nil, fmt.Errorf("pdfplumber: document is closed")
	}
	var res *RenderResult
	var rerr error
	pdfsync.With(func() {
		res, rerr = renderPageFromDoc(d.Inner, pageIdx, dpi)
	})
	return res, rerr
}

// renderPageFromDoc is the shared rendering core: calls RenderPageRaw and
// converts premultiplied alpha to straight alpha.
func renderPageFromDoc(doc *pdfoxide.PdfDocument, pageIdx int, dpi float64) (*RenderResult, error) {
	pixmap, err := doc.RenderPageRaw(pageIdx, int(math.Round(dpi)))
	if err != nil {
		return nil, fmt.Errorf("pdfplumber: render page %d: %w", pageIdx, err)
	}

	data := make([]byte, len(pixmap.Data))
	for i := 0; i < len(pixmap.Data); i += 4 {
		a := pixmap.Data[i+3]
		if a == 0 {
			data[i], data[i+1], data[i+2], data[i+3] = 0, 0, 0, 0
		} else {
			data[i] = uint8(math.Min(255, float64(pixmap.Data[i])*255/float64(a)))
			data[i+1] = uint8(math.Min(255, float64(pixmap.Data[i+1])*255/float64(a)))
			data[i+2] = uint8(math.Min(255, float64(pixmap.Data[i+2])*255/float64(a)))
			data[i+3] = a
		}
	}
	return &RenderResult{Data: data, Width: pixmap.Width, Height: pixmap.Height, Channels: 4}, nil
}

// InitRenderer is a no-op for pdf_oxide (renderer is initialized internally).
func InitRenderer(path string) error { return nil }

// ToImage converts a RenderResult to an image.RGBA.
func (r *RenderResult) ToImage() *image.RGBA {
	img := image.NewRGBA(image.Rect(0, 0, r.Width, r.Height))
	copy(img.Pix, r.Data)
	return img
}

// ColorModel implements image.Image.
func (r *RenderResult) ColorModel() color.Model { return color.RGBAModel }

// Bounds implements image.Image.
func (r *RenderResult) Bounds() image.Rectangle { return image.Rect(0, 0, r.Width, r.Height) }

// At implements image.Image.
func (r *RenderResult) At(x, y int) color.Color {
	if x < 0 || x >= r.Width || y < 0 || y >= r.Height {
		return color.RGBA{}
	}
	idx := (y*r.Width + x) * r.Channels
	if r.Channels >= 4 {
		return color.RGBA{R: r.Data[idx], G: r.Data[idx+1], B: r.Data[idx+2], A: r.Data[idx+3]}
	}
	return color.RGBA{R: r.Data[idx], G: r.Data[idx+1], B: r.Data[idx+2], A: 255}
}

// ── Utility ──────────────────────────────────────────────────────────────

// TotalPageNumber opens a PDF and returns the page count.
func TotalPageNumber(path string, data []byte) (int, error) {
	var doc *Document
	var err error
	if data != nil {
		doc, err = OpenBytes(data)
	} else {
		doc, err = Open(path)
	}
	if err != nil {
		return 0, err
	}
	defer doc.Close()
	return doc.PageCount()
}