한국어

Erlang 예제

https://github.com/bobhyun/TS-ANPR/tree/main/examples/Erlang/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                        # 이미지 디렉토리
└── Erlang
    └── anpr                   # 프로젝트 디렉토리
       ├── c_src               # C NIF 소스 파일
       │   └── tsanpr_nif.c
       ├── src                 # Erlang 소스 파일
       │   ├── anpr_app.erl    # 애플리케이션 동작
       │   ├── anpr_sup.erl    # 슈퍼바이저 동작
       │   ├── anpr.erl        # 메인 모듈
       │   ├── tsanpr.erl      # NIF 래퍼 모듈
       │   └── anpr.app.src    # 애플리케이션 리소스 파일
       ├── priv                # 컴파일된 NIF 라이브러리
       │   └── tsanpr_nif.dll/.so
       ├── rebar.config        # rebar3 설정
       └── _build              # rebar3 빌드 출력 (생성됨)
          └── default
             └── lib
                └── anpr
                   ├── ebin    # 컴파일된 .beam 파일
                   └── priv    # NIF 라이브러리

2. 사전 요구사항

Erlang/OTP 설치 (버전 24 이상 권장)

Windows:

# https://www.erlang.org/downloads 에서 다운로드
# 또는 Chocolatey 사용
choco install erlang

Linux:

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install -y erlang

# Oracle Linux / RHEL / CentOS (8/9+)
sudo dnf install -y erlang || sudo yum install -y erlang
# 팁: 패키지가 없으면 EPEL 활성화 또는 Erlang Solutions 저장소 사용:
# https://www.erlang.org/downloads

# 또는 kerl 사용 (권장)
curl -O https://raw.githubusercontent.com/kerl/kerl/master/kerl
chmod a+x kerl
./kerl build 24.3 24.3
./kerl install 24.3 ~/erlang/24.3
# 현재 셸에 활성화
. ~/erlang/24.3/activate
# 비활성화: deactivate

rebar3 설치

Windows:

GitHub에서 최신 rebar3 escript 다운로드:

# 최신 rebar3 다운로드 (Erlang/OTP 28+ 호환)
Invoke-WebRequest -Uri "https://github.com/erlang/rebar3/releases/latest/download/rebar3" -OutFile "rebar3"
   
# rebar3를 프로젝트 디렉토리에 배치하거나 PATH의 디렉토리로 이동

참고: Windows에서는 escript rebar3 <명령어> 형식으로 실행해야 합니다 (rebar3 <명령어>가 아님).

Linux:

# Ubuntu/Debian
sudo apt-get install rebar3
   
# 또는 GitHub에서 최신 버전 다운로드
wget https://github.com/erlang/rebar3/releases/latest/download/rebar3
chmod +x rebar3
sudo mv rebar3 /usr/local/bin/

C 컴파일러 설치 (NIF 빌드에 필요)

Windows:
- C++ 개발 도구가 포함된 Visual Studio 설치, 또는
- MinGW-w64 설치: choco install mingw
Linux:
```
# Ubuntu/Debian
sudo apt-get install build-essential

# Fedora/CentOS
sudo yum groupinstall "Development Tools"
```

설치 확인

erl -version
rebar3 version
gcc --version  # Windows에서 Visual Studio 사용 시 cl.exe

3. 빌드 및 실행

Erlang 예제 디렉토리로 이동
```
cd examples/Erlang/anpr
```
NIF (Native Implemented Function) 라이브러리 빌드

Windows:

“x64 Native Tools Command Prompt for VS”를 열거나 vcvars64.bat를 실행한 후:
```
build_nif.bat
```
다음을 수행합니다:
- Erlang 설치 자동 감지
- MSVC를 사용하여 c_src/tsanpr_nif.c 컴파일
- priv/tsanpr_nif.dll 생성
Linux:
```
make priv/tsanpr_nif.so
```
다음을 수행합니다:
- gcc를 사용하여 c_src/tsanpr_nif.c 컴파일
- libdl을 적절히 링크하여 priv/tsanpr_nif.so 생성
Erlang 애플리케이션 빌드

Windows (escript 명령어 사용):
```
escript rebar3 compile
```
Linux:
```
rebar3 compile
```
다음을 수행합니다:
- Erlang 모듈(anpr.erl, tsanpr.erl)을 _build/default/lib/anpr/ebin/로 컴파일
- priv/의 NIF 라이브러리를 _build/default/lib/anpr/priv/로 복사

애플리케이션 실행

# 비대화형 모드
erl -pa _build/default/lib/anpr/ebin -noshell -eval "anpr:main()" -s init stop

# 대화형 모드
erl -pa _build/default/lib/anpr/ebin
1> anpr:main().

4. 참고사항

이 Erlang 구현은 다른 언어 예제들과 동일한 기능을 제공합니다
Erlang의 NIF(Native Implemented Functions)를 사용하여 네이티브 TSANPR 라이브러리와 인터페이스합니다
Erlang의 내결함성과 동시성 모델로 고가용성 시스템에 이상적입니다
Windows와 Linux에 대한 크로스 플랫폼 지원
참고: 이것은 데모 목적을 위한 단순화된 NIF 구현입니다

5. 기능

파일 기반 인식: 이미지 파일을 직접 처리
인코딩된 이미지 처리: 인코딩된 이미지 데이터 처리 (JPEG, PNG 등)
픽셀 버퍼 처리: 원시 픽셀 데이터 처리 (단순화된 구현)
다중 출력 형식: 텍스트, JSON, YAML, XML, CSV 출력 지원
다중 인식 모드: 단일 번호판, 다중 번호판, 차량 감지 등
관심 영역(RoI): 이미지 내 특정 영역 처리
다국가 지원: 다양한 번호판 형식 지원 (KR, JP, VN 등)

6. API 참조

tsanpr 모듈

tsanpr 모듈은 다음 함수들을 제공합니다:

초기화:

tsanpr:new(LibraryPath): 네이티브 라이브러리 경로로 초기화

핵심 함수:

tsanpr:anpr_initialize(Tsanpr, Mode): ANPR 엔진 초기화
tsanpr:anpr_read_file(Tsanpr, ImgFileName, OutputFormat, Options): 이미지 파일 처리
tsanpr:anpr_read_pixels(Tsanpr, Pixels, Width, Height, Stride, PixelFormat, OutputFormat, Options): 픽셀 데이터 처리

인식 옵션

"": 단일 번호판 인식 (기본값)
"vm": 차량에 부착된 다중 번호판 인식
"vmb": 차량에 부착된 다중 번호판 인식 (오토바이 포함)
"vms": 주변 감지와 함께 차량에 부착된 다중 번호판 인식
"dms": 다중 주변 객체 (차량) 인식
"dmsr": 다중 주변 객체 (차량)와 번호판 인식
"dmsri<좌표>": 관심 영역 내에서 인식

출력 형식

"text": 일반 텍스트 출력
"json": JSON 형식 출력
"yaml": YAML 형식 출력
"xml": XML 형식 출력
"csv": CSV 형식 출력

7. 문제 해결

라이브러리 로딩 문제:

TSANPR 라이브러리 경로가 올바른지 확인
모든 시스템 종속성이 설치되어 있는지 확인
라이브러리 권한이 올바른지 확인

NIF 문제:

이 예제는 데모를 위한 단순화된 NIF 접근 방식을 사용합니다
프로덕션 사용을 위해서는 적절한 C NIF를 구현해야 합니다
Erlang 개발 헤더가 설치되어 있는지 확인

플랫폼별 문제:

Windows: Visual C++ 재배포 가능 패키지가 설치되어 있는지 확인
Linux: 필요한 시스템 라이브러리를 설치하고 라이브러리 권한이 올바른지 확인