Redshift Environment Variables 红移环境变量
The previous section described the basic environment variables that can be used to customize the paths used by Redshift for its core data and plugins.
前面的部分描述了基本的环境变量，这些环境变量可以用来定制 Redshift 为其核心数据和插件使用的路径。
The default behavior of Redshift can be further customized using several additional environment variables.
可以使用几个其他环境变量进一步定制 Redshift 的默认行为。
REDSHIFT_CACHEPATH |
The Redshift disk cache path is normally defined as a system-wide preference in the 中的系统范围首选项通常定义为红移磁盘缓存路径preferences.xml file in the Redshift local data path. The value set in the global preferences can be overridden using the environment variable REDSHIFT_CACHEPATH. |
REDSHIFT_TEXTURECACHEBUDGET |
Similar to 类似于REDSHIFT_CACHEPATH, the 、预防退伍军人病委员会REDSHIFT_TEXTURECACHEBUDGET variable can be used to override the values defined in the system preferences. 变量可用于覆盖系统首选项中定义的值 |
REDSHIFT_MAXLOGSTOKEEP |
By default, Redshift stores the log files for the last 10 sessions. The number of log files to keep can be adjusted by setting the 默认情况下，Redshift 存储最后10个会话的日志文件。属性来调整要保存的日志文件的数量REDSHIFT_MAXLOGSTOKEEP environment variable. A negative value (e.g. -1) will prevent older log files from being automatically purged at startup. 负值(例如-1)将防止在启动时自动清除旧的环境变量文件 |
REDSHIFT_GPUDEVICES |
When defined, this variable overrides the which GPUs will be used for rendering (normally defined in the preferences.xml file in the Redshift local data path). Set REDSHIFT_GPUDEVICES to a comma-separated list of GPU ordinals. 以逗号分隔的 GPU 序号列表For example, 比如说,REDSHIFT_GPUDEVICES=0,1 will force the system to use GPU devices 0 and 1 for rendering. 将迫使系统使用 GPU 设备0和1渲染Note that this variable is read only when Redshift initializes. Any changes to the variable will only take effect after the host application is closed and relaunched. 请注意，此变量仅在初始化 Redshift 时读取。对变量的任何更改只有在关闭并重新启动宿主应用程序后才会生效 |
REDSHIFT_LICENSERETURNTIMEOUT |
Redshift always attempts to check out a license when it starts rendering a frame. By default, the license is not immediately returned when the frame finishes, but is instead kept checked out. If within 5 seconds, there is no further rendering activity, Redshift returns the license (licenses are also automatically returned when closing the host application). This timeout is configurable using the environment variable 当一个许可证开始呈现一个帧时，Redshift 总是尝试检出它。默认情况下，当帧结束时不会立即返回许可证，而是保持签出。如果在5秒内没有进一步的呈现活动，Redshift 将返回许可证(在关闭主机应用程序时也会自动返回许可证)。这个超时是可以通过环境变量的 REDSHIFT licenser/turntimeout 配置的。负值(例如-1)将导致许可被签出，直到主机应用程序(Maya 等)关闭。正值以秒为单位定义超时。允许浮点值(例如2.5)。 |
REDSHIFT_DISABLELICENSECHECKOUTONINIT |
Added in version 2.5.51 在2.5.51版本中添加 In order to display license information early, Redshift by default checks out a license at initialization (when the Redshift plugin loads in the host DCC application) and checks it back in immediately. This behavior can be disbaled by defining the environment variable 为了尽早显示许可证信息，Redshift 默认在初始化时检出一个许可证(当 Redshift 插件在主机 DCC 应用程序中加载时)并立即检入。这种行为可以通过定义环境变量/红移/diselicensechecoutoninit 来解除。如果定义了许可证，则只会在呈现期间签出许可证。 |
REDSHIFT_DISABLEOUTPUTLOCKFILES |
When Redshift starts rendering a frame, it writes out a 当 Redshift 开始渲染一个帧时，它会写出一个.lock file for each output image to be rendered. These lock files are used to prevent multiple instances of Redshift from rendering to the same file concurrently. In the event that this behavior is causing problems, defining the variable R 每个输出图像要渲染的文件。这些锁文件用于防止红移的多个实例并发地呈现到同一文件。如果此行为导致了问题，则定义变量 rEDSHIFT_DISABLEOUTPUTLOCKFILES will disable the use of lock files altogether. 将完全禁用锁文件的使用 |
REDSHIFT_PATHOVERRIDE_FILE |
Added in version 2.5.61 在2.5.61版本中添加 A proxy file can contain references to other proxies, VDBs, textures, etc. If these assets are moved from their original folder locations, the proxy loader will fail to find them and load them. The 代理文件可以包含对其他代理、 VDBs、纹理等的引用。如果这些资产从其原始文件夹位置移动，代理加载器将无法找到它们并加载它们。文件环境变量可以指向一个文本文件，该文件用于将路径从一个位置“翻译”到另一个位置。文本文件应该包含双引号括起来的字符串对。这对字符串的第一个字符串是“ from”路径，第二个字符串是“ to”路径。 So, for example, if the environment variable is set to 所以，举个例子，如果美国环境变量设置为
文件 = c: mypathoverrides.txt ... the file Txt 文件可以包含以下内容，这有助于从本地文件夹映射到某个共享的网络位置
“ c: MyTextures”“ MYSERVER01 Textures”
“ c: MyVDBs”“ MYSERVER01 VDBs” |
REDSHIFT_PATHOVERRIDE_STRING |
Added in version 2.5.61 在2.5.61版本中添加 This is similar to 这类似于 REDSHIFT _ pathoverride _ file，只不过环境变量本身包含双引号分隔的对列表:
“”“”“”“”“”“” Please note that, if both 请注意，如果同时定义了 REDSHIFT _ pathoverride _ file 和 REDSHIFT _ pathoverride _ string 环境变量，则 REDSHIFT _ pathoverride _ file 优先 |
REDSHIFT_ABORTONLICENSEFAIL |
Added in version 2.5.72 在2.5.72版本中添加 Redshift normally renders with a watermark if it fails to obtain a license. Enabling the render option Abort on License Failure in the System tab will cause Redshift to abort the frame instead of rendering with watermarks. Setting the environment variable 红移通常呈现与水印，如果它未能获得许可证。在系统选项卡中启用渲染选项 Abort on License Failure 将导致红移中止框架而不是使用水印渲染。将环境变量红移/abortonlicensefail 设置为除“0”或“ FALSE”以外的任何值，提供了一个全系统范围的替代方案，可以启用许可失败中止呈现选项。 |
|
红移/cpuaffinity |
Added in version 2.6.15 在2.6.15版本中添加 Allows the limiting of CPU threads. For example: 允许限制 CPU 线程。例如:
2. 红移 cpuaffinity = 2 will tell the various Redshift systems to use no more than two threads. Please note that some systems might have to use a certain number of threads onwards. 将告诉各种红移系统使用不超过两个线程。请注意，有些系统可能必须使用一定数量的线程。 Important note: When rendering with multiple GPUs, please ensure to use a value no smaller than the number of GPUs the renderer will use. 重要提示: 当使用多个 gpu 渲染时，请确保使用的值不小于渲染器将使用的 gpu 数量。 |
REDSHIFT_FORCEQUITONINTERNALERROR |
Added in version 2.6.27 在2.6.27版本中添加 When set to any value other than 0, will force a hard crash when an unrecoverable error occurs while rendering 当设置为0以外的任何值时，当呈现过程中出现不可恢复的错误时，将强制崩溃 |
OCIO |
Added in version 2.6.39 在2.6.39版本中添加 If a valid path is found it will override the default Display Mode to OCIO and sets the OCIO Config path to this. 如果找到一个有效的路径，它将覆盖默认的显示模式为 OCIO，并将 OCIO 配置路径设置为此。 |
OCIO_ACTIVE_DISPLAYS |
Added in version 2.6.39 在2.6.39版本中添加 Override to only provide the given displays in the View Transform combo box. 重写以仅在“视图变换”组合框中提供给定的显示。 |
OCIO_ACTIVE_VIEWS |
Added in version 2.6.39 在2.6.39版本中添加 Override to only provide the given views in the View Transform combo box. 重写以仅在“视图转换”组合框中提供给定的视图。 |
|
最终目标 |
Added in version 2.6.42 在2.6.42版本中添加 Sets the directory snapshots are saved to. 设置保存的目录快照。 Important note: Specified directories set with Snapshot Configuration > Path take priority. 重要提示: 用 Snapshot Configuration 设置指定的目录 > Path 具有优先权。 |
RS_PRESET_DIR |
Added in version 2.6.44 在2.6.44版本中添加 Sets the directory to load post effect presets. The directory should contain folders for each post effect to correctly load by user defined defaults. 设置加载后期效果预设的目录。目录应该包含文件夹，用于根据用户定义的默认值正确加载每个 post 效果。 |
REDSHIFT_TEXTUREFILELOCKINGDISABLED |
Added in version 2.6.48 在2.6.48版本中添加 Disables texture file locking; this can help improve performance on Operating Systems that have slow file locking mechanisms, for when textures have been pre-converted and are not going to be copied to the local cache. 禁用纹理文件锁定; 这有助于提高具有缓慢文件锁定机制的操作系统的性能，因为纹理已经预先转换，不会被复制到本地缓存。 |
REDSHIFT_FILESTREAMBUFFERSIZE |
Added in version 3.0.28 在3.0.28版本中添加 Sets the minimum number of KBytes Redshift will read from a filestream during file access. The default setting is "16" which means Redshift will read a file in chunks of 16KB. Larger values like 64, 256 or even 1024 might help with network file access performance for certain networks. Larger values, though, also mean that Redshift can "overfetch" data which could have an adverse performance effect. We, therefore, recommend using this env variable only if you encounter considerable network file performance issues. 设置在文件访问期间从文件列表读取的最小 KBytes 红移量。默认设置是“16”，这意味着红移将读取大块16KB 的文件。较大的值，如64、256甚至1024，可能有助于某些网络的网络文件访问性能。不过，较大的值也意味着 Redshift 可以“超取”数据，这可能会对性能产生不利影响。因此，我们建议只有在遇到大量网络文件性能问题时才使用此 env 变量。 |
Houdini Specific Environment Variables
特定环境变量
REDSHIFT_RV_ALWAYSONTOP |
Can be set to "0" or "1" to configure the RSRenderView always on top initial state. 可以设置为“0”或“1”来配置 RSRenderView 始终处于顶部初始状态 |
REDSHIFT_AUTOSPAREPARAMS |
Can be set to "0" to disable the automatic creation of the Redshift spare parameters tabs. 可以设置为“0”来禁用自动创建的红移备用参数标签 |
REDSHIFT_RV_OPEN_ONLY |
Added in version 2.6.49 在2.6.49版本中添加 When set to 1 to open the RenderView from the shelf tool without rendering. 当设置为1时，在没有渲染的情况下从搁板工具打开渲染视图。 |
REDSHIFT_DEFAULT_SHADER_COLOR |
Added in version 2.6.49 在2.6.49版本中添加 Configure the default shader color as three float RGB values. 将默认着色器颜色配置为三个浮动 RGB 值。 |
Katana Specific Environment Variables
武士刀特定环境变量
REDSHIFT_DEFAULT_SHADER_COLOR |
Added in version 2.6.49 在2.6.49版本中添加 Configure the default shader color as three float RGB values. 将默认着色器颜色配置为三个浮动 RGB 值。 |
赶快留个言打破零评论！~