options objects for roundCorners and fisheye

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MLHc7GW46D6BmwtEM2khgr

Author: matmen

src/image.ts

@@ -88,6 +88,18 @@ export interface EncodeOptions {
     metadata?: Metadata;
 }
 
+/** Options of {@link Image.roundCorners} */
+export interface RoundCornersOptions {
+    /** The radius of the corners. Default: a quarter of the smaller side */
+    radius?: number;
+}
+
+/** Options of {@link Image.fisheye} */
+export interface FisheyeOptions {
+    /** The distortion strength (exponent of the radial mapping), higher values bulge the center more. Default: `2` */
+    strength?: number;
+}
+
 /** Options of {@link Image.renderSVG} */
 export interface SVGOptions {
     /** The scale, or the width or height in pixels, see `mode`. Default: `1` */
@@ -1648,11 +1660,18 @@ export class Image {
         };
     }
 
+    /**
+     * Rounds the images corners, with antialiased edges
+     * @param options See {@link RoundCornersOptions}
+     */
+    roundCorners(options?: RoundCornersOptions): this;
     /**
      * Rounds the images corners, with antialiased edges
      * @param [radius=min(width,height)/4] The radius of the corners
      */
-    roundCorners(radius: number = Math.min(this.width, this.height) / 4): this {
+    roundCorners(radius?: number): this;
+    roundCorners(radiusOrOptions?: number | RoundCornersOptions): this {
+        let radius = (isOptions(radiusOrOptions) ? radiusOrOptions.radius : radiusOrOptions) ?? Math.min(this.width, this.height) / 4;
         radius = Math.max(0, Math.min(radius, this.width / 2, this.height / 2));
         const size = Math.ceil(radius);
 
@@ -1694,11 +1713,18 @@ export class Image {
         };
     }
 
+    /**
+     * Applies a fisheye (barrel distortion) effect
+     * @param options See {@link FisheyeOptions}
+     */
+    fisheye(options?: FisheyeOptions): this;
     /**
      * Applies a fisheye (barrel distortion) effect
      * @param [strength=2] The distortion strength (exponent of the radial mapping), higher values bulge the center more
      */
-    fisheye(strength = 2): this {
+    fisheye(strength?: number): this;
+    fisheye(strengthOrOptions?: number | FisheyeOptions): this {
+        const strength = (isOptions(strengthOrOptions) ? strengthOrOptions.strength : strengthOrOptions) ?? 2;
         const r = new Image(this.width, this.height);
 
         const w = this.width;

src/index.ts

@@ -8,7 +8,7 @@ import { view } from './util/mem.ts';
 import { ImageType } from './image-type.ts';
 
 export { Image } from './image.ts';
-export type { Color, ColorFunction, ResizeMode, SVGScaleMode, PNGMetadata, TextStyle, DecodeOptions, CompositeOptions, BlendMode, CropCircleOptions, DominantColorOptions, RotateOptions, ColorToAlphaOptions, ResizeOptions, AdjustOptions, SharpenOptions, PNGEncodeOptions, JPEGEncodeOptions, EncodeOptions, SVGOptions, TextOptions } from './image.ts';
+export type { Color, ColorFunction, ResizeMode, SVGScaleMode, PNGMetadata, TextStyle, DecodeOptions, CompositeOptions, BlendMode, CropCircleOptions, DominantColorOptions, RotateOptions, ColorToAlphaOptions, ResizeOptions, AdjustOptions, SharpenOptions, PNGEncodeOptions, JPEGEncodeOptions, EncodeOptions, SVGOptions, TextOptions, RoundCornersOptions, FisheyeOptions } from './image.ts';
 export { Frame } from './frame.ts';
 export type { FrameDisposalModeName, FrameDisposalModeId, FrameOptions } from './frame.ts';
 export { GIF } from './gif.ts';

tests/options.js

@@ -31,6 +31,10 @@ const same = (name, a, b) => {
     same('composite', tile().composite(logo, 5, 7, {opacity: 0.5, mode: 'multiply'}), tile().composite(logo, {x: 5, y: 7, opacity: 0.5, mode: 'multiply'}));
     same('composite default', tile().composite(logo), tile().composite(logo, {}));
     same('sharpen', tile().sharpen(2, 3), tile().sharpen({amount: 2, radius: 3}));
+    same('roundCorners', tile().roundCorners(9), tile().roundCorners({radius: 9}));
+    same('roundCorners default', tile().roundCorners(), tile().roundCorners({}));
+    same('fisheye', tile().fisheye(3), tile().fisheye({strength: 3}));
+    same('fisheye default', tile().fisheye(), tile().fisheye({}));
 
     // encoders: decoded, since the metadata has a creation time
     const pixelsOf = async data => (await Image.decode(data)).bitmap;