요약
Katana 실행하고 다양한 렌더러 플러그인을 사용하려면 몇 가지 환경 변수가 올바르게 설정되어 있는지 확인해야 합니다. 이러한 환경 변수를 관리하는 가장 쉬운 방법은 Katana 시작하는 실행기 배치 스크립트를 만드는 것입니다.
이 글에서는 다양한 렌더러 플러그인을 다루는 몇 가지 예제 스크립트를 제공합니다. 이 스크립트는 바로 사용할 수 있으며, 해당 렌더러 플러그인의 기본 설치 경로를 사용하여 구성됩니다.
아직 Windows에 Katana 설치하고 라이선스를 취득하지 않았다면 Windows 사용자 가이드에 설치하기 전에 먼저 읽어보세요.
KATANA 런처 스크립트 용어
모든 런처 스크립트는 Katana 성공적으로 실행하기 위해 다음 환경 변수가 필요합니다. 편의를 위해 변수와 그 주요 기능을 아래에 정리했습니다.
환경 변수 |
기능 |
| KATANA _루트 | Katana 의 루트 설치 위치는 C:\Program Files\Katana7.0v1 입니다. 기본 위치는 다음과 같습니다. |
| 길 | 명령으로 사용될 다양한 모듈을 검색하기 위한 디렉토리를 지정하는 운영 체제 변수입니다. |
| KATANA _리소스 | 플러그인 및 기타 사용자 지정 항목을 찾는 데 사용되는 경로 목록입니다. 예: 셰이더, 매크로, SuperTools 등. 자세한 내용은 Katana Docs의 Katana 리소스 페이지를 참조하세요. |
아래는 런처 배치 스크립트에서 사용되는 몇 가지 일반적인 배치 명령과 편의를 위한 설명입니다.
| 명령 | 기능 |
| 렘 | 현재 줄을 주석으로 표시합니다. 이 명령으로 시작하는 줄은 스크립트 실행 시 무시됩니다. |
| @에코 꺼짐 | 명령 프롬프트 창에서 실행된 명령의 표시를 비활성화합니다. |
| 세트 | 주어진 환경 변수를 지정된 값이나 경로로 설정합니다. 여러 값이나 경로는 세미콜론(;)으로 구분할 수 있습니다. |
"%KATANA_ROOT%\bin\katanaBin.exe"
|
지정된 Katana 실행 파일을 실행합니다. 배치 파일이 이 줄에 도달하면 Katana 에서 실행한 명령을 반영하는 명령 프롬프트가 나타납니다. |
런처 스크립트 구성
이 스크립트를 수정하고 사용하는 방법에 대한 지침은 다음 단계를 따르세요.
- 아래 스크립트 중 하나의 내용(예시: 런처 배치 스크립트 )을 복사하여 텍스트 편집기(예: 메모장) 에 붙여넣습니다.
예제 파일도 첨부되어 있으니, 첨부된 배치 스크립트를 다운로드하세요. .bat 파일을 편집하려면 파일을 마우스 오른쪽 버튼으로 클릭하고 '편집'을 선택하세요. - 스크립트를 주의 깊게 읽고 지정된 경로가 컴퓨터에서 동일한지 확인하세요. 동일하지 않다면 올바른 위치를 가리키도록 경로를 업데이트하세요.
- 렌더러나 사용자 정의 스크립트 등 사용하지 않는 도구에 대한 섹션을 삭제합니다.
- 파일을 Katana 7.0v1.bat 라는 이름으로 저장하고 닫습니다.
- 이제 .bat 파일을 두 번 클릭하거나 마우스 오른쪽 버튼을 클릭 > 열기를 선택 하면 명령이 실행되고 모든 필수 환경 변수가 설정된 Katana 시작됩니다.
예를 들어 Python 탭에서 다음 명령을 실행하여 올바르게 설정되었는지 확인할 수 있습니다.
import os
print(os.environ['KATANA_RESOURCES'])
이렇게 하면 런처 스크립트에서 KATANA _RESOURCES에 추가한 경로가 출력됩니다. - Katana 클릭하여 실행할 수 있는 바탕 화면 아이콘이 필요한 경우 다음과 같은 방법으로 추가할 수 있습니다.
- .bat 파일을 마우스 오른쪽 버튼으로 클릭하고 바로 가기 만들기를 선택합니다.
- 생성된 바로가기를 바탕 화면에 놓습니다.
- 바로가기를 마우스 오른쪽 버튼으로 클릭 > 속성 > 바로가기 탭 > 아이콘 변경…
- 이제 .bat 파일에 아이콘이 없다는 경고가 표시될 수 있습니다. "확인"을 클릭하면 다른 위치에서 아이콘을 선택할 수 있는 옵션이 나타납니다.
- 찾아보기 ...를 클릭하고 Katana 설치 디렉터리(KATANA_ROOT)로 이동합니다. WindowsIcon.ico 파일을 선택하고 열기를 클릭합니다. 확인을 클릭하여 아이콘 변경 대화 상자를 닫고, 확인을 클릭하여 속성 창을 닫습니다.
이제 바탕 화면에 Katana 아이콘이 표시된 Katana 실행기 스크립트 바로 가기가 생겼습니다.
예제 스크립트
다음 드롭다운 섹션에서는 가장 일반적으로 사용되는 각 렌더 플러그인에 대한 예제 스크립트를 소개합니다. 이 스크립트는 바로 사용할 수 있으며, 해당 렌더 플러그인의 기본 설치 경로를 사용하여 구성되어 있습니다. 이 문서 하단의 첨부 파일 섹션에서 예제를 다운로드할 수도 있습니다.
렌더맨
아래는 Katana 렌더러 플러그인용 RenderMan의 런처 배치 스크립트 예시입니다. RenderMan 관련 환경 변수에 대한 자세한 내용은 해당 설명서 페이지 Katana 의 환경 변수"를 참조하세요.
@echo off rem -- Define the install location for KATANA -- set "KATANA_ROOT=C:\Program Files\Katana7.0v1" rem -- select which renderer Katana expects by default when rendering -- set "DEFAULT_RENDERER=prman" rem -- Location of the RenderMan Pro Server installation -- set "RMANTREE=C:\Program Files\Pixar\RenderManProServer-26.3" rem -- Location of the PRman plugin for KATANA -- set "RFKTREE=C:\Program Files\Pixar\RenderManForKatana-26.3\plugins\katana7.0" rem -- This is what is required to load the RfK plugin -- set "KATANA_RESOURCES=%KATANA_RESOURCES%;%RFKTREE%" rem -- These are required for the hdPrman Render Delegate set "FNPXR_PLUGINPATH=%RFKTREE%\usd"
set "RMAN_SHADERPATH=%RMAN_SHADERPATH%;%RFKTREE%\usd\resources\shaders"
set "RMAN_RIXPLUGINPATH=%RMAN_RIXPLUGINPATH%;%RFKTREE%\usd"
rem -- Start Katana -- "%KATANA_ROOT%\bin\katanaBin.exe"
참고: 이 스크립트에 사용된 다양한 구성 요소에 대한 경로가 서로 다르다면 해당 경로를 시스템의 올바른 위치로 업데이트해야 합니다.
아놀드
다음은 Arnold for Katana 렌더러 플러그인의 런처 배치 스크립트 예시입니다. Arnold 관련 환경 변수 및 설치에 대한 자세한 내용은 해당 설명서 페이지 "설치 - Arnold for Katana 를 참조하세요.
@echo off rem -- Define the install location for KATANA -- set "KATANA_ROOT=C:\Program Files\Katana7.0v1" rem -- select which renderer Katana expects by default when rendering -- set "DEFAULT_RENDERER=arnold" rem -- Where you have installed the KtoA plug-in -- set "KTOA_HOME=C:\Program Files\ktoa\ktoa-4.3.2.1-kat7.0-windows" rem -- The KtoA bin folder is needed in PATH -- set "PATH=%PATH%;%KTOA_HOME%\bin" rem -- This is how to load the KtoA plug-in -- set "KATANA_RESOURCES=%KATANA_RESOURCES%;%KTOA_HOME%" rem -- Start Katana -- "%KATANA_ROOT%\bin\katanaBin.exe"
참고: 이 스크립트에 사용된 다양한 구성 요소에 대한 경로가 서로 다르다면 해당 경로를 시스템의 올바른 위치로 업데이트해야 합니다.
3딜라이트
3Delight는 Katana 설치 및 구성에 사용되는 렌더러이며, Katana 설치 폴더에 있는 기본 실행 파일을 통해 액세스할 수 있습니다. 3Delight 설치를 이전했거나 다른 버전을 사용하려는 경우, 다음 예제 런처 배치 스크립트는 필요한 환경 변수를 보여줍니다. 자세한 내용은 Katana 설치용 3Delight 설명서 페이지를 참조하세요.
@echo off rem -- Define the install location for KATANA -- set "KATANA_ROOT=C:\Program Files\Katana7.0v1" rem -- select which renderer Katana expects by default when rendering -- set "DEFAULT_RENDERER=dl" rem -- Location of where the main 3Delight package is installed -- set "DELIGHT=C:\Program Files\3Delight" rem -- The 3Delight bin folder is needed in PATH -- set "PATH=%PATH%;%DELIGHT%\bin" rem -- Location of the 3Delight for KATANA plug-in -- set "KATANA_RESOURCES=%KATANA_RESOURCES%;%DELIGHT%\3DelightForKatana" "%KATANA_ROOT%\bin\katanaBin.exe"
참고: 이 스크립트에 사용된 다양한 구성 요소에 대한 경로가 서로 다르다면 해당 경로를 시스템의 올바른 위치로 업데이트해야 합니다.
적색편이
아래는 Katana 렌더러 플러그인용 Redshift의 런처 배치 스크립트 예시입니다. Redshift 관련 환경 변수에 대한 자세한 내용은 해당 문서 페이지 Katana 플러그인 구성"을 참조하세요.
@echo off rem -- Define the install location for KATANA -- set "KATANA_ROOT=C:\Program Files\Katana7.0v1" rem -- select which renderer Katana expects by default when rendering -- set "DEFAULT_RENDERER=redshift" rem -- Location of the RedShift bin folder -- set "REDSHIFT_HOME=C:\ProgramData\Redshift\bin" rem -- Location of the RedShift plugin for KATANA -- set "REDSHIFT4KATANA_HOME=C:\ProgramData\Redshift\Plugins\Katana\7.0v1" rem -- This is what is required to load the RedshiftForKatana plugin -- set "PATH=%PATH%;%REDSHIFT_HOME%" set "KATANA_RESOURCES=%KATANA_RESOURCES%;%REDSHIFT4KATANA_HOME%" "%KATANA_ROOT%\bin\katanaBin.exe"
참고: 이 스크립트에 사용된 다양한 구성 요소에 대한 경로가 서로 다르다면 해당 경로를 시스템의 올바른 위치로 업데이트해야 합니다.
고급 팁 및 요령
다중 렌더러 플러그인
Katana 여러 렌더러 플러그인과 함께 동시에 실행할 수 있습니다. 각 플러그인에 필요한 모든 환경 변수를 하나의 배치 파일로 통합하면 Katana 에서 두 플러그인 모두에 액세스할 수 있습니다. 단, DEFAULT_RENDERER 변수에는 렌더러를 하나만 지정할 수 있습니다.
사용자 정의 환경 변수
사용자 지정 환경 변수를 직접 생성할 수도 있습니다. 여러 버전의 Katana 또는 특정 렌더러 플러그인 간에 빠르게 전환하려는 경우 매우 유용합니다. 아래는 OPTIONS 헤더 아래에 세 개의 사용자 지정 변수가 생성된 RenderMan 스크립트 예시입니다. 경로의 일부가 퍼센트 기호로 둘러싸인 환경 변수 이름으로 대체된 것을 확인할 수 있습니다. 이렇게 하면 해당 이름이 이전에 스크립트에 설정한 값으로 대체됩니다.
@echo off rem ** OPTIONS ** set "KAT_VER=7.0v1" set "REN_VER=26.3" set "KAT_LINE=7.0" rem -- Define the install location for KATANA -- set "KATANA_ROOT=C:\Program Files\Katana%KAT_VER%" set "DEFAULT_RENDERER=prman" rem -- Location of the RenderMan Pro Server installation -- set "RMANTREE=C:\Program Files\Pixar\RenderManProServer-%REN_VER%" rem -- Location of the PRman plugin for KATANA -- set "RFKTREE=C:\Program Files\Pixar\RenderManForKatana-%REN_VER%\plugins\katana%KAT_LINE%" rem -- This is what is required to load the RfK plugin -- set "KATANA_RESOURCES=%KATANA_RESOURCES%;%RFKTREE%" "%KATANA_ROOT%\bin\katanaBin.exe"
추가 읽기
Katana 실행 및 사용 가능한 다양한 실행 모드에 대한 자세한 내용은 Katana 설명서의 Windows에서 실행 섹션을 참조하세요.
첨부 파일
우리는 문제로 불편을 끼쳐 드려 죄송합니다
이유를 알려주세요