플러그인 설치 및 관리 ​

플러그인은 HarmoFlow에 조작 패널이나 이미지 필터를 추가하는 기능입니다. 이 페이지에서는 전달받은 파일을 사용하는 방법을 설명합니다. 직접 만들려면 플러그인 만들기를, 처음부터 사용할 수 있는 색조 보정·톤 커브·그라데이션 맵은 기본 조정 기능을 참고하세요.

먼저 파일 형식 확인하기 ​

확장자가 같은 .lua라도 일반 스크립트와 플러그인용 확장은 다릅니다. 플러그인으로 추가하는 Lua에는 패널을 등록하는 hf.register_panel이 필요합니다. 일반 스크립트를 추가 화면에 전달해도 기대한 플러그인 패널이 만들어지지 않습니다.

추가부터 실행까지 ​

1. 상단의 “플러그인 → 플러그인 추가／보기...”를 엽니다.
2. “플러그인 추가...”에서 배포받은 .lua 또는 .dll을 선택합니다.
3. 파일이 앱의 저장 위치로 복사되고 로드가 시작됩니다. Lua 확장은 그리기와 진행 중인 다른 작업이 끝난 뒤 등록됩니다. 추가 완료가 표시되어도 Lua 확장 목록에서 등록 결과를 확인하세요.
4. 상단의 “플러그인” 메뉴를 다시 열고 등록된 항목을 선택합니다. 추가·찾아보기 화면은 관리용이며, 실행은 플러그인 메뉴에서 합니다.
5. 작은 테스트용 씬에서 처리 결과를 확인합니다. 레이어를 추가하는 확장이라면 레이어 목록에 의도한 결과가 만들어졌는지도 확인하세요.

추가한 파일은 다음 시작 시 로드 대상이 됩니다. 실행 메뉴에 항목이 없다면 정상적으로 로드되지 않을 때를 참고하세요.

현재 구현은 시작할 때 파일 이름순으로 앞의 Lua 파일 16개까지만 로드를 시도합니다. 실행 중에는 확장을 최대 32개까지 로드할 수 있지만, 재시작 후에도 모두 자동으로 로드하려면 extensions/ 바로 아래의 .lua 파일을 16개 이하로 유지하세요.

어디에 저장되나요? ​

앱에서 추가하면 HarmoFlow 실행 파일과 같은 위치에 있는 다음 폴더에 저장됩니다. 프로젝트 폴더에 넣는 파일이 아닙니다.

HarmoFlow 실행 파일이 있는 폴더/
├─ extensions/
│  └─ my_panel.lua
└─ plugins/
   └─ my_filter.dll

수동으로 배치할 때도 같은 위치를 사용합니다. 시작 시에는 각 폴더 바로 아래에 있는 파일을 검색합니다. ZIP 상태로 두거나 더 깊은 하위 폴더에 넣지 말고, 소문자 .lua／.dll 확장자를 사용하세요. 추가 화면에서 복사하면 확장자는 소문자로 통일됩니다.

추가 화면에는 같은 이름의 파일을 덮어쓰는 기능이 없습니다. 같은 이름이 이미 있다면 아래 업데이트 절차를 따르세요.

업데이트·삭제하기 ​

1. 씬을 저장하고 HarmoFlow를 종료합니다.
2. Lua 확장은 extensions/, DLL은 plugins/에서 해당 파일을 확인합니다.
3. 업데이트하려면 기존 파일을 다른 위치에 백업한 뒤 새 파일로 교체합니다. 더 이상 사용하지 않으려면 해당 폴더 밖으로 옮깁니다.
4. HarmoFlow를 다시 시작하고 목록의 로드 상태와 메뉴 항목을 확인합니다.

실행 중 다시 로드·언로드·삭제하는 전용 기능은 없습니다. 같은 DLL을 다시 로드하거나, 같은 패널 ID를 가진 Lua 확장을 다른 이름으로 추가해도 업데이트되지 않습니다. 백업 파일을 .dll／.lua 확장자 그대로 같은 폴더에 남겨 두면 시작 시 로드 대상이 되므로 다른 위치에 보관하세요.

정상적으로 로드되지 않을 때 ​

다른 사이트에서 출처가 불분명한 DLL을 찾아 추가하기 전에 배포처의 요구 사항을 확인하세요. 문제를 보고할 때는 HarmoFlow와 플러그인의 버전, 파일 이름, 표시된 오류, 추가한 절차를 함께 전달하면 원인을 찾기 쉽습니다.

다음에 읽기 ​

• 플러그인 만들기: Lua 최소 예제, DLL 구조, 테스트
• 기본 조정 기능: 색조 보정·톤 커브·그라데이션 맵
• 환경 설정과 Lua 스크립트