Package Guide

TtalkkagFlow 패키지 설치 및 관리 가이드입니다.

Overview

패키지는 TtalkkagFlow의 기능을 확장하는 모듈입니다. 패키지 매니저를 통해 손쉽게 설치, 활성화/비활성화, 삭제할 수 있습니다.

내 문서/

└── TtalkkagFlow/

└── packages.json (패키지 상태 저장)

---

Download

패키지 파일은 .jsx 또는 .jsxbin 형식으로 제공됩니다.

패키지	설명	다운로드
GroupAndGroup	레이어 그룹화 및 관리	Download
NullTracking	가상 카메라 트래킹 시스템	Download
AlignMaster	레이어 정렬 도구	준비중
DynamicPalette	동적 컬러 팔레트	준비중
FileManager	파일 관리 도구	준비중
FontManager	폰트 관리 도구	준비중
PresetLibrary	프리셋 라이브러리	준비중

---

How to Install

Package Manager

Inactive Packages

MyPackage.jsx

Active Packages

MyPackage.jsx

Add Package

Delete

Double Click!

→

Inactive에서 더블클릭 → Active로 이동하여 활성화

1. 패키지 매니저 열기

TtalkkagFlow 앱에서 패키지 매니저를 엽니다.

메뉴 → Package Manager

2. 패키지 추가

1. Add Package 버튼 클릭
2. 다운로드한 .jsx 또는 .jsxbin 파일 선택
3. 패키지가 Inactive Packages 목록에 추가됨

3. 패키지 활성화

• Inactive Packages 목록에서 패키지를 더블클릭
• 패키지가 Active Packages로 이동하며 UI가 생성됨

4. 패키지 비활성화

• Active Packages 목록에서 패키지를 더블클릭
• 패키지가 Inactive Packages로 이동하며 UI가 제거됨

---

Package Manager UI

영역	설명
Inactive Packages	비활성화된 패키지 목록
Active Packages	활성화된 패키지 목록
Add Package	새 패키지 파일 추가
Delete Selected	선택한 패키지 삭제
Refresh	목록 새로고침
Close	창 닫기

---

패키지 상태 저장

패키지 활성화 상태는 자동으로 저장됩니다.

[
  {
    "name": "GroupAndGroupPackage",
    "path": "/path/to/GroupAndGroupPackage.jsx",
    "active": true
  },
  {
    "name": "NullTrackingPackage",
    "path": "/path/to/NullTrackingPackage.jsx",
    "active": false
  }
]

• 앱 재시작 시 활성화된 패키지가 자동으로 로드됩니다.
• 저장 위치: 내 문서/TtalkkagFlow/packages.json

---

패키지 개발

직접 패키지를 개발하려면 다음 규격을 따라야 합니다.

필수 구조

var MyPackage = (function () {
    function info() {
        return {
            packageName: "My Package",    // 표시 이름
            version: "1.0.0",             // 버전
            des: "패키지 설명"             // 설명
        };
    }

    function createPanelUI(parent) {
        // parent에 UI 요소 추가
        var panel = parent.add("group");
        panel.add("button", undefined, "버튼");
        return panel;
    }

    return {
        createPanelUI: createPanelUI,
        info: info()
    };
})();

필수 요소

요소	타입	설명
info	Object	패키지 메타데이터
info.packageName	String	패키지 표시 이름
info.version	String	버전 문자열
info.des	String	패키지 설명
createPanelUI(parent)	Function	UI 생성 함수 (필수)

파일명 규칙

파일명과 내부 변수명이 일치해야 합니다.

• MyPackage.jsx → var MyPackage = ...

---

주의사항

중복 등록 불가

동일 경로의 패키지는 중복 등록할 수 없습니다.

createPanelUI 필수

createPanelUI 함수가 없으면 패키지 로드에 실패합니다.

앱 재시작

패키지 파일 수정 후에는 앱 재시작 또는 Refresh가 필요합니다.

---

에러 메시지

상황	메시지
저장 파일 없음	"저장 파일이 없어서 빈 파일을 생성했습니다."
파일 읽기 실패	"[loadSavedPackages] 파일 읽기 실패: ..."
JSON 파싱 실패	"Error loading save file"
createPanelUI 없음	"[loadSavedPackages] createPanelUI 없음: ..."
중복 패키지	"Package already registered (duplex memory)"