Difference between revisions of "Documentation/Tools/SCS Blender Tools/Export Panel"

From SCS Modding Wiki
Jump to navigation Jump to search
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
Export panel is located within Scene tab and offers a quick way for content export to the game.
+
Export panel is located within ''Output'' tab of properties window and offers a quick way for content export to the game.
  
[[File:SCS_Tools_Export_00.png]]
+
[[File:SCS_Tools_Export_00.280.png]]
  
 
== Export modes (Scope) ==
 
== Export modes (Scope) ==
Line 9: Line 9:
 
Exports only selected objects, while there are certain logical rules for deciding about objects' inclusion in export from initial selection. When the Root Object is selected, all its content will be exported. When only some mesh objects are selected, then only those are exported for their Game Objects. In these cases it is not important if their Root Object is selected or not.
 
Exports only selected objects, while there are certain logical rules for deciding about objects' inclusion in export from initial selection. When the Root Object is selected, all its content will be exported. When only some mesh objects are selected, then only those are exported for their Game Objects. In these cases it is not important if their Root Object is selected or not.
  
'''Preview Selection''' - shows all the objects that will be exported. This is very good way, how to be sure about exported content. It will show always only geometries and locators, that are going to be exported. Selection previewing is extra mode, where you can use '''''Numpad''''' keys for view manipulation similar way like Blender standardly does – '''''4''''' and '''''6''''' keys turn the view left and right, '''''8''''' and '''''2''''' keys up and down and '''''+''''' and '''''-''''' will zoom in and out. If you press '''''Enter''''' the export begins and with '''''Esc''''' key you can cancel the export and get back to the previous selection state.
+
When checkbox on the left of '''Selection''' button is ticked, then before export all the objects that will be exported will be isolated in local view. This is very good way, how to be sure about exported content. It will always show only geometries and locators, that are going to be exported. Selection previewing is extra mode, where you can use '''''Numpad''''' keys for view manipulation similar way like Blender standardly does – '''''4''''' and '''''6''''' keys turn the view left and right, '''''8''''' and '''''2''''' keys up and down and '''''+''''' and '''''-''''' will zoom in and out. If you press '''''Enter''''' the export begins and with '''''Esc''''' key you can cancel the export and get back to the previous selection state.
  
 
=== Active Scene ===
 
=== Active Scene ===
Line 42: Line 42:
 
</blockquote>
 
</blockquote>
  
=== Scale ===
+
=== Export Scale ===
 
The resulting scale of all exported models and elements. This setting is saved and thus remembered in every Blend file.
 
The resulting scale of all exported models and elements. This setting is saved and thus remembered in every Blend file.
  
Line 53: Line 53:
 
=== Output Format ===
 
=== Output Format ===
 
Developers feature only, for now it should be always set to &quot;Game Data Format&quot;.
 
Developers feature only, for now it should be always set to &quot;Game Data Format&quot;.
 
[[Category:Documentation]]
 
[[Category:SCS Blender Tools]]
 

Latest revision as of 13:38, 4 December 2019

Export panel is located within Output tab of properties window and offers a quick way for content export to the game.

SCS Tools Export 00.280.png

Export modes (Scope)

Selection

Exports only selected objects, while there are certain logical rules for deciding about objects' inclusion in export from initial selection. When the Root Object is selected, all its content will be exported. When only some mesh objects are selected, then only those are exported for their Game Objects. In these cases it is not important if their Root Object is selected or not.

When checkbox on the left of Selection button is ticked, then before export all the objects that will be exported will be isolated in local view. This is very good way, how to be sure about exported content. It will always show only geometries and locators, that are going to be exported. Selection previewing is extra mode, where you can use Numpad keys for view manipulation similar way like Blender standardly does – 4 and 6 keys turn the view left and right, 8 and 2 keys up and down and + and - will zoom in and out. If you press Enter the export begins and with Esc key you can cancel the export and get back to the previous selection state.

Active Scene

Exports all properly set Game Objects in current scene.

Note: You can specify in each Root Object whether its content has to be exported or not using “Export Inclusion” switch.

All Scenes

Exports all properly set Game Objects in all scenes in current Blender file.

Note: You can specify in each Root Object whether its content has to be exported or not using “Export Inclusion” switch.

Other export options

Default Export Path

Here you can specify relative filepath inside "SCS Project Base Path" where your Game Objects will be exported.

How is default export path used:

  1. If default export path is empty, Blender Tools will try to export Game Object beside saved Blender file.
  2. If default export path is set, Blender Tools will combine "SCS Project Base Path" with given default export path to export files there.
  3. If Blender Tools can't find any solution for cases above, files are exported directly into "SCS Project Base Path".

Note: If input field will be marked red, then path is invalid and extra button for more info will be shown.

Note: Export path can be overwritten on Root Object by specifying "Custom Export Filepath".

Export Scale

The resulting scale of all exported models and elements. This setting is saved and thus remembered in every Blend file.

Apply Modifiers

Apply all modifiers before export.

Apply Only 'Edge Split'

Apply only 'Edge Split' modifier before export to get sharp edges. All the other modifiers will be ignored.

Output Format

Developers feature only, for now it should be always set to "Game Data Format".