Flame

Flame용 Shotgun 엔진

Flame용 Shotgun 엔진
최신 버전: v1.14.0(prod)
버전 번호의 경우 유의적 버전 표준을 따릅니다.
시스템 이름: tk-flame

참고: 이 문서에서는 툴킷 구성에 대한 제어 권한이 있는 경우에만 사용할 수 있는 기능에 대해 설명합니다. 자세한 정보는 Shotgun 통합 사용자 안내서를 참조하십시오.

Flame용 Shotgun 엔진은 Flame 2015 Extension 2부터 사용 가능한 다양한 통합 후크를 연결하며 툴킷 Flame 앱을 실행하기 위한 호스트 역할도 합니다.

지원되는 응용프로그램 버전

이 항목은 테스트를 거쳐 2016+ 응용프로그램 버전에서 작동하는 것으로 알려져 있습니다. 최신 릴리즈에서는 더 완벽하게 작동할 수 있지만 이러한 버전에서 아직 공식적으로 테스트되지는 않았습니다.

설명서

심층적 기술 연습

Flame 통합을 설치하고 사용하려는 경우 가장 좋은 시작점은 심층적 기술 연습 동영상입니다. Shotgun 데스크톱을 설치하고 프로젝트를 설정한 다음 Flame 통합을 실행하는 방법을 단계별로 보여 주는 여러 동영상이 포함된 재생 목록이 아래에 나와 있습니다.

마지막 섹션에서는 구성 및 후크에 대한 보다 자세한 기술 정보를 제공합니다. 모든 동영상을 보려면 Flame 통합이 수행할 수 있는 작업과 파이프라인의 나머지 부분에 연결할 수 있는 방법에 대해 잘 알고 있어야 합니다.

설치

Flame용 Shotgun 엔진은 Flame 2015 익스텐션 2에 추가된 새 통합 후크를 사용합니다. 엔진이 작동하려면 반드시 이 Flame 버전을 사용해야 합니다. Flame 2015 익스텐션 2에 대한 자세한 정보(얻는 방법 포함)는 Flame 지원 팀에 문의하십시오.

Flame용 Shotgun 엔진을 시작하는 가장 간단한 방법은 예제 파이프라인 구성을 사용하여 새 테스트 프로젝트를 설정하는 것입니다. Shotgun 데스크톱을 시작하고 새 프로젝트에 대한 프로젝트 설정을 실행하여 기본 구성 섹션에서 기본 Flame 구성을 선택하면 이 작업을 수행할 수 있습니다.

Flame 프로젝트 설정

Flame용 Shotgun 엔진은 Shotgun 프로젝트를 Flame 프로젝트와 연결하는 데 도움을 주며 필요한 경우 Flame 프로젝트를 생성합니다. Flame의 데이터가 Shotgun의 올바른 데이터와 연결되도록 하므로 이 설정이 통합의 핵심입니다. 추가 기능으로 엔진은 Flame 프로젝트의 명명 규칙 및 프로젝트의 다른 여러 설정을 관리하는 기능을 제공합니다.

Shotgun을 통해 Flame이 처음 시작되면 아티스트가 표준 Flame 프로젝트 생성 화면에서 일반적인 설정을 편집할 수 있는 Flame 프로젝트 생성 UI가 나타납니다.

그러나 Shotgun 통합을 통해 파이프라인 관련 값으로 설정에 미리 입력할 수 있으므로 아티스트는 고민할 필요 없이 신속하게 올바른 결과를 얻을 수 있습니다. 기본값은 project_setup_hook를 통해 커스터마이즈할 수 있으며 다음 옵션을 지원합니다.

use_project_settings_ui True로 설정된 경우 프로젝트 생성 UI가 나타납니다. False로 설정된 경우 Flame 프로젝트는 후크의 나머지 기본값을 기반으로 자동으로 생성됩니다.

get_server_hostname 기본적으로 'localhost'로 설정되어 있지만 원하는 경우 재지정할 수 있습니다.

get_project_name 기본적으로 Shotgun 프로젝트와 동일한 값으로 설정되지만 원하는 경우 재지정할 수 있습니다.

get_volume 기본적으로 사용 가능한 첫 번째 저장소로 설정되지만 원하는 경우 재지정할 수 있습니다.

get_workspace 기본적으로 Flame은 표준 작업공간 생성 로직에 따라 기본 작업공간을 만들지만 원하는 경우 재지정할 수 있습니다.

get_user 이 설정은 Flame 컴퓨터에 로그인한 사용자와 Shotgun의 사용자의 연결을 시도합니다.

get_project_settings 이 설정을 통해 기본 Flame 설정이 구성되고 후크가 Flame 프로젝트 XML 스트림을 빌드합니다. 다음 매개변수를 반드시 제공해야 합니다.

  • FrameWidth(예: 1280)
  • FrameHeight(예: 1080)
  • FrameDepth(16-bit fp, 12-bit, 12-bit u, 10-bit, 8-bit)
  • FieldDominance(PROGRESSIVE, FIELD_1, FIELD_2)
  • AspectRatio(4:3, 16:9 또는 문자열 부동 소수점 값)

프록시 설정을 제공할 수도 있습니다. 자세한 정보는 Autodesk Wiretap SDK 문서를 참조하십시오.

project_setup 후크의 전체 코드베이스를 보려면 엔진에 대한 Github 리포지토리를 참조하십시오.

설치 및 업데이트

Shotgun Pipeline Toolkit에 이 엔진 추가

asset 환경의 XYZ 프로젝트에 이 엔진을 추가하려면 다음 명령을 실행합니다.

> tank Project XYZ install_engine asset tk-flame

최신 버전으로 업데이트

프로젝트에 이 항목이 이미 설치되어 있는 경우 최신 버전을 얻으려면 update 명령을 실행할 수 있습니다. 특정 프로젝트와 함께 제공되는 tank 명령을 탐색하여 다음과 같이 실행할 수 있습니다.

> cd /my_tank_configs/project_xyz
> ./tank updates

또는 스튜디오 tank 명령을 실행하고 업데이트 확인을 실행할 프로젝트 이름을 지정할 수 있습니다.

> tank Project XYZ updates

협업 및 개선

Shotgun Pipeline Toolkit에 액세스할 수 있다면 모든 앱, 엔진 및 프레임워크가 저장 및 관리되는 Github에서 그 소스 코드에도 액세스할 수 있습니다. 이러한 항목을 자유롭게 개선하여 향후 독립적인 개발을 위한 기반으로 사용하고 변경 후 다시 풀 리퀘스트를 제출하거나, 아니면 그냥 조금만 손을 보고 어떻게 빌드되었는지, 툴킷이 어떻게 작동하는지 확인해 보십시오. https://github.com/shotgunsoftware/tk-flame에서 이 코드 리포지토리에 액세스할 수 있습니다.

특별 요구 사항

  • 이 기능을 이용하려면 Shotgun Pipeline Toolkit Core API 버전 v0.18.45 이상이 필요합니다.

구성

아래는 사용되는 모든 구성 설정을 요약한 것입니다. 해당 설정은 이 앱 또는 엔진을 활성화하려는 환경 파일에서 정의해야 합니다.

run_at_startup

유형: list

설명: 시작할 때 실행할 앱을 제어합니다. 이 설정은 하나의 목록이며 각 요소는 'app_instance'와 'name'이라는 두 개의 키가 포함된 사전입니다. app_instance 값은 이 항목을 환경 구성 파일에 정의된 특정 앱 인스턴스에 연결합니다. name은 Flame을 시작할 때 실행할 명령의 메뉴 이름입니다. name이 ''이면 지정된 앱 인스턴스의 모든 명령이 시작됩니다.

local_movies_preset_path

유형: str

기본값: Generate Local Movie.xml

설명: 로컬 동영상 생성에 사용할 사전 설정 경로입니다. 상대 경로가 전달되면 Shotgun에 대한 응용프로그램별 사전 설정 경로가 앞에 추가됩니다(/opt/Autodesk/presets//export/presets/shotgun/movie_file). 이 설정은 Flame 2019.1 이상에서만 적용됩니다.

context_menu

유형: list

설명: Flame의 상황에 맞는 메뉴에 표시되는 명령을 제어합니다. 이 설정은 하나의 목록이며 각 요소는 'app_instance', 'name' 및 'display_name'이라는 세 개의 키가 포함된 사전입니다. app_instance 값은 이 항목을 환경 구성 파일에 정의된 특정 앱 인스턴스에 연결합니다. name 값은 엔진에 등록된 명령의 이름입니다. display_name 값은 Flame이 메뉴에 표시되는 이름입니다. name이 ''이면 지정된 앱 인스턴스의 모든 명령이 시작됩니다. display_name이 없으면 대신 name이 사용됩니다.

thumbnails_preset_path

유형: str

기본값: Generate Thumbnail.xml

설명: 썸네일 생성에 사용할 사전 설정 경로입니다. 상대 경로가 전달되면 Shotgun에 대한 응용프로그램별 사전 설정 경로가 앞에 추가됩니다(/opt/Autodesk/presets//export/presets/shotgun/file_sequence). 이 설정은 Flame 2019.1 이상에서만 적용됩니다.

backburner_servers

유형: str

설명: backburner 작업을 제출할 때 사용할 쉼표로 구분된 서버 목록입니다. (그룹이 사용되는 경우 무시됨)

flame_batch_publish_type

유형: tank_type

기본값: Flame Batch File

설명: Flame 배치(Batch) 스크립트와 관련된 게시 유형입니다. 이 매개변수는 시작할 때 Flare 시작 프로세스가 Shotgun에서 배치(Batch) 스크립트를 자동 로드하는 데 사용됩니다.

backburner_manager

유형: str

설명: Backburner 관리자가 있는 호스트입니다. Flame 엔진에서 생성된 모든 backburner 작업은 이 서버로 디스패치됩니다. 이 설정은 Flame 2016.1 이상에서만 지원됩니다. 이 값을 지정하지 않으면 시스템 기본값이 사용됩니다.

backburner_server_group

유형: str

설명: backburner 작업을 제출할 때 사용할 서버의 그룹 이름입니다.

backburner_shared_tmp

유형: str

기본값: /tmp

설명: Flame 엔진이 임시 파일을 저장할 수 있는 폴더입니다. 이 폴더는 모든 backburner 노드에서 액세스할 수 있어야 하므로 큰 backburner 설정을 실행하는 경우 이 경로는 일종의 공유 네트워크 위치여야 합니다.

project_startup_hook

유형: hook

기본값: {self}/project_startup.py

설명: Flame 프로젝트를 시작할 때 사용할 작업공간 및 사용자를 결정하고 생성하는 로직을 포함합니다.

bypass_server_transcoding

유형: bool

설명: 가능한 경우 썸네일 생성을 위한 Shotgun 서버 측 트랜스코딩을 건너뜁니다. 따라서 미리보기 Quicktime이 그대로 업로드되고 webm을 생성하지 않으므로 모든 브라우저에서 재생이 지원되지 않습니다. 그러면 재생 가능한 동영상 미리보기 및 영사 슬라이드 생성도 비활성화됩니다. 이 옵션에 대한 자세한 정보는 문서를 참조하십시오.

use_builtin_plugin

유형: bool

설명: 기본 제공 툴킷 플러그인을 사용하여 Flame을 시작할 준비를 할지 여부입니다. false인 경우 Flame이 시작되면 기본 스타일 툴킷 통합이 초기화됩니다.

debug_logging

유형: bool

설명: 디버거 메시지를 로거로 내보낼지 여부를 제어합니다.

previews_preset_path

유형: str

기본값: Generate Preview.xml

설명: 미리보기 생성에 사용할 사전 설정 경로입니다. 상대 경로가 전달되면 Shotgun에 대한 응용프로그램별 사전 설정 경로가 앞에 추가됩니다(/opt/Autodesk/presets//export/presets/shotgun/movie_file). 이 설정은 Flame 2019.1 이상에서만 적용됩니다.

project_switching

유형: bool

설명: 프로젝트 전환 가능성에 대한 힌트입니다.

generate_thumbnails

유형: bool

기본값: True

설명: Shotgun에 제출할 때 Flame에서 내보낸 에셋의 썸네일을 생성합니다.

backburner_hooks

유형: hook

기본값: {self}/backburner_hooks.py

설명: Backburner 백그라운드 작업 로직을 포함합니다.

generate_local_movies

유형: bool

기본값: True

설명: Shotgun에 업로드되지 않지만 원래 Flame에서 내보낸 미디어를 읽지 않으려고 하거나 읽을 수 없는 클라이언트 응용프로그램에서 사용할 수 있는 고품질 동영상 파일을 생성합니다.

generate_previews

유형: bool

기본값: True

설명: Shotgun에 제출할 때 Flame에서 내보낸 에셋의 미리보기를 생성합니다. 모든 Shotgun 엔티티가 미리보기를 지원하는 것은 아니며 지원하지 않는 엔티티의 썸네일에 코드가 폴백됩니다.

팔로우

0 댓글

댓글을 남기려면 로그인하세요.