Changes

Jump to navigation Jump to search

Documentation/Tools/SCS Blender Tools/Global Settings

1,913 bytes added, 14:56, 11 November 2016
SCS Project Base Path
Global Settings hold common settings to whole SCS Blender Tools addon and are defined either per-machine not or per-blender file like any other properties in Blender, depending on user choice.
<blockquote>NOTE: Altered items are written to the settings file (config.txt) immediately, so the next time you start Blender all the settings will be preserved, even if application experience crash. If you want to reset settings to default navigate to installed Blender Tools in file browser, delete file &quot;io_scs_tools/config.txt&quot; and restart Blender.</blockquote>'''''Global Settings''''' sub-palette can be find found within '''''SCS Tools''''' palette panel in '''''Scene''''' settings of the Properties window.
[[File:SCS_Tools_Properties_-_icons_01.png]]
There are two sub-palettes: '''''Path Settings''''' panels (categorizing most of the properties into proper layout) and '''''Display Settings'''''panel for uncategorised global settings.
[[File:SCS_Tools_Globals_01.png]]
== Path Settings ==
Before you start to use the tools, it is necessary to specify where to access data sources, which are used for filling up of some library menus and addressing textures.  First of all, you’ll need to set the main folder that contains your project. Do it to the “SCS Project Base Path” entry. Other routes usually proceed from that location, and therefore can be stored in the form of a relative path. However that doesn’t need to be the rule every time and therefore the mechanism for path selection in the SCS Tools will always decide the appropriate form for the path.  If paths are set properly is clearly seen from color of its background – if any entry is faulty, the background is in red color and needs to be set to the valid location or valid library file.
[[File:SCS_Tools_Globals_Path_01.png]]
''[folder, always absolute path]''
'''''This is most important path, which leads to “base” root directory of your mod for any SCS game. Base directory always has to have specific structure, because of relative texture and definition file addressing.''''' So all of the paths of following libraries should continue from this location and should be in relative form. However if you prefer another location for those libraries, you can use it and the path form will be automatically chosen.<blockquote>{{Note|For importing sample models make sure you set SCS Project Base Path to one of the sample base folders inside &quot;data&quot; directory of downloaded SCS Blender Tools package.}}</blockquote>
<blockquote>NOTE: For importing sample models make sure you set SCS Project Base Path to one of the sample base folders inside &quot;data&quot; directory of downloaded SCS Blender Tools package.
</blockquote>
<blockquote>NOTE: You should prefer another location for libraries only if you are using any custom library file.
</blockquote>
=== Trigger Action Library ===
=== Hookup Library ===
''[folder, absolute or relative path to 'SCS Project Base Path']''
Directory containing predefined Hookup files. You can assign them to Model Locators which are used in game to instance other game models within actual model.
Shader Presets library filepath. This library has been created specially for SCS Blender Tools and thus it is located in its installation folder. The correct path should be set automatically.
 
=== Conversion Tools Path ===
 
Property holding path to directory where you extracted [[Documentation/Tools/Conversion Tools|Conversion Tools]] and is used by operators from [[Documentation/Tools/SCS Blender Tools/Conversion Helper|Conversion Helper]]. Also note that you should select proper conversion tools depending on the game you want to use your content for.
== Display Settings ==
=== Collider Locator Wire Color ===
Custom color for Collider Locators' wire frames.
=== Collider Locator Face Color ===
Custom color for Collider Locators' faces.
=== Display Connections ===
Turns on and off displaying of Locators' connections - Curves and Lines.
=== Optimized Connections Draw ===
Turns on and off displaying of Preview models for Locators.
 
=== Base Paint Color ===
 
For greater diversity in SCS games there is paintable functionality, which is usually used on AI traffic cars and makes each car using different color based on it's configuration in SII file. However as Blender Tools does not read this kind of SII files, every shader with "paint" flavor will use this base paint color property for previewing.
 
In case you don't want to change look of shaders with this functionality make sure this property in display setting has set complete white color RGB(1.0, 1.0, 1.0).
 
== Uncategorised Global Settings & Operators ==
 
[[File:SCS_Tools_Globals_Uncategorised.png]]
 
=== Copy BT Log To Clipboard ===
 
Simple tool to copy log of Blender Tools to clipboard. Clipboard will have whole Blender Tools log since Blender was started up.
 
This tool can be used to easily grab log when you want to report some issues with your usage of Blender Tools.
 
=== Log Level ===
 
Sets level of logging inside Blender console. Recommended level for normal usage is 2, however when trying to investigate bugs or errors it is useful to use logging up to level 4.
 
=== Use Global Settings ===
 
Sets place of global settings storage:
 
<ol>
<li>'''''From Common Config File''''' - will save global settings into one same config.txt file, thus this option will give you same settings for all Blender files you will be working on (global settings per machine).
<blockquote>{{Note|Altered items are written to the settings file (config.txt) immediately, so the next time you start Blender all the settings will be preserved, even if application experience crash. If you want to reset settings to default navigate to installed Blender Tools in file browser, delete file &quot;io_scs_tools/config.txt&quot; and restart Blender.}}
</blockquote>
</li>
<li>'''''From Blend File''''' - will save global settings directly into blend file, giving you opportunity for each saved Blender file to have it's own settings (global settings per blend file).</li>
</ol>

Navigation menu