docs(OpenGLRenderWindow): add setSize description

Edited getComputedDevicePixelRatio

Author: PaulHax

Sources/Rendering/OpenGL/RenderWindow/index.d.ts

@@ -327,7 +327,18 @@ export interface vtkOpenGLRenderWindow extends vtkOpenGLRenderWindowBase {
 	setViewStream(stream: vtkViewStream): boolean;
 
 	/**
-	 *
+	 * Sets the pixel width and height of the rendered image.  
+	 * 
+	 * WebGL and WebGPU render windows apply these values to 
+	 * the width and height attribute of the canvas element.
+	 * 
+	 * To match the device resolution in browser environments, 
+	 * multiply the container size by `window.devicePixelRatio`
+	 * `apiSpecificRenderWindow.setSize(Math.floor(containerWidth * devicePixelRatio), Math.floor(containerHeight * devicePixelRatio));
+	 * See the VTK.js FullscreenRenderWindow class for an example.
+	 * 
+	 * @see getComputedDevicePixelRatio()
+	 * 
 	 * @param {Vector2} size 
 	 */
 	setSize(size: Vector2): void;
@@ -363,14 +374,15 @@ export interface vtkOpenGLRenderWindow extends vtkOpenGLRenderWindowBase {
 	getVrResolution(): Vector2;
 
 	/**
-	 * Use to scale the size of a rendered canvas pixel to a browser CSS pixel.  
-	 * `const cssPixelWidth = renderedPixelWidth / apiRenderWindow.getComputedDevicePixelRatio()`
+	 * Scales the size of a browser CSS pixel to a rendered canvas pixel.  
+	 * `const renderedPixelWidth = cssPixelWidth * apiRenderWindow.getComputedDevicePixelRatio()`
+	 * Use to scale rendered objects to a consistent perceived size or DOM pixel position.
+	 * 
 	 * Rather than using window.devicePixelRatio directly, the device pixel ratio is inferred
-	 * from the container CSS pixel size and rendered image pixel size. The user can reduce the rendered size.
-	 * `apiSpecificRenderWindow.setSize(Math.floor(container.width * window.devicePixelRatio / 2), Math.floor(container.height * window.devicePixelRatio / 2))`
+	 * from the container CSS pixel size and rendered image pixel size. The user directly sets the rendered pixel size.
 	 * 
+	 * @see setSize()
 	 * @see getContainerSize()
-	 * @see getSize()
 	 */
 	getComputedDevicePixelRatio(): number;
 }