.bbart 아트 라이브러리

.bbart 파일은 프로젝트 간에 재사용하려는 아트 클립 모음입니다. 로고, 장식, 공통 도형, 캡처한 선택 영역 등을 저장할 수 있습니다. 아트 라이브러리 패널에서 파일을 불러오고 편집할 수 있습니다.

단일 진행 중 디자인을 나타내는 .lzrproj 프로젝트와 달리, .bbart 파일은 공유, 버전 관리 및 재사용을 위해 구성된 라이브러리입니다.

포함된 내용

항목 종류

• 외부 파일: 원본 이미지 또는 벡터 파일을 참조합니다. 항목에는 원본 바이트가 포함되며, 라이브러리 내에서는 콘텐츠 해시를 기준으로 중복이 제거됩니다.
• 선택 영역 스냅샷: 프로젝트에서 캡처한 선택 영역을 평탄화한 버전입니다. 텍스트는 도형으로 평탄화되므로 수신자에게 글꼴 종속성이 없습니다. 나중에 다시 편집할 수 있도록 source_text_metadata를 포함합니다.

썸네일

각 항목에는 파일에 포함된 프론트엔드 생성 썸네일이 있습니다. 라이브러리를 불러올 때 실시간 렌더링이 필요하지 않습니다.

중복 제거

하나의 .bbart 파일에서는 콘텐츠 해시가 동일한 래스터 바이트를 한 번만 저장하고 여러 항목에서 참조합니다. 동일한 이미지를 여러 항목으로 다시 가져올 때 파일 크기를 줄일 수 있습니다.

읽기 및 쓰기 방법

• GUI: 아트 라이브러리 패널에서 라이브러리를 생성, 불러오기, 저장, 가져오기 및 내보내기할 수 있습니다.
• CLI: 현재 제공되지 않습니다.

.bbart 파일은 Beam Bench에서 열리며 편집하는 동안 메모리에 유지됩니다. 즉시 디스크 반영: 변경 작업을 수행할 때마다 즉시 디스크에 기록됩니다. 디스크 쓰기에 실패하면 메모리 내 변경 사항은 유지되고 라이브러리에 save_error가 설정되며, 다시 시도할 때까지 삭제 작업이 차단됩니다.

레거시 JSON에서 마이그레이션

레거시 앱 데이터의 *.json 라이브러리는 처음 실행할 때 같은 디렉터리의 .bbart 파일로 자동 마이그레이션됩니다. 원본 .json 파일은 그대로 유지됩니다.

라이브러리 공유

.bbart 파일은 이식할 수 있습니다. 이메일로 보내거나 업로드하면 수신자가 아트 라이브러리 패널 → 불러오기를 통해 열 수 있습니다.

두 .bbart 파일이 동일한 library_id를 공유하는 경우(예: 하나를 복사한 경우), 두 번째로 불러온 파일은 재매핑되고 새 ID가 발급되며 파일이 다시 기록되고 경고가 표시됩니다. 이렇게 하면 ID 충돌이 조용히 발생하는 것을 방지할 수 있습니다.

예외 상황

• 저장에 실패하면(파일 권한, 잠긴 파일 또는 디스크 용량 부족) 라이브러리에 저장 오류가 표시되고 다음 저장이 성공할 때까지 삭제 작업이 비활성화됩니다. 상태가 조용히 롤백되지는 않습니다.
• 디스크에서 .bbart 파일 이름을 변경해도 표시 이름만 변경됩니다. library_id와 콘텐츠는 그대로 유지됩니다.
• 두 파일의 표시 이름이 같아도 library_id가 서로 다르면 문제가 없습니다.

관련 문서

• 아트 라이브러리 패널
• Beam Bench 프로젝트 파일