Assimp - Revision history

Anarchid: /* Blender Workflow Tutorial */

2020-05-06T10:32:26Z

Blender Workflow Tutorial

← Older revision		Revision as of 11:32, 6 May 2020
Line 37:		Line 37:
	# Blender is Z-up and Spring is Y-up. Spring will import Blender models as Z-up. If you want to fix that, add a root piece to your model, and rotate its children 90 degrees, such that their local Y-axis points up.		# Blender is Z-up and Spring is Y-up. Spring will import Blender models as Z-up. If you want to fix that, add a root piece to your model, and rotate its children 90 degrees, such that their local Y-axis points up.
	# Make sure you have a lamp in your scene while in this mode or your model will be dark. You can delete it before export.		# Make sure you have a lamp in your scene while in this mode or your model will be dark. You can delete it before export.
	# If you want to animate the model using the animation exporter addon later, set the rotation mode for all your pieces to be Euler ZXY.		# If you want to animate the model using the animation exporter [https://github.com/Anarchid/blender2lus addon] later, set the rotation mode for all your pieces to be Euler ZXY.
	# Applying texture:		# Applying texture:
	## In the UV/Image editor, click the image icon (Tooltip: Browse Image to be linked) to select your texture. If it's not there, click on Image > Open Image to browse for it.		## In the UV/Image editor, click the image icon (Tooltip: Browse Image to be linked) to select your texture. If it's not there, click on Image > Open Image to browse for it.

Anarchid: /* Blender Workflow Tutorial */

2020-05-06T10:21:18Z

Blender Workflow Tutorial

← Older revision		Revision as of 11:21, 6 May 2020
Line 32:		Line 32:
	This is a stub containing a simple outline of a Blender workflow.		This is a stub containing a simple outline of a Blender workflow.

	# Open an existing Blender model or import a different format through the File menu (File > Import).		# Open an existing Blender model or import a different format through the File menu (File > Import). You can import s3o models - complete with materials - using the [https://github.com/sanguinariojoe/blender_s3o_import s3o import] plugin.
	# ~~In the 3D view~~, ~~drag out the secret panel from the right~~. ~~[[File:3-12-2013 5-02-21 PM~~.~~pngâ€Žâ€Ž\|secret panel]]~~		# Compose your model by making a series of rigid pieces, and parenting them to one another (ctrl+P). These will be imported as `pieces` into Spring.
	# ~~In that panel~~, ~~select Display > Shading > GLSL~~. ~~[[File:3~~-12-~~2013 5~~-02-~~04 PM~~.~~pngâ€Žâ€Ž\|display settings]]~~		# It is preferred to apply all scale transforms, because uneven transforms will not be tolerated by Spring. You can keep rotations, though.
	# Make sure you have a lamp in your scene while in this mode or your model will be dark.		# Blender is Z-up and Spring is Y-up. Spring will import Blender models as Z-up. If you want to fix that, add a root piece to your model, and rotate its children 90 degrees, such that their local Y-axis points up.
			# Make sure you have a lamp in your scene while in this mode or your model will be dark. You can delete it before export.
			# If you want to animate the model using the animation exporter addon later, set the rotation mode for all your pieces to be Euler ZXY.
	# Applying texture:		# Applying texture:
	## In the UV/Image editor, click the image icon (Tooltip: Browse Image to be linked) to select your texture. If it's not there, click on Image > Open Image to browse for it.		## In the UV/Image editor, click the image icon (Tooltip: Browse Image to be linked) to select your texture. If it's not there, click on Image > Open Image to browse for it.
	## In the 3D View, select (right-click) your object and hit Tab to enter Mesh Mode.		## In the 3D View, select (right-click) your object and hit Tab to enter Mesh Mode. You can select multiple objects if you want to unwrap the entire model without going piece-by-piece.
	## Hit A to select all your faces.		## Hit A to select all your faces.
	## In the 3D View, hit A to select all the faces there and select your image with the image icon. Assuming there's a UVMap, you should see your texture.		## In the 3D View, hit A to select all the faces there and select your image with the image icon. Assuming there's a UVMap, you should see your texture.
Line 55:		Line 57:
	# Piece hierarchy:		# Piece hierarchy:
	## Select piece A, hold shift and select piece B. Hit Ctrl+P and it will make piece A a child of piece B.		## Select piece A, hold shift and select piece B. Hit Ctrl+P and it will make piece A a child of piece B.
	## <strike>Make sure all the pieces are descending from one single piece.</strike> This is no longer necessary but is still good practice. Spring will now place all your pieces into one root piece for you, regardless.
	# Setting piece origins:		# Setting piece origins:
	## Select a piece.		## Select a piece.
Line 72:		Line 73:
	# The dae file will be used as your object.		# The dae file will be used as your object.

			Don't hesitate to google for answers if you bump into questions with how to use Blender itself. It's a powerful piece of software with a lot of tutorials on how to use - the scope of this article is not teaching how to use Blender, but only how to use Blender for making Spring models.

Maddox: Adding assimp-metadata link

2019-03-27T16:18:55Z

Adding assimp-metadata link

← Older revision		Revision as of 17:18, 27 March 2019
Line 27:		Line 27:

	* [[3DModels:AssimpWorkflow]]		* [[3DModels:AssimpWorkflow]]
			* [[3DModels:AssimpMetadata]]

	=Blender Workflow Tutorial=		=Blender Workflow Tutorial=

Flozi: /* Assimp */ 104.0 - trim unused AssParser root-piece transform overrides; 'rotAxisSigns' and 'rotAxisMap' from 95.0 are also gone (This page is hideous)

2017-12-21T16:59:09Z

Assimp: 104.0 - trim unused AssParser root-piece transform overrides; 'rotAxisSigns' and 'rotAxisMap' from 95.0 are also gone (This page is hideous)

← Older revision		Revision as of 17:59, 21 December 2017
Line 10:		Line 10:
	* loading of the texture filepaths from the model (don't have to be in <code>unittextures/</code>)		* loading of the texture filepaths from the model (don't have to be in <code>unittextures/</code>)
	* when texture filepaths aren't included in the model, it searches for <code>%modelfilename%.</code> & <code>%modelfilename%2.</code> in <code>unittextures/</code>		* when texture filepaths aren't included in the model, it searches for <code>%modelfilename%.</code> & <code>%modelfilename%2.</code> in <code>unittextures/</code>
	* special modelpieces `SpringHeight` & `SpringRadius` (removed in 101.0)		* special modelpieces `SpringHeight` & `SpringRadius` {{removed\|101.0}}
	* {{new\|102.0}} auto-normalize normals and tangents for all AssImp-loaded models		* {{new\|102.0}} auto-normalize normals and tangents for all AssImp-loaded models
	* {{new\|95.0}} allow modellers to work around {{mantis\|3552}} (differing axes conventions between software) by recognizing a number of new piece-table keys as follows		* {{new\|95.0}} allow modellers to work around {{mantis\|3552}} (differing axes conventions between software) by recognizing a number of new piece-table keys as follows

	For the root piece:		For the root piece: {{removed\|104.0}}
	* "xaxis" = float3, "yaxis" = float3, "zaxis" = float3 (determine global orientation of model)		* "xaxis" = float3, "yaxis" = float3, "zaxis" = float3 (determine global orientation of model)
	For all pieces:		For all pieces: {{removed\|104.0}}
	* "rotAxisSigns" = float3 (determines direction of script-applied rotations around each axis)		* "rotAxisSigns" = float3 (determines direction of script-applied rotations around each axis)
	* "rotAxisMap" = number (currently can only be 0=XYZ or 3=XZY, determines coordinate conversion)		* "rotAxisMap" = number (currently can only be 0=XYZ or 3=XZY, determines coordinate conversion)

Maddox: Added ASSIMP Standard Workflow link

2017-09-20T03:07:05Z

Added ASSIMP Standard Workflow link

← Older revision		Revision as of 04:07, 20 September 2017
Line 22:		Line 22:
	=Assimp Textures=		=Assimp Textures=
	See [[3DModels:Textures#Textures_-_Assimp_Model_Formats_.28DAE.2CMDL.2CMD3_and_others_except_OBJ.29 \|3DModels:Textures (Assimp Section)]]		See [[3DModels:Textures#Textures_-_Assimp_Model_Formats_.28DAE.2CMDL.2CMD3_and_others_except_OBJ.29 \|3DModels:Textures (Assimp Section)]]

			=Standard Workflow=
			The following 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 to export models for ASSIMP, as covered in the next section.

			* [[3DModels:AssimpWorkflow]]

	=Blender Workflow Tutorial=		=Blender Workflow Tutorial=

Flozi: /* Assimp */ 102.0 - auto-normalize normals and tangents for all AssImp-loaded models

2016-08-25T16:27:20Z

Assimp: 102.0 - auto-normalize normals and tangents for all AssImp-loaded models

← Older revision		Revision as of 17:27, 25 August 2016
Line 11:		Line 11:
	* when texture filepaths aren't included in the model, it searches for <code>%modelfilename%.</code> & <code>%modelfilename%2.</code> in <code>unittextures/</code>		* when texture filepaths aren't included in the model, it searches for <code>%modelfilename%.</code> & <code>%modelfilename%2.</code> in <code>unittextures/</code>
	* special modelpieces `SpringHeight` & `SpringRadius` (removed in 101.0)		* special modelpieces `SpringHeight` & `SpringRadius` (removed in 101.0)
			* {{new\|102.0}} auto-normalize normals and tangents for all AssImp-loaded models
	* {{new\|95.0}} allow modellers to work around {{mantis\|3552}} (differing axes conventions between software) by recognizing a number of new piece-table keys as follows		* {{new\|95.0}} allow modellers to work around {{mantis\|3552}} (differing axes conventions between software) by recognizing a number of new piece-table keys as follows

Flozi: /* Assimp */ ! nuke support for "special" Spring{Radius,Height} pieces in assimp models

2016-07-21T17:22:12Z

Assimp: ! nuke support for "special" Spring{Radius,Height} pieces in assimp models

← Older revision		Revision as of 18:22, 21 July 2016
Line 10:		Line 10:
	* loading of the texture filepaths from the model (don't have to be in <code>unittextures/</code>)		* loading of the texture filepaths from the model (don't have to be in <code>unittextures/</code>)
	* when texture filepaths aren't included in the model, it searches for <code>%modelfilename%.</code> & <code>%modelfilename%2.</code> in <code>unittextures/</code>		* when texture filepaths aren't included in the model, it searches for <code>%modelfilename%.</code> & <code>%modelfilename%2.</code> in <code>unittextures/</code>
	* special modelpieces `SpringHeight` & `SpringRadius`		* special modelpieces `SpringHeight` & `SpringRadius` (removed in 101.0)
	* {{new\|95.0}} allow modellers to work around {{mantis\|3552}} (differing axes conventions between software) by recognizing a number of new piece-table keys as follows		* {{new\|95.0}} allow modellers to work around {{mantis\|3552}} (differing axes conventions between software) by recognizing a number of new piece-table keys as follows

Anarchid: /* Blender Workflow Tutorial */

2016-03-24T16:45:42Z

Blender Workflow Tutorial

← Older revision		Revision as of 17:45, 24 March 2016
Line 58:		Line 58:
	## Do this for all your pieces.		## Do this for all your pieces.
	# Preparing for Spring (this may or may not apply depending on how assimp handles your model.):		# Preparing for Spring (this may or may not apply depending on how assimp handles your model.):
	## ~~<strike>Select your root piece.~~		## Ensure that the scales for each object in your scene are uniform (that is, x, y, and z scales are equal to each other). A quick way to ensure that is select all (a) and apply scale (ctrl+a -> scale).
	~~## Press Shift-C to put~~ the ~~3D cursor~~ in ~~the center of the world.~~
	~~## Click on the dropdown "Pivot Center for Rotation/Scaling"~~ and ~~select 3D Cursor~~.
	~~## Rotate your whole model so~~ that ~~it's~~ -~~90 degrees. You can do this by typing "R X -90". This will make your model lie on its back.~~
	~~## Click Object~~ > ~~Apply > Rotation & Scale~~.~~</strike>~~
	# Save your model.		# Save your model.
	# Select all the pieces of your model, ignore the lamp.		# Select all the pieces of your model, ignore the lamp.

Flozi: /* Assimp */ 95.0 - AssParser: Restrict support... allow modellers to work around #3552....

2013-12-23T14:55:54Z

Assimp: 95.0 - AssParser: Restrict support... allow modellers to work around #3552....

← Older revision		Revision as of 15:55, 23 December 2013
Line 2:		Line 2:

	=Assimp=		=Assimp=
	Open Asset Import Library (short name: Assimp) is used in Spring for loading a number of model formats ~~including Collada &~~ 3ds (currently obj is parsed by a different ~~codepaths~~).		Open Asset Import Library (short name: Assimp) is used in Spring for loading a number of common and well supported model formats (.3ds, .dae, .lwo, .blend - currently .obj is parsed by a different code path).

	What Spring supports in its Assimp renderer:		What Spring supports in its Assimp renderer:
Line 11:		Line 11:
	* when texture filepaths aren't included in the model, it searches for <code>%modelfilename%.</code> & <code>%modelfilename%2.</code> in <code>unittextures/</code>		* when texture filepaths aren't included in the model, it searches for <code>%modelfilename%.</code> & <code>%modelfilename%2.</code> in <code>unittextures/</code>
	* special modelpieces `SpringHeight` & `SpringRadius`		* special modelpieces `SpringHeight` & `SpringRadius`
			* {{new\|95.0}} allow modellers to work around {{mantis\|3552}} (differing axes conventions between software) by recognizing a number of new piece-table keys as follows

			For the root piece:
			* "xaxis" = float3, "yaxis" = float3, "zaxis" = float3 (determine global orientation of model)
			For all pieces:
			* "rotAxisSigns" = float3 (determines direction of script-applied rotations around each axis)
			* "rotAxisMap" = number (currently can only be 0=XYZ or 3=XZY, determines coordinate conversion)

	=Assimp Textures=		=Assimp Textures=

Carrepairer: Updated blender workflow tutorial

2013-11-21T20:08:23Z

Updated blender workflow tutorial

← Older revision		Revision as of 21:08, 21 November 2013
Line 50:		Line 50:
	### Rotate.		### Rotate.
	## Do this for all your pieces.		## Do this for all your pieces.
	# ~~<strike>~~Preparing for Spring (this may or may not apply depending on how assimp handles your model):		# Preparing for Spring (this may or may not apply depending on how assimp handles your model.):
	## Select your root piece.		## <strike>Select your root piece.
	## Press Shift-C to put the 3D cursor in the center of the world.		## Press Shift-C to put the 3D cursor in the center of the world.
	## Click on the dropdown "Pivot Center for Rotation/Scaling" and select 3D Cursor.		## Click on the dropdown "Pivot Center for Rotation/Scaling" and select 3D Cursor.