日本語

Pony サンプル

https://github.com/bobhyun/TS-ANPR/tree/main/examples/Pony/anpr

1. エンジンファイルのコピー

[注意] このサンプルでは、他のサンプルと共有するためにエンジンファイルをexamples/bin/ディレクトリに展開します。ただし、実際のデプロイでは、通常、アプリケーションの実行ファイルがあるディレクトリにエンジンファイルをコピーします。

Windows x86 64ビットの場合エンジンファイルをexamples/bin/windows-x86_64ディレクトリに展開します
```
7z x tsanpr*-windows-x86_64.7z
```
Windows x86 32ビットの場合エンジンファイルをexamples/bin/windows-x86ディレクトリに展開します
```
7z x tsanpr*-windows-x86.7z
```
Linux x86 64ビットの場合エンジンファイルをexamples/bin/linux-x86_64ディレクトリに展開します
```
tar xvf tsanpr-linux-x86_64.tar.xz
```
Linux arm 64ビットの場合エンジンファイルをexamples/bin/linux-aarch64ディレクトリに展開します
```
tar xvf tsanpr-linux-aarch64.tar.xz
```

ディレクトリ構造

examples
├── bin
│   ├─── windows-x86_64        # Windows (x86_64)用エンジンディレクトリ
│   │   ├── tsanpr.dll
│   │   ├── tsanpr-2505M.eon
│   │   └── tshelper.exe
│   ├─── windows-x86           # Windows (x86)用エンジンディレクトリ
│   │   ├── tsanpr.dll
│   │   ├── tsanpr-2505M.eon
│   │   └── tshelper.exe
│   ├── linux-x86_64           # Linux (x86_64)用エンジンディレクトリ
│   │   ├── libtsanpr.so
│   │   ├── tsanpr-2505M.eon
│   │   └── tshelper
│   └── linux-aarch64          # Linux (arm64)用エンジンディレクトリ
│       ├── libtsanpr.so
│       ├── tsanpr-2505M.eon
│       └── tshelper
├── img                        # 画像ディレクトリ
└── Pony
    └── anpr                   # プロジェクトディレクトリ
       ├── src/                # メインパッケージ
       │   ├── main.pony
       │   └── tsanpr.pony
       ├── ffi/                # C FFIラッパー
       │   ├── tsanpr_wrapper.c
       │   ├── tsanpr_wrapper.h
       │   ├── image_loader.c
       │   └── stb_image.h
       └── Makefile

2. 前提条件

Ponyコンパイラのインストール

Ubuntu/Debian:

# ponyupを使用（推奨）
curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/ponylang/ponyup/latest-release/ponyup-init.sh | sh
source ~/.profile
ponyup update ponyc release

macOS:

brew install ponyc

Windows:

# Chocolateyを使用
choco install ponyc

# または https://github.com/ponylang/ponyc/releases からダウンロード

Cコンパイラのインストール（GCCまたはClang）

Ubuntu/Debian:
```
sudo apt-get install build-essential
```
macOS:
```
xcode-select --install
```
Windows:
- Visual Studio Build ToolsまたはMinGW-w64をインストール
インストールの確認
```
ponyc --version
gcc --version
```

3. 実行方法

cd examples/Pony/anpr

# ビルドして実行
make run

# ビルドのみ
make

# リリースバージョンをビルド
make release

# ビルド成果物をクリーン
make clean

4. 機能

readImageFile: anpr_read_file()を使用して画像ファイルを直接処理
readEncodedImage: ‘encoded’形式でanpr_read_pixels()を使用してエンコードされた画像バイトを処理
readPixelBuffer: stb_imageライブラリを使用して生のRGBピクセルデータを処理
動的ロード: TSANPRライブラリはdlopen/LoadLibraryを使用して実行時にロード
クロスプラットフォーム: WindowsとLinux（x86_64、ARM64）をサポート

5. APIリファレンス

TSANPRクラス

class TSANPR
  new create(library_path: String) ?
  fun ref initialize(mode: String): String
  fun ref read_file(img_file_name: String, output_format: String, options: String): String
  fun ref read_pixels(pixels: Array[U8] val, width: U64, height: U64, stride: I64,
                     pixel_format: String, output_format: String, options: String): String

認識オプション

オプション	説明
`""`	単一ナンバープレート認識（デフォルト）
`"vm"`	車両に取り付けられた複数のナンバープレートを認識
`"vmb"`	複数のナンバープレートを認識（バイクを含む）
`"vms"`	サラウンド検出付きで認識
`"dms"`	複数の周囲オブジェクト（車両）を検出
`"dmsr"`	オブジェクトを検出してナンバープレートを認識
`"dmsri<coords>"`	関心領域内で認識

出力形式

"text", "json", "yaml", "xml", "csv"

6. 実装に関する注意事項

このサンプルでは、動的ライブラリのロードと画像処理のためにCラッパーを使用しています：

動的ライブラリロード（tsanpr_wrapper.c）:

Linux: libdlのdlopen()、dlsym()、dlclose()を使用
Windows: kernel32のLoadLibrary()、GetProcAddress()、FreeLibrary()を使用

画像処理（image_loader.c）:

画像デコードのためにstb_imageシングルヘッダーライブラリを使用
画像をロードしてANPRを直接呼び出す便利関数image_anpr_read()を提供

PonyコードはFFIを通じてCラッパー関数を呼び出し、Cラッパー関数は動的にロードされたTSANPRライブラリ関数を呼び出します。