내보내기

Spine은 하나의 이미지, 여러 개의 이미지, 비디오, JSON 또는 바이너리 데이터를 내보낼 수 있습니다.

Export 대화창을 열려면 ctrl+E(Mac에서는 cmd+E)를 누르거나 Spine의 왼쪽 위에 있는 Spine 로고를 클릭하고 메뉴에서 Export를 선택하세요.

JSON

Spine은 모든 뼈대 데이터를 JSON으로 내보낼 수 있습니다. 이 데이터는 Spine 런타임으로 로드하고 Spine에서와 같은 방식으로 애플리케이션에서 표시할 수 있습니다.

JSON은 바이너리에 비해 몇 가지 장점이 있습니다. Spine 내보내기 포맷에 대한 대부분의 변경사항은 이전에 내보낸 JSON 데이터를 무효화하지 않습니다. JSON은 또한 사람이 읽을 수 있고 코드가 파싱하기도 쉽습니다. 단점은 JSON 데이터의 용량이 크고 데이터 파싱이 느리다는 점입니다.

JSON 데이터 내보내기에 대한 자세한 정보는 JSON 포맷을 참조하세요.

  • Output folder 프로젝트에 있는 각 뼈대의 JSON 파일이 이 폴더에 생성됩니다. 파일 이름에는 뼈대의 이름을 사용합니다.
  • Extension JSON 파일은 이 파일 확장자를 사용합니다.
  • Format Spine은 약간 더 작고, 읽기 쉽고, 편집하기 쉬운 JSON 같은 포맷으로 기록할 수도 있습니다.
    • JSON 표준 JSON입니다.
    • JavaScript JSON과 같지만 이름은 필요한 경우에만 따옴표 처리됩니다. 출력물은 유효한 JavaScript입니다.
    • Minimal JSON과 같지만 이름과 값은 rnt 또는 space를 포함하지 않고 /{}[]:,"로 시작하지 않을 경우에만 따옴표 처리됩니다. 또한 이름은 :을 포함할 수 없고, 값은 }],를 포함할 수 없습니다. 이 포맷은 libgdx와 같은 리니언트 JSON 파서가 필요합니다. .
  • Nonessential data 이 옵션을 체크하면 뼈대를 렌더링하는 데 필요하지 않은 추가적인 데이터가 JSON 데이터에 포함됩니다. 이 때문에 파일 크기가 약간 커집니다. 이 데이터는 JSON 데이터를 Spine으로 다시 가져올 때 필요합니다. 자세한 정보는 가져오기를 참조하세요.
  • Pretty print 이 옵션을 체크하면 JSON의 서식이 깔끔하게 정리되어 사람이 읽기 쉬워집니다. 이 때문에 파일 크기가 약간 커집니다.
  • Create atlas 이 옵션을 체크하면 뼈대에 사용된 이미지가 텍스처 아틀라스에 포함됩니다. 이 기능은 편리하지만 텍스처 패커를 별도로 실행하면 패킹을 더 많이 제어할 수 있습니다. 자세한 정보는 텍스처 패킹을 참조하세요.

바이너리

Spine은 모든 뼈대 데이터를 바이너리로 내보낼 수 있습니다. 이 데이터는 Spine 런타임으로 로드하고 Spine에서와 같은 방식으로 애플리케이션에서 표시할 수 있습니다.

바이너리는 JSON에 비해 몇 가지 장점이 있습니다. 크기가 작고 코드별로 빠르게 파싱할 수 있지만, 사람이 읽을 수는 없습니다. 단점은 Spine 내보내기 포맷을 변경할 경우 이전에 내보낸 모든 바이너리 데이터가 무효화되고 다시 내보내기를 해야 한다는 점입니다.

바이너리 데이터 내보내기에 관한 자세한 정보는 바이너리 포맷을 참조하세요.

  • Output folder 프로젝트에 있는 각 뼈대의 바이너리 파일이 이 폴더에 생성됩니다. 파일 이름에는 뼈대의 이름을 사용합니다.
  • Extension 바이너리 파일은 이 파일 확장자를 사용합니다.
  • Nonessential data 이 옵션을 체크하면 뼈대를 렌더링하는 데 필요하지 않은 추가적인 데이터가 바이너리 데이터에 포함됩니다. 이 때문에 파일 크기가 약간 커집니다. 이 데이터는 바이너리 데이터를 Spine으로 다시 가져올 때 필요합니다. 자세한 정보는 가져오기를 참조하세요.
  • Create atlas 이 옵션을 체크하면 뼈대에 사용된 이미지가 텍스처 아틀라스에 포함됩니다. 이 기능은 편리하지만 텍스처 패커를 별도로 실행하면 패킹을 더 많이 제어할 수 있습니다. 자세한 정보는 텍스처 패킹을 참조하세요.

GIF

Spine은 이미지를 인터넷에 공유하기 쉽도록 움직이는 GIF를 내보낼 수 있습니다. GIF는 256색만으로 이루어진 이미지 포맷으로서 반투명도를 지원하지 않기 때문에 화질 저하가 나타날 수 있습니다.

  • Type 수행할 내보내기 유형입니다.
    • Sequence 현재 애니메이션을 움직이는 GIF로 내보냅니다.
    • Frame 현재 뼈대 포즈를 정지 GIF로 내보냅니다.
  • Output file 기록할 GIF 파일입니다.
  • Images 이 옵션을 체크하면 뼈대 이미지가 렌더링됩니다.
  • Bones 이 옵션을 체크하면 뼈대의 뼈가 렌더링됩니다.
  • Background 사용할 배경색입니다.
  • Transparency 이 옵션을 체크하면 완전히 투명한 픽셀이 배경색 없이 투명해집니다. GIF는 반투명도를 지원하지 않기 때문에 부분적으로 투명한 픽셀은 여전히 배경색을 사용합니다.
  • Quality 높은 화질의 색상은 더 보기 좋지만 내보내기 시간이 오래 걸립니다.
  • FPS GIF 애니메이션의 초당 프레임 수입니다.
  • Repeat GIF 애니메이션을 반복할 횟수입니다. 무한히 반복하려면 0을 입력하세요.

JPEG

Spine은 JPEG 이미지를 내보낼 수 있습니다. JPEG은 투명도를 지원하지 않고 손실이 있는 이미지 포맷이기 때문에 화질 저하가 나타날 수 있습니다.

  • Type 수행할 내보내기 유형입니다.
    • Sequence 지정된 애니메이션을 각각 여러 개의 JPEG 파일로 내보냅니다.
    • Frame 현재 뼈대 포즈를 하나의 JPEG로 내보냅니다.
  • Animation 현재 애니메이션만 내보내거나 모든 애니메이션을 한 번에 내보냅니다.
  • Skins 현재 스킨만 내보내거나 모든 스킨을 한 번에 내보냅니다.
  • Output folder JPEG 파일을 기록할 폴더입니다.
  • Images 이 옵션을 체크하면 뼈대 이미지가 렌더링됩니다.
  • Bones 이 옵션을 체크하면 뼈대의 뼈가 렌더링됩니다.
  • Background 사용할 배경색입니다.
  • Quality 높은 화질의 이미지는 더 보기 좋지만 파일 크기가 커집니다.
  • FPS JPEG 시퀀스의 초당 프레임 수입니다.
  • Create atlas 이 옵션을 체크하면 내보낸 이미지가 텍스처 아틀라스에 포함됩니다. 이 기능은 편리하지만 텍스처 패커를 별도로 실행하면 패킹을 더 많이 제어할 수 있습니다. 자세한 정보는 텍스처 패킹을 참조하세요.

PNG

Spine은 PNG 이미지를 내보낼 수 있습니다. PNG는 투명도를 지원하는 손실 없는 이미지 포맷이기 때문에 화질 저하가 나타나지 않습니다.

  • Type 수행할 내보내기 유형입니다.
    • Sequence 지정된 애니메이션을 각각 여러 개의 PNG 파일로 내보냅니다.
    • Frame 현재 뼈대 포즈를 하나의 PNG로 내보냅니다.
  • Animation 현재 애니메이션만 내보내거나 모든 애니메이션을 한 번에 내보냅니다.
  • Skins 현재 스킨만 내보내거나 모든 스킨을 한 번에 내보냅니다.
  • Output folder PNG 파일을 기록할 폴더입니다.
  • Images 이 옵션을 체크하면 뼈대 이미지가 렌더링됩니다.
  • Bones 이 옵션을 체크하면 뼈대의 뼈가 렌더링됩니다.
  • Background 이 옵션을 체크하면 배경색을 사용합니다. 체크하지 않으면 PNG 배경이 투명하게 됩니다.
  • FPS PNG 시퀀스의 초당 프레임 수입니다.
  • Create atlas 이 옵션을 체크하면 내보낸 이미지가 텍스처 아틀라스에 포함됩니다. 이 기능은 편리하지만 텍스처 패커를 별도로 실행하면 패킹을 더 많이 제어할 수 있습니다. 자세한 정보를 보려면 텍스처 패킹을 참조하세요.

AVI

Spine은 현재 애니메이션을 AVI 비디오 파일로 내보낼 수 있습니다.

  • Codec AVI 비디오를 인코딩하기 위해 사용하는 코덱입니다.
  • Output file 기록할 AVI 파일입니다.
  • Images 이 옵션을 체크하면 뼈대 이미지가 렌더링됩니다.
  • Bones 이 옵션을 체크하면 뼈대의 뼈가 렌더링됩니다.
  • Background 사용할 배경색입니다.
  • Quality JPEG 기반 코덱의 경우, 높은 화질의 이미지는 더 보기 좋지만 파일 크기가 커집니다.
  • FPS AVI 비디오의 초당 프레임 수입니다.

QuickTime

Spine은 현재 애니메이션을 QuickTime MOV 비디오 파일로 내보낼 수 있습니다.

  • Codec MOV 비디오를 인코딩하기 위해 사용하는 코덱입니다.
  • Output file 기록할 MOV 파일입니다.
  • Images 이 옵션을 체크하면 뼈대 이미지가 렌더링됩니다.
  • Bones 이 옵션을 체크하면 뼈대의 뼈가 렌더링됩니다.
  • Background 사용할 배경색입니다.
  • Quality JPEG 기반 코덱의 경우, 높은 화질의 이미지는 더 보기 좋지만 파일 크기가 커집니다.
  • FPS MOV 비디오의 초당 프레임 수입니다.

커맨드 라인

내보내기 및 텍스처 패킹은 스크립트 및 빌드 서버와 함께 사용할 수 있도록 커맨드 라인에서 실행할 수 있습니다. 이렇게 실행할 경우, Spine이 실행되고 내보내기 또는 텍스처 패킹이 1회 이상 실행된 다음 종료됩니다.

사양

커맨드 라인 내보내기를 수행하려면 Spine과 Spine 론처 모두 2.1.00 이상이어야 합니다. Spine 론처를 업데이트하려면 Spine을 구입할 때 이메일로 받은 Spine 라이선스 링크를 사용하여 다운로드하고 Spine을 재설치하세요.

JSON 및 바이너리 데이터 내보내기와 텍스처 패킹은 헤드리스 머신에서 수행할 수 있습니다. 이미지나 비디오를 내보내려면 OS 윈도 시스템과 OpenGL이 필요합니다.

사용법

내보내기 및 텍스처 패킹을 위한 커맨드 라인 사용법:

내보내기: Spine [-i <project.spine>] [-o <path>] -e <path>
  패킹: Spine -i <path> -o <path> -p <name>

내보내기:
-i, --input   Spine 프로젝트 파일 경로, 내보내기 설정 JSON에 우선.
-o, --output  내보내기 파일 경로, 내보내기 설정 JSON에 우선.
-e, --export  설정 JSON 파일 내보내기 경로.

패킹:
-i, --input   패킹할 이미지 폴더 경로.
-o, --output  텍스처 아틀라스 파일을 기록할 경로.
-p, --pack    텍스처 아틀라스 이름 또는 설정 JSON 파일을 패킹할 경로.

예시:
Spine --export /path/to/export.json
Spine --export "/path/with spaces/to/export.json"
Spine --input /path/to/project.spine --output /path/to/output/
      --export /path/to/export.json
Spine -i /path/to/project.spine -o /path/to/output/ -e /path/to/export.json
Spine -e /path/to/export1.json -e /path/to/export2.json
Spine -i /path/to/images/ -o /path/to/output/ --pack /path/to/pack.json
Spine -i /path/to/images/ -o /path/to/output/ -p /path/to/pack.json
Spine -i /path/to/project1.spine -o /path/to/output/ -e /path/to/export1.json
      -i /path/to/project2.spine -e /path/to/export2.json -i /path/to/images/
      -o /path/to/output/ -p /path/to/pack.json

출력 폴더가 존재하지 않을 경우 출력 폴더가 생성됩니다. 지난 예제에서 본 것과 같이 여러 개의 내보내기 및 텍스처 패킹을 지정할 수 있습니다. 명령이 실패하면 Spine은 0이 아닌 오류 코드를 반환합니다.

내보내기의 경우, 입력 및 출력 경로는 선택적입니다. 경로를 지정할 경우, 내보내기 설정 JSON 파일에 지정된 입력 및/또는 출력 경로에 우선합니다. 입력 경로는 프로젝트 파일 경로입니다. 출력 경로는 내보내기 설정에 따라 파일 또는 폴더일 수 있습니다. Spine에서 Export 대화창 아래에 있는 Save 버튼을 클릭하여 내보내기 설정 JSON 파일을 생성할 수 있습니다.

텍스처 패킹의 경우, 입력 및 출력 경로가 필요하며 폴더 경로여야 합니다. --pack 또는 -p 파라미터는 출력 파일을 기록할 경우 사용할 텍스처 아틀라스 이름이거나 패킹 설정 JSON 파일 경로입니다. Spine에서 Texture Packer Settings 대화창 아래에 있는 Save 버튼을 클릭하여 패킹 설정 JSON 파일을 생성할 수 있습니다. JSON 파일의 이름은 파일 확장자 없이 텍스처 아틀라스 이름으로 사용됩니다.

텍스처 패킹을 수행할 때, 지정된 패킹 설정 JSON 파일의 설정이 사용됩니다. 텍스처 아틀라스 이름이 지정된 경우에는 기본 설정이 사용됩니다. 입력 폴더에 있는 pack.json 파일에 정의된 설정이 이 설정보다 우선합니다. 자세한 정보는 Spine 텍스처 패커 JSON 설정을 참조하세요.

Windows

Windows용 Spine에는 Spine.exeSpine.com의 두 가지 실행파일이 있습니다. EXE 파일은 GUI 애플리케이션이고, Spine을 콘솔 창 없이 실행하고 Spine이 종료될 때까지 기다리지 않습니다. COM 파일은 커맨드 라인 애플리케이션이고, Spine의 출력물을 콘솔 창으로 보내고 Spine이 종료될 때까지 기다립니다.

두 실행파일 중 어느 것이든 커맨드 라인 내보내기에 사용할 수 있지만 일반적으로 COM 파일이 선호됩니다. Spine 설치 폴더가 시스템 경로에 있거나 현재 작업 디렉터리인 경우, 확장자 없이 Spine을 입력하면 확장자는 언제나 Spine.com을 실행합니다. 예시:

Spine -e C:\path\to\export.json

Mac

Mac용 Spine을 사용할 경우 커맨드 라인 내보내기는 Spine.app을 여는 대신 Spine 실행파일을 직접 실행하여 수행됩니다. 실행파일은 Spine.app 내에 Spine.app/Contents/MacOs/Spine에 있습니다. 예시:

/Applications/Spine/Spine.app/Contents/MacOs/Spine -e /path/to/export.json

Linux

Linux용 Spine을 사용할 경우 커맨드 라인 내보내기는 Spine.sh 스크립트를 실행하여 수행됩니다. 예시:

./Spine.sh -e /path/to/export.json

다음: 텍스처 패킹 이전: 가중치