Exporting Blender Models - Revision history

Zapper: /* Modifying the Material file */

2015-08-18T12:58:17Z

Modifying the Material file

← Older revision		Revision as of 12:58, 18 August 2015
Line 88:		Line 88:
	texture_unit		texture_unit
	{		{
	texture ~~MyCube~~.png		texture Rock_uv.png
	tex_address_mode wrap		tex_address_mode wrap
	filtering trilinear		filtering trilinear

Zapper at 12:53, 18 August 2015

2015-08-18T12:53:48Z

← Older revision		Revision as of 12:53, 18 August 2015
Line 1:		Line 1:

			If you run into any problems with these instructions, please leave a post on the [http://forum.openclonk.org/board_show.pl?bid=16 forum] addressing the issue. (You don't have to register to post there)

	== Setting up the Exporter ==		== Setting up the Exporter ==

Zapper: /* Modifying the Material file */

2015-08-18T12:52:01Z

Modifying the Material file

← Older revision		Revision as of 12:52, 18 August 2015
Line 69:		Line 69:

	<pre style="color:green;width:75%;background-color:#dcdcdc">		<pre style="color:green;width:75%;background-color:#dcdcdc">
	material ~~MyCube~~		material Rock_Grey
	{		{
	receive_shadows on		receive_shadows on
Line 104:		Line 104:
	emissive 0.000000 0.000000 0.000000 0.000000		emissive 0.000000 0.000000 0.000000 0.000000
	...</pre>		...</pre>
	If so, make sure the fourth parameter on ambient, diffuse, specular, and emissive is '1.0', not '0.000000' (as shown in the 'material ~~MyCube~~' example).		If so, make sure the fourth parameter on ambient, diffuse, specular, and emissive is '1.0', not '0.000000' (as shown in the 'material Rock_Grey' example).

	== Importing the files into OpenClonk ==		== Importing the files into OpenClonk ==

Zapper at 12:51, 18 August 2015

2015-08-18T12:51:19Z

← Older revision		Revision as of 12:51, 18 August 2015
Line 62:		Line 62:

	The exporter now also generates a .skeleton file (that must not be renamed).		The exporter now also generates a .skeleton file (that must not be renamed).

			== Modifying the Material file ==
			'''Graphics.material'''

			Graphics.material is the file which defines which materials to apply to meshes. Manually modifying Graphics.material is crucial to the mesh appearing properly in game. When you export (assuming you are using a texture) your Graphics.material file will look more or less like this (don't worry if it looks somewhat different):

			<pre style="color:green;width:75%;background-color:#dcdcdc">
			material MyCube
			{
			receive_shadows on
			technique
			{
			pass
			{
			cull_hardware none
			scene_blend alpha_blend

			ambient 1.0 1.0 1.0 1.0
			diffuse 1.0 1.0 1.0 1.0
			specular 0.0 0.0 0.0 0.0 12.5
			emissive 0.0 0.0 0.0 0.0

			texture_unit
			{
			texture MyCube.png
			tex_address_mode wrap
			filtering trilinear
			}
			}
			}
			}</pre>
			*If 'depth_write off' exists, delete that line.
			*If you are using alpha, make sure 'scene_blend alpha_blend' exists (as shown above).
			*If your mesh has visible backface(s), make sure to add 'cull_hardware none' (as shown above).
			*Depending on the method you used to define alpha in blender, the 'pass' section in Graphics.material may look like this:
			<pre style="color:green;width:75%;background-color:#dcdcdc">pass
			{
			ambient 0.500000 0.500000 0.500000 0.000000
			diffuse 0.640000 0.640000 0.640000 0.000000
			specular 0.500000 0.500000 0.500000 0.000000 12.500000
			emissive 0.000000 0.000000 0.000000 0.000000
			...</pre>
			If so, make sure the fourth parameter on ambient, diffuse, specular, and emissive is '1.0', not '0.000000' (as shown in the 'material MyCube' example).

	== Importing the files into OpenClonk ==		== Importing the files into OpenClonk ==

Zapper: /* Importing the files into OpenClonk */

2015-08-18T12:35:26Z

Importing the files into OpenClonk

← Older revision		Revision as of 12:35, 18 August 2015
Line 65:		Line 65:
	== Importing the files into OpenClonk ==		== Importing the files into OpenClonk ==
	To get the objects into the game, you need to put the .mesh, .material and .skeleton file into your object definition. If you have additional textures (for example an UV map), you need to move the texture into the same folder (you can not rename it after the export).		To get the objects into the game, you need to put the .mesh, .material and .skeleton file into your object definition. If you have additional textures (for example an UV map), you need to move the texture into the same folder (you can not rename it after the export).

			To view a .mesh file you can use the free tool "Ogre Meshy".

			The exporter also comes with a test scenario to view objects ingame. For more information please see the Readme.txt of the exporter.

Zapper at 12:32, 18 August 2015

2015-08-18T12:32:18Z

← Older revision		Revision as of 12:32, 18 August 2015
Line 23:		Line 23:

	Rename the mesh of the object to something meaningful:		Rename the mesh of the object to something meaningful:
	[[{{ns:file}}:Blender_MeshName.PNG]]		[[{{ns:file}}:Blender_MeshName.PNG\|center]]
	Also rename the whole object to the same name.		Also rename the whole object to the same name.
	[[{{ns:file}}:Blender_ObjectName.PNG]]		[[{{ns:file}}:Blender_ObjectName.PNG\|center]]

	Make sure the object has at least one material and give the materials your object name as a prefix (f.e. Rock_Grey or Idol_Gold), because in OpenClonk all material names are global.		Make sure the object has at least one material and give the materials your object name as a prefix (f.e. Rock_Grey or Idol_Gold), because in OpenClonk all material names are global.
	[[{{ns:file}}:Blender_MaterialName.PNG]]		[[{{ns:file}}:Blender_MaterialName.PNG\|center]]


Line 39:		Line 39:

	== Exporting Animations ==		== Exporting Animations ==
			When working with actions, it is a good idea to click the little "[F]" next to the action name in the action editor to make sure the actions are never deleted.
			[[{{ns:file}}:Blender_ActionEditor_SaveDatablock.PNG\|center]]

	To prepare the animations for the export, you need to add them as NLA tracks doing the following steps:		To prepare the animations for the export, you need to add them as NLA tracks doing the following steps:

	Open two windows, one for the "Dope Sheet" and one for the "NLA Editor". In the Dope Sheet, select the "Action Editor".		Open two windows, one for the "Dope Sheet" and one for the "NLA Editor". In the Dope Sheet, select the "Action Editor".
	[[{{ns:file}}:Blender_ActionEditor_NLA_Editor.PNG]]		[[{{ns:file}}:Blender_ActionEditor_NLA_Editor.PNG\|center]]

	Make sure you have the "Armature" selected in the NLA Editor.		Make sure you have the "Armature" selected in the NLA Editor.
	[[{{ns:file}}:Blender_Empty_NLA_Editor.PNG]]		[[{{ns:file}}:Blender_Empty_NLA_Editor.PNG\|center]]

	For every action you first need to select the action in the Action Editor.		For every action you first need to select the action in the Action Editor.
	[[{{ns:file}}:Blender_ActionEditor_Select_Action.PNG]]		[[{{ns:file}}:Blender_ActionEditor_Select_Action.PNG\|center]]

	Then you click on "Push Down" next to the action name to add the action as a new NLA strip.		Then you click on "Push Down" next to the action name to add the action as a new NLA strip.
	[[{{ns:file}}:Blender_ActionEditor_Push_Action.PNG]]		[[{{ns:file}}:Blender_ActionEditor_Push_Action.PNG\|center]]

			The actions should now all be visible in the NLA editor in separate strips.
			[[{{ns:file}}:Blender_NLA_Editor_ActionStrips.PNG\|center]]

	In the exporter, make sure you have "Independent Animations" selected.		In the exporter, make sure you have "Independent Animations" selected.

Zapper at 12:17, 18 August 2015

2015-08-18T12:17:31Z

← Older revision		Revision as of 12:17, 18 August 2015
Line 23:		Line 23:

	Rename the mesh of the object to something meaningful:		Rename the mesh of the object to something meaningful:
	~~<nowiki>~~[[~~</nowiki>~~{{ns:file}}~~<nowiki>~~:Blender_MeshName.PNG]]~~</nowiki>~~		[[{{ns:file}}:Blender_MeshName.PNG]]
	Also rename the whole object to the same name.		Also rename the whole object to the same name.
	~~<nowiki>~~[[~~</nowiki>~~{{ns:file}}~~<nowiki>~~:Blender_ObjectName.PNG]]~~</nowiki>~~		[[{{ns:file}}:Blender_ObjectName.PNG]]

	Make sure the object has at least one material and give the materials your object name as a prefix (f.e. Rock_Grey or Idol_Gold), because in OpenClonk all material names are global.		Make sure the object has at least one material and give the materials your object name as a prefix (f.e. Rock_Grey or Idol_Gold), because in OpenClonk all material names are global.
	~~<nowiki>~~[[~~</nowiki>~~{{ns:file}}~~<nowiki>~~:Blender_MaterialName.PNG]]~~</nowiki>~~		[[{{ns:file}}:Blender_MaterialName.PNG]]


Line 42:		Line 42:

	Open two windows, one for the "Dope Sheet" and one for the "NLA Editor". In the Dope Sheet, select the "Action Editor".		Open two windows, one for the "Dope Sheet" and one for the "NLA Editor". In the Dope Sheet, select the "Action Editor".
	~~<nowiki>~~[[~~</nowiki>~~{{ns:file}}~~<nowiki>~~:Blender_ActionEditor_NLA_Editor.PNG]]~~</nowiki>~~		[[{{ns:file}}:Blender_ActionEditor_NLA_Editor.PNG]]

	Make sure you have the "Armature" selected in the NLA Editor.		Make sure you have the "Armature" selected in the NLA Editor.
	~~<nowiki>~~[[~~</nowiki>~~{{ns:file}}~~<nowiki>~~:Blender_Empty_NLA_Editor.PNG]]~~</nowiki>~~		[[{{ns:file}}:Blender_Empty_NLA_Editor.PNG]]

	For every action you first need to select the action in the Action Editor.		For every action you first need to select the action in the Action Editor.
	~~<nowiki>~~[[~~</nowiki>~~{{ns:file}}~~<nowiki>~~:Blender_ActionEditor_Select_Action.PNG]]~~</nowiki>~~		[[{{ns:file}}:Blender_ActionEditor_Select_Action.PNG]]

	Then you click on "Push Down" next to the action name to add the action as a new NLA strip.		Then you click on "Push Down" next to the action name to add the action as a new NLA strip.
	~~<nowiki>~~[[~~</nowiki>~~{{ns:file}}~~<nowiki>~~:Blender_ActionEditor_Push_Action.PNG]]~~</nowiki>~~		[[{{ns:file}}:Blender_ActionEditor_Push_Action.PNG]]

Zapper: /* Setting up the Exporter */

2015-08-18T12:16:11Z

Setting up the Exporter

← Older revision		Revision as of 12:16, 18 August 2015
Line 6:		Line 6:
	To install the exporter, follow the steps in the contained Readme.txt, which are also listed here for convenience:		To install the exporter, follow the steps in the contained Readme.txt, which are also listed here for convenience:

	* <p>copy the files from the folder BlenderAddon to:		'''copy the files from the folder BlenderAddon to:'''
	Linux: ~/.config/blender/[version]/scripts/addons/		*Linux: ~/.config/blender/[version]/scripts/addons/
	Windows: [blender directory]/[version]/scripts/addons/		*Windows: [blender directory]/[version]/scripts/addons/
	[version] should be the version of the installed Blender e.g. 2.71</p>		[version] should be the version of the installed Blender e.g. 2.71</p>


	* <p>enable the addon:		'''enable the addon:'''
	Load up Blender, go to File>User Preferences>Addons>Import-Export and enable the "OGRE Clonk Exporter" addon.		*Load up Blender, go to File>User Preferences>Addons>Import-Export and enable the "OGRE Clonk Exporter" addon.
	Then click on "Save User Settings".		*Then click on "Save User Settings".
	HINT: You can also use the search box to look for an addon containing "Clonk".~~</p>~~		HINT: You can also use the search box to look for an addon containing "Clonk".

	From now on, you will find "Ogre3D Clonk" as an exporter listed under File->Export.		From now on, you will find "Ogre3D Clonk" as an exporter listed under File->Export.

Zapper: Created page with " == Setting up the Exporter == Randrian provides an own OGRE exporter for OpenClonk, which can be found on the renderclonks page[http://www.renderclonks.de/files/OgreClonkExp..."

2015-08-18T12:10:44Z

Created page with " == Setting up the Exporter == Randrian provides an own OGRE exporter for OpenClonk, which can be found on the renderclonks page[http://www.renderclonks.de/files/OgreClonkExp..."

New page

== Setting up the Exporter ==

Randrian provides an own OGRE exporter for OpenClonk, which can be found on the renderclonks page[http://www.renderclonks.de/files/OgreClonkExporter.zip].

To install the exporter, follow the steps in the contained Readme.txt, which are also listed here for convenience:

* <p>copy the files from the folder BlenderAddon to:
Linux: ~/.config/blender/[version]/scripts/addons/
Windows: [blender directory]/[version]/scripts/addons/
[version] should be the version of the installed Blender e.g. 2.71</p>

* <p>enable the addon:
Load up Blender, go to File>User Preferences>Addons>Import-Export and enable the "OGRE Clonk Exporter" addon.
Then click on "Save User Settings".
HINT: You can also use the search box to look for an addon containing "Clonk".</p>

From now on, you will find "Ogre3D Clonk" as an exporter listed under File->Export.

== Preparing the Model in Blender ==
The model needs an armature. If you do not have any animations, please add an armature and rename the one bone to "main" - which is our convention for single-bone armatures.

Rename the mesh of the object to something meaningful:
<nowiki>[[</nowiki>{{ns:file}}<nowiki>:Blender_MeshName.PNG]]</nowiki>
Also rename the whole object to the same name.
<nowiki>[[</nowiki>{{ns:file}}<nowiki>:Blender_ObjectName.PNG]]</nowiki>

Make sure the object has at least one material and give the materials your object name as a prefix (f.e. Rock_Grey or Idol_Gold), because in OpenClonk all material names are global.
<nowiki>[[</nowiki>{{ns:file}}<nowiki>:Blender_MaterialName.PNG]]</nowiki>

== Exporting a Model ==
Make sure you have the object selected in object mode.
For exporting a model without animations, open the exporter (File->Export->"Ogre3D Clonk"), select a directory and click "Export Ogre".

You will then find a .mesh and a .material that you need to keep. The .scene file is not required (if it exists).

== Exporting Animations ==
To prepare the animations for the export, you need to add them as NLA tracks doing the following steps:

Open two windows, one for the "Dope Sheet" and one for the "NLA Editor". In the Dope Sheet, select the "Action Editor".
<nowiki>[[</nowiki>{{ns:file}}<nowiki>:Blender_ActionEditor_NLA_Editor.PNG]]</nowiki>

Make sure you have the "Armature" selected in the NLA Editor.
<nowiki>[[</nowiki>{{ns:file}}<nowiki>:Blender_Empty_NLA_Editor.PNG]]</nowiki>

For every action you first need to select the action in the Action Editor.
<nowiki>[[</nowiki>{{ns:file}}<nowiki>:Blender_ActionEditor_Select_Action.PNG]]</nowiki>

Then you click on "Push Down" next to the action name to add the action as a new NLA strip.
<nowiki>[[</nowiki>{{ns:file}}<nowiki>:Blender_ActionEditor_Push_Action.PNG]]</nowiki>

In the exporter, make sure you have "Independent Animations" selected.

The exporter now also generates a .skeleton file (that must not be renamed).

== Importing the files into OpenClonk ==
To get the objects into the game, you need to put the .mesh, .material and .skeleton file into your object definition. If you have additional textures (for example an UV map), you need to move the texture into the same folder (you can not rename it after the export).