Layers.html 2.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="page.js"></script>
  7. <link type="text/css" rel="stylesheet" href="page.css" />
  8. </head>
  9. <body>
  10. <h1>[name]</h1>
  11. <p class="desc">
  12. A [page:Layers] object assigns an [page:Object3D] to 1 or more of 32 layers numbered 0 to 31
  13. - internally the layers are stored as a [link:https://en.wikipedia.org/wiki/Mask_(computing) bit mask], and by default all
  14. Object3Ds are a member of layer 0.<br /><br />
  15. This can be used to control visibility - an object must share a layer with a [page:Camera camera] to be visible when that camera's
  16. view is renderered.<br /><br />
  17. All classes that inherit from [page:Object3D] have an [page:Object3D.layers] property which is an instance of this class.
  18. </p>
  19. <h2>Examples</h2>
  20. <p>
  21. [example:webgl_layers WebGL / layers]
  22. </p>
  23. <h2>Constructor</h2>
  24. <h3>[name]()</h3>
  25. <p>
  26. Create a new Layers object, with membership initially set to layer 0.
  27. </p>
  28. <h2>Properties</h2>
  29. <h3>[property:Integer mask]</h3>
  30. <p>
  31. A bit mask storing which of the 32 layers this layers object is currently a member of.
  32. </p>
  33. <h2>Methods</h2>
  34. <h3>[method:null disable]( [param:Integer layer] )</h3>
  35. <p>
  36. layer - an integer from 0 to 31.<br /><br />
  37. Remove membership of this *layer*.
  38. </p>
  39. <h3>[method:null enable]( [param:Integer layer] )</h3>
  40. <p>
  41. layer - an integer from 0 to 31.<br /><br />
  42. Add membership of this *layer*.
  43. </p>
  44. <h3>[method:null set]( [param:Integer layer] )</h3>
  45. <p>
  46. layer - an integer from 0 to 31.<br /><br />
  47. Set membership to *layer*, and remove membership all other layers.
  48. </p>
  49. <h3>[method:Boolean test]( [param:Layers layers] )</h3>
  50. <p>
  51. layers - a Layers object<br /><br />
  52. Returns true if this and the passed *layers* object have at least one layer in common.
  53. </p>
  54. <h3>[method:null toggle]( [param:Integer layer] )</h3>
  55. <p>
  56. layer - an integer from 0 to 31.<br /><br />
  57. Toggle membership of *layer*.
  58. </p>
  59. <h3>[method:null enableAll]()</h3>
  60. <p>
  61. Add membership to all layers.
  62. </p>
  63. <h3>[method:null disableAll]()</h3>
  64. <p>
  65. Remove membership from all layers.
  66. </p>
  67. <h2>Source</h2>
  68. <p>
  69. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  70. </p>
  71. </body>
  72. </html>