samien
/
three.js
kopia lustrzana https://github.com/mrdoob/three.js.git


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156
							<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="utf-8">
	<title>LineMaterial - Three.js Docs</title>
	<meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
	<script src="../scripts/highlight.min.js"></script>
	<link type="text/css" rel="stylesheet" href="../styles/highlight-three.css">
	<link type="text/css" rel="stylesheet" href="../styles/page.css">
</head>
<body>
		<p class="inheritance" translate="no"><a href="EventDispatcher.html">EventDispatcher</a> → <a href="Material.html">Material</a> → <a href="ShaderMaterial.html">ShaderMaterial</a> → </p>
	<h1 translate="no">LineMaterial</h1>
		<section>
			<header>
				<div class="class-description"><p>A material for drawing wireframe-style geometries.</p>
<p>Unlike <a href="LineBasicMaterial.html">LineBasicMaterial</a>, it supports arbitrary line widths and allows using world units
instead of screen space units. This material is used with <a href="LineSegments2.html">LineSegments2</a> and <a href="Line2.html">Line2</a>.</p>
<p>This module can only be used with <a href="WebGLRenderer.html">WebGLRenderer</a>. When using <a href="WebGPURenderer.html">WebGPURenderer</a>,
use <a href="Line2NodeMaterial.html">Line2NodeMaterial</a>.</p></div>
			</header>
			<article>
				<h2 class="subsection-title">Import</h2>
				<p><span translate="no">LineMaterial</span> is an addon, and must be imported explicitly, see <a href="https://threejs.org/manual/#en/installation" target="_blank" rel="noopener">Installation#Addons</a>.</p>
				<pre><code class="language-js">import { LineMaterial } from 'three/addons/lines/LineMaterial.js';</code></pre>
				<div class="container-overview">
					<h2>Constructor</h2>
					<h3 class="name name-method" id="LineMaterial" translate="no">new <a href="#LineMaterial">LineMaterial</a><span class="signature">( parameters : <span class="param-type">Object</span> )</span> </h3>
					<div class="method">
						<div class="description">
							<p>Constructs a new line segments geometry.</p>
						</div>
						<table class="params">
							<tbody>
								<tr>
									<td class="name">
										<strong>parameters</strong>
									</td>
									<td class="description last">
										<p>An object with one or more properties
defining the material's appearance. Any property of the material
(including any property from inherited materials) can be passed
in here. Color values can be passed any type of value accepted
by <a href="Color.html#set">Color#set</a>.</p>
									</td>
								</tr>
							</tbody>
						</table>
					</div>
				</div>
				<h2 class="subsection-title">Properties</h2>
				<div class="member">
					<h3 class="name" id="alphaToCoverage" translate="no">.<a href="#alphaToCoverage">alphaToCoverage</a><span class="type-signature"> : boolean</span> </h3>
					<div class="description">
						<p>Whether to use alphaToCoverage or not. When enabled, this can improve the
anti-aliasing of line edges when using MSAA.</p>
					</div>
						<dl class="details">
							<dt class="tag-overrides"><strong>Overrides:</strong> <a href="ShaderMaterial.html#alphaToCoverage">ShaderMaterial#alphaToCoverage</a></dt>
						</dl>
				</div>
				<div class="member">
					<h3 class="name" id="color" translate="no">.<a href="#color">color</a><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
					<div class="description">
						<p>The material's color.</p>
						<p>Default is <code>(1,1,1)</code>.</p>
					</div>
				</div>
				<div class="member">
					<h3 class="name" id="dashOffset" translate="no">.<a href="#dashOffset">dashOffset</a><span class="type-signature"> : number</span> </h3>
					<div class="description">
						<p>Where in the dash cycle the dash starts.</p>
						<p>Default is <code>0</code>.</p>
					</div>
				</div>
				<div class="member">
					<h3 class="name" id="dashScale" translate="no">.<a href="#dashScale">dashScale</a><span class="type-signature"> : number</span> </h3>
					<div class="description">
						<p>The scale of the dashes and gaps.</p>
						<p>Default is <code>1</code>.</p>
					</div>
				</div>
				<div class="member">
					<h3 class="name" id="dashSize" translate="no">.<a href="#dashSize">dashSize</a><span class="type-signature"> : number</span> </h3>
					<div class="description">
						<p>The size of the dash.</p>
						<p>Default is <code>1</code>.</p>
					</div>
				</div>
				<div class="member">
					<h3 class="name" id="dashed" translate="no">.<a href="#dashed">dashed</a><span class="type-signature"> : boolean</span> </h3>
					<div class="description">
						<p>Whether the line is dashed, or solid.</p>
						<p>Default is <code>false</code>.</p>
					</div>
				</div>
				<div class="member">
					<h3 class="name" id="gapSize" translate="no">.<a href="#gapSize">gapSize</a><span class="type-signature"> : number</span> </h3>
					<div class="description">
						<p>The size of the gap.</p>
						<p>Default is <code>0</code>.</p>
					</div>
				</div>
				<div class="member">
					<h3 class="name" id="isLineMaterial" translate="no">.<a href="#isLineMaterial">isLineMaterial</a><span class="type-signature"> : boolean</span> <span class="type-signature">(readonly) </span></h3>
					<div class="description">
						<p>This flag can be used for type testing.</p>
						<p>Default is <code>true</code>.</p>
					</div>
				</div>
				<div class="member">
					<h3 class="name" id="linewidth" translate="no">.<a href="#linewidth">linewidth</a><span class="type-signature"> : number</span> </h3>
					<div class="description">
						<p>Controls line thickness in CSS pixel units when <code>worldUnits</code> is <code>false</code> (default),
or in world units when <code>worldUnits</code> is <code>true</code>.</p>
						<p>Default is <code>1</code>.</p>
					</div>
						<dl class="details">
							<dt class="tag-overrides"><strong>Overrides:</strong> <a href="ShaderMaterial.html#linewidth">ShaderMaterial#linewidth</a></dt>
						</dl>
				</div>
				<div class="member">
					<h3 class="name" id="opacity" translate="no">.<a href="#opacity">opacity</a><span class="type-signature"> : number</span> </h3>
					<div class="description">
						<p>The opacity.</p>
						<p>Default is <code>1</code>.</p>
					</div>
						<dl class="details">
							<dt class="tag-overrides"><strong>Overrides:</strong> <a href="ShaderMaterial.html#opacity">ShaderMaterial#opacity</a></dt>
						</dl>
				</div>
				<div class="member">
					<h3 class="name" id="resolution" translate="no">.<a href="#resolution">resolution</a><span class="type-signature"> : <a href="Vector2.html">Vector2</a></span> </h3>
					<div class="description">
						<p>The size of the viewport, in screen pixels. This must be kept updated to make
screen-space rendering accurate.The <code>LineSegments2.onBeforeRender</code> callback
performs the update for visible objects.</p>
					</div>
				</div>
				<div class="member">
					<h3 class="name" id="worldUnits" translate="no">.<a href="#worldUnits">worldUnits</a><span class="type-signature"> : boolean</span> </h3>
					<div class="description">
						<p>Whether the material's sizes (width, dash gaps) are in world units.</p>
						<p>Default is <code>false</code>.</p>
					</div>
				</div>
				<h2 class="subsection-title">Source</h2>
				<p>
					<a href="https://github.com/mrdoob/three.js/blob/master/examples/jsm/lines/LineMaterial.js" translate="no" target="_blank" rel="noopener">examples/jsm/lines/LineMaterial.js</a>
				</p>
			</article>
		</section>
<script src="../scripts/linenumber.js"></script>
<script src="../scripts/page.js"></script>
</body>
</html>