Skip to content

T
three.js

车家大少爷 / three.js
与 Fork 源项目一致

从无法访问的项目Fork

通知 2
Star 0
Fork 0
T
three.js

体验新版 GitCode，发现更多精彩内容 >>

切换分支/标签
查找文件 普通视图历史永久链接Permalink
MeshPhongMaterial.html 9.7 KB
Newer Older
M
Refactored documentation system. No more XMLHttpRequest.  
Mr.doob 已提交
1 2 3 
<!DOCTYPE html>
<html lang="en">
	<head>
M
Docs: Implemented base tag. See #6840  
Mr.doob 已提交
4 5 6 7 8 
		<meta charset="utf-8" />
		<base href="../../" />
		<script src="list.js"></script>
		<script src="page.js"></script>
		<link type="text/css" rel="stylesheet" href="page.css" />
M
Refactored documentation system. No more XMLHttpRequest.  
Mr.doob 已提交
9 10 
	</head>
	<body>
C
additions to documentation  
cjshannon 已提交
11 
		[page:Material] &rarr;
M
Docs: Some herarchy.  
Mr.doob 已提交
12
M
Refactored documentation system. No more XMLHttpRequest.  
Mr.doob 已提交
13 
		<h1>[name]</h1>
M
Added placeholder for all the objects.  
Mr.doob 已提交
14
E
Document materials  
Eric Haines 已提交
15 
		<div class="desc">A material for shiny surfaces, evaluated per pixel.</div>
M
Added placeholder for all the objects.  
Mr.doob 已提交
16
M
Docs: Implemented base tag. See #6840  
Mr.doob 已提交
17 
		<iframe src='scenes/material-browser.html#MeshPhongMaterial'></iframe>
M
Added placeholder for all the objects.  
Mr.doob 已提交
18
M
Refactored documentation system. No more XMLHttpRequest.  
Mr.doob 已提交
19 
		<h2>Constructor</h2>
M
Added placeholder for all the objects.  
Mr.doob 已提交
20
C
added constructors to documentation  
cjshannon 已提交
21
G
Completed small todos  
Greg Tatum 已提交
22 
		<h3>[name]([page:Object parameters])</h3>
C
added constructors to documentation  
cjshannon 已提交
23 
		<div>
G
Completed small todos  
Greg Tatum 已提交
24 
		parameters -- an object with one or more of the material's properties defining the its appearance.
C
added constructors to documentation  
cjshannon 已提交
25 26 
		</div>
		<div>
S
sorted and added missing parameters for material docs  
Satimidus 已提交
27 
		color — geometry color in hexadecimal. Default is 0xffffff.<br />
W
Restored aoMap to MeshBasicMaterial  
WestLangley 已提交
28 
		map — Set texture map. Default is null <br />
S
sorted and added missing parameters for material docs  
Satimidus 已提交
29 
		lightMap — Set light map. Default is null.<br />
W
Restored aoMap to MeshBasicMaterial  
WestLangley 已提交
30 
		aoMap — Set ao map. Default is null.<br />
W
MeshPhongMaterial: Added support for Emissive Maps  
WestLangley 已提交
31 
		emissiveMap — Set emissive map. Default is null.<br />
S
sorted and added missing parameters for material docs  
Satimidus 已提交
32 33 
		specularMap — Set specular map. Default is null.<br />
		alphaMap — Set alpha map. Default is null.<br />
T
Updated MeshPhongMaterial.html to include displacement properties  
terry 已提交
34 35 36 
		displacementMap — Set displacement map. Default is null.<br />
		displacementScale — Set displacement scale. Default is 1.<br />
		displacementBias — Set displacement offset. Default is 0.<br />
S
sorted and added missing parameters for material docs  
Satimidus 已提交
37 38 39 40 41 42 43 44 45 46 47 48 
		envMap — Set env map. Default is null.<br />
		fog — Define whether the material color is affected by global fog settings. Default is true.<br />
		shading — Define shading type. Default is THREE.SmoothShading.<br />
		wireframe — render geometry as wireframe. Default is false.<br />
		wireframeLinewidth — Line thickness. Default is 1.<br />
		wireframeLinecap — Define appearance of line ends. Default is 'round'.<br />
		wireframeLinejoin — Define appearance of line joints. Default is 'round'.<br />
		vertexColors — Define how the vertices gets colored. Default is THREE.NoColors.<br />
		skinning — Define whether the material uses skinning. Default is false.<br />
		morphTargets — Define whether the material uses morphTargets. Default is false.
		</div>
		<div>
P
Update MeshPhongMaterial.html  
PaulJacobs 已提交
49 
		Example:<br>
G
Fixed little docs issues  
Greg Tatum 已提交
50 
		materials.push( new THREE.MeshPhongMaterial( { color: 0xdddddd, specular: 0x009900, shininess: 30, shading: THREE.FlatShading } ) );
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
51
C
added constructors to documentation  
cjshannon 已提交
52 
		</div>
M
Added placeholder for all the objects.  
Mr.doob 已提交
53 54
M
Refactored documentation system. No more XMLHttpRequest.  
Mr.doob 已提交
55 
		<h2>Properties</h2>
C
prepare documentation for programmatic additions  
cjshannon 已提交
56 
		<div>See the base [page:Material] class for common parameters.</div>
M
Added placeholder for all the objects.  
Mr.doob 已提交
57
C
Reformatted docs to add property anchors  
Casey Grun 已提交
58 
		<h3>[property:Color color]</h3>
E
Document materials  
Eric Haines 已提交
59 60 61 62 
		<div>
		Diffuse color of the material. Default is white.<br />
		</div>
C
Reformatted docs to add property anchors  
Casey Grun 已提交
63 
		<h3>[property:Color emissive]</h3>
E
Document materials  
Eric Haines 已提交
64 65 66 
		<div>
		Emissive (light) color of the material, essentially a solid color unaffected by other lighting. Default is black.<br />
		</div>
M
Added placeholder for all the objects.  
Mr.doob 已提交
67
C
Reformatted docs to add property anchors  
Casey Grun 已提交
68 
		<h3>[property:Color specular]</h3>
E
Document materials  
Eric Haines 已提交
69 70 71 
		<div>
		Specular color of the material, i.e., how shiny the material is and the color of its shine. Setting this the same color as the diffuse value (times some intensity) makes the material more metallic-looking; setting this to some gray makes the material look more plastic. Default is dark gray.<br />
		</div>
M
Added placeholder for all the objects.  
Mr.doob 已提交
72
C
Reformatted docs to add property anchors  
Casey Grun 已提交
73 
		<h3>[property:Float shininess]</h3>
M
Docs: Removed unneeded shininess information. See #7252.  
Mr.doob 已提交
74 
		<div>How shiny the specular highlight is; a higher value gives a sharper highlight. Default is *30*.</div>
E
Document materials  
Eric Haines 已提交
75
C
Reformatted docs to add property anchors  
Casey Grun 已提交
76 
		<h3>[property:Texture map]</h3>
W
MeshPhongMaterial: Added support for Emissive Maps  
WestLangley 已提交
77 
		<div>Set color texture map. Default is null. The texture map color is modulated by the diffuse color.</div>
E
Document materials  
Eric Haines 已提交
78
C
Reformatted docs to add property anchors  
Casey Grun 已提交
79 
		<h3>[property:Texture lightMap]</h3>
W
MeshPhongMaterial: Added support for Emissive Maps  
WestLangley 已提交
80 
		<div>Set light map. Default is null. The lightMap requires a second set of UVs.</div>
E
Document materials  
Eric Haines 已提交
81
W
Restored aoMap to MeshBasicMaterial  
WestLangley 已提交
82 
		<h3>[property:Texture aoMap]</h3>
W
MeshPhongMaterial: Added support for Emissive Maps  
WestLangley 已提交
83 84 85 86 
		<div>Set ambient occlusion map. Default is null. The aoMap requires a second set of UVs.</div>

		<h3>[property:Texture emissiveMap]</h3>
		<div>Set emisssive (glow) map. Default is null. The emissive map color is modulated by the emissive color. If you have an emissive map, be sure to set the emissive color to something other than black.</div>
W
Restored aoMap to MeshBasicMaterial  
WestLangley 已提交
87
S
sorted and added missing parameters for material docs  
Satimidus 已提交
88 89 90 91 92 93 
		<h3>[property:Texture bumpMap]</h3>
		<div>
			The texture to create a bump map. The black and white values map to the perceived depth in relation to the lights.
			Bump doesn't actually affect the geometry of the object, only the lighting. If a normal map is defined this will
			be ignored.
		</div>
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
94
S
sorted and added missing parameters for material docs  
Satimidus 已提交
95 96 97 98 99 100 101 102 103 104 
		<h3>[property:Float bumpScale]</h3>
		<div>
			How much the bump map affects the material. Typical ranges are 0-1. Default is 1.
		</div>

		<h3>[property:Texture normalMap]</h3>
		<div>
			The texture to create a normal map. The RGB values affect the surface normal for each pixel fragment and change
			the way the color is lit. Normal maps do not change the actual shape of the surface, only the lighting.
		</div>
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
105
S
sorted and added missing parameters for material docs  
Satimidus 已提交
106 107 108 
		<h3>[property:Vector2 normalScale]</h3>
		<div>
			How much the normal map affects the material. Typical ranges are 0-1. Default is (1,1).
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
109 
		</div>
S
sorted and added missing parameters for material docs  
Satimidus 已提交
110
C
Reformatted docs to add property anchors  
Casey Grun 已提交
111 
		<h3>[property:Texture specularMap]</h3>
E
Document materials  
Eric Haines 已提交
112 113 
		<div>The specular map value affects both how much the specular surface highlight contributes and how much of the environment map affects the surface. Default is null.</div>
C
Reformatted docs to add property anchors  
Casey Grun 已提交
114 
		<h3>[property:Texture alphaMap]</h3>
T
Updated documentation for MeshBasicMaterial, MeshLambertMaterial, and...  
Ted Cipicchio 已提交
115 116 117 
		<div>The alpha map is a grayscale texture that controls the opacity across the surface (black: fully transparent; white: fully opaque). Default is null.</div>
		<div>Only the color of the texture is used, ignoring the alpha channel if one exists. For RGB and RGBA textures, the [page:WebGLRenderer WebGL] renderer will use the green channel when sampling this texture due to the extra bit of precision provided for green in DXT-compressed and uncompressed RGB 565 formats. Luminance-only and luminance/alpha textures will also still work as expected.</div>
T
Updated MeshPhongMaterial.html to include displacement properties  
terry 已提交
118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 
		<h3>[property:Texture displacementMap]</h3>
		<div>
			The displacement map affects the position of the mesh's vertices. Unlike other maps which only affect the light and shade of the material the displaced vertices can cast shadows, block other objects, and otherwise act as real geometry. 
			The displacement texture is an image where the value of each pixel (white being the highest) is mapped against, and repositions, the vertices of the mesh.
		</div>
		
		<h3>[property:Float displacementScale]</h3>
		<div>
			How much the displacement map affects the mesh (where black is no displacement, and white is maximum displacement). Without a displacement map set, this value is not applied. Default is 1.
		</div>
		
		<h3>[property:Float displacementBias]</h3>
		<div>
			The offset of the displacement map's values on the mesh's vertices. Without a displacement map set, this value is not applied. Default is 0.
		</div>
C
Reformatted docs to add property anchors  
Casey Grun 已提交
134 
		<h3>[property:TextureCube envMap]</h3>
E
Document materials  
Eric Haines 已提交
135 
		<div>Set env map. Default is null.</div>
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
136
S
sorted and added missing parameters for material docs  
Satimidus 已提交
137 
		<h3>[property:Integer combine]</h3>
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
138 139 
		<div>How to combine the result of the surface's color with the environment map, if any.</div>
S
sorted and added missing parameters for material docs  
Satimidus 已提交
140 
		<div>Options are [page:Textures THREE.MultiplyOperation] (default), [page:Textures THREE.MixOperation], [page:Textures THREE.AddOperation]. If mix is chosen, the reflectivity is used to blend between the two colors.</div>
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
141
C
Reformatted docs to add property anchors  
Casey Grun 已提交
142 
		<h3>[property:Float reflectivity]</h3>
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
143 
		<div>How much the environment map affects the surface; also see "combine".</div>
E
Document materials  
Eric Haines 已提交
144
C
Reformatted docs to add property anchors  
Casey Grun 已提交
145 
		<h3>[property:Float refractionRatio]</h3>
B
couple more files of linking constants to docs pages  
Brent Van Minnen 已提交
146 
		<div>The index of refraction for an environment map using [page:Textures THREE.CubeRefractionMapping]. Default is *0.98*.</div>
E
Document materials  
Eric Haines 已提交
147
S
sorted and added missing parameters for material docs  
Satimidus 已提交
148 149 150 151 152 153 154 
		<h3>[property:Boolean fog]</h3>
		<div>Define whether the material color is affected by global fog settings. Default is *true*.</div>
		<div>This setting might not have any effect when used with certain renderers. For example, it is ignored with the [page:CanvasRenderer Canvas] renderer, but does work with the [page:WebGLRenderer WebGL] renderer.</div>

		<h3>[property:Integer shading]</h3>
		<div>How the triangles of a curved surface are rendered: as a smooth surface, as flat separate facets, or no shading at all.</div>
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
155 156 
		<div>Options are [page:Materials THREE.SmoothShading] (default), [page:Materials THREE.FlatShading].</div>
S
sorted and added missing parameters for material docs  
Satimidus 已提交
157 158 
		<h3>[property:Boolean wireframe]</h3>
		<div>Whether the triangles' edges are displayed instead of surfaces. Default is *false*.</div>
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
159
S
sorted and added missing parameters for material docs  
Satimidus 已提交
160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 
		<h3>[property:Float wireframeLinewidth]</h3>
		<div>Line thickness for wireframe mode. Default is *1.0*.</div>
		<div>Due to limitations in the <a href="https://code.google.com/p/angleproject/" target="_blank">ANGLE layer</a>, on Windows platforms linewidth will always be 1 regardless of the set value.</div>

		<h3>[property:String wireframeLinecap]</h3>
		<div>Define appearance of line ends. Possible values are "butt", "round" and "square". Default is 'round'.</div>
		<div>This setting might not have any effect when used with certain renderers. For example, it is ignored with the [page:WebGLRenderer WebGL] renderer, but does work with the [page:CanvasRenderer Canvas] renderer.</div>

		<h3>[property:String wireframeLinejoin]</h3>
		<div>Define appearance of line joints. Possible values are "round", "bevel" and "miter". Default is 'round'.</div>
		<div>This setting might not have any effect when used with certain renderers. For example, it is ignored with the [page:WebGLRenderer WebGL] renderer, but does work with the [page:CanvasRenderer Canvas] renderer.</div>

		<h3>[property:Integer vertexColors]</h3>
		<div>Define how the vertices gets colored. Possible values are THREE.NoColors, THREE.FaceColors and THREE.VertexColors. Default is THREE.NoColors.</div>
		<div>This setting might not have any effect when used with certain renderers. For example, it is ignored with the [page:CanvasRenderer Canvas] renderer, but does work with the [page:WebGLRenderer WebGL] renderer.</div>
C
Reformatted docs to add property anchors  
Casey Grun 已提交
176 
		<h3>[property:Boolean skinning]</h3>
E
Document materials  
Eric Haines 已提交
177 
		<div>Define whether the material uses skinning. Default is *false*.</div>
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
178
C
Reformatted docs to add property anchors  
Casey Grun 已提交
179 
		<h3>[property:Boolean morphTargets]</h3>
M
Removed NoShading constant. Fixes #7115.  
Mr.doob 已提交
180 
		<div>Define whether the material uses morphTargets. Default is *false*.</div>
E
Document materials  
Eric Haines 已提交
181
G
Material docs todos  
Greg Tatum 已提交
182 
		<h3>[property:boolean morphNormals]</h3>
C
additions to documentation  
cjshannon 已提交
183 
		<div>
G
Material docs todos  
Greg Tatum 已提交
184 185 186 
			Defines whether the material uses morphNormals. Set as true to pass morphNormal attributes from the [page:Geometry]
			to the shader. Default is *false*.
		</div>
C
additions to documentation  
cjshannon 已提交
187
E
Document materials  
Eric Haines 已提交
188 
		<h2>Methods</h2>
M
Added placeholder for all the objects.  
Mr.doob 已提交
189
M
Refactored documentation system. No more XMLHttpRequest.  
Mr.doob 已提交
190 
		<h2>Source</h2>
M
Added placeholder for all the objects.  
Mr.doob 已提交
191
M
Refactored documentation system. No more XMLHttpRequest.  
Mr.doob 已提交
192 193 194 
		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
	</body>
</html>