Home Esplora Aiuto
Registrati Accedi
samien
/
three.js
mirror da https://github.com/mrdoob/three.js.git
1
0
Forka 0
File Problemi 0 Wiki
Albero (Tree): 08d34b63b7
Rami (Branch) Tag
three.js
/
docs
/
pages
/
Color.html

Color.html 42 KB
Cronologia Originale

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042 
  1. <!DOCTYPE html>
    2. 

  2. <html lang="en">
    3. 

  3. <head>
    4. 

  4. 	<meta charset="utf-8">
    5. 

  5. 	<title>Color - Three.js Docs</title>
    6. 

  6. 	<meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
    7. 

  7. 	<script src="../scripts/highlight.min.js"></script>
    8. 

  8. 	<link type="text/css" rel="stylesheet" href="../styles/highlight-three.css">
    9. 

  9. 	<link type="text/css" rel="stylesheet" href="../styles/page.css">
    10. 

  10. </head>
    11. 

  11. <body>
    12. 

  12. 	<h1 translate="no">Color</h1>
    13. 

  13. 		<section>
    14. 

  14. 			<header>
    15. 

  15. 				<div class="class-description"><p>A Color instance is represented by RGB components in the linear <i>working
    16. 

  16. color space</i>, which defaults to <code>LinearSRGBColorSpace</code>. Inputs
    17. 

  17. conventionally using <code>SRGBColorSpace</code> (such as hexadecimals and CSS
    18. 

  18. strings) are converted to the working color space automatically.</p>
    19. 

  19. <pre><code class="language-js">// converted automatically from SRGBColorSpace to LinearSRGBColorSpace
    20. 

  20. const color = new THREE.Color().setHex( 0x112233 );
    21. 

  21. </code></pre>
    22. 

  22. <p>Source color spaces may be specified explicitly, to ensure correct conversions.</p>
    23. 

  23. <pre><code class="language-js">// assumed already LinearSRGBColorSpace; no conversion
    24. 

  24. const color = new THREE.Color().setRGB( 0.5, 0.5, 0.5 );
    25. 

  25. // converted explicitly from SRGBColorSpace to LinearSRGBColorSpace
    26. 

  26. const color = new THREE.Color().setRGB( 0.5, 0.5, 0.5, SRGBColorSpace );
    27. 

  27. </code></pre>
    28. 

  28. <p>If THREE.ColorManagement is disabled, no conversions occur. For details,
    29. 

  29. see <i>Color management</i>. Iterating through a Color instance will yield
    30. 

  30. its components (r, g, b) in the corresponding order. A Color can be initialised
    31. 

  31. in any of the following ways:</p>
    32. 

  32. <pre><code class="language-js">//empty constructor - will default white
    33. 

  33. const color1 = new THREE.Color();
    34. 

  34. //Hexadecimal color (recommended)
    35. 

  35. const color2 = new THREE.Color( 0xff0000 );
    36. 

  36. //RGB string
    37. 

  37. const color3 = new THREE.Color(&quot;rgb(255, 0, 0)&quot;);
    38. 

  38. const color4 = new THREE.Color(&quot;rgb(100%, 0%, 0%)&quot;);
    39. 

  39. //X11 color name - all 140 color names are supported.
    40. 

  40. //Note the lack of CamelCase in the name
    41. 

  41. const color5 = new THREE.Color( 'skyblue' );
    42. 

  42. //HSL string
    43. 

  43. const color6 = new THREE.Color(&quot;hsl(0, 100%, 50%)&quot;);
    44. 

  44. //Separate RGB values between 0 and 1
    45. 

  45. const color7 = new THREE.Color( 1, 0, 0 );
    46. 

  46. </code></pre></div>
    47. 

  47. 			</header>
    48. 

  48. 			<article>
    49. 

  49. 				<div class="container-overview">
    50. 

  50. 					<h2>Constructor</h2>
    51. 

  51. 					<h3 class="name name-method" id="Color" translate="no">new <a href="#Color">Color</a><span class="signature">( r : <span class="param-type">number | string | <a href="Color.html">Color</a></span>, g : <span class="param-type">number</span>, b : <span class="param-type">number</span> )</span> </h3>
    52. 

  52. 					<div class="method">
    53. 

  53. 						<div class="description">
    54. 

  54. 							<p>Constructs a new color.</p>
    55. 

  55. <p>Note that standard method of specifying color in three.js is with a hexadecimal triplet,
    56. 

  56. and that method is used throughout the rest of the documentation.</p>
    57. 

  57. 						</div>
    58. 

  58. 						<table class="params">
    59. 

  59. 							<tbody>
    60. 

  60. 								<tr>
    61. 

  61. 									<td class="name">
    62. 

  62. 										<strong translate="no">r</strong>
    63. 

  63. 									</td>
    64. 

  64. 									<td class="description last">
    65. 

  65. 										<p>The red component of the color. If <code>g</code> and <code>b</code> are
    66. 

  66. not provided, it can be hexadecimal triplet, a CSS-style string or another <code>Color</code> instance.</p>
    67. 

  67. 									</td>
    68. 

  68. 								</tr>
    69. 

  69. 								<tr>
    70. 

  70. 									<td class="name">
    71. 

  71. 										<strong translate="no">g</strong>
    72. 

  72. 									</td>
    73. 

  73. 									<td class="description last">
    74. 

  74. 										<p>The green component.</p>
    75. 

  75. 									</td>
    76. 

  76. 								</tr>
    77. 

  77. 								<tr>
    78. 

  78. 									<td class="name">
    79. 

  79. 										<strong translate="no">b</strong>
    80. 

  80. 									</td>
    81. 

  81. 									<td class="description last">
    82. 

  82. 										<p>The blue component.</p>
    83. 

  83. 									</td>
    84. 

  84. 								</tr>
    85. 

  85. 							</tbody>
    86. 

  86. 						</table>
    87. 

  87. 					</div>
    88. 

  88. 				</div>
    89. 

  89. 				<h2 class="subsection-title">Properties</h2>
    90. 

  90. 				<div class="member">
    91. 

  91. 					<h3 class="name" id="b" translate="no">.<a href="#b">b</a><span class="type-signature"> : number</span> </h3>
    92. 

  92. 					<div class="description">
    93. 

  93. 						<p>The blue component.</p>
    94. 

  94. 						<p>Default is <code>1</code>.</p>
    95. 

  95. 					</div>
    96. 

  96. 				</div>
    97. 

  97. 				<div class="member">
    98. 

  98. 					<h3 class="name" id="g" translate="no">.<a href="#g">g</a><span class="type-signature"> : number</span> </h3>
    99. 

  99. 					<div class="description">
    100. 

  100. 						<p>The green component.</p>
    101. 

  101. 						<p>Default is <code>1</code>.</p>
    102. 

  102. 					</div>
    103. 

  103. 				</div>
    104. 

  104. 				<div class="member">
    105. 

  105. 					<h3 class="name" id="isColor" translate="no">.<a href="#isColor">isColor</a><span class="type-signature"> : boolean</span> <span class="type-signature">(readonly) </span></h3>
    106. 

  106. 					<div class="description">
    107. 

  107. 						<p>This flag can be used for type testing.</p>
    108. 

  108. 						<p>Default is <code>true</code>.</p>
    109. 

  109. 					</div>
    110. 

  110. 				</div>
    111. 

  111. 				<div class="member">
    112. 

  112. 					<h3 class="name" id="r" translate="no">.<a href="#r">r</a><span class="type-signature"> : number</span> </h3>
    113. 

  113. 					<div class="description">
    114. 

  114. 						<p>The red component.</p>
    115. 

  115. 						<p>Default is <code>1</code>.</p>
    116. 

  116. 					</div>
    117. 

  117. 				</div>
    118. 

  118. 				<div class="member">
    119. 

  119. 					<h3 class="name" id=".NAMES" translate="no">.<a href="#.NAMES">NAMES</a><span class="type-signature"> : Object</span> </h3>
    120. 

  120. 					<div class="description">
    121. 

  121. 						<p>A dictionary with X11 color names.</p>
    122. 

  122. <p>Note that multiple words such as Dark Orange become the string 'darkorange'.</p>
    123. 

  123. 					</div>
    124. 

  124. 				</div>
    125. 

  125. 				<h2 class="subsection-title">Methods</h2>
    126. 

  126. 					<h3 class="name name-method" id="add" translate="no">.<a href="#add">add</a><span class="signature">( color : <span class="param-type"><a href="Color.html">Color</a></span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    127. 

  127. 					<div class="method">
    128. 

  128. 						<div class="description">
    129. 

  129. 							<p>Adds the RGB values of the given color to the RGB values of this color.</p>
    130. 

  130. 						</div>
    131. 

  131. 						<table class="params">
    132. 

  132. 							<tbody>
    133. 

  133. 								<tr>
    134. 

  134. 									<td class="name">
    135. 

  135. 										<strong translate="no">color</strong>
    136. 

  136. 									</td>
    137. 

  137. 									<td class="description last">
    138. 

  138. 										<p>The color to add.</p>
    139. 

  139. 									</td>
    140. 

  140. 								</tr>
    141. 

  141. 							</tbody>
    142. 

  142. 						</table>
    143. 

  143. 						<dl class="details">
    144. 

  144. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    145. 

  145. 						</dl>
    146. 

  146. 					</div>
    147. 

  147. 					<h3 class="name name-method" id="addColors" translate="no">.<a href="#addColors">addColors</a><span class="signature">( color1 : <span class="param-type"><a href="Color.html">Color</a></span>, color2 : <span class="param-type"><a href="Color.html">Color</a></span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    148. 

  148. 					<div class="method">
    149. 

  149. 						<div class="description">
    150. 

  150. 							<p>Adds the RGB values of the given colors and stores the result in this instance.</p>
    151. 

  151. 						</div>
    152. 

  152. 						<table class="params">
    153. 

  153. 							<tbody>
    154. 

  154. 								<tr>
    155. 

  155. 									<td class="name">
    156. 

  156. 										<strong translate="no">color1</strong>
    157. 

  157. 									</td>
    158. 

  158. 									<td class="description last">
    159. 

  159. 										<p>The first color.</p>
    160. 

  160. 									</td>
    161. 

  161. 								</tr>
    162. 

  162. 								<tr>
    163. 

  163. 									<td class="name">
    164. 

  164. 										<strong translate="no">color2</strong>
    165. 

  165. 									</td>
    166. 

  166. 									<td class="description last">
    167. 

  167. 										<p>The second color.</p>
    168. 

  168. 									</td>
    169. 

  169. 								</tr>
    170. 

  170. 							</tbody>
    171. 

  171. 						</table>
    172. 

  172. 						<dl class="details">
    173. 

  173. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    174. 

  174. 						</dl>
    175. 

  175. 					</div>
    176. 

  176. 					<h3 class="name name-method" id="addScalar" translate="no">.<a href="#addScalar">addScalar</a><span class="signature">( s : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    177. 

  177. 					<div class="method">
    178. 

  178. 						<div class="description">
    179. 

  179. 							<p>Adds the given scalar value to the RGB values of this color.</p>
    180. 

  180. 						</div>
    181. 

  181. 						<table class="params">
    182. 

  182. 							<tbody>
    183. 

  183. 								<tr>
    184. 

  184. 									<td class="name">
    185. 

  185. 										<strong translate="no">s</strong>
    186. 

  186. 									</td>
    187. 

  187. 									<td class="description last">
    188. 

  188. 										<p>The scalar to add.</p>
    189. 

  189. 									</td>
    190. 

  190. 								</tr>
    191. 

  191. 							</tbody>
    192. 

  192. 						</table>
    193. 

  193. 						<dl class="details">
    194. 

  194. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    195. 

  195. 						</dl>
    196. 

  196. 					</div>
    197. 

  197. 					<h3 class="name name-method" id="applyMatrix3" translate="no">.<a href="#applyMatrix3">applyMatrix3</a><span class="signature">( m : <span class="param-type"><a href="Matrix3.html">Matrix3</a></span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    198. 

  198. 					<div class="method">
    199. 

  199. 						<div class="description">
    200. 

  200. 							<p>Transforms this color with the given 3x3 matrix.</p>
    201. 

  201. 						</div>
    202. 

  202. 						<table class="params">
    203. 

  203. 							<tbody>
    204. 

  204. 								<tr>
    205. 

  205. 									<td class="name">
    206. 

  206. 										<strong translate="no">m</strong>
    207. 

  207. 									</td>
    208. 

  208. 									<td class="description last">
    209. 

  209. 										<p>The matrix.</p>
    210. 

  210. 									</td>
    211. 

  211. 								</tr>
    212. 

  212. 							</tbody>
    213. 

  213. 						</table>
    214. 

  214. 						<dl class="details">
    215. 

  215. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    216. 

  216. 						</dl>
    217. 

  217. 					</div>
    218. 

  218. 					<h3 class="name name-method" id="clone" translate="no">.<a href="#clone">clone</a><span class="signature">()</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    219. 

  219. 					<div class="method">
    220. 

  220. 						<div class="description">
    221. 

  221. 							<p>Returns a new color with copied values from this instance.</p>
    222. 

  222. 						</div>
    223. 

  223. 						<dl class="details">
    224. 

  224. 							<dt class="tag-returns"><strong>Returns:</strong> A clone of this instance.</dt>
    225. 

  225. 						</dl>
    226. 

  226. 					</div>
    227. 

  227. 					<h3 class="name name-method" id="convertLinearToSRGB" translate="no">.<a href="#convertLinearToSRGB">convertLinearToSRGB</a><span class="signature">()</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    228. 

  228. 					<div class="method">
    229. 

  229. 						<div class="description">
    230. 

  230. 							<p>Converts this color from <code>LinearSRGBColorSpace</code> to <code>SRGBColorSpace</code>.</p>
    231. 

  231. 						</div>
    232. 

  232. 						<dl class="details">
    233. 

  233. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    234. 

  234. 						</dl>
    235. 

  235. 					</div>
    236. 

  236. 					<h3 class="name name-method" id="convertSRGBToLinear" translate="no">.<a href="#convertSRGBToLinear">convertSRGBToLinear</a><span class="signature">()</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    237. 

  237. 					<div class="method">
    238. 

  238. 						<div class="description">
    239. 

  239. 							<p>Converts this color from <code>SRGBColorSpace</code> to <code>LinearSRGBColorSpace</code>.</p>
    240. 

  240. 						</div>
    241. 

  241. 						<dl class="details">
    242. 

  242. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    243. 

  243. 						</dl>
    244. 

  244. 					</div>
    245. 

  245. 					<h3 class="name name-method" id="copy" translate="no">.<a href="#copy">copy</a><span class="signature">( color : <span class="param-type"><a href="Color.html">Color</a></span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    246. 

  246. 					<div class="method">
    247. 

  247. 						<div class="description">
    248. 

  248. 							<p>Copies the values of the given color to this instance.</p>
    249. 

  249. 						</div>
    250. 

  250. 						<table class="params">
    251. 

  251. 							<tbody>
    252. 

  252. 								<tr>
    253. 

  253. 									<td class="name">
    254. 

  254. 										<strong translate="no">color</strong>
    255. 

  255. 									</td>
    256. 

  256. 									<td class="description last">
    257. 

  257. 										<p>The color to copy.</p>
    258. 

  258. 									</td>
    259. 

  259. 								</tr>
    260. 

  260. 							</tbody>
    261. 

  261. 						</table>
    262. 

  262. 						<dl class="details">
    263. 

  263. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    264. 

  264. 						</dl>
    265. 

  265. 					</div>
    266. 

  266. 					<h3 class="name name-method" id="copyLinearToSRGB" translate="no">.<a href="#copyLinearToSRGB">copyLinearToSRGB</a><span class="signature">( color : <span class="param-type"><a href="Color.html">Color</a></span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    267. 

  267. 					<div class="method">
    268. 

  268. 						<div class="description">
    269. 

  269. 							<p>Copies the given color into this color, and then converts this color from
    270. 

  270. <code>LinearSRGBColorSpace</code> to <code>SRGBColorSpace</code>.</p>
    271. 

  271. 						</div>
    272. 

  272. 						<table class="params">
    273. 

  273. 							<tbody>
    274. 

  274. 								<tr>
    275. 

  275. 									<td class="name">
    276. 

  276. 										<strong translate="no">color</strong>
    277. 

  277. 									</td>
    278. 

  278. 									<td class="description last">
    279. 

  279. 										<p>The color to copy/convert.</p>
    280. 

  280. 									</td>
    281. 

  281. 								</tr>
    282. 

  282. 							</tbody>
    283. 

  283. 						</table>
    284. 

  284. 						<dl class="details">
    285. 

  285. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    286. 

  286. 						</dl>
    287. 

  287. 					</div>
    288. 

  288. 					<h3 class="name name-method" id="copySRGBToLinear" translate="no">.<a href="#copySRGBToLinear">copySRGBToLinear</a><span class="signature">( color : <span class="param-type"><a href="Color.html">Color</a></span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    289. 

  289. 					<div class="method">
    290. 

  290. 						<div class="description">
    291. 

  291. 							<p>Copies the given color into this color, and then converts this color from
    292. 

  292. <code>SRGBColorSpace</code> to <code>LinearSRGBColorSpace</code>.</p>
    293. 

  293. 						</div>
    294. 

  294. 						<table class="params">
    295. 

  295. 							<tbody>
    296. 

  296. 								<tr>
    297. 

  297. 									<td class="name">
    298. 

  298. 										<strong translate="no">color</strong>
    299. 

  299. 									</td>
    300. 

  300. 									<td class="description last">
    301. 

  301. 										<p>The color to copy/convert.</p>
    302. 

  302. 									</td>
    303. 

  303. 								</tr>
    304. 

  304. 							</tbody>
    305. 

  305. 						</table>
    306. 

  306. 						<dl class="details">
    307. 

  307. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    308. 

  308. 						</dl>
    309. 

  309. 					</div>
    310. 

  310. 					<h3 class="name name-method" id="equals" translate="no">.<a href="#equals">equals</a><span class="signature">( c : <span class="param-type"><a href="Color.html">Color</a></span> )</span><span class="type-signature"> : boolean</span> </h3>
    311. 

  311. 					<div class="method">
    312. 

  312. 						<div class="description">
    313. 

  313. 							<p>Returns <code>true</code> if this color is equal with the given one.</p>
    314. 

  314. 						</div>
    315. 

  315. 						<table class="params">
    316. 

  316. 							<tbody>
    317. 

  317. 								<tr>
    318. 

  318. 									<td class="name">
    319. 

  319. 										<strong translate="no">c</strong>
    320. 

  320. 									</td>
    321. 

  321. 									<td class="description last">
    322. 

  322. 										<p>The color to test for equality.</p>
    323. 

  323. 									</td>
    324. 

  324. 								</tr>
    325. 

  325. 							</tbody>
    326. 

  326. 						</table>
    327. 

  327. 						<dl class="details">
    328. 

  328. 							<dt class="tag-returns"><strong>Returns:</strong> Whether this bounding color is equal with the given one.</dt>
    329. 

  329. 						</dl>
    330. 

  330. 					</div>
    331. 

  331. 					<h3 class="name name-method" id="fromArray" translate="no">.<a href="#fromArray">fromArray</a><span class="signature">( array : <span class="param-type">Array.&lt;number></span>, offset : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    332. 

  332. 					<div class="method">
    333. 

  333. 						<div class="description">
    334. 

  334. 							<p>Sets this color's RGB components from the given array.</p>
    335. 

  335. 						</div>
    336. 

  336. 						<table class="params">
    337. 

  337. 							<tbody>
    338. 

  338. 								<tr>
    339. 

  339. 									<td class="name">
    340. 

  340. 										<strong translate="no">array</strong>
    341. 

  341. 									</td>
    342. 

  342. 									<td class="description last">
    343. 

  343. 										<p>An array holding the RGB values.</p>
    344. 

  344. 									</td>
    345. 

  345. 								</tr>
    346. 

  346. 								<tr>
    347. 

  347. 									<td class="name">
    348. 

  348. 										<strong translate="no">offset</strong>
    349. 

  349. 									</td>
    350. 

  350. 									<td class="description last">
    351. 

  351. 										<p>The offset into the array.</p>
    352. 

  352. 										<p>Default is <code>0</code>.</p>
    353. 

  353. 									</td>
    354. 

  354. 								</tr>
    355. 

  355. 							</tbody>
    356. 

  356. 						</table>
    357. 

  357. 						<dl class="details">
    358. 

  358. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    359. 

  359. 						</dl>
    360. 

  360. 					</div>
    361. 

  361. 					<h3 class="name name-method" id="fromBufferAttribute" translate="no">.<a href="#fromBufferAttribute">fromBufferAttribute</a><span class="signature">( attribute : <span class="param-type"><a href="BufferAttribute.html">BufferAttribute</a></span>, index : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    362. 

  362. 					<div class="method">
    363. 

  363. 						<div class="description">
    364. 

  364. 							<p>Sets the components of this color from the given buffer attribute.</p>
    365. 

  365. 						</div>
    366. 

  366. 						<table class="params">
    367. 

  367. 							<tbody>
    368. 

  368. 								<tr>
    369. 

  369. 									<td class="name">
    370. 

  370. 										<strong translate="no">attribute</strong>
    371. 

  371. 									</td>
    372. 

  372. 									<td class="description last">
    373. 

  373. 										<p>The buffer attribute holding color data.</p>
    374. 

  374. 									</td>
    375. 

  375. 								</tr>
    376. 

  376. 								<tr>
    377. 

  377. 									<td class="name">
    378. 

  378. 										<strong translate="no">index</strong>
    379. 

  379. 									</td>
    380. 

  380. 									<td class="description last">
    381. 

  381. 										<p>The index into the attribute.</p>
    382. 

  382. 									</td>
    383. 

  383. 								</tr>
    384. 

  384. 							</tbody>
    385. 

  385. 						</table>
    386. 

  386. 						<dl class="details">
    387. 

  387. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    388. 

  388. 						</dl>
    389. 

  389. 					</div>
    390. 

  390. 					<h3 class="name name-method" id="getHSL" translate="no">.<a href="#getHSL">getHSL</a><span class="signature">( target : <span class="param-type">Object</span>, colorSpace : <span class="param-type">string</span> )</span><span class="type-signature"> : Object</span> </h3>
    391. 

  391. 					<div class="method">
    392. 

  392. 						<div class="description">
    393. 

  393. 							<p>Converts the colors RGB values into the HSL format and stores them into the
    394. 

  394. given target object.</p>
    395. 

  395. 						</div>
    396. 

  396. 						<table class="params">
    397. 

  397. 							<tbody>
    398. 

  398. 								<tr>
    399. 

  399. 									<td class="name">
    400. 

  400. 										<strong translate="no">target</strong>
    401. 

  401. 									</td>
    402. 

  402. 									<td class="description last">
    403. 

  403. 										<p>The target object that is used to store the method's result.</p>
    404. 

  404. 									</td>
    405. 

  405. 								</tr>
    406. 

  406. 								<tr>
    407. 

  407. 									<td class="name">
    408. 

  408. 										<strong translate="no">colorSpace</strong>
    409. 

  409. 									</td>
    410. 

  410. 									<td class="description last">
    411. 

  411. 										<p>The color space.</p>
    412. 

  412. 										<p>Default is <code>ColorManagement.workingColorSpace</code>.</p>
    413. 

  413. 									</td>
    414. 

  414. 								</tr>
    415. 

  415. 							</tbody>
    416. 

  416. 						</table>
    417. 

  417. 						<dl class="details">
    418. 

  418. 							<dt class="tag-returns"><strong>Returns:</strong> The HSL representation of this color.</dt>
    419. 

  419. 						</dl>
    420. 

  420. 					</div>
    421. 

  421. 					<h3 class="name name-method" id="getHex" translate="no">.<a href="#getHex">getHex</a><span class="signature">( colorSpace : <span class="param-type">string</span> )</span><span class="type-signature"> : number</span> </h3>
    422. 

  422. 					<div class="method">
    423. 

  423. 						<div class="description">
    424. 

  424. 							<p>Returns the hexadecimal value of this color.</p>
    425. 

  425. 						</div>
    426. 

  426. 						<table class="params">
    427. 

  427. 							<tbody>
    428. 

  428. 								<tr>
    429. 

  429. 									<td class="name">
    430. 

  430. 										<strong translate="no">colorSpace</strong>
    431. 

  431. 									</td>
    432. 

  432. 									<td class="description last">
    433. 

  433. 										<p>The color space.</p>
    434. 

  434. 										<p>Default is <code>SRGBColorSpace</code>.</p>
    435. 

  435. 									</td>
    436. 

  436. 								</tr>
    437. 

  437. 							</tbody>
    438. 

  438. 						</table>
    439. 

  439. 						<dl class="details">
    440. 

  440. 							<dt class="tag-returns"><strong>Returns:</strong> The hexadecimal value.</dt>
    441. 

  441. 						</dl>
    442. 

  442. 					</div>
    443. 

  443. 					<h3 class="name name-method" id="getHexString" translate="no">.<a href="#getHexString">getHexString</a><span class="signature">( colorSpace : <span class="param-type">string</span> )</span><span class="type-signature"> : string</span> </h3>
    444. 

  444. 					<div class="method">
    445. 

  445. 						<div class="description">
    446. 

  446. 							<p>Returns the hexadecimal value of this color as a string (for example, 'FFFFFF').</p>
    447. 

  447. 						</div>
    448. 

  448. 						<table class="params">
    449. 

  449. 							<tbody>
    450. 

  450. 								<tr>
    451. 

  451. 									<td class="name">
    452. 

  452. 										<strong translate="no">colorSpace</strong>
    453. 

  453. 									</td>
    454. 

  454. 									<td class="description last">
    455. 

  455. 										<p>The color space.</p>
    456. 

  456. 										<p>Default is <code>SRGBColorSpace</code>.</p>
    457. 

  457. 									</td>
    458. 

  458. 								</tr>
    459. 

  459. 							</tbody>
    460. 

  460. 						</table>
    461. 

  461. 						<dl class="details">
    462. 

  462. 							<dt class="tag-returns"><strong>Returns:</strong> The hexadecimal value as a string.</dt>
    463. 

  463. 						</dl>
    464. 

  464. 					</div>
    465. 

  465. 					<h3 class="name name-method" id="getRGB" translate="no">.<a href="#getRGB">getRGB</a><span class="signature">( target : <span class="param-type"><a href="Color.html">Color</a></span>, colorSpace : <span class="param-type">string</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    466. 

  466. 					<div class="method">
    467. 

  467. 						<div class="description">
    468. 

  468. 							<p>Returns the RGB values of this color and stores them into the given target object.</p>
    469. 

  469. 						</div>
    470. 

  470. 						<table class="params">
    471. 

  471. 							<tbody>
    472. 

  472. 								<tr>
    473. 

  473. 									<td class="name">
    474. 

  474. 										<strong translate="no">target</strong>
    475. 

  475. 									</td>
    476. 

  476. 									<td class="description last">
    477. 

  477. 										<p>The target color that is used to store the method's result.</p>
    478. 

  478. 									</td>
    479. 

  479. 								</tr>
    480. 

  480. 								<tr>
    481. 

  481. 									<td class="name">
    482. 

  482. 										<strong translate="no">colorSpace</strong>
    483. 

  483. 									</td>
    484. 

  484. 									<td class="description last">
    485. 

  485. 										<p>The color space.</p>
    486. 

  486. 										<p>Default is <code>ColorManagement.workingColorSpace</code>.</p>
    487. 

  487. 									</td>
    488. 

  488. 								</tr>
    489. 

  489. 							</tbody>
    490. 

  490. 						</table>
    491. 

  491. 						<dl class="details">
    492. 

  492. 							<dt class="tag-returns"><strong>Returns:</strong> The RGB representation of this color.</dt>
    493. 

  493. 						</dl>
    494. 

  494. 					</div>
    495. 

  495. 					<h3 class="name name-method" id="getStyle" translate="no">.<a href="#getStyle">getStyle</a><span class="signature">( colorSpace : <span class="param-type">string</span> )</span><span class="type-signature"> : string</span> </h3>
    496. 

  496. 					<div class="method">
    497. 

  497. 						<div class="description">
    498. 

  498. 							<p>Returns the value of this color as a CSS style string. Example: <code>rgb(255,0,0)</code>.</p>
    499. 

  499. 						</div>
    500. 

  500. 						<table class="params">
    501. 

  501. 							<tbody>
    502. 

  502. 								<tr>
    503. 

  503. 									<td class="name">
    504. 

  504. 										<strong translate="no">colorSpace</strong>
    505. 

  505. 									</td>
    506. 

  506. 									<td class="description last">
    507. 

  507. 										<p>The color space.</p>
    508. 

  508. 										<p>Default is <code>SRGBColorSpace</code>.</p>
    509. 

  509. 									</td>
    510. 

  510. 								</tr>
    511. 

  511. 							</tbody>
    512. 

  512. 						</table>
    513. 

  513. 						<dl class="details">
    514. 

  514. 							<dt class="tag-returns"><strong>Returns:</strong> The CSS representation of this color.</dt>
    515. 

  515. 						</dl>
    516. 

  516. 					</div>
    517. 

  517. 					<h3 class="name name-method" id="lerp" translate="no">.<a href="#lerp">lerp</a><span class="signature">( color : <span class="param-type"><a href="Color.html">Color</a></span>, alpha : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    518. 

  518. 					<div class="method">
    519. 

  519. 						<div class="description">
    520. 

  520. 							<p>Linearly interpolates this color's RGB values toward the RGB values of the
    521. 

  521. given color. The alpha argument can be thought of as the ratio between
    522. 

  522. the two colors, where <code>0.0</code> is this color and <code>1.0</code> is the first argument.</p>
    523. 

  523. 						</div>
    524. 

  524. 						<table class="params">
    525. 

  525. 							<tbody>
    526. 

  526. 								<tr>
    527. 

  527. 									<td class="name">
    528. 

  528. 										<strong translate="no">color</strong>
    529. 

  529. 									</td>
    530. 

  530. 									<td class="description last">
    531. 

  531. 										<p>The color to converge on.</p>
    532. 

  532. 									</td>
    533. 

  533. 								</tr>
    534. 

  534. 								<tr>
    535. 

  535. 									<td class="name">
    536. 

  536. 										<strong translate="no">alpha</strong>
    537. 

  537. 									</td>
    538. 

  538. 									<td class="description last">
    539. 

  539. 										<p>The interpolation factor in the closed interval <code>[0,1]</code>.</p>
    540. 

  540. 									</td>
    541. 

  541. 								</tr>
    542. 

  542. 							</tbody>
    543. 

  543. 						</table>
    544. 

  544. 						<dl class="details">
    545. 

  545. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    546. 

  546. 						</dl>
    547. 

  547. 					</div>
    548. 

  548. 					<h3 class="name name-method" id="lerpColors" translate="no">.<a href="#lerpColors">lerpColors</a><span class="signature">( color1 : <span class="param-type"><a href="Color.html">Color</a></span>, color2 : <span class="param-type"><a href="Color.html">Color</a></span>, alpha : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    549. 

  549. 					<div class="method">
    550. 

  550. 						<div class="description">
    551. 

  551. 							<p>Linearly interpolates between the given colors and stores the result in this instance.
    552. 

  552. The alpha argument can be thought of as the ratio between the two colors, where <code>0.0</code>
    553. 

  553. is the first and <code>1.0</code> is the second color.</p>
    554. 

  554. 						</div>
    555. 

  555. 						<table class="params">
    556. 

  556. 							<tbody>
    557. 

  557. 								<tr>
    558. 

  558. 									<td class="name">
    559. 

  559. 										<strong translate="no">color1</strong>
    560. 

  560. 									</td>
    561. 

  561. 									<td class="description last">
    562. 

  562. 										<p>The first color.</p>
    563. 

  563. 									</td>
    564. 

  564. 								</tr>
    565. 

  565. 								<tr>
    566. 

  566. 									<td class="name">
    567. 

  567. 										<strong translate="no">color2</strong>
    568. 

  568. 									</td>
    569. 

  569. 									<td class="description last">
    570. 

  570. 										<p>The second color.</p>
    571. 

  571. 									</td>
    572. 

  572. 								</tr>
    573. 

  573. 								<tr>
    574. 

  574. 									<td class="name">
    575. 

  575. 										<strong translate="no">alpha</strong>
    576. 

  576. 									</td>
    577. 

  577. 									<td class="description last">
    578. 

  578. 										<p>The interpolation factor in the closed interval <code>[0,1]</code>.</p>
    579. 

  579. 									</td>
    580. 

  580. 								</tr>
    581. 

  581. 							</tbody>
    582. 

  582. 						</table>
    583. 

  583. 						<dl class="details">
    584. 

  584. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    585. 

  585. 						</dl>
    586. 

  586. 					</div>
    587. 

  587. 					<h3 class="name name-method" id="lerpHSL" translate="no">.<a href="#lerpHSL">lerpHSL</a><span class="signature">( color : <span class="param-type"><a href="Color.html">Color</a></span>, alpha : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    588. 

  588. 					<div class="method">
    589. 

  589. 						<div class="description">
    590. 

  590. 							<p>Linearly interpolates this color's HSL values toward the HSL values of the
    591. 

  591. given color. It differs from <a href="Color.html#lerp">Color#lerp</a> by not interpolating straight
    592. 

  592. from one color to the other, but instead going through all the hues in between
    593. 

  593. those two colors. The alpha argument can be thought of as the ratio between
    594. 

  594. the two colors, where 0.0 is this color and 1.0 is the first argument.</p>
    595. 

  595. 						</div>
    596. 

  596. 						<table class="params">
    597. 

  597. 							<tbody>
    598. 

  598. 								<tr>
    599. 

  599. 									<td class="name">
    600. 

  600. 										<strong translate="no">color</strong>
    601. 

  601. 									</td>
    602. 

  602. 									<td class="description last">
    603. 

  603. 										<p>The color to converge on.</p>
    604. 

  604. 									</td>
    605. 

  605. 								</tr>
    606. 

  606. 								<tr>
    607. 

  607. 									<td class="name">
    608. 

  608. 										<strong translate="no">alpha</strong>
    609. 

  609. 									</td>
    610. 

  610. 									<td class="description last">
    611. 

  611. 										<p>The interpolation factor in the closed interval <code>[0,1]</code>.</p>
    612. 

  612. 									</td>
    613. 

  613. 								</tr>
    614. 

  614. 							</tbody>
    615. 

  615. 						</table>
    616. 

  616. 						<dl class="details">
    617. 

  617. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    618. 

  618. 						</dl>
    619. 

  619. 					</div>
    620. 

  620. 					<h3 class="name name-method" id="multiply" translate="no">.<a href="#multiply">multiply</a><span class="signature">( color : <span class="param-type"><a href="Color.html">Color</a></span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    621. 

  621. 					<div class="method">
    622. 

  622. 						<div class="description">
    623. 

  623. 							<p>Multiplies the RGB values of the given color with the RGB values of this color.</p>
    624. 

  624. 						</div>
    625. 

  625. 						<table class="params">
    626. 

  626. 							<tbody>
    627. 

  627. 								<tr>
    628. 

  628. 									<td class="name">
    629. 

  629. 										<strong translate="no">color</strong>
    630. 

  630. 									</td>
    631. 

  631. 									<td class="description last">
    632. 

  632. 										<p>The color to multiply.</p>
    633. 

  633. 									</td>
    634. 

  634. 								</tr>
    635. 

  635. 							</tbody>
    636. 

  636. 						</table>
    637. 

  637. 						<dl class="details">
    638. 

  638. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    639. 

  639. 						</dl>
    640. 

  640. 					</div>
    641. 

  641. 					<h3 class="name name-method" id="multiplyScalar" translate="no">.<a href="#multiplyScalar">multiplyScalar</a><span class="signature">( s : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    642. 

  642. 					<div class="method">
    643. 

  643. 						<div class="description">
    644. 

  644. 							<p>Multiplies the given scalar value with the RGB values of this color.</p>
    645. 

  645. 						</div>
    646. 

  646. 						<table class="params">
    647. 

  647. 							<tbody>
    648. 

  648. 								<tr>
    649. 

  649. 									<td class="name">
    650. 

  650. 										<strong translate="no">s</strong>
    651. 

  651. 									</td>
    652. 

  652. 									<td class="description last">
    653. 

  653. 										<p>The scalar to multiply.</p>
    654. 

  654. 									</td>
    655. 

  655. 								</tr>
    656. 

  656. 							</tbody>
    657. 

  657. 						</table>
    658. 

  658. 						<dl class="details">
    659. 

  659. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    660. 

  660. 						</dl>
    661. 

  661. 					</div>
    662. 

  662. 					<h3 class="name name-method" id="offsetHSL" translate="no">.<a href="#offsetHSL">offsetHSL</a><span class="signature">( h : <span class="param-type">number</span>, s : <span class="param-type">number</span>, l : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    663. 

  663. 					<div class="method">
    664. 

  664. 						<div class="description">
    665. 

  665. 							<p>Adds the given HSL values to this color's values.
    666. 

  666. Internally, this converts the color's RGB values to HSL, adds HSL
    667. 

  667. and then converts the color back to RGB.</p>
    668. 

  668. 						</div>
    669. 

  669. 						<table class="params">
    670. 

  670. 							<tbody>
    671. 

  671. 								<tr>
    672. 

  672. 									<td class="name">
    673. 

  673. 										<strong translate="no">h</strong>
    674. 

  674. 									</td>
    675. 

  675. 									<td class="description last">
    676. 

  676. 										<p>Hue value between <code>0.0</code> and <code>1.0</code>.</p>
    677. 

  677. 									</td>
    678. 

  678. 								</tr>
    679. 

  679. 								<tr>
    680. 

  680. 									<td class="name">
    681. 

  681. 										<strong translate="no">s</strong>
    682. 

  682. 									</td>
    683. 

  683. 									<td class="description last">
    684. 

  684. 										<p>Saturation value between <code>0.0</code> and <code>1.0</code>.</p>
    685. 

  685. 									</td>
    686. 

  686. 								</tr>
    687. 

  687. 								<tr>
    688. 

  688. 									<td class="name">
    689. 

  689. 										<strong translate="no">l</strong>
    690. 

  690. 									</td>
    691. 

  691. 									<td class="description last">
    692. 

  692. 										<p>Lightness value between <code>0.0</code> and <code>1.0</code>.</p>
    693. 

  693. 									</td>
    694. 

  694. 								</tr>
    695. 

  695. 							</tbody>
    696. 

  696. 						</table>
    697. 

  697. 						<dl class="details">
    698. 

  698. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    699. 

  699. 						</dl>
    700. 

  700. 					</div>
    701. 

  701. 					<h3 class="name name-method" id="set" translate="no">.<a href="#set">set</a><span class="signature">( r : <span class="param-type">number | string | <a href="Color.html">Color</a></span>, g : <span class="param-type">number</span>, b : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    702. 

  702. 					<div class="method">
    703. 

  703. 						<div class="description">
    704. 

  704. 							<p>Sets the colors's components from the given values.</p>
    705. 

  705. 						</div>
    706. 

  706. 						<table class="params">
    707. 

  707. 							<tbody>
    708. 

  708. 								<tr>
    709. 

  709. 									<td class="name">
    710. 

  710. 										<strong translate="no">r</strong>
    711. 

  711. 									</td>
    712. 

  712. 									<td class="description last">
    713. 

  713. 										<p>The red component of the color. If <code>g</code> and <code>b</code> are
    714. 

  714. not provided, it can be hexadecimal triplet, a CSS-style string or another <code>Color</code> instance.</p>
    715. 

  715. 									</td>
    716. 

  716. 								</tr>
    717. 

  717. 								<tr>
    718. 

  718. 									<td class="name">
    719. 

  719. 										<strong translate="no">g</strong>
    720. 

  720. 									</td>
    721. 

  721. 									<td class="description last">
    722. 

  722. 										<p>The green component.</p>
    723. 

  723. 									</td>
    724. 

  724. 								</tr>
    725. 

  725. 								<tr>
    726. 

  726. 									<td class="name">
    727. 

  727. 										<strong translate="no">b</strong>
    728. 

  728. 									</td>
    729. 

  729. 									<td class="description last">
    730. 

  730. 										<p>The blue component.</p>
    731. 

  731. 									</td>
    732. 

  732. 								</tr>
    733. 

  733. 							</tbody>
    734. 

  734. 						</table>
    735. 

  735. 						<dl class="details">
    736. 

  736. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    737. 

  737. 						</dl>
    738. 

  738. 					</div>
    739. 

  739. 					<h3 class="name name-method" id="setColorName" translate="no">.<a href="#setColorName">setColorName</a><span class="signature">( style : <span class="param-type">string</span>, colorSpace : <span class="param-type">string</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    740. 

  740. 					<div class="method">
    741. 

  741. 						<div class="description">
    742. 

  742. 							<p>Sets this color from a color name. Faster than <a href="Color.html#setStyle">Color#setStyle</a> if
    743. 

  743. you don't need the other CSS-style formats.</p>
    744. 

  744. <p>For convenience, the list of names is exposed in <code>Color.NAMES</code> as a hash.</p>
    745. 

  745. <pre><code class="language-js">Color.NAMES.aliceblue // returns 0xF0F8FF
    746. 

  746. </code></pre>
    747. 

  747. 						</div>
    748. 

  748. 						<table class="params">
    749. 

  749. 							<tbody>
    750. 

  750. 								<tr>
    751. 

  751. 									<td class="name">
    752. 

  752. 										<strong translate="no">style</strong>
    753. 

  753. 									</td>
    754. 

  754. 									<td class="description last">
    755. 

  755. 										<p>The color name.</p>
    756. 

  756. 									</td>
    757. 

  757. 								</tr>
    758. 

  758. 								<tr>
    759. 

  759. 									<td class="name">
    760. 

  760. 										<strong translate="no">colorSpace</strong>
    761. 

  761. 									</td>
    762. 

  762. 									<td class="description last">
    763. 

  763. 										<p>The color space.</p>
    764. 

  764. 										<p>Default is <code>SRGBColorSpace</code>.</p>
    765. 

  765. 									</td>
    766. 

  766. 								</tr>
    767. 

  767. 							</tbody>
    768. 

  768. 						</table>
    769. 

  769. 						<dl class="details">
    770. 

  770. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    771. 

  771. 						</dl>
    772. 

  772. 					</div>
    773. 

  773. 					<h3 class="name name-method" id="setFromVector3" translate="no">.<a href="#setFromVector3">setFromVector3</a><span class="signature">( v : <span class="param-type"><a href="Vector3.html">Vector3</a></span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    774. 

  774. 					<div class="method">
    775. 

  775. 						<div class="description">
    776. 

  776. 							<p>Sets the color's RGB components from the given 3D vector.</p>
    777. 

  777. 						</div>
    778. 

  778. 						<table class="params">
    779. 

  779. 							<tbody>
    780. 

  780. 								<tr>
    781. 

  781. 									<td class="name">
    782. 

  782. 										<strong translate="no">v</strong>
    783. 

  783. 									</td>
    784. 

  784. 									<td class="description last">
    785. 

  785. 										<p>The vector to set.</p>
    786. 

  786. 									</td>
    787. 

  787. 								</tr>
    788. 

  788. 							</tbody>
    789. 

  789. 						</table>
    790. 

  790. 						<dl class="details">
    791. 

  791. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    792. 

  792. 						</dl>
    793. 

  793. 					</div>
    794. 

  794. 					<h3 class="name name-method" id="setHSL" translate="no">.<a href="#setHSL">setHSL</a><span class="signature">( h : <span class="param-type">number</span>, s : <span class="param-type">number</span>, l : <span class="param-type">number</span>, colorSpace : <span class="param-type">string</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    795. 

  795. 					<div class="method">
    796. 

  796. 						<div class="description">
    797. 

  797. 							<p>Sets this color from RGB values.</p>
    798. 

  798. 						</div>
    799. 

  799. 						<table class="params">
    800. 

  800. 							<tbody>
    801. 

  801. 								<tr>
    802. 

  802. 									<td class="name">
    803. 

  803. 										<strong translate="no">h</strong>
    804. 

  804. 									</td>
    805. 

  805. 									<td class="description last">
    806. 

  806. 										<p>Hue value between <code>0.0</code> and <code>1.0</code>.</p>
    807. 

  807. 									</td>
    808. 

  808. 								</tr>
    809. 

  809. 								<tr>
    810. 

  810. 									<td class="name">
    811. 

  811. 										<strong translate="no">s</strong>
    812. 

  812. 									</td>
    813. 

  813. 									<td class="description last">
    814. 

  814. 										<p>Saturation value between <code>0.0</code> and <code>1.0</code>.</p>
    815. 

  815. 									</td>
    816. 

  816. 								</tr>
    817. 

  817. 								<tr>
    818. 

  818. 									<td class="name">
    819. 

  819. 										<strong translate="no">l</strong>
    820. 

  820. 									</td>
    821. 

  821. 									<td class="description last">
    822. 

  822. 										<p>Lightness value between <code>0.0</code> and <code>1.0</code>.</p>
    823. 

  823. 									</td>
    824. 

  824. 								</tr>
    825. 

  825. 								<tr>
    826. 

  826. 									<td class="name">
    827. 

  827. 										<strong translate="no">colorSpace</strong>
    828. 

  828. 									</td>
    829. 

  829. 									<td class="description last">
    830. 

  830. 										<p>The color space.</p>
    831. 

  831. 										<p>Default is <code>ColorManagement.workingColorSpace</code>.</p>
    832. 

  832. 									</td>
    833. 

  833. 								</tr>
    834. 

  834. 							</tbody>
    835. 

  835. 						</table>
    836. 

  836. 						<dl class="details">
    837. 

  837. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    838. 

  838. 						</dl>
    839. 

  839. 					</div>
    840. 

  840. 					<h3 class="name name-method" id="setHex" translate="no">.<a href="#setHex">setHex</a><span class="signature">( hex : <span class="param-type">number</span>, colorSpace : <span class="param-type">string</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    841. 

  841. 					<div class="method">
    842. 

  842. 						<div class="description">
    843. 

  843. 							<p>Sets this color from a hexadecimal value.</p>
    844. 

  844. 						</div>
    845. 

  845. 						<table class="params">
    846. 

  846. 							<tbody>
    847. 

  847. 								<tr>
    848. 

  848. 									<td class="name">
    849. 

  849. 										<strong translate="no">hex</strong>
    850. 

  850. 									</td>
    851. 

  851. 									<td class="description last">
    852. 

  852. 										<p>The hexadecimal value.</p>
    853. 

  853. 									</td>
    854. 

  854. 								</tr>
    855. 

  855. 								<tr>
    856. 

  856. 									<td class="name">
    857. 

  857. 										<strong translate="no">colorSpace</strong>
    858. 

  858. 									</td>
    859. 

  859. 									<td class="description last">
    860. 

  860. 										<p>The color space.</p>
    861. 

  861. 										<p>Default is <code>SRGBColorSpace</code>.</p>
    862. 

  862. 									</td>
    863. 

  863. 								</tr>
    864. 

  864. 							</tbody>
    865. 

  865. 						</table>
    866. 

  866. 						<dl class="details">
    867. 

  867. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    868. 

  868. 						</dl>
    869. 

  869. 					</div>
    870. 

  870. 					<h3 class="name name-method" id="setRGB" translate="no">.<a href="#setRGB">setRGB</a><span class="signature">( r : <span class="param-type">number</span>, g : <span class="param-type">number</span>, b : <span class="param-type">number</span>, colorSpace : <span class="param-type">string</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    871. 

  871. 					<div class="method">
    872. 

  872. 						<div class="description">
    873. 

  873. 							<p>Sets this color from RGB values.</p>
    874. 

  874. 						</div>
    875. 

  875. 						<table class="params">
    876. 

  876. 							<tbody>
    877. 

  877. 								<tr>
    878. 

  878. 									<td class="name">
    879. 

  879. 										<strong translate="no">r</strong>
    880. 

  880. 									</td>
    881. 

  881. 									<td class="description last">
    882. 

  882. 										<p>Red channel value between <code>0.0</code> and <code>1.0</code>.</p>
    883. 

  883. 									</td>
    884. 

  884. 								</tr>
    885. 

  885. 								<tr>
    886. 

  886. 									<td class="name">
    887. 

  887. 										<strong translate="no">g</strong>
    888. 

  888. 									</td>
    889. 

  889. 									<td class="description last">
    890. 

  890. 										<p>Green channel value between <code>0.0</code> and <code>1.0</code>.</p>
    891. 

  891. 									</td>
    892. 

  892. 								</tr>
    893. 

  893. 								<tr>
    894. 

  894. 									<td class="name">
    895. 

  895. 										<strong translate="no">b</strong>
    896. 

  896. 									</td>
    897. 

  897. 									<td class="description last">
    898. 

  898. 										<p>Blue channel value between <code>0.0</code> and <code>1.0</code>.</p>
    899. 

  899. 									</td>
    900. 

  900. 								</tr>
    901. 

  901. 								<tr>
    902. 

  902. 									<td class="name">
    903. 

  903. 										<strong translate="no">colorSpace</strong>
    904. 

  904. 									</td>
    905. 

  905. 									<td class="description last">
    906. 

  906. 										<p>The color space.</p>
    907. 

  907. 										<p>Default is <code>ColorManagement.workingColorSpace</code>.</p>
    908. 

  908. 									</td>
    909. 

  909. 								</tr>
    910. 

  910. 							</tbody>
    911. 

  911. 						</table>
    912. 

  912. 						<dl class="details">
    913. 

  913. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    914. 

  914. 						</dl>
    915. 

  915. 					</div>
    916. 

  916. 					<h3 class="name name-method" id="setScalar" translate="no">.<a href="#setScalar">setScalar</a><span class="signature">( scalar : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    917. 

  917. 					<div class="method">
    918. 

  918. 						<div class="description">
    919. 

  919. 							<p>Sets the colors's components to the given scalar value.</p>
    920. 

  920. 						</div>
    921. 

  921. 						<table class="params">
    922. 

  922. 							<tbody>
    923. 

  923. 								<tr>
    924. 

  924. 									<td class="name">
    925. 

  925. 										<strong translate="no">scalar</strong>
    926. 

  926. 									</td>
    927. 

  927. 									<td class="description last">
    928. 

  928. 										<p>The scalar value.</p>
    929. 

  929. 									</td>
    930. 

  930. 								</tr>
    931. 

  931. 							</tbody>
    932. 

  932. 						</table>
    933. 

  933. 						<dl class="details">
    934. 

  934. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    935. 

  935. 						</dl>
    936. 

  936. 					</div>
    937. 

  937. 					<h3 class="name name-method" id="setStyle" translate="no">.<a href="#setStyle">setStyle</a><span class="signature">( style : <span class="param-type">string</span>, colorSpace : <span class="param-type">string</span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    938. 

  938. 					<div class="method">
    939. 

  939. 						<div class="description">
    940. 

  940. 							<p>Sets this color from a CSS-style string. For example, <code>rgb(250, 0,0)</code>,
    941. 

  941. <code>rgb(100%, 0%, 0%)</code>, <code>hsl(0, 100%, 50%)</code>, <code>#ff0000</code>, <code>#f00</code>, or <code>red</code> ( or
    942. 

  942. any <a href="https://en.wikipedia.org/wiki/X11_color_names#Color_name_chart" target="_blank" rel="noopener">X11 color name</a> -
    943. 

  943. all 140 color names are supported).</p>
    944. 

  944. 						</div>
    945. 

  945. 						<table class="params">
    946. 

  946. 							<tbody>
    947. 

  947. 								<tr>
    948. 

  948. 									<td class="name">
    949. 

  949. 										<strong translate="no">style</strong>
    950. 

  950. 									</td>
    951. 

  951. 									<td class="description last">
    952. 

  952. 										<p>Color as a CSS-style string.</p>
    953. 

  953. 									</td>
    954. 

  954. 								</tr>
    955. 

  955. 								<tr>
    956. 

  956. 									<td class="name">
    957. 

  957. 										<strong translate="no">colorSpace</strong>
    958. 

  958. 									</td>
    959. 

  959. 									<td class="description last">
    960. 

  960. 										<p>The color space.</p>
    961. 

  961. 										<p>Default is <code>SRGBColorSpace</code>.</p>
    962. 

  962. 									</td>
    963. 

  963. 								</tr>
    964. 

  964. 							</tbody>
    965. 

  965. 						</table>
    966. 

  966. 						<dl class="details">
    967. 

  967. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    968. 

  968. 						</dl>
    969. 

  969. 					</div>
    970. 

  970. 					<h3 class="name name-method" id="sub" translate="no">.<a href="#sub">sub</a><span class="signature">( color : <span class="param-type"><a href="Color.html">Color</a></span> )</span><span class="type-signature"> : <a href="Color.html">Color</a></span> </h3>
    971. 

  971. 					<div class="method">
    972. 

  972. 						<div class="description">
    973. 

  973. 							<p>Subtracts the RGB values of the given color from the RGB values of this color.</p>
    974. 

  974. 						</div>
    975. 

  975. 						<table class="params">
    976. 

  976. 							<tbody>
    977. 

  977. 								<tr>
    978. 

  978. 									<td class="name">
    979. 

  979. 										<strong translate="no">color</strong>
    980. 

  980. 									</td>
    981. 

  981. 									<td class="description last">
    982. 

  982. 										<p>The color to subtract.</p>
    983. 

  983. 									</td>
    984. 

  984. 								</tr>
    985. 

  985. 							</tbody>
    986. 

  986. 						</table>
    987. 

  987. 						<dl class="details">
    988. 

  988. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this color.</dt>
    989. 

  989. 						</dl>
    990. 

  990. 					</div>
    991. 

  991. 					<h3 class="name name-method" id="toArray" translate="no">.<a href="#toArray">toArray</a><span class="signature">( array : <span class="param-type">Array.&lt;number></span>, offset : <span class="param-type">number</span> )</span><span class="type-signature"> : Array.&lt;number></span> </h3>
    992. 

  992. 					<div class="method">
    993. 

  993. 						<div class="description">
    994. 

  994. 							<p>Writes the RGB components of this color to the given array. If no array is provided,
    995. 

  995. the method returns a new instance.</p>
    996. 

  996. 						</div>
    997. 

  997. 						<table class="params">
    998. 

  998. 							<tbody>
    999. 

  999. 								<tr>
    1000. 

  1000. 									<td class="name">
    1001. 

  1001. 										<strong translate="no">array</strong>
    1002. 

  1002. 									</td>
    1003. 

  1003. 									<td class="description last">
    1004. 

  1004. 										<p>The target array holding the color components.</p>
    1005. 

  1005. 										<p>Default is <code>[]</code>.</p>
    1006. 

  1006. 									</td>
    1007. 

  1007. 								</tr>
    1008. 

  1008. 								<tr>
    1009. 

  1009. 									<td class="name">
    1010. 

  1010. 										<strong translate="no">offset</strong>
    1011. 

  1011. 									</td>
    1012. 

  1012. 									<td class="description last">
    1013. 

  1013. 										<p>Index of the first element in the array.</p>
    1014. 

  1014. 										<p>Default is <code>0</code>.</p>
    1015. 

  1015. 									</td>
    1016. 

  1016. 								</tr>
    1017. 

  1017. 							</tbody>
    1018. 

  1018. 						</table>
    1019. 

  1019. 						<dl class="details">
    1020. 

  1020. 							<dt class="tag-returns"><strong>Returns:</strong> The color components.</dt>
    1021. 

  1021. 						</dl>
    1022. 

  1022. 					</div>
    1023. 

  1023. 					<h3 class="name name-method" id="toJSON" translate="no">.<a href="#toJSON">toJSON</a><span class="signature">()</span><span class="type-signature"> : number</span> </h3>
    1024. 

  1024. 					<div class="method">
    1025. 

  1025. 						<div class="description">
    1026. 

  1026. 							<p>This methods defines the serialization result of this class. Returns the color
    1027. 

  1027. as a hexadecimal value.</p>
    1028. 

  1028. 						</div>
    1029. 

  1029. 						<dl class="details">
    1030. 

  1030. 							<dt class="tag-returns"><strong>Returns:</strong> The hexadecimal value.</dt>
    1031. 

  1031. 						</dl>
    1032. 

  1032. 					</div>
    1033. 

  1033. 				<h2 class="subsection-title">Source</h2>
    1034. 

  1034. 				<p>
    1035. 

  1035. 					<a href="https://github.com/mrdoob/three.js/blob/master/src/math/Color.js" translate="no" target="_blank" rel="noopener">src/math/Color.js</a>
    1036. 

  1036. 				</p>
    1037. 

  1037. 			</article>
    1038. 

  1038. 		</section>
    1039. 

  1039. <script src="../scripts/linenumber.js"></script>
    1040. 

  1040. <script src="../scripts/page.js"></script>
    1041. 

  1041. </body>
    1042. 

  1042. </html>
    1043.
粤ICP备19079148号