Material - Revision history

Zehra: improved display of content

2017-02-08T20:27:34Z

improved display of content

← Older revision		Revision as of 20:27, 8 February 2017
Line 110:		Line 110:
	==Magic Material Names==		==Magic Material Names==
	===General===		===General===
	[[GroundMaterial]]~~<br>~~		* [[GroundMaterial]]
	WaterMaterial~~<br>~~		* WaterMaterial
	LinkMaterial For Teleporter Links~~<br>~~		* [[LinkMaterial]] For Teleporter Links

	===[[Skybox]]===		===[[Skybox]]===
	LeftSkyboxMaterial~~<br>~~		* LeftSkyboxMaterial
	RightSkyboxMaterial~~<br>~~		* RightSkyboxMaterial
	FrontSkyboxMaterial~~<br>~~		* FrontSkyboxMaterial
	BackSkyboxMaterial~~<br>~~		* BackSkyboxMaterial
	TopSkyboxMaterial~~<br>~~		* TopSkyboxMaterial
	BottomSkyboxMaterial~~<br>~~		* BottomSkyboxMaterial

	==History==		==History==

Zehra: /* Editor Support */ update

2017-02-02T21:01:40Z

Editor Support: update

← Older revision		Revision as of 21:01, 2 February 2017
Line 126:		Line 126:

	==Editor Support==		==Editor Support==
	Materials are supported in [[Blender]] with [[BZWTools]], [[pyBZEdit]], and [[~~Wings3D]] with the [[BZW Exporter for~~ Wings3D]]. Materials are NOT supported in [[BZEdit]], [[BZFed]] or IBZEdit.		Materials are supported in [[Blender]] with [[BZWTools]], [[pyBZEdit]], and [[Wings3D]]. Materials are NOT supported in [[BZEdit]], [[BZFed]] or IBZEdit.

	==A note about textures==		==A note about textures==

Zehra: /* Code */ added wiki table

2016-12-03T01:39:42Z

Code: added wiki table

← Older revision		Revision as of 01:39, 3 December 2016
Line 33:		Line 33:
	\|}		\|}
	Valid parameters for a Material are:		Valid parameters for a Material are:
			{\|{{Prettytable}}
	;name: name for reference		\|-
	;texture: set the texture (must be .png but don't include the extension unless on the Internet)		\| {{Hl3}} \|'''Parameter'''
	;addtexture: add a texture (again, no extension is needed)		\| {{Hl3}} \|'''Description'''
	;notextures: don't use textures.		\|-
	;notexcolor: don't apply the [[Color(BZW)\|color]] to the texture		\| '''name''' \|\| name for reference.
	;notexalpha: don't use the texture's alpha channel		\|-
	;texmat: specify a [[TextureMatrix\|texture matrix]]. -1 for no texture matrix. (addtexture must be used before texmat)		\| '''texture''' \|\| set the texture (must be .png but don't include the extension unless on the Internet).
	;dyncol: specify a [[DynamicColor\|dynamic color]]. -1 for no dynamic color.		\|-
	;ambient: ambient color		\| '''addtexture''' \|\| add a texture (again, no extension is needed).
	;diffuse: diffuse (main)[[Color(BZW)\|color]]		\|-
	;[[Color(BZW)\|color]]: synonym for diffuse		\| '''notextures''' \|\| don't use textures.
	;specular: specular [[Color(BZW)\|color]]		\|-
	;emission: emission [[Color(BZW)\|color]]		\| '''notexcolor''' \|\| don't apply the [[Color(BZW)\|color]] to the texture.
	;shininess: shiny!		\|-
	;resetmat: restore default values		\| '''notexalpha''' \|\| don't use the texture's alpha channel.
	;spheremap: use spherical texture coordinate mapping		\|-
	;noradar: do not display on radar (except normal mode)		\| '''texmat''' \|\| specify a [[TextureMatrix\|texture matrix]]. -1 for no texture matrix. (addtexture must be used before texmat).
	;noshadow: do not render shadows		\|-
	;noculling: do not cull by face winding (double-sided)		\| '''dyncol''' \|\| specify a [[DynamicColor\|dynamic color]]. -1 for no dynamic color.
	;nosorting: do not do front-to-back alpha sorting		\|-
	;nolighting: disable lighting		\| '''ambient''' \|\| ambient color.
	;alphathresh: alpha thresholding value		\|-
	;groupalpha: sort translucent faces as a group		\| '''diffuse''' \|\| diffuse (main)[[Color(BZW)\|color]].
	;occluder: faces with this material will occlude		\|-
			\| '''[[Color(BZW)\|color]]''' \|\| synonym for diffuse.
			\|-
			\| '''specular''' \|\| specular [[Color(BZW)\|color]].
			\|-
			\| '''emission''' \|\| emission [[Color(BZW)\|color]].
			\|-
			\| '''shininess''' \|\| shiny!.
			\|-
			\| '''resetmat''' \|\| restore default values.
			\|-
			\| '''spheremap''' \|\| use spherical texture coordinate mapping.
			\|-
			\| '''noradar''' \|\| do not display on radar (except normal mode).
			\|-
			\| '''noshadow''' \|\| do not render shadows.
			\|-
			\| '''noculling''' \|\| do not cull by face winding (double-sided).
			\|-
			\| '''nosorting''' \|\| do not do front-to-back alpha sorting.
			\|-
			\| '''nolighting''' \|\| disable lighting.
			\|-
			\| '''alphathresh''' \|\| alpha thresholding value.
			\|-
			\| '''groupalpha''' \|\| sort translucent faces as a group.
			\|-
			\| '''occluder''' \|\| faces with this material will occlude.
			\|}

	To actually apply a material, you must use some sort of reference in an object, like so:		To actually apply a material, you must use some sort of reference in an object, like so:

Zehra: /* Magic Material Names */ improved wiki links

2016-11-27T00:18:41Z

Magic Material Names: improved wiki links

← Older revision		Revision as of 00:18, 27 November 2016
Line 85:		Line 85:
	WaterMaterial<br>		WaterMaterial<br>
	LinkMaterial For Teleporter Links<br>		LinkMaterial For Teleporter Links<br>
	~~TeleMaterial For Teleporter Frame (BZFlag version 3.0)~~

	===Skybox===		===[[Skybox]]===
	[[LeftSkyboxMaterial]]<br>		LeftSkyboxMaterial<br>
	[[RightSkyboxMaterial]]<br>		RightSkyboxMaterial<br>
	[[FrontSkyboxMaterial]]<br>		FrontSkyboxMaterial<br>
	[[BackSkyboxMaterial]]<br>		BackSkyboxMaterial<br>
	[[TopSkyboxMaterial]]<br>		TopSkyboxMaterial<br>
	[[BottomSkyboxMaterial]]<br>		BottomSkyboxMaterial<br>

	==History==		==History==

Prestidigitator: /* Code */ properties formatting

2012-07-28T03:12:01Z

Code: properties formatting

← Older revision		Revision as of 03:12, 28 July 2012
Line 33:		Line 33:
	\|}		\|}
	Valid parameters for a Material are:		Valid parameters for a Material are:
	~~<properties>~~
	name=name for reference		;name: name for reference
	texture=set the texture (must be .png but don't include the extension unless on the Internet)		;texture: set the texture (must be .png but don't include the extension unless on the Internet)
	addtexture=add a texture (again, no extension is needed)		;addtexture: add a texture (again, no extension is needed)
	notextures=don't use textures.		;notextures: don't use textures.
	notexcolor=don't apply the [[Color(BZW)\|color]] to the texture		;notexcolor: don't apply the [[Color(BZW)\|color]] to the texture
	notexalpha=don't use the texture's alpha channel		;notexalpha: don't use the texture's alpha channel
	texmat=specify a [[TextureMatrix\|texture matrix]]. -1 for no texture matrix. (addtexture must be used before texmat)		;texmat: specify a [[TextureMatrix\|texture matrix]]. -1 for no texture matrix. (addtexture must be used before texmat)
	dyncol=specify a [[DynamicColor\|dynamic color]]. -1 for no dynamic color.		;dyncol: specify a [[DynamicColor\|dynamic color]]. -1 for no dynamic color.
	ambient=ambient color		;ambient: ambient color
	diffuse=diffuse (main)[[Color(BZW)\|color]]		;diffuse: diffuse (main)[[Color(BZW)\|color]]
	[[Color(BZW)\|color]]=synonym for diffuse		;[[Color(BZW)\|color]]: synonym for diffuse
	specular=specular [[Color(BZW)\|color]]		;specular: specular [[Color(BZW)\|color]]
	emission=emission [[Color(BZW)\|color]]		;emission: emission [[Color(BZW)\|color]]
	shininess=shiny!		;shininess: shiny!
	resetmat=restore default values		;resetmat: restore default values
	spheremap=use spherical texture coordinate mapping		;spheremap: use spherical texture coordinate mapping
	noradar=do not display on radar (except normal mode)		;noradar: do not display on radar (except normal mode)
	noshadow=do not render shadows		;noshadow: do not render shadows
	noculling=do not cull by face winding (double-sided)		;noculling: do not cull by face winding (double-sided)
	nosorting=do not do front-to-back alpha sorting		;nosorting: do not do front-to-back alpha sorting
	nolighting=disable lighting		;nolighting: disable lighting
	alphathresh=alpha thresholding value		;alphathresh: alpha thresholding value
	groupalpha=sort translucent faces as a group		;groupalpha: sort translucent faces as a group
	occluder=faces with this material will occlude		;occluder: faces with this material will occlude
	~~</properties>~~
	To actually apply a material, you must use some sort of reference in an object, like so:		To actually apply a material, you must use some sort of reference in an object, like so:
	{\|		{\|

98.111.223.193: remove prev

2010-07-18T14:20:24Z

remove prev

@@ Line 78: / Line 78: @@
 The same applies to textures that have translucent sections.
-{|
 ==Magic Material Names==

98.111.223.193: added sample translucent material

2010-07-18T14:15:32Z

added sample translucent material

@@ Line 77: / Line 77: @@
 Material translucency is enabled by setting the alpha component of a material's [[Color(BZW)|color]] to a value less than one. Translucent objects should be sparingly, because everything behind them must always be rendered. In addition, very large translucent objects may be sorted and drawn in the wrong order. This is caused by the fact that the Z-buffer cannot be used because it would allow another translucent object to cover the translucent object, which would not look right. Thus, the translucent elements are instead sorted by determining the distance to a point in the center, which works well as long as there are not too many large translucent objects.
 The same applies to textures that have translucent sections.
 ==Magic Material Names==

Cobra Fast: summed stuff up and formatting

2010-03-04T15:57:07Z

summed stuff up and formatting

← Older revision		Revision as of 15:57, 4 March 2010
Line 6:		Line 6:
	\|		\|
	material		material
	name example_material		name <u>example_material</u>
	texture filename		texture filename
	addtexture filename		addtexture filename
Line 66:		Line 66:
	rotation 0		rotation 0
	size 10 10 5		size 10 10 5
	matref example_material
			# refer to the previously defined material with its particular name we gave it before
			# compare underlined text in the code at the [[#Code\|page top]]
			'''matref <u>example_material</u>'''
	end		end
	\|}		\|}
	Please note the ''matref'' is the '''name''' of the defined material, not the name of the .png/url file!		Please note the ''matref'' is the '''name''' of the defined material, not the name of the .png/url file!
	~~Note the bolded term next to "name"...~~
	{\|
	\|
	~~material~~
	~~name '''example_material'''~~
	~~texture filename~~
	~~addtexture filename~~
	~~—etc—~~
	\|}
	~~...is the same as the material listed for "matref"~~
	{\|
	\|
	~~meshbox~~
	~~position 0 0 10~~
	~~rotation 0~~
	~~size 10 10 5~~
	~~matref '''example_material'''~~
	~~end~~
	\|}

	==Translucency==		==Translucency==

72.148.216.70: /* Code */

2010-03-03T21:15:59Z

Code

@@ Line 67: / Line 67: @@
    size 10 10 5
    matref example_material
   end
 |}

Trepan: Transparency => Translucency

2009-02-05T01:21:22Z

Transparency => Translucency

← Older revision		Revision as of 01:21, 5 February 2009
Line 70:		Line 70:
	\|}		\|}

	==~~Transparency~~==		==Translucency==
	~~The transparency effect~~ is ~~created~~ by setting the alpha component of a material's [[Color(BZW)\|color]] to a value less than one.		Material translucency is enabled by setting the alpha component of a material's [[Color(BZW)\|color]] to a value less than one. Translucent objects should be sparingly, because everything behind them must always be rendered. In addition, very large translucent objects may be sorted and drawn in the wrong order. This is caused by the fact that the Z-buffer cannot be used because it would allow another translucent object to cover the translucent object, which would not look right. Thus, the translucent elements are instead sorted by determining the distance to a point in the center, which works well as long as there are not too many large translucent objects.
	~~Transparent~~ objects should be sparingly, because everything behind them must always be rendered. In addition, very large ~~transparent~~ objects may be sorted and drawn in the wrong order. This is caused by the fact that the Z-buffer cannot be used because it would allow another ~~transparent~~ object to cover the ~~transparent~~ object, which would not look right. Thus, the ~~transparent~~ elements are instead sorted by determining the distance to a point in the center, which works well as long as there are not too many large ~~transparent~~ objects.		The same applies to textures that have translucent sections.
	The same applies to textures that have ~~transparent~~ sections.

	==Magic Material Names==		==Magic Material Names==