Review Submission

Review Submission

리뷰를 위해 Shotgun에 미디어를 제출하는 기능을 제공합니다.
최신 버전: v1.0.2(prod)
버전 번호의 경우 유의적 버전 표준을 따릅니다.
시스템 이름: tk-multi-reviewsubmission

참고: 이 문서에서는 툴킷 구성에 대한 제어 권한이 있는 경우에만 사용할 수 있는 기능에 대해 설명합니다. 자세한 정보는 Shotgun 통합 사용자 안내서를 참조하십시오.
개요 요약
설명서
            앱 사용 방법
                  API로 사용
                  메뉴 항목으로 사용
설치, 업데이트 및 개발
구성 옵션

Shotgun에서 리뷰를 위해 이미지 시퀀스를 버전으로 제출하는 데 도움이 되는 기능을 제공하는 앱입니다. 이 앱에는 UI가 없지만 대신 QuickTime 및 리뷰 생성을 위한 API 메서드를 제공합니다. 스크립트 또는 후크 내에서 앱을 호출할 수 있습니다. 예를 들어, QuickTime을 만든 후 리뷰를 위해 보내려는 경우 게시 구성에서 이를 사후 프로세스 후크의 일부로 호출할 수 있습니다. 이 앱은 번인과 슬레이트가 포함된 QuickTime을 생성합니다. QuickTime을 Shotgun에 업로드하거나 디스크에 보관하거나 또는 둘 다 구성할 수 있습니다. 마지막으로 Screening Room에서 리뷰할 수 있도록 Shotgun 내부에 새 버전을 만듭니다.

설명서

앱 사용 방법

API로 사용

이 앱에는 Multi Publish 앱과 같은 다른 앱 내에서 호출되는 모드가 있습니다.

이 모드는 이미지 시퀀스에서 Quicktime을 만들고 리뷰를 용이하게 하기 위해 Shotgun에 버전으로 제출합니다. 생성된 Quicktime에는 슬레이트 및 번인이 있습니다. 글꼴, 로고 위치, 영상 압축 옵션 및 번인/슬레이트 정보 등은 현재 기본 후크에서 하드코딩되어 있으므로 후크 함수를 다시 구현하여 동작을 조정하는 것이 좋습니다.

슬레이트 및 번인의 현재 기본 형식은 다음과 같습니다.

기본 메뉴

기본 메뉴

자체 앱 또는 후크에서 이 앱을 활용하고 싶다면 간단한 다음 방법을 참조하십시오.

  • 현재 엔진에서 tk-multi-reviewsubmission 앱을 가져옵니다. 이 작업은 self.parent.engine.apps.get('tk-multi-reviewsubmission') 호출을 사용하여 후크 내에서 수행할 수 있습니다.
  • 앱을 사용할 수 있는 경우 render_and_submit_version() 메서드를 호출합니다.

후크 코드의 내용은 다음 예와 같습니다.

review_submission_app = self.parent.engine.apps.get("tk-multi-reviewsubmission")
if review_submission_app:
    review_submission_app.render_and_submit_version(
        template,
        fields,
        first_frame,
        last_frame,
        sg_publishes,
        sg_task,
        comment,
        thumbnail_path,
        progress_cb,
        color_space
    )

render_and_submit_version에 전달해야 하는 인수는 다음과 같습니다.

  • template: 게시할 파일의 위치를 정의하는 템플릿
  • fields: 템플릿을 입력하는 데 사용할 필드
  • first_frame: 처리할 이미지 시퀀스의 첫 번째 프레임
  • last_frame: 처리할 이미지 시퀀스의 마지막 프레임
  • sg_publishes: 버전을 링크할 Shotgun 게시된 파일 객체의 목록
  • sg_task: 버전을 링크할 Shotgun 태스크 링크 사전
  • comment: 버전 설명에 추가할 텍스트
  • thumbnail_path: 영상이 Shotgun에 업로드되지 않을 경우 버전에 사용할 썸네일 경로(구성에서 설정)
  • progress_cb: 진행률을 보고하기 위한 콜백. callback(percent, message) 형식이어야 합니다.
  • color_space: 입력 프레임이 있는 색상 공간. Nuke에서 쓰기 노드의 색상 영역 노브에 있는 열거 값 중 하나입니다.

메뉴 항목으로 사용

이 모드는 DCC 내부의 Shotgun 메뉴에 메뉴 항목을 추가합니다.

이 모드는 현재 뷰포트의 빠른 스냅샷을 만들고 이를 버전 초안으로 Shotgun Create에 보냅니다. 그런 다음 사용자는 주석, 텍스트 또는 비교 노트를 추가해 Shotgun Create 내에서 리뷰 제출물을 확장할 수 있습니다.

이 기능을 컨텍스트에 추가하려면 다음을 수행해야 합니다.

  • display_name 필드가 메뉴 항목에 포함되도록 설정합니다.
  • DCC에서 미디어를 렌더링하는 방법을 알려주는 render_media_hook 필드를 후크로 설정합니다(tk-photoshopcc 및 tk-maya에는 기본 구현이 있음).
  • submitter_hook 필드를 {self}/submitter_create.py로 설정합니다.

다음과 같습니다.

tk-multi-reviewsubmission:
  display_name: Send for review
  render_media_hook: '{self}/render_media.py:{self}/{engine_name}/render_media.py'
  submitter_hook: '{self}/submitter_create.py'
  location: 
    type: app_store
    name: tk-multi-reviewsubmission
    version: v1.0.1

관련 앱 및 문서

Publish

아티스트는 Publish 앱을 통해 아티스트 다운스트림에서 사용할 수 있도록 작업물을 게시할 수 있습니다. 아티스트의 컨텐츠 생성 소프트웨어 내에서 기존 게시 워크플로우를 지원하고 디스크상의 파일을 독립 실행형으로 게시할 수 있습니다. 컨텐츠 생성 소프트웨어에서 작업하거나 기본 Shotgun 통합을 사용하여 작업할 때 이 앱은 아티스트가 게시할 수 있는 항목을 자동으로 검색해 표시해 줍니다. 보다 정교한 프로덕션이 필요한 경우 스튜디오는 커스텀 게시 플러그인을 작성하여 아티스트 워크플로우를 진행할 수 있습니다.

빠른 데일리

이 앱은 Nuke에 노드 유형을 추가합니다. 노드 유형은 노드 그래프의 아무데나 추가할 수 있습니다. 씬에 추가되면 해당 노드를 두 번 클릭하여 특성 페이지로 이동한 다음 "리뷰로 보내기(Send to Review)" 버튼을 클릭하면 됩니다. 그러면 이 앱은 씬의 Quicktime을 렌더링하고 번인 및 슬레이트를 추가한 후 Shotgun에 전송합니다. Shotgun에서 버전을 쉽게 미리볼 수 있는 영사 슬라이드 썸네일도 생성합니다.

Quickreview 노드

이 앱은 노드 그래프의 아무 곳에나 추가할 수 있는 Nuke 노드를 추가합니다. 씬에 추가되면 해당 노드를 두 번 클릭하여 특성 페이지로 이동한 다음 "리뷰로 보내기(Send to Review)" 버튼을 클릭하면 됩니다. 그러면 이 앱은 씬의 Quicktime을 렌더링하고 번인 및 슬레이트를 추가한 후 Shotgun에 업로드합니다.

Write Node

이 앱에는 Nuke용 커스텀 Write Node 기즈모가 포함되어 있어 사용자의 파일 시스템 경로를 추출하여 특정 출력의 이름을 지정하는 데만 집중할 수 있습니다. 나머지는 Shotgun이 처리합니다. 이 앱은 일반적으로 Publish 앱과 함께 사용되며 Nuke용 Publish 앱을 설치할 경우 이 앱도 설치하는 것이 좋습니다.

설치 및 업데이트

Shotgun Pipeline Toolkit에 이 앱 추가

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

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

최신 버전으로 업데이트

프로젝트에 이 항목이 이미 설치되어 있는 경우 최신 버전을 얻으려면 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-reviewsubmission에서 이 코드 리포지토리에 액세스할 수 있습니다.

특별 요구 사항

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

구성

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

movie_width

유형: int

기본값: 1920

설명: 렌더링된 영상 파일의 폭입니다.

display_name

유형: str

설명: 메뉴 및 기본 메뉴에서 사용해야 하는 이름을 지정합니다.

render_media_hook

유형: hook

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

설명: 이 앱이 실행되는 동안 미디어가 생성되는 방법을 구현합니다.

slate_logo

유형: config_path

설명: 회사 로고와 같이 슬레이트에서 사용할 이미지 경로입니다. 제공된 이미지는 400픽셀 상자로 재구성되며 로고의 왼쪽 하단은 오른쪽으로 100픽셀, 슬레이트의 왼쪽 하단 위에 100픽셀로 맞춰집니다. 투명도를 추가하려면 알파 채널이 있는 이미지를 사용할 수 있습니다. 현재 Nuke가 지원하는 모든 이미지 형식이 적합합니다. 이 설정이 빈 문자열이면 로고가 적용되지 않습니다.

movie_path_template

유형: template

선택적 템플릿 키: ***

설명: 파일 시스템에서 영상 파일의 출력 위치를 정의하는 템플릿입니다. 이 템플릿의 경우 render_and_submit 필드에 전달된 템플릿에 정의된 모든 필드를 사용할 수 있습니다. 이 외에도 영상의 해상도를 포함하는 폭과 높이의 특수 필드를 사용할 수 있습니다. store_on_disk 설정이 false인 경우 이 설정은 계속 필요하지만 파일을 Shotgun에 업로드하기 전 임시 처리 위치로 사용됩니다.

store_on_disk

유형: bool

기본값: True

설명: 생성 중인 영상을 디스크에 보관해야 합니까? 이 설정과 upload_to_shotgun 옵션을 비활성화하면 전체 도구가 효과적으로 비활성화됩니다.

upload_to_shotgun

유형: bool

기본값: True

설명: 생성 중인 영상을 Shotgun에 버전으로 업로드하거나 디스크에 보관해야 합니까? 이 설정과 store_on_disk 옵션을 비활성화하면 전체 도구가 효과적으로 비활성화됩니다.

version_number_padding

유형: int

기본값: 3

설명: 이 값은 슬레이트 및 다양한 영상 번인의 버전 번호를 패딩하는 데 사용됩니다. 영상 파일 이름의 버전 번호 패딩에는 영향을 미치지 않습니다. movie_path_template을 참조하십시오. 패딩이 없는 경우 1을 사용합니다.

submitter_hook

유형: hook

기본값: {self}/submitter_sgtk.py

설명: 미디어가 Shotgun에 전송되는 방법을 구현합니다.

movie_height

유형: int

기본값: 1080

설명: 렌더링된 영상 파일의 높이입니다.

팔로우