Q100401: Katana 에서 쉽게 액세스할 수 있는 사용자 정의 Python 스크립트를 제공하기 위해 Shelf Item을 만드는 방법

요약

셸프 항목 스크립트는 셸프(Shelves) 아래에 그룹화된 셸프 항목에 포함된 Python 스크립트로, Katana UI에서 실행할 수 있습니다. 셸프는 사용자가 셸프에서 Python 작업을 실행하거나 사용자 지정 키보드 단축키를 사용하여 시간을 절약하는 도구를 만들 수 있도록 해주므로 매우 유용합니다. 셸프 항목 스크립트는 NodegraphAPI 와 같은 Katana API를 사용하여 Katana 의 다양한 부분에 접근하여 쿼리하거나 수정할 수 있습니다.

이 문서에서는 셸프 도구에 대해 자세히 설명하고 첫 번째 셸프 항목 설정에 대한 간략한 튜토리얼을 제공합니다. 이미 첫 번째 셸프 항목을 설정했고 업데이트 또는 삭제에 대한 팁이 필요하면 Q100402: Katana 에서 셸프 항목을 편집하고 삭제하여 기존 사용자 지정 Python 스크립트를 수정하는 방법을 참조하세요.

선반 위치

선반 항목은 선반 작업 (톱니바퀴)이라는 팝업 UI로 정리됩니다.gear16.png 아이콘). Shelf Action은 더 광범위한 기능에 사용하거나 아래와 같이 장면 그래프나 특정 노드에 대해 만들 수 있습니다.

  • 메인 메뉴 툴바를 통해 사용 가능한 메인 선반 위치

shelf_mainToolBar.png

  • Scene Graph 탭에 대한 선반 위치

shelf_SceneGraphTab.png

  • 매개변수 탭을 통해 사용 가능한 노드 내의 위젯 도구 모음

shelf_ParametersTab.png

다양한 유형의 선반과 특정 위치에 대한 선반 항목 스크립트를 설정하는 방법에 대해 자세히 알아보려면 선반 항목 스크립트 사용자 가이드를 참조하세요.

선반 항목 스크립트 만들기

첫 번째 선반 항목 스크립트를 설정할 때는 여러 단계를 거쳐야 합니다.

  1. 시작하려면 Katana 열고 Shelf Action (톱니바퀴)을 선택하세요.gear16.png 아이콘)을 클릭합니다.
  2. UI의 오른쪽 상단에서 ' 추가 -> 새 선반... '을 선택하면 스크립트에 대한 사용자 정의 선반이 생성됩니다.
    NewShelf1.PNG

    NewShelf.PNG
    새로운 선반 이름을 입력하고 확인을 클릭합니다.

  3. 선반 작업 톱니바퀴 아이콘으로 돌아가서 새로 만든 선반을 선택하고 ' 추가 -> 새 항목... ' 을 사용하여 첫 번째 선반 항목을 추가합니다.
    selectNewShelf.png새 항목.png
    팝업 창이 나타나면 선반 항목의 이름을 지정하고 원하는 경우 단축키를 지정할 수 있습니다. 그런 다음 '확인'을 선택하세요.

    NewShelfScript.PNG
    참고:
    사용자 지정 선반 항목에 키보드 단축키를 설정할 때 Katana 에 이미 존재하는 단축키는 사용할 수 없습니다. 경고 메시지가 표시되며, Katana 기본 키보드 단축키 목록은 키보드 단축키 리소스에서 확인할 수 있습니다.

  4. 생성을 초기화한 후 Shelf Item Python Script 파일이 포함된 텍스트 문서가 열립니다. ShelfScript_NotePad.PNG
    이렇게 하면 기본적으로 Katana 터미널 창에 'hello, world'가 인쇄됩니다.

    참고: NodegraphAPI 명령을 사용하면 Python 스크립트에 추가 기능을 추가할 수 있습니다.

  5. 기본 선반 작업 에서 선반 항목 스크립트를 실행하거나, 새 선반을 선택하고 새 선반 항목을 클릭하거나, 앞서 추가한 키보드 단축키를 사용합니다.

    런셸프.PNG
    이렇게 하면 Katana 터미널 창에 'hello, world'가 출력됩니다.

추가 읽기

Katana 의 Shelf Item Scripts에 대한 개요는 Shelf Item Scripts 사용자 가이드를 참조하세요.

사용자 정의 Python 함수를 추가하고 사용자 정의 아이콘이나 키보드 단축키를 포함하도록 docstring을 편집하여 선반 항목을 개선하려면 Q100402: Katana 에서 선반 항목을 편집하고 제거하여 기존 사용자 정의 Python 스크립트를 수정하는 방법을 읽어보세요.

입력/출력 포트의 이름을 바꾸는 데 사용되는 Shelf Item 스크립트의 예를 보려면 Q100372: 더 명확한 연결을 위해 Python으로 입력 및 출력 포트의 이름을 바꾸는 방법을 읽어보세요.

    우리는 문제로 불편을 끼쳐 드려 죄송합니다

    이유를 알려주세요