MeshBasicMaterial.html 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../" />
  6. <script src="list.js"></script>
  7. <script src="page.js"></script>
  8. <link type="text/css" rel="stylesheet" href="page.css" />
  9. </head>
  10. <body>
  11. [page:Material] &rarr;
  12. <h1>[name]</h1>
  13. <div class="desc">
  14. A material for drawing geometries in a simple shaded (flat or wireframe) way.<br /><br />
  15. This material is not affected by lights.
  16. </div>
  17. <iframe id="scene" src="scenes/material-browser.html#MeshBasicMaterial"></iframe>
  18. <script>
  19. // iOS iframe auto-resize workaround
  20. if ( /(iPad|iPhone|iPod)/g.test( navigator.userAgent ) ) {
  21. var scene = document.getElementById( 'scene' );
  22. scene.style.width = getComputedStyle( scene ).width;
  23. scene.style.height = getComputedStyle( scene ).height;
  24. scene.setAttribute( 'scrolling', 'no' );
  25. }
  26. </script>
  27. <h2>Constructor</h2>
  28. <h3>[name]( [page:Object parameters] )</h3>
  29. <div>
  30. [page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
  31. Any property of the material (including any property inherited from [page:Material]) can be passed in here.<br /><br />
  32. The exception is the property [page:Hexadecimal color], which can be passed in as a hexadecimal
  33. string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.
  34. </div>
  35. <h2>Properties</h2>
  36. <div>See the base [page:Material] class for common properties.</div>
  37. <h3>[property:Texture alphaMap]</h3>
  38. <div>The alpha map is a grayscale texture that controls the opacity across the surface
  39. (black: fully transparent; white: fully opaque). Default is null.<br /><br />
  40. Only the color of the texture is used, ignoring the alpha channel if one exists.
  41. For RGB and RGBA textures, the [page:WebGLRenderer WebGL] renderer will use the
  42. green channel when sampling this texture due to the extra bit of precision provided
  43. for green in DXT-compressed and uncompressed RGB 565 formats. Luminance-only and
  44. luminance/alpha textures will also still work as expected.
  45. </div>
  46. <h3>[property:Texture aoMap]</h3>
  47. <div>The ambient occlusion map. Default is null.</div>
  48. <h3>[property:Float aoMapIntensity]</h3>
  49. <div>Intensity of the ambient occlusion effect. Default is 1. Zero is no occlusion effect.</div>
  50. <h3>[property:Color color]</h3>
  51. <div>[page:Color] of the material, by default set to white (0xffffff).</div>
  52. <h3>[property:Integer combine]</h3>
  53. <div>
  54. How to combine the result of the surface's color with the environment map, if any.<br /><br />
  55. Options are [page:Materials THREE.Multiply] (default), [page:Materials THREE.MixOperation],
  56. [page:Materials THREE.AddOperation]. If mix is chosen, the [page:.reflectivity] is used to
  57. blend between the two colors.
  58. </div>
  59. <h3>[property:Boolean isMeshBasicMaterial]</h3>
  60. <div>
  61. Used to check whether this or derived classes are mesh basic materials. Default is *true*.<br /><br />
  62. You should not change this, as it used internally for optimisation.
  63. </div>
  64. <h3>[property:TextureCube envMap]</h3>
  65. <div>The environment map. Default is null.</div>
  66. <h3>[property:Texture lightMap]</h3>
  67. <div>The light map. Default is null. The lightMap requires a second set of UVs.</div>
  68. <h3>[property:Float lightMapIntensity]</h3>
  69. <div>Intensity of the baked light. Default is 1.</div>
  70. <h3>[property:Boolean lights]</h3>
  71. <div>Whether the material is affected by lights. Default is *false*.</div>
  72. <h3>[property:Texture map]</h3>
  73. <div>The color map. Default is null.</div>
  74. <h3>[property:Boolean morphTargets]</h3>
  75. <div>Define whether the material uses morphTargets. Default is false.</div>
  76. <h3>[property:Float reflectivity]</h3>
  77. <div>How much the environment map affects the surface; also see [page:.combine].</div>
  78. <h3>[property:Float refractionRatio]</h3>
  79. <div>The index of refraction for an environment map using [page:Textures THREE.CubeRefractionMapping]. Default is *0.98*.</div>
  80. <h3>[property:Boolean skinning]</h3>
  81. <div>Define whether the material uses skinning. Default is false.</div>
  82. <h3>[property:Texture specularMap]</h3>
  83. <div>Specular map used by the material. Default is null.</div>
  84. <h3>[property:Boolean wireframe]</h3>
  85. <div>Render geometry as wireframe. Default is *false* (i.e. render as flat polygons).</div>
  86. <h3>[property:String wireframeLinecap]</h3>
  87. <div>
  88. Define appearance of line ends. Possible values are "butt", "round" and "square". Default is 'round'.<br /><br />
  89. This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineCap 2D Canvas lineCap]
  90. property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
  91. </div>
  92. <h3>[property:String wireframeLinejoin]</h3>
  93. <div>
  94. Define appearance of line joints. Possible values are "round", "bevel" and "miter". Default is 'round'.<br /><br />
  95. This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]
  96. property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
  97. </div>
  98. <h3>[property:Float wireframeLinewidth]</h3>
  99. <div>Controls wireframe thickness. Default is 1.<br /><br />
  100. Due to limitations in the [link:https://code.google.com/p/angleproject ANGLE layer],
  101. on Windows platforms linewidth will always be 1 regardless of the set value.
  102. </div>
  103. <h2>Methods</h2>
  104. <div>See the base [page:Material] class for common methods.</div>
  105. <h2>Source</h2>
  106. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  107. </body>
  108. </html>