pdf_load

PDF ファイルをロード

pdf_load "path" [, "password"], var_hid

"path"   : 開く PDF ファイルのパス
"password": 暗号化 PDF のパスワード (省略可)
var_hid  : ハンドル (>=0) または負のエラーコードを受け取る変数

(プラグイン / モジュール : hsppdf.dll)

解説

指定パスの PDF を開きます。成功するとハンドル (0..15) が返ります。
16 スロットが全て使用中なら -1、ファイルが開けないか PDF として
不正なら -10、stub ビルド時は -100 が返ります。

エラーコード:
  -1   : ハンドル満杯
 -10   : FPDF_LoadDocument 失敗 (ファイル無し / 破損 / password 不一致)
-100   : PDFium が vendor されていない (stub ビルド)

関連項目

pdf_closeハンドルを解放(hsppdf.dll)
pdf_page_countページ数を取得(hsppdf.dll)

情報

プラグイン / モジュールhsppdf.dll
バージョン1.0
作成日2026-04-15
著作者IronHSP / hsppdf
URLhttps://github.com/inovia/IronHSP
備考hsppdf.dll は Google PDFium (bblanchon/pdfium-binaries の prebuilt ~7 MB)
を embed した薄いプラグインです。HSP から PDF ファイルを開き、ページ数
の取得、ラスタライズ (ビットマップ化)、テキスト抽出、メタデータ参照が
できます。

PDFium 本体 (pdfium.dll) は別途 bblanchon のリリースから DL して
hsppdf.dll と同じディレクトリに配置する必要があります。詳しくは
plugins/win32/hsppdf/third_party/pdfium/README.md を参照してください。
プラグイン未配置時は stub として全関数が -100 / 空文字を返します。

HSP からは package/win32/common/iron_pdf.hsp を include して
pdf_open / pdf_draw / pdf_text 等の糖衣 API を使うのが推奨です。
本ヘルプは生 API の説明です。

ドキュメントハンドルは 16 並列まで同時に保持できます。使い終わった
ものは pdf_close で解放してください。

iron_ai との連携で PDF 要約を書く場合は、pdf_page_count で全ページ数を
取り、pdf_get_text を順に呼んで CP_ACP 文字列を結合してから
ai_chat / ai_complete に投げます (iron_ai 側で chunk 分割が必要な場合あり)。
タイプ拡張命令
グループhsppdf ― ドキュメント
対応環境
  • その他 : Win32 / Win64
hs ファイルhsphelp\hsppdf.hs