프레임 범위 설정

Shotgun과 프레임 범위 동기화

씬의 프레임 범위를 Shotgun에 저장된 범위와 동기화합니다.
최신 버전: v0.4.0(prod)
버전 번호의 경우 유의적 버전 표준을 따릅니다.
시스템 이름: tk-multi-setframerange

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

Shotgun에서 현재 파일을 관련된 샷의 최신 프레임 범위와 동기화하는 간편하면서도 유용한 앱입니다. 편집에서 컷이 변경되면 이 앱을 사용하여 작업 중인 씬을 빠르고 안전하게 업데이트합니다. 마지막으로 변경된 사항에 대한 정보가 포함된 UI가 표시됩니다.

설명서

이 앱은 현재 열려 있는 씬에서 프레임 범위를 관리하는 데 도움이 됩니다. Sync Frame Range with Shotgun 메뉴 옵션을 클릭하면 Shotgun 메뉴에서 앱에 액세스할 수 있습니다.

이 버튼을 클릭하면 Shotgun 툴킷은 현재 작업 영역(일반적으로 샷)과 관련된 Shotgun 엔티티를 보고 입력 및 출력 프레임 정보가 있는 입력 및 출력 필드를 찾습니다. 일반적으로 샷과 함께 사용되며 이 경우 앱은 Shotgun의 기본 구성에 정의된 표준 샷 입력 및 출력 필드를 사용합니다. 그러나 다른 필드에서 프레임 범위를 가져오도록 앱을 구성할 수도 있습니다.

Shotgun

앱을 실행하면 현재 씬을 해당 입출력으로 업데이트하고 마지막으로 요약 메시지를 표시합니다.

Nuke

여러 Shotgun 필드 동기화 옵션

Shotgun 메뉴에서 menu_name 속성을 설정하여 이 앱의 인스턴스를 여러 개 정의할 수 있습니다. 이렇게 하면 서로 다른 Shotgun 필드의 동기화를 위해 여러 가지 메뉴 액션을 정의할 수 있게 됩니다.

이를 위해 각 인스턴스에 대해 다른 앱 인스턴스 이름, menu_name 및 입력/출력 프레임 필드를 설정하십시오.

tk-multi-setframerange_cuts:
  menu_name: Sync frame range using cut fields
  sg_in_frame_field: sg_cut_in
  sg_out_frame_field: sg_cut_out
  location: "@apps.tk-multi-setframerange.location"
tk-multi-setframerange_handles:
  menu_name: Sync frame range using handle fields
  sg_in_frame_field: sg_handle_in
  sg_out_frame_field: sg_handle_out
  location: "@apps.tk-multi-setframerange.location"

그러면 각 항목이 Shotgun 메뉴에 별도의 옵션으로 표시됩니다.

여러 인스턴스

참고: 이는 앱 v0.4.0 버전의 새로운 기능입니다.

작업 후크

현재 씬 프레임 범위를 가져오거나 프레임 범위를 설정하기 위한 소프트웨어별 로직은 프레임 작업 후크에서 처리됩니다. 새 엔진에 대한 지원을 추가하거나 해당 동작의 구현 방법을 변경하려는 경우 hook_frame_operation 앱 속성을 설정하고 고유의 가져오기(get) 및 설정(set) 로직을 구현하여 프레임 작업 후크를 인수할 수 있습니다.

참고: 이는 앱 v0.4.0 버전의 새로운 기능입니다.

설치 및 업데이트

Shotgun Pipeline Toolkit에 이 앱 추가

이 앱을 이름이 asset인 환경에 있는 프로젝트 XYZ에 추가하고 싶다면 다음 명령을 실행합니다.

> tank Project XYZ install_app asset tk-maya tk-multi-setframerange

최신 버전으로 업데이트

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

> cd /my_tank_configs/project_xyz
> ./tank updates

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

> tank Project XYZ updates

협업 및 개선

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

특별 요구 사항

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

구성

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

menu_name

유형: str

기본값: Sync Frame Range with Shotgun

설명: Shotgun 메뉴에 표시되는 이름입니다.

sg_in_frame_field

유형: str

기본값: sg_cut_in

설명: 프레임을 검색하는 데 사용할 Shotgun 필드입니다. 앱은 현재 컨텍스트(예: 현재 샷, 현재 에셋 등)와 관련된 엔티티에서 이 필드를 찾습니다.

sg_out_frame_field

유형: str

기본값: sg_cut_out

설명: 출력 프레임을 검색하는 데 사용할 Shotgun 필드입니다. 앱은 현재 컨텍스트(예: 현재 샷, 현재 에셋 등)와 관련된 엔티티에서 이 필드를 찾습니다.

hook_frame_operation

유형: hook

기본값: {self}/frame_operations_{engine_name}.py

설명: 프레임 범위 설정(set)/가져오기(get)를 위한 모든 메서드가 포함된 후크입니다.

팔로우