wgsl-renderer 0.1.7 → 0.1.9

package/dist/cjs/index.js

@@ -341,6 +341,12 @@ var TextureManager = class {
 		});
 		this.textures.clear();
 	}
+	/**
+	* Store a texture in the manager
+	*/
+	setTexture(name, texture) {
+		this.textures.set(name, texture);
+	}
 	destroy() {
 		this.textures.forEach((texture) => texture.destroy());
 		this.textures.clear();
@@ -359,8 +365,10 @@ const PASS_TEXTURE_REF_SYMBOL = Symbol("PassTextureRef");
 var PassTextureRef = class PassTextureRef {
 	[PASS_TEXTURE_REF_SYMBOL] = true;
 	passName;
-	constructor(passName) {
+	options;
+	constructor(passName, options) {
 		this.passName = passName;
+		this.options = options;
 	}
 	static is(obj) {
 		return obj && typeof obj === "object" && PASS_TEXTURE_REF_SYMBOL in obj;
@@ -369,8 +377,8 @@ var PassTextureRef = class PassTextureRef {
 		if (this.is(resource)) return resource;
 		return null;
 	}
-	static create(passName) {
-		return new PassTextureRef(passName);
+	static create(passName, options) {
+		return new PassTextureRef(passName, options);
 	}
 };
 function isPassTextureRef(obj) {
@@ -432,10 +440,13 @@ var WGSLRenderer = class {
 	/**
 	* Get texture reference by pass name
 	* Returns a PassTextureRef that will resolve to the actual texture at render time
+	*
+	* @param passName Name of the pass to reference
+	* @param options Optional texture creation options for when the texture needs to be created
 	*/
-	getPassTexture(passName) {
+	getPassTexture(passName, options) {
 		if (!this.passes.find((pass) => pass.name === passName)) throw new Error(`Cannot find pass named '${passName}'. Available passes: [${this.passes.map((p) => p.name).join(", ")}]`);
-		return PassTextureRef.create(passName);
+		return PassTextureRef.create(passName, options);
 	}
 	/**
 	* Resolve a PassTextureRef to actual GPUTextureView with validation
@@ -446,8 +457,22 @@ var WGSLRenderer = class {
 		if (targetPass.view) return targetPass.view;
 		const textureName = `pass_${this.passes.indexOf(targetPass)}_output`;
 		let texture = this.textureManager.getTexture(textureName);
-		if (!texture) texture = this.textureManager.createTexture(textureName, this.format);
-		return texture.createView();
+		if (!texture) {
+			const format = ref.options?.format || this.format;
+			const usage = ref.options?.usage || GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT;
+			const size = this.textureManager.getPixelSize();
+			texture = this.device.createTexture({
+				size: [size.width, size.height],
+				format,
+				usage,
+				sampleCount: ref.options?.sampleCount || 1
+			});
+			this.textureManager.setTexture(textureName, texture);
+		}
+		return texture.createView({
+			baseMipLevel: 0,
+			mipLevelCount: ref.options?.mipmaps ? texture.mipLevelCount : 1
+		});
 	}
 	/**
 	* Get pass by name
@@ -629,7 +654,7 @@ var WGSLRenderer = class {
 			addressModeV: "clamp-to-edge"
 		}, options));
 	}
-	async loadImageTexture(image, format) {
+	async loadImageTexture(image, format, options) {
 		if (typeof image === "string") if (image.startsWith("data:")) {
 			const base64Data = image.split(",")[1];
 			const binaryString = atob(base64Data);
@@ -644,7 +669,7 @@ var WGSLRenderer = class {
 			});
 			image = await (await resp).blob();
 		}
-		const future = createImageBitmap(image);
+		const future = createImageBitmap(image, options);
 		future.catch((err) => {
 			console.error("Failed to load texture:", err);
 		});

package/dist/esm/index.d.ts

@@ -3,10 +3,26 @@ declare const PASS_TEXTURE_REF_SYMBOL: unique symbol;
 declare class PassTextureRef {
   readonly [PASS_TEXTURE_REF_SYMBOL] = true;
   readonly passName: string;
-  constructor(passName: string);
+  readonly options?: {
+    format?: GPUTextureFormat;
+    mipmaps?: boolean;
+    sampleCount?: number;
+    usage?: GPUTextureUsageFlags;
+  };
+  constructor(passName: string, options?: {
+    format?: GPUTextureFormat;
+    mipmaps?: boolean;
+    sampleCount?: number;
+    usage?: GPUTextureUsageFlags;
+  });
   static is(obj: any): obj is PassTextureRef;
   static fromGPUBindingResource(resource: GPUBindingResource): PassTextureRef | null;
-  static create(passName: string): PassTextureRef;
+  static create(passName: string, options?: {
+    format?: GPUTextureFormat;
+    mipmaps?: boolean;
+    sampleCount?: number;
+    usage?: GPUTextureUsageFlags;
+  }): PassTextureRef;
 }
 //#endregion
 //#region src/RenderPass.d.ts
@@ -140,8 +156,16 @@ declare class WGSLRenderer {
   /**
    * Get texture reference by pass name
    * Returns a PassTextureRef that will resolve to the actual texture at render time
+   *
+   * @param passName Name of the pass to reference
+   * @param options Optional texture creation options for when the texture needs to be created
    */
-  getPassTexture(passName: string): PassTextureRef;
+  getPassTexture(passName: string, options?: {
+    format?: GPUTextureFormat;
+    mipmaps?: boolean;
+    sampleCount?: number;
+    usage?: GPUTextureUsageFlags;
+  }): PassTextureRef;
   /**
    * Resolve a PassTextureRef to actual GPUTextureView with validation
    */
@@ -217,7 +241,7 @@ declare class WGSLRenderer {
    * Create a sampler
    */
   createSampler(options?: GPUSamplerDescriptor): GPUSampler;
-  loadImageTexture(image: Blob | string, format?: GPUTextureFormat): Promise<{
+  loadImageTexture(image: Blob | string, format?: GPUTextureFormat, options?: ImageBitmapOptions): Promise<{
     texture: GPUTexture;
     bitMap: ImageBitmap;
     width: number;

package/dist/esm/index.js

@@ -340,6 +340,12 @@ var TextureManager = class {
 		});
 		this.textures.clear();
 	}
+	/**
+	* Store a texture in the manager
+	*/
+	setTexture(name, texture) {
+		this.textures.set(name, texture);
+	}
 	destroy() {
 		this.textures.forEach((texture) => texture.destroy());
 		this.textures.clear();
@@ -358,8 +364,10 @@ const PASS_TEXTURE_REF_SYMBOL = Symbol("PassTextureRef");
 var PassTextureRef = class PassTextureRef {
 	[PASS_TEXTURE_REF_SYMBOL] = true;
 	passName;
-	constructor(passName) {
+	options;
+	constructor(passName, options) {
 		this.passName = passName;
+		this.options = options;
 	}
 	static is(obj) {
 		return obj && typeof obj === "object" && PASS_TEXTURE_REF_SYMBOL in obj;
@@ -368,8 +376,8 @@ var PassTextureRef = class PassTextureRef {
 		if (this.is(resource)) return resource;
 		return null;
 	}
-	static create(passName) {
-		return new PassTextureRef(passName);
+	static create(passName, options) {
+		return new PassTextureRef(passName, options);
 	}
 };
 function isPassTextureRef(obj) {
@@ -431,10 +439,13 @@ var WGSLRenderer = class {
 	/**
 	* Get texture reference by pass name
 	* Returns a PassTextureRef that will resolve to the actual texture at render time
+	*
+	* @param passName Name of the pass to reference
+	* @param options Optional texture creation options for when the texture needs to be created
 	*/
-	getPassTexture(passName) {
+	getPassTexture(passName, options) {
 		if (!this.passes.find((pass) => pass.name === passName)) throw new Error(`Cannot find pass named '${passName}'. Available passes: [${this.passes.map((p) => p.name).join(", ")}]`);
-		return PassTextureRef.create(passName);
+		return PassTextureRef.create(passName, options);
 	}
 	/**
 	* Resolve a PassTextureRef to actual GPUTextureView with validation
@@ -445,8 +456,22 @@ var WGSLRenderer = class {
 		if (targetPass.view) return targetPass.view;
 		const textureName = `pass_${this.passes.indexOf(targetPass)}_output`;
 		let texture = this.textureManager.getTexture(textureName);
-		if (!texture) texture = this.textureManager.createTexture(textureName, this.format);
-		return texture.createView();
+		if (!texture) {
+			const format = ref.options?.format || this.format;
+			const usage = ref.options?.usage || GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT;
+			const size = this.textureManager.getPixelSize();
+			texture = this.device.createTexture({
+				size: [size.width, size.height],
+				format,
+				usage,
+				sampleCount: ref.options?.sampleCount || 1
+			});
+			this.textureManager.setTexture(textureName, texture);
+		}
+		return texture.createView({
+			baseMipLevel: 0,
+			mipLevelCount: ref.options?.mipmaps ? texture.mipLevelCount : 1
+		});
 	}
 	/**
 	* Get pass by name
@@ -628,7 +653,7 @@ var WGSLRenderer = class {
 			addressModeV: "clamp-to-edge"
 		}, options));
 	}
-	async loadImageTexture(image, format) {
+	async loadImageTexture(image, format, options) {
 		if (typeof image === "string") if (image.startsWith("data:")) {
 			const base64Data = image.split(",")[1];
 			const binaryString = atob(base64Data);
@@ -643,7 +668,7 @@ var WGSLRenderer = class {
 			});
 			image = await (await resp).blob();
 		}
-		const future = createImageBitmap(image);
+		const future = createImageBitmap(image, options);
 		future.catch((err) => {
 			console.error("Failed to load texture:", err);
 		});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wgsl-renderer",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A multi-pass renderer based on WebGPU and WGSL.",
   "type": "module",
   "main": "./dist/cjs/index.js",