Zig Requires Chilkat v11.7.0+

Extract Right-to-Left (Hebrew, Arabic) Text in Logical Order

See more PDF Text Extraction Examples

Demonstrates the "bidi" clean-up option. PDFs draw right-to-left text in visual order (the order of the glyphs on the page); by default the extracted text is reordered into logical order, so that it reads and compares correctly. Set "bidi" to false to get the glyphs in the order they are drawn. Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    // The PDF used in this example is available at hebrew_line.pdf

    const pdf = try chilkat.Pdf.init();
    defer pdf.deinit();
    pdf.loadFile("qa_data/pdf/hebrew_line.pdf") catch {
        std.debug.print("{s}\n", .{try pdf.getLastErrorText(alloc)});
        return;
    };

    const json = try chilkat.JsonObject.init();
    defer json.deinit();
    const json_out = try chilkat.JsonObject.init();
    defer json_out.deinit();

    // The page has a line of Hebrew with a Latin word (PDF) and a number (2026) embedded in it.
    // In logical order the line reads: kovetz PDF mishnat 2026 muchan ("the PDF file from 2026 is ready"),
    // with the Hebrew words in reading order and "PDF" and "2026" kept left to right.
    pdf.extractText("text", json, json_out) catch {
        std.debug.print("{s}\n", .{try pdf.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("---- default (bidi: true, logical order) ----\n", .{});
    std.debug.print("{s}\n", .{try json_out.stringOf(alloc, "text")});

    // Without reordering, the Hebrew words come out reversed and in the opposite order, as drawn.
    json.updateBool("bidi", false) catch {};
    pdf.extractText("text", json, json_out) catch {
        std.debug.print("{s}\n", .{try pdf.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("---- bidi: false (as drawn) ----\n", .{});
    std.debug.print("{s}\n", .{try json_out.stringOf(alloc, "text")});

    // Sample output (the Hebrew is shown here transliterated):

    // ---- default (bidi: true, logical order) ----
    // Right-to-Left Text
    //
    // The line below is Hebrew with a Latin word and a number embedded in it:
    //
    // kovetz PDF mishnat 2026 muchan
    // ---- bidi: false (as drawn) ----
    // Right-to-Left Text
    //
    // The line below is Hebrew with a Latin word and a number embedded in it:
    //
    // nachum 2026 tanshim PDF ztevok    (the words in reverse order, each Hebrew word with its letters reversed)
}