Skip to content

Commit

Permalink
Docs: Clean up color space references. (#25922)
Browse files Browse the repository at this point in the history
* Docs: Update references to ColorSpace

* ColorSpace / string

* Revert unintended change
  • Loading branch information
donmccurdy authored Apr 25, 2023
1 parent 8808391 commit fbf16ee
Show file tree
Hide file tree
Showing 12 changed files with 23 additions and 32 deletions.
4 changes: 2 additions & 2 deletions docs/api/en/constants/Core.html
Original file line number Diff line number Diff line change
Expand Up @@ -27,15 +27,15 @@ <h2>Color Spaces</h2>
</code>
<p>[page:NoColorSpace] defines no specific color space.</p>
<p>
[page:SRGBColorSpace] (“sRGB”) refers to the color space defined by the
[page:SRGBColorSpace] (“srgb”) refers to the color space defined by the
Rec. 709 primaries, D65 white point, and nonlinear sRGB transfer
functions. sRGB is the default color space in CSS, and is often found in
color palettes and color pickers. Colors expressed in hexadecimal or CSS
notation are typically in the sRGB color space.
</p>

<p>
[page:LinearSRGBColorSpace] (“Linear-sRGB”) refers to the sRGB color space
[page:LinearSRGBColorSpace] (“srgb-linear”) refers to the sRGB color space
(above) with linear transfer functions. Linear-sRGB is the working color
space in three.js, used throughout most of the rendering process. RGB
components found in three.js materials and shaders are in the Linear-sRGB
Expand Down
2 changes: 1 addition & 1 deletion docs/api/en/renderers/WebGLRenderer.html
Original file line number Diff line number Diff line change
Expand Up @@ -199,7 +199,7 @@ <h3>[property:Object extensions]</h3>
<li>`WEBGL_compressed_texture_etc1`</li>
</ul>

<h3>[property:number outputColorSpace]</h3>
<h3>[property:string outputColorSpace]</h3>
<p>
Defines the output color space of the renderer. Default is [page:Textures THREE.SRGBColorSpace].
</p>
Expand Down
11 changes: 4 additions & 7 deletions docs/api/en/textures/Texture.html
Original file line number Diff line number Diff line change
Expand Up @@ -253,14 +253,11 @@ <h3>[property:number unpackAlignment]</h3>
[link:http://www.khronos.org/opengles/sdk/docs/man/xhtml/glPixelStorei.xml glPixelStorei] for more information.
</p>

<h3>[property:number colorSpace]</h3>
<h3>[property:string colorSpace]</h3>
<p>
[page:Textures THREE.NoColorSpace] is the default. See the [page:Textures texture constants]
page for details of other formats.<br /><br />

Note that if this value is changed on a texture after the material has
been used, it is necessary to trigger a Material.needsUpdate for this
value to be realized in the shader.
[page:Textures THREE.NoColorSpace] is the default. Textures containing color data should be
annotated with [page:Textures THREE.SRGBColorSpace] or
[page:Textures THREE.LinearSRGBColorSpace].
</p>

<h3>[property:Integer version]</h3>
Expand Down
4 changes: 2 additions & 2 deletions docs/api/fr/constants/Core.html
Original file line number Diff line number Diff line change
Expand Up @@ -29,14 +29,14 @@ <h2>Espaces colorimétriques</h2>
[page:NoColorSpace] ne définit aucun espace colorimétrique spécifique.
</p>
<p>
[page:SRGBColorSpace] (“sRGB”) fait référence à l'espace colorimétrique défini par la Rec. 709 primaires, D65
[page:SRGBColorSpace] (“srgb”) fait référence à l'espace colorimétrique défini par la Rec. 709 primaires, D65
point blanc et fonctions de transfert sRGB non linéaires. sRGB est l'espace colorimétrique par défaut dans
CSS, et se trouve souvent dans les palettes de couleurs et les sélecteurs de couleurs. Les couleurs exprimées en
notation hexadécimale ou en CSS sont généralement dans l'espace colorimétrique sRGB.
</p>

<p>
[page:LinearSRGBColorSpace] (“Linear-sRGB”) fait référence à l'espace colorimétrique sRGB (ci-dessus) avec
[page:LinearSRGBColorSpace] (“srgb-linear”) fait référence à l'espace colorimétrique sRGB (ci-dessus) avec
fonctions de transfert linéaires. Linear-sRGB est l'espace colorimétrique de travail dans three.js, utilisé
pendant la majeure partie du processus de rendu. Les composants RVB trouvés dans les matériaux three.js
et dans les shaders sont dans l'espace colorimétrique Linear-sRGB.
Expand Down
4 changes: 2 additions & 2 deletions docs/api/it/constants/Core.html
Original file line number Diff line number Diff line change
Expand Up @@ -29,14 +29,14 @@ <h2>Spazi Colore</h2>
[page:NoColorSpace] non definisce uno spazio colore specifico.
</p>
<p>
[page:SRGBColorSpace] (“sRGB”) si riferisce allo spazio colore definito dal Rec. 709
[page:SRGBColorSpace] (“srgb”) si riferisce allo spazio colore definito dal Rec. 709
primari, punto di bianco D65 e funzioni di trasferimento sRGB non lineare. sRGB è lo spazio
colore predefinito nei CSS, e si trova spesso nelle palette dei colori e nei selettori di colore.
I colori espressi in esadecimale o in notazione CSS sono tipicamente nello spazio colore sRGB.
</p>

<p>
[page:LinearSRGBColorSpace] (“Linear-sRGB”) si riferisce allo spazio colore sRGB (sopra) con
[page:LinearSRGBColorSpace] (“srgb-linear”) si riferisce allo spazio colore sRGB (sopra) con
funzioni di trasferimento lineare. Linear-sRGB è lo spazio colore di lavoro in three.js, utilizzato
durante la maggior parte del processo di rendering. I componenti RGB presenti nei materiali, negli
shader in three.js si trovano nello spazio colore Linear-sRGB.
Expand Down
2 changes: 1 addition & 1 deletion docs/api/it/renderers/WebGLRenderer.html
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,7 @@ <h3>[property:Object extensions]</h3>
</ul>
</p>

<h3>[property:number outputColorSpace]</h3>
<h3>[property:string outputColorSpace]</h3>
<p>Definisce la codifica di output del renderer. Il valore predefinito è [page:Textures THREE.SRGBColorSpace].</p>
<p>Se il target render è stato impostato utilizzando [page:WebGLRenderer.setRenderTarget .setRenderTarget],
verrà invece utilizzato renderTarget.texture.colorSpace.</p>
Expand Down
7 changes: 2 additions & 5 deletions docs/api/it/textures/Texture.html
Original file line number Diff line number Diff line change
Expand Up @@ -225,13 +225,10 @@ <h3>[property:number unpackAlignment]</h3>
Vedi [link:http://www.khronos.org/opengles/sdk/docs/man/xhtml/glPixelStorei.xml glPixelStorei] per maggiori informazioni.
</p>

<h3>[property:number colorSpace]</h3>
<h3>[property:string colorSpace]</h3>
<p>
[page:Textures THREE.NoColorSpace] è l'impostazione predefinita.
Vedi la pagina [page:Textures texture constants] per i dettagli su altri formati.<br /><br />

Si noti che questo valore viene modificato su una texture dopo che il materiale è stato utilizzato,
è necessario attivare un Material.needsUpdate affinché questo valore venga realizzato nello shader.
Vedi la pagina [page:Textures texture constants] per i dettagli su altri formati.
</p>

<h3>[property:Integer version]</h3>
Expand Down
4 changes: 2 additions & 2 deletions docs/api/ko/constants/Core.html
Original file line number Diff line number Diff line change
Expand Up @@ -26,14 +26,14 @@ <h2>Color Spaces</h2>
</code>

<p>
[page:SRGBColorSpace] (“sRGB”) refers to the color space defined by the Rec. 709 primaries, D65
[page:SRGBColorSpace] (“srgb”) refers to the color space defined by the Rec. 709 primaries, D65
white point, and nonlinear sRGB transfer functions. sRGB is the default color space in
CSS, and is often found in color palettes and color pickers. Colors expressed in
hexadecimal or CSS notation are typically in the sRGB color space.
</p>

<p>
[page:LinearSRGBColorSpace] (“Linear-sRGB”) refers to the sRGB color space (above) with
[page:LinearSRGBColorSpace] (“srgb-linear”) refers to the sRGB color space (above) with
linear transfer functions. Linear-sRGB is the working color space in three.js, used
throughout most of the rendering process. RGB components found in three.js materials
and shaders are in the Linear-sRGB color space.
Expand Down
4 changes: 2 additions & 2 deletions docs/api/pt-br/constants/Core.html
Original file line number Diff line number Diff line change
Expand Up @@ -29,14 +29,14 @@ <h2>Espaço de Cores</h2>
[page:NoColorSpace] não define nenhum espaço de cor específico.
</p>
<p>
[page:SRGBColorSpace] (“sRGB”) refere-se ao espaço de cores definido pelo Rec. 709 primárias, D65
[page:SRGBColorSpace] (“srgb”) refere-se ao espaço de cores definido pelo Rec. 709 primárias, D65
ponto branco e funções de transferência sRGB não lineares. sRGB é o espaço de cor padrão em
CSS, e é frequentemente encontrado em paletas e seletores de cores. Cores expressas em
notação hexadecimal ou CSS estão normalmente no espaço de cores sRGB.
</p>

<p>
[page:LinearSRGBColorSpace] (“Linear-sRGB”) refere-se ao espaço de cores sRGB (acima) com
[page:LinearSRGBColorSpace] (“srgb-linear”) refere-se ao espaço de cores sRGB (acima) com
funções de transferência lineares. Linear-sRGB é o espaço de cores de trabalho em three.js, usado
durante a maior parte do processo de renderização. Componentes RGB encontrados em materiais three.js
e os shaders estão no espaço de cores Linear-sRGB.
Expand Down
4 changes: 2 additions & 2 deletions docs/api/zh/constants/Core.html
Original file line number Diff line number Diff line change
Expand Up @@ -26,14 +26,14 @@ <h2>Color Spaces</h2>
</code>

<p>
[page:SRGBColorSpace] (“sRGB”) refers to the color space defined by the Rec. 709 primaries, D65
[page:SRGBColorSpace] (“srgb”) refers to the color space defined by the Rec. 709 primaries, D65
white point, and nonlinear sRGB transfer functions. sRGB is the default color space in
CSS, and is often found in color palettes and color pickers. Colors expressed in
hexadecimal or CSS notation are typically in the sRGB color space.
</p>

<p>
[page:LinearSRGBColorSpace] (“Linear-sRGB”) refers to the sRGB color space (above) with
[page:LinearSRGBColorSpace] (“srgb-linear”) refers to the sRGB color space (above) with
linear transfer functions. Linear-sRGB is the working color space in three.js, used
throughout most of the rendering process. RGB components found in three.js materials
and shaders are in the Linear-sRGB color space.
Expand Down
2 changes: 1 addition & 1 deletion docs/api/zh/renderers/WebGLRenderer.html
Original file line number Diff line number Diff line change
Expand Up @@ -151,7 +151,7 @@ <h3>[property:Object extensions]</h3>
</ul>
</p>

<h3>[property:number outputColorSpace]</h3>
<h3>[property:string outputColorSpace]</h3>
<p>定义渲染器的输出编码。默认为[page:Textures THREE.SRGBColorSpace]</p>
<p>如果渲染目标已经使用 [page:WebGLRenderer.setRenderTarget .setRenderTarget]、之后将直接使用renderTarget.texture.colorSpace</p>
<p>查看[page:Textures texture constants]页面以获取其他格式细节</p>
Expand Down
7 changes: 2 additions & 5 deletions docs/api/zh/textures/Texture.html
Original file line number Diff line number Diff line change
Expand Up @@ -209,13 +209,10 @@ <h3>[property:number unpackAlignment]</h3>
请参阅[link:http://www.khronos.org/opengles/sdk/docs/man/xhtml/glPixelStorei.xml glPixelStorei]来了解详细信息。
</p>

<h3>[property:number colorSpace]</h3>
<h3>[property:string colorSpace]</h3>
<p>
默认值为[page:Textures THREE.NoColorSpace]。
请参阅[page:Textures texture constants]来了解其他格式的详细信息。<br /><br />

请注意,如果在材质被使用之后,纹理贴图中这个值发生了改变,
需要触发Material.needsUpdate,来使得这个值在着色器中实现。
请参阅[page:Textures texture constants]来了解其他格式的详细信息。
</p>

<h3>[property:Integer version]</h3>
Expand Down

0 comments on commit fbf16ee

Please sign in to comment.