Selaa lähdekoodia

Docs: Add KTX2Exporter page (#31441)

Michael Blix 7 kuukautta sitten
vanhempi
sitoutus
35ad995297
2 muutettua tiedostoa jossa 87 lisäystä ja 0 poistoa
  1. 86 0
      docs/examples/en/exporters/KTX2Exporter.html
  2. 1 0
      docs/list.json

+ 86 - 0
docs/examples/en/exporters/KTX2Exporter.html

@@ -0,0 +1,86 @@
+<!DOCTYPE html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<base href="../../../" />
+		<script src="page.js"></script>
+		<link type="text/css" rel="stylesheet" href="page.css" />
+	</head>
+	<body>
+		<h1>[name]</h1>
+
+		<p class="desc">
+			An exporter for `KTX2`.
+			<br /><br />
+			[link:https://www.khronos.org/ktx/ KTX2] is an
+			[link:https://github.khronos.org/KTX-Specification/ktxspec.v2.html open
+			format specification] container format that provides efficient storage and
+			transmission of texture data with support for GPU-optimized formats.
+		</p>
+
+		<h2>Import</h2>
+
+		<p>
+			[name] is an add-on, and must be imported explicitly. See
+			[link:#manual/introduction/Installation Installation / Addons].
+		</p>
+
+		<code>
+			import { KTX2Exporter } from 'three/addons/exporters/KTX2Exporter.js';
+		</code>
+
+		<h2>Code Example</h2>
+
+		<code>
+			// Instantiate an exporter
+			const exporter = new KTX2Exporter();
+			
+			// Export a data texture
+			const result = await exporter.parse( dataTexture );
+			
+			// Export a render target
+			const result = await exporter.parse( renderer, renderTarget );
+		</code>
+
+		<h2>Examples</h2>
+
+		<p>[example:misc_exporter_ktx2]</p>
+
+		<h2>Constructor</h2>
+
+		<h3>[name]()</h3>
+		<p>Creates a new [name].</p>
+
+		<h2>Methods</h2>
+
+		<h3>[method:Promise parse]( [param:DataTexture texture] )</h3>
+
+		<p>[page:Object texture] — DataTexture or Data3DTexture to export.<br /></p>
+		<p>
+			Generates a KTX2 file from the input texture. Returns a promise that
+			resolves with the result.
+		</p>
+
+		<h3>
+			[method:Promise parse]( [param:WebGLRenderer renderer],
+			[param:WebGLRenderTarget renderTarget] )
+		</h3>
+
+		<p>
+			[page:Object renderer] — Renderer to use to read pixel data from the render target. Should be a
+			[page:WebGLRenderer] or [page:WebGPURenderer].<br />
+
+			[page:Object renderTarget] — The render target to export. Should be a [page:RenderTarget].<br />
+		</p>
+		<p>
+			Generates a KTX2 file from the render target. Returns a promise that
+			resolves with the result.
+		</p>
+
+		<h2>Source</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/exporters/KTX2Exporter.js examples/jsm/exporters/KTX2Exporter.js]
+		</p>
+	</body>
+</html>

+ 1 - 0
docs/list.json

@@ -375,6 +375,7 @@
 				"DRACOExporter": "examples/en/exporters/DRACOExporter",
 				"EXRExporter": "examples/en/exporters/EXRExporter",
 				"GLTFExporter": "examples/en/exporters/GLTFExporter",
+				"KTX2Exporter": "examples/en/exporters/KTX2Exporter",
 				"OBJExporter": "examples/en/exporters/OBJExporter",
 				"PLYExporter": "examples/en/exporters/PLYExporter",
 				"STLExporter": "examples/en/exporters/STLExporter",

粤ICP备19079148号