Q100402: Katana 에서 선반 항목을 편집 및 제거하여 기존 사용자 정의 Python 스크립트를 수정하는 방법

Bradley Webster

업데이트 된 : 2024년 08월 02일 19:48

만들어진 : 2018년 05월 11일 07:35

요약

이 도움말에서는 실행기 항목 편집/사용자 지정과 필요한 경우 제거하는 절차를 다룹니다.

처음으로 선반 항목을 설정하려는 경우Q100401: Katana 에서 선반 항목을 만드는 방법 의 단계와 정보를 따르십시오.

선반 항목 편집

선반 항목은 생성 후 Katana 의 선반 항목 Python 스크립트에 액세스하거나 .katana 및 관련 선반, ShelvesNodeSpecific 또는 ShelvesScenegraph 디렉터리로 이동하여 스크립트를 찾아서 편집할 수 있습니다.

1. Katana 에서 스크립트에 액세스하려면 선반 작업을 열고 원하는 선반 항목을 선택한 다음 ' 소스 보기 '를 마우스 오른쪽 버튼으로 클릭하세요.

뷰소스.png

그러면 다음과 같은 텍스트 편집기에서 선반 항목 Python 스크립트가 열립니다.

2. Katana 외부에서 스크립트에 액세스하려면 .katana/Shelves, .katana/ShelvesNodeSpecific 또는 .katana/ShelvesScenegraph 폴더로 이동하여 관련 .py 파일을 찾습니다.

이는 선반 항목의 이름을 딴 해당 디렉터리 중 하나의 하위 폴더에 있습니다. 여기에서 원하는 Python 편집기에서 파일을 열 수 있습니다.

선반 항목 스크립트의 독스트링

Q100401: How to create a Shelf Item in Katana 에 설명된 프로세스를 사용하여 선반 항목 스크립트를 만든 경우 기본적으로 다음과 같은 독스트링이 포함됩니다.

""" 
NAME: <the name of the script to show in the UI>
ICON: <the filename of icon to use in the UI>
KEYBOARD_SHORTCUT: <the keyboard shortcut to use in the UI to run the Shelf Item Script>
SCOPE: <names of types of nodes to target by node-specific shelf items> 
<description> 
"""

여기에는 아래에 자세히 설명된 대로 스크립트에 대한 정보가 들어 있습니다.

NAME은 스크립트 항목이 실행기 작업에 표시되는 이름입니다.
ICON은 선택한 아이콘의 이미지 위치입니다. (아래에서 더 논의)
KEYBOARD_SHORTCUT은 스크립트 항목을 실행할 수 있는 바로가기입니다.
SCOPE는 선반 항목이 적용되는 특정 노드 유형을 정의하는 데 사용됩니다.
<설명>은 실행기 항목에 대한 도움말 툴팁입니다.

참고: 사용자 정의 선반 항목에 대한 키보드 단축키를 설정할 때 이미 Katana 에 있는 단축키를 사용할 수 없습니다. 경고가 표시되어야 하며 Katana 기본 키보드 단축키 목록은 키보드 단축키 리소스에서 찾을 수 있습니다.

선반 항목 스크립트 편집

위의 독스트링을 활용하는 방법을 보여주기 위해 아래 선반 항목 스크립트를 빈 .py 파일에 복사하고 .katana/Shelves/Custom_Shelves/ 디렉터리에 저장합니다.

"""
NAME: Float Selected
ICON: Icons\Scenegraph\locator32.png
KEYBOARD_SHORTCUT: T
SCOPE: none
Float Selected Nodes via Keyboard Shortcut
"""

# Get list of selected nodes
nodeList = NodegraphAPI.GetAllSelectedNodes()

# Find Nodegraph tab and float nodes
nodegraphTab = UI4.App.Tabs.FindTopTab('Node Graph')
if nodegraphTab:
    nodegraphTab.floatNodes(nodeList)

스크립트를 저장한 후 Katana Shelf Action 메뉴의 ' 추가 -> 선반 다시 로드' 를 통해 선반을 다시 로드하세요.

실행기 항목은 사용자 정의 키보드 단축키, 아이콘 및 도움말 도구 설명과 함께 '선택 항목 부동'으로 표시되어야 합니다.

선반 항목 스크립트 기능은 키보드 단축키(T)를 사용하거나 선반 작업 메뉴에서 선반 항목을 선택하여 트리거될 때 현재 선택된 노드를 부동화하는 것입니다.

플로팅 노드는 마우스 왼쪽 버튼을 클릭하여 놓을 때까지 커서를 따라가므로 선택한 노드나 배경을 수동으로 클릭하고 드래그할 필요가 없습니다.

유사한 Python 함수를 함께 사용하는 방법에 대한 자세한 내용은 예제 스크립트 개발자 가이드에서 확인할 수 있습니다.

선반 항목 아이콘 선택

선반 작업 메뉴에 표시된 선반 항목의 아이콘을 바꾸려면 다음 위치에서 Katana 의 기본 아이콘 중 하나를 선택할 수 있습니다: $KATANA_HOME\bin\python\UI4\Resources\Icons

선반 항목에 Katana 에서 사용할 수 있는 아이콘을 사용하려면 Katana 의 기본 리소스 검색 경로 뒤에 아이콘 경로를 지정해야 합니다. Katana 의 기본 리소스 검색 경로는 $KATANA_HOME\bin\python\UI4\Resources입니다. 예를 들어:

아이콘: Icons\Scenegraph\locator32.png

참고: 다른 사용자 정의 아이콘을 사용하려면 Python 스크립트의 ICON 섹션에 전체 아이콘 경로를 추가해야 합니다.

선반 제거

선반 작업에서 선반을 제거하려면 .katana\Shelves 폴더에서 선반 폴더를 삭제하면 됩니다. Katana 연 상태에서 변경 사항을 보거나 드롭다운 선반에서 선반을 제거하려는 경우 Reload Shelf를 클릭하면 .katana/shelf 파일에 대한 변경 사항이 Katana 장면에서 업데이트됩니다.