3DModels:AssimpWorkflow - Revision history

Maddox: /* Other File Formats */ minor fix to the alpha-saving format now used by PS

2017-10-03T04:34:34Z

Other File Formats: minor fix to the alpha-saving format now used by PS

← Older revision		Revision as of 05:34, 3 October 2017
Line 50:		Line 50:

	DDS is a native nVidia format, it holds all mipmaps and has many great image compression algorithms. Bear in mind that the image packed inside DDS can't be altered (like "flipped vertically") through commands in the model configuration .lua file.		DDS is a native nVidia format, it holds all mipmaps and has many great image compression algorithms. Bear in mind that the image packed inside DDS can't be altered (like "flipped vertically") through commands in the model configuration .lua file.
	If you don't want to use DDS for any reason, like not having support in your image app, make sure to use TARGA (.TGA) 32-bits. That's because, although ASSIMP also supports JPG, PNG, and BMP, the first has no support for alpha channels and the other two, for optmization reasons, may embed the alpha channel in a non-standard way. In Photoshop, until version CS6, PNG and BMP saved their alpha channels separately, after that version and up to the latest (CC.2017 at the time of this writing) it ~~stores it as a "saved~~ alpha ~~channel"~~. TARGA format always saves the alpha channel separately, as expected by ASSIMP.		If you don't want to use DDS for any reason, like not having support in your image app, make sure to use TARGA (.TGA) 32-bits. That's because, although ASSIMP also supports JPG, PNG, and BMP, the first has no support for alpha channels and the other two, for optmization reasons, may embed the alpha channel in a non-standard way. In Photoshop, until version CS6, PNG and BMP saved their alpha channels separately, after that version and up to the latest (CC.2017 at the time of this writing) it embeds the alpha information in the RGB channels. TARGA format always saves the alpha channel separately, as expected by ASSIMP.

Maddox: * Added corpse / feature settings for .dae models

2017-10-03T04:29:31Z

* Added corpse / feature settings for .dae models

← Older revision		Revision as of 05:29, 3 October 2017
Line 2:		Line 2:
	== Standard Assimp Workflow ==		== Standard Assimp Workflow ==

	This Workflow is provided for a standard 3D Modeling package using the Z = forward, Y = upwards convention, like Maya, Modo or Lightwave. You can also use Blender for ASSIMP, but it won't be covered here.		This Workflow is provided for a standard 3D Modeling package using the Z = forward, Y = upwards convention, like Maya, Modo or Lightwave. You can also use Blender for ASSIMP, but it won't be covered here. Bear in mind that the default DAE/FBX exporter from Maya might present issues with the texture overriding options of the model .lua script (version tested: Maya 2017). 3rd-Party DAE exporters from Maya might suit you best.

	I. In the 3D Modeling Package:		I. In the 3D Modeling Package:
Line 23:		Line 23:
	# Place your spanking new DDS textures in the '\unittextures' folder of your game/mod		# Place your spanking new DDS textures in the '\unittextures' folder of your game/mod
	# In your unit's .lua file (the UnitDef one), set object = "3dmeshname.dae", replacing the filename with your own model name of course. You need to add the .dae extension for Spring to load this file instead of searching for an .s3o file		# In your unit's .lua file (the UnitDef one), set object = "3dmeshname.dae", replacing the filename with your own model name of course. You need to add the .dae extension for Spring to load this file instead of searching for an .s3o file
			## Attention: For the FeatureDef property of the UnitDef, its inner 'object' value shouldn't take the extension, or else Spring will fail loading it. Also make sure the corpse property is set to that same value. Eg.:
			<nowiki>
			corpse = "3dmeshname",
			featuredefs = {
			dead = {
			object = "3dmeshname",
			}
			}</nowiki>
	# Place your .dae file in the objects3d folder		# Place your .dae file in the objects3d folder
	# Add a new .lua file to the objects3d folder, in our case "3dmeshname.dae.lua"		# Add a new .lua file to the objects3d folder, in our case "3dmeshname.dae.lua"
	# Add the following code to it, editing the field values a needed. `tex2` is commented out, but your 2nd unit texture (for reflectivity/glow/clipping) may also be defined here.		# Add the following code to it, editing the field values as needed. `tex2` is commented out, but your 2nd unit texture (for reflectivity/glow/clipping) may also be defined here.
	<nowiki>		<nowiki>
	model = {		model = {

Maddox: while => white

2017-09-22T01:50:58Z

while => white

← Older revision		Revision as of 02:50, 22 September 2017
Line 16:		Line 16:
	# Click 'Save As', select DDS file format. Make sure to keep 'Alpha Channels' selected		# Click 'Save As', select DDS file format. Make sure to keep 'Alpha Channels' selected
	# In the 'DDS Options' panel, select Format 'DXT5' (for main/team texture), keep 'Mipmap' and the Alpha Channel enabled (usually 'Alpha 1'). No need to mess with anything else, defaults are fine. Save the texture to your mod's 'unittextures' folder.		# In the 'DDS Options' panel, select Format 'DXT5' (for main/team texture), keep 'Mipmap' and the Alpha Channel enabled (usually 'Alpha 1'). No need to mess with anything else, defaults are fine. Save the texture to your mod's 'unittextures' folder.
	# Now it's time to create your 2nd texture. ''If you don't, the model will show all transparent in-game and you'll keep scratching your head.'' A quick way to do that, if you don't want to spend time properly separating the channels, is to turn the RGB image into grayscale (Image > Adjust > Hue Saturation, set Saturation to 0). Now select the Alpha Channel again, hit D (default colors) then Ctrl+Delete (Fill layer with bg color, ~~while~~ in this case).		# Now it's time to create your 2nd texture. ''If you don't, the model will show all transparent in-game and you'll keep scratching your head.'' A quick way to do that, if you don't want to spend time properly separating the channels, is to turn the RGB image into grayscale (Image > Adjust > Hue Saturation, set Saturation to 0). Now select the Alpha Channel again, hit D (default colors) then Ctrl+Delete (Fill layer with bg color, white in this case).
	# Save the 2nd texture as DDS to your mod's 'unittextures' folder too, this time using DXT1 format, with Alpha selected.		# Save the 2nd texture as DDS to your mod's 'unittextures' folder too, this time using DXT1 format, with Alpha selected.

Maddox: /* Standard Assimp Workflow */

2017-09-22T01:49:44Z

Standard Assimp Workflow

← Older revision		Revision as of 02:49, 22 September 2017
Line 16:		Line 16:
	# Click 'Save As', select DDS file format. Make sure to keep 'Alpha Channels' selected		# Click 'Save As', select DDS file format. Make sure to keep 'Alpha Channels' selected
	# In the 'DDS Options' panel, select Format 'DXT5' (for main/team texture), keep 'Mipmap' and the Alpha Channel enabled (usually 'Alpha 1'). No need to mess with anything else, defaults are fine. Save the texture to your mod's 'unittextures' folder.		# In the 'DDS Options' panel, select Format 'DXT5' (for main/team texture), keep 'Mipmap' and the Alpha Channel enabled (usually 'Alpha 1'). No need to mess with anything else, defaults are fine. Save the texture to your mod's 'unittextures' folder.
	# Now it's time to create your 2nd texture. ''If you don't, the model will show all transparent in-game and you'll keep scratching your head.'' A quick way to do that, if you don't want to spend time properly separating the channels, is to turn the RGB image into grayscale (Image > Adjust > Hue Saturation, set Saturation to 0). Now select the Alpha Channel again, hit D (default colors) Ctrl~~+A (select all) then Alt~~+Delete (Fill layer with bg color, while in this case).		# Now it's time to create your 2nd texture. ''If you don't, the model will show all transparent in-game and you'll keep scratching your head.'' A quick way to do that, if you don't want to spend time properly separating the channels, is to turn the RGB image into grayscale (Image > Adjust > Hue Saturation, set Saturation to 0). Now select the Alpha Channel again, hit D (default colors) then Ctrl+Delete (Fill layer with bg color, while in this case).
	# Save the 2nd texture as DDS to your mod's 'unittextures' folder too, this time using DXT1 with Alpha selected.		# Save the 2nd texture as DDS to your mod's 'unittextures' folder too, this time using DXT1 format, with Alpha selected.

	III. In Spring:		III. In Spring:

Maddox: Added tex2 and pivot-setting critical information which was missing

2017-09-22T01:47:20Z

Added tex2 and pivot-setting critical information which was missing

← Older revision		Revision as of 02:47, 22 September 2017
Line 1:		Line 1:
			[[Category:3D Models]]
	== Standard Assimp Workflow ==		== Standard Assimp Workflow ==

Line 4:		Line 5:

	I. In the 3D Modeling Package:		I. In the 3D Modeling Package:
	* Create your models as usual ~~and export to DAE~~, after making sure all separate pieces share a single UV set. There shouldn't be more than one UV set in the file. All packages have a way to merge multiple UV sets as needed, bear in mind that in some of them you need to combine all objects first.		# Create your models as usual, after making sure all separate pieces share a single UV set. There shouldn't be more than one UV set in the file. All packages have a way to merge multiple UV sets as needed, bear in mind that in some of them you need to combine all objects first.
			# To set the separate pieces pivot points, ''don't use your modeling package's set pivot functionality'', it'll usually reset it to the world's origin (0,0,0) upon save to .dae. Instead, add an empty object / locator, move it to where you want the pivot to be, and parent the actual mesh to that object.
			# Remember Spring uses a quite unique coordinates system, which probably won't correspond to your 3D Apps for rotation of pieces.

	II. In Photoshop:		II. In Photoshop:
Line 12:		Line 15:
	# Use 'Levels' (Ctrl+L) to make sure you have no pure black or white in the Alpha Channel. First select the Alpha Channel from the Channels tab of the Layer panel. In the 'Output Levels' box (at the bottom) set the left field to 5 and the right field to 250.		# Use 'Levels' (Ctrl+L) to make sure you have no pure black or white in the Alpha Channel. First select the Alpha Channel from the Channels tab of the Layer panel. In the 'Output Levels' box (at the bottom) set the left field to 5 and the right field to 250.
	# Click 'Save As', select DDS file format. Make sure to keep 'Alpha Channels' selected		# Click 'Save As', select DDS file format. Make sure to keep 'Alpha Channels' selected
	# In the 'DDS Options' panel, select Format 'DXT5' (for main/team texture), keep 'Mipmap' and the Alpha Channel enabled (usually 'Alpha 1'). No need to mess with anything else, defaults are fine.		# In the 'DDS Options' panel, select Format 'DXT5' (for main/team texture), keep 'Mipmap' and the Alpha Channel enabled (usually 'Alpha 1'). No need to mess with anything else, defaults are fine. Save the texture to your mod's 'unittextures' folder.
			# Now it's time to create your 2nd texture. ''If you don't, the model will show all transparent in-game and you'll keep scratching your head.'' A quick way to do that, if you don't want to spend time properly separating the channels, is to turn the RGB image into grayscale (Image > Adjust > Hue Saturation, set Saturation to 0). Now select the Alpha Channel again, hit D (default colors) Ctrl+A (select all) then Alt+Delete (Fill layer with bg color, while in this case).
			# Save the 2nd texture as DDS to your mod's 'unittextures' folder too, this time using DXT1 with Alpha selected.

	III. In Spring:		III. In Spring:

	# Place your spanking new DDS ~~texture~~ in the '\unittextures' folder of your game/mod		# Place your spanking new DDS textures in the '\unittextures' folder of your game/mod
	# In your unit's .lua file (the UnitDef one), set object = "3dmeshname.dae", replacing the filename with your own model name of course. You need to add the .dae extension for Spring to load this file instead of searching for an .s3o file		# In your unit's .lua file (the UnitDef one), set object = "3dmeshname.dae", replacing the filename with your own model name of course. You need to add the .dae extension for Spring to load this file instead of searching for an .s3o file
	# Place your .dae file in the objects3d folder		# Place your .dae file in the objects3d folder
Line 26:		Line 31:
	height = 40,		height = 40,
	tex1 = "3dmeshname_tex.dds",		tex1 = "3dmeshname_tex.dds",
	--tex2 = "3dmeshname_tex2.dds",		tex2 = "3dmeshname_tex2.dds",
	midpos = {0,0,0},		midpos = {0,0,0},
	}		}

Maddox: Added 'Other File Format' section, linked to main text

2017-09-20T16:22:54Z

Added 'Other File Format' section, linked to main text

← Older revision		Revision as of 17:22, 20 September 2017
Line 8:		Line 8:
	II. In Photoshop:		II. In Photoshop:

	# Install the DDS export/import plugin. If you have an older Photoshop, you can use nVidia's older 32-bit release. If you use a newer Photoshop (tested on CC.2017) make sure you download this amazing open source plugin [http://fnordware.blogspot.com.br/2014/09/dds-plug-in-for-after-effects-and.html here]		# Install the DDS export/import plugin ([[3DModels:AssimpWorkflow#Other File Formats\|Other image file formats]]). If you have an older Photoshop, you can use nVidia's older 32-bit release. If you use a newer Photoshop (tested on CC.2017) make sure you download this amazing open source plugin [http://fnordware.blogspot.com.br/2014/09/dds-plug-in-for-after-effects-and.html here]
	# With the main (diffuse) texture opened, select the areas of the UV you want to have team color on. Select > Save Selection, click ok. A new 'Alpha 1' channel will be created and accessible from Photoshop's 'Channels' panel, usually docked as a tab next to 'Layers'.		# With the main (diffuse) texture opened, select the areas of the UV you want to have team color on. Select > Save Selection, click ok. A new 'Alpha 1' channel will be created and accessible from Photoshop's 'Channels' panel, usually docked as a tab next to 'Layers'.
	# Use 'Levels' (Ctrl+L) to make sure you have no pure black or white in the Alpha Channel. First select the Alpha Channel from the Channels tab of the Layer panel. In the 'Output Levels' box (at the bottom) set the left field to 5 and the right field to 250.		# Use 'Levels' (Ctrl+L) to make sure you have no pure black or white in the Alpha Channel. First select the Alpha Channel from the Channels tab of the Layer panel. In the 'Output Levels' box (at the bottom) set the left field to 5 and the right field to 250.
Line 23:		Line 23:
	<nowiki>		<nowiki>
	model = {		model = {
			radius = 25.0,
			height = 40,
	tex1 = "3dmeshname_tex.dds",		tex1 = "3dmeshname_tex.dds",
	--tex2 = "3dmeshname_tex2.dds",		--tex2 = "3dmeshname_tex2.dds",
Line 31:		Line 33:

	Done. Go test your new unit model and texture in-game.		Done. Go test your new unit model and texture in-game.

			== Other File Formats ==

			DDS is a native nVidia format, it holds all mipmaps and has many great image compression algorithms. Bear in mind that the image packed inside DDS can't be altered (like "flipped vertically") through commands in the model configuration .lua file.
			If you don't want to use DDS for any reason, like not having support in your image app, make sure to use TARGA (.TGA) 32-bits. That's because, although ASSIMP also supports JPG, PNG, and BMP, the first has no support for alpha channels and the other two, for optmization reasons, may embed the alpha channel in a non-standard way. In Photoshop, until version CS6, PNG and BMP saved their alpha channels separately, after that version and up to the latest (CC.2017 at the time of this writing) it stores it as a "saved alpha channel". TARGA format always saves the alpha channel separately, as expected by ASSIMP.

Maddox: /* Standard Assimp Workflow */

2017-09-20T03:50:23Z

Standard Assimp Workflow

← Older revision		Revision as of 04:50, 20 September 2017
Line 23:		Line 23:
	<nowiki>		<nowiki>
	model = {		model = {
	~~radius = 25.0,~~
	~~height = 40,~~
	tex1 = "3dmeshname_tex.dds",		tex1 = "3dmeshname_tex.dds",
	--tex2 = "3dmeshname_tex2.dds",		--tex2 = "3dmeshname_tex2.dds",

Maddox: /* Simple Assimp Workflow */

2017-09-20T03:45:40Z

Simple Assimp Workflow

← Older revision		Revision as of 04:45, 20 September 2017
Line 1:		Line 1:
	== ~~Simple~~ Assimp Workflow ==		== Standard Assimp Workflow ==

	This Workflow is provided for a standard 3D Modeling package using the Z = forward, Y = upwards convention, like Maya, Modo or Lightwave. You can also use Blender for ASSIMP, but it won't be covered here.		This Workflow is provided for a standard 3D Modeling package using the Z = forward, Y = upwards convention, like Maya, Modo or Lightwave. You can also use Blender for ASSIMP, but it won't be covered here.

Maddox: /* Simple Assimp Workflow */

2017-09-20T03:17:27Z

Simple Assimp Workflow

← Older revision		Revision as of 04:17, 20 September 2017
Line 2:		Line 2:

	This Workflow is provided for a standard 3D Modeling package using the Z = forward, Y = upwards convention, like Maya, Modo or Lightwave. You can also use Blender for ASSIMP, but it won't be covered here.		This Workflow is provided for a standard 3D Modeling package using the Z = forward, Y = upwards convention, like Maya, Modo or Lightwave. You can also use Blender for ASSIMP, but it won't be covered here.

	Install the DDS export/import plugin. If you have an older Photoshop, you can use nVidia's older 32-bit release. If you use a newer Photoshop (tested on CC.2017) make sure you download this amazing open source plugin here: http://fnordware.blogspot.com.br/2014/09/dds-plug-in-for-after-effects-and.html

	I. In the 3D Modeling Package:		I. In the 3D Modeling Package:
	-> Create your models as usual and export to DAE, after making sure all separate pieces share a single UV set. There shouldn't be more than one UV set in the file. All packages have a way to merge multiple UV sets as needed, bear in mind that in some of them you need to combine all objects first.		* Create your models as usual and export to DAE, after making sure all separate pieces share a single UV set. There shouldn't be more than one UV set in the file. All packages have a way to merge multiple UV sets as needed, bear in mind that in some of them you need to combine all objects first.

	II. In Photoshop:		II. In Photoshop:

	1. With the main (diffuse) texture opened, select the areas of the UV you want to have team color on. Select > Save Selection, click ok. A new 'Alpha 1' channel will be created and accessible from Photoshop's 'Channels' panel, usually docked as a tab next to 'Layers'.		# Install the DDS export/import plugin. If you have an older Photoshop, you can use nVidia's older 32-bit release. If you use a newer Photoshop (tested on CC.2017) make sure you download this amazing open source plugin [http://fnordware.blogspot.com.br/2014/09/dds-plug-in-for-after-effects-and.html here]
			# With the main (diffuse) texture opened, select the areas of the UV you want to have team color on. Select > Save Selection, click ok. A new 'Alpha 1' channel will be created and accessible from Photoshop's 'Channels' panel, usually docked as a tab next to 'Layers'.
	2. Use 'Levels' (Ctrl+L) to make sure you have no pure black or white in the Alpha Channel. First select the Alpha Channel from the Channels tab of the Layer panel. In the 'Output Levels' box (at the bottom) set the left field to 5 and the right field to 250.		# Use 'Levels' (Ctrl+L) to make sure you have no pure black or white in the Alpha Channel. First select the Alpha Channel from the Channels tab of the Layer panel. In the 'Output Levels' box (at the bottom) set the left field to 5 and the right field to 250.
			# Click 'Save As', select DDS file format. Make sure to keep 'Alpha Channels' selected
	3. Click 'Save As', select DDS file format. Make sure to keep 'Alpha Channels' selected		# In the 'DDS Options' panel, select Format 'DXT5' (for main/team texture), keep 'Mipmap' and the Alpha Channel enabled (usually 'Alpha 1'). No need to mess with anything else, defaults are fine.

	4. In the 'DDS Options' panel, select Format 'DXT5' (for main/team texture), keep 'Mipmap' and the Alpha Channel enabled (usually 'Alpha 1'). No need to mess with anything else, defaults are fine.

	III. In Spring:		III. In Spring:

	1. Place your spanking new DDS texture in the '\unittextures' folder of your game/mod		# Place your spanking new DDS texture in the '\unittextures' folder of your game/mod
	2. In your unit's .lua file (the UnitDef one), set object = "3dmeshname.dae", replacing the filename with your own model name of course. You need to add the .dae extension for Spring to load this file instead of searching for an .s3o file		# In your unit's .lua file (the UnitDef one), set object = "3dmeshname.dae", replacing the filename with your own model name of course. You need to add the .dae extension for Spring to load this file instead of searching for an .s3o file
	3. Place your dae file in the objects3d folder		# Place your .dae file in the objects3d folder
	4. Add a new .lua file to the objects3d folder, in our case "3dmeshname.dae.lua"		# Add a new .lua file to the objects3d folder, in our case "3dmeshname.dae.lua"
	5. Add the following code to it, editing the field values a needed. `tex2` is commented out, but your 2nd unit texture (for reflectivity/glow/clipping) may also be defined here.		# Add the following code to it, editing the field values a needed. `tex2` is commented out, but your 2nd unit texture (for reflectivity/glow/clipping) may also be defined here.
			<nowiki>
	model = {		model = {
	radius = 25.0,		radius = 25.0,
Line 33:		Line 30:
	}		}
	return model		return model
			</nowiki>

	Done. Go test your new unit model and texture in-game.		Done. Go test your new unit model and texture in-game.

Maddox: Adding ASSIMP Workflow page

2017-09-20T03:08:24Z

Adding ASSIMP Workflow page

New page

== Simple Assimp Workflow ==

This Workflow is provided for a standard 3D Modeling package using the Z = forward, Y = upwards convention, like Maya, Modo or Lightwave. You can also use Blender for ASSIMP, but it won't be covered here.

Install the DDS export/import plugin. If you have an older Photoshop, you can use nVidia's older 32-bit release. If you use a newer Photoshop (tested on CC.2017) make sure you download this amazing open source plugin here: http://fnordware.blogspot.com.br/2014/09/dds-plug-in-for-after-effects-and.html

I. In the 3D Modeling Package:
-> Create your models as usual and export to DAE, after making sure all separate pieces share a single UV set. There shouldn't be more than one UV set in the file. All packages have a way to merge multiple UV sets as needed, bear in mind that in some of them you need to combine all objects first.

II. In Photoshop:

1. With the main (diffuse) texture opened, select the areas of the UV you want to have team color on. Select > Save Selection, click ok. A new 'Alpha 1' channel will be created and accessible from Photoshop's 'Channels' panel, usually docked as a tab next to 'Layers'.

2. Use 'Levels' (Ctrl+L) to make sure you have no pure black or white in the Alpha Channel. First select the Alpha Channel from the Channels tab of the Layer panel. In the 'Output Levels' box (at the bottom) set the left field to 5 and the right field to 250.

3. Click 'Save As', select DDS file format. Make sure to keep 'Alpha Channels' selected

4. In the 'DDS Options' panel, select Format 'DXT5' (for main/team texture), keep 'Mipmap' and the Alpha Channel enabled (usually 'Alpha 1'). No need to mess with anything else, defaults are fine.

III. In Spring:

1. Place your spanking new DDS texture in the '\unittextures' folder of your game/mod
2. In your unit's .lua file (the UnitDef one), set object = "3dmeshname.dae", replacing the filename with your own model name of course. You need to add the .dae extension for Spring to load this file instead of searching for an .s3o file
3. Place your dae file in the objects3d folder
4. Add a new .lua file to the objects3d folder, in our case "3dmeshname.dae.lua"
5. Add the following code to it, editing the field values a needed. `tex2` is commented out, but your 2nd unit texture (for reflectivity/glow/clipping) may also be defined here.
model = {
radius = 25.0,
height = 40,
tex1 = "3dmeshname_tex.dds",
--tex2 = "3dmeshname_tex2.dds",
midpos = {0,0,0},
}
return model

Done. Go test your new unit model and texture in-game.