runmat 0.4.5-dev.3 → 0.4.5-dev.5

package/dist/generated/builtins/imread.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinDoc } from "../../builtins.js";
+declare const builtinDoc: BuiltinDoc;
+export default builtinDoc;
+//# sourceMappingURL=imread.d.ts.map

package/dist/generated/builtins/imread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imread.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/imread.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UA8HjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/imread.js

@@ -0,0 +1,131 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "imread",
+    "category": "image/io",
+    "keywords": [
+        "imread",
+        "image",
+        "read image",
+        "png",
+        "jpeg",
+        "jpg",
+        "tiff",
+        "bmp",
+        "gif",
+        "webp",
+        "upload"
+    ],
+    "summary": "Read image data from an uploaded file into MATLAB-compatible arrays.",
+    "references": [
+        "https://www.mathworks.com/help/matlab/ref/imread.html"
+    ],
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`imread` performs host-side file or network I/O and CPU decoding. Results are host tensors; wrap with `gpuArray` if device residency is needed after import."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::image::imread::tests",
+        "integration": "builtins::image::imread::tests::imread_fetches_http_url"
+    },
+    "description": "`imread(filename)` reads raster image data into dense column-major tensors using MATLAB-compatible shape conventions. Grayscale images return an MxN array, RGB images return an MxNx3 truecolor array, and alpha channels are available through the third output. Due to CORS and browser security restrictions, `file://` and `http://`/`https://` URLs are not currently supported — upload your image first and pass the resulting filename to `imread`.",
+    "behaviors": [
+        "Accepts a character vector or string scalar for the image source.",
+        "Due to CORS and browser security restrictions, `file://` URLs and `http://`/`https://` URLs are not currently supported. Upload your image first and pass the resulting filename to `imread`.",
+        "Accepts an optional explicit format hint: `imread(filename, format)`. Common hints include `png`, `jpg`, `jpeg`, `tif`, `tiff`, `bmp`, `gif`, and `webp`.",
+        "Without a format hint, RunMat detects the image format from the byte stream.",
+        "Grayscale images return MxN tensors. RGB and RGBA images return MxNx3 truecolor tensors using red, green, and blue planes along the third dimension.",
+        "8-bit images return `uint8` tensors and 16-bit images return `uint16` tensors. Floating-point images return `single` tensors when the decoder exposes floating-point pixel data.",
+        "For `[X, map] = imread(...)`, RunMat returns `X` and an empty colormap for direct-color formats.",
+        "For `[X, map, alpha] = imread(...)`, RunMat returns alpha as an MxN tensor when the source image has an alpha channel; otherwise alpha is empty.",
+        "Animated image frame selection and indexed colormap extraction are not implemented yet; current decoding returns the first decoded image frame as direct pixel data."
+    ],
+    "examples": [
+        {
+            "description": "Read A Local PNG",
+            "input": "img = imread(\"logo.png\");\nsize(img)",
+            "output": "ans =\n    rows    cols     3"
+        },
+        {
+            "description": "Get Alpha Separately",
+            "input": "[rgb, map, alpha] = imread(\"icon.png\");\nsize(alpha)",
+            "output": "ans =\n    rows    cols"
+        },
+        {
+            "description": "Use An Explicit Format Hint",
+            "input": "img = imread(\"raw-download\", \"jpg\");",
+            "output": "% Decodes the bytes as JPEG even when the file name has no extension."
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What shape does `imread` return for RGB images?",
+            "answer": "RGB images return an MxNx3 tensor where the third dimension stores red, green, and blue planes. Data is stored in RunMat's column-major tensor layout while preserving MATLAB indexing semantics."
+        },
+        {
+            "question": "Where is the alpha channel returned?",
+            "answer": "Use the three-output form: `[X, map, alpha] = imread(filename)`. Direct-color images return an empty colormap in `map`; alpha is an MxN tensor when present."
+        },
+        {
+            "question": "Can `imread` load `file://` or HTTP URLs?",
+            "answer": "Not currently. Due to CORS and browser security restrictions, `file://` and `http://`/`https://` URLs are blocked. Upload your image first and pass the resulting filename to `imread`."
+        },
+        {
+            "question": "Does `imread` return GPU arrays?",
+            "answer": "No. Image reading performs host I/O and CPU decoding, so outputs are host tensors. Call `gpuArray(imread(...))` if subsequent processing should run on the GPU."
+        },
+        {
+            "question": "Are animated GIF frames supported?",
+            "answer": "Not yet. The current decoder returns the first decoded image frame as direct pixel data."
+        }
+    ],
+    "links": [
+        {
+            "label": "image",
+            "url": "./image"
+        },
+        {
+            "label": "imagesc",
+            "url": "./imagesc"
+        },
+        {
+            "label": "class",
+            "url": "./class"
+        },
+        {
+            "label": "size",
+            "url": "./size"
+        },
+        {
+            "label": "gpuArray",
+            "url": "./gpuarray"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/image/imread.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/image/imread.rs"
+    },
+    "gpu_residency": "`imread` always returns host-resident tensors because file and network I/O plus image decoding occur on the CPU. Use `gpuArray` after reading if later operations should use device residency.",
+    "gpu_behavior": [
+        "`imread` does not dispatch provider kernels and is not fusion eligible. GPU-resident scalar string inputs are gathered before decoding, and decoded pixel tensors remain on the host."
+    ],
+    "key": "imread",
+    "slug": "imread",
+    "aliases": [],
+    "categoryPath": [
+        "image",
+        "io"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=imread.js.map

package/dist/generated/builtins/imread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imread.js","sourceRoot":"","sources":["../../../src/generated/builtins/imread.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,OAAO;QACP,YAAY;QACZ,KAAK;QACL,MAAM;QACN,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,MAAM;QACN,QAAQ;KACT;IACD,SAAS,EAAE,sEAAsE;IACjF,YAAY,EAAE;QACZ,uDAAuD;KACxD;IACD,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,8JAA8J;KACxK;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,gCAAgC;QACxC,aAAa,EAAE,yDAAyD;KACzE;IACD,aAAa,EAAE,8bAA8b;IAC7c,WAAW,EAAE;QACX,mEAAmE;QACnE,+LAA+L;QAC/L,2JAA2J;QAC3J,8EAA8E;QAC9E,sJAAsJ;QACtJ,kLAAkL;QAClL,kGAAkG;QAClG,kJAAkJ;QAClJ,sKAAsK;KACvK;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kBAAkB;YACjC,OAAO,EAAE,wCAAwC;YACjD,QAAQ,EAAE,+BAA+B;SAC1C;QACD;YACE,aAAa,EAAE,sBAAsB;YACrC,OAAO,EAAE,wDAAwD;YACjE,QAAQ,EAAE,yBAAyB;SACpC;QACD;YACE,aAAa,EAAE,6BAA6B;YAC5C,OAAO,EAAE,0CAA0C;YACnD,QAAQ,EAAE,uEAAuE;SAClF;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,mMAAmM;SAC9M;QACD;YACE,UAAU,EAAE,sCAAsC;YAClD,QAAQ,EAAE,8JAA8J;SACzK;QACD;YACE,UAAU,EAAE,2CAA2C;YACvD,QAAQ,EAAE,yLAAyL;SACpM;QACD;YACE,UAAU,EAAE,kCAAkC;YAC9C,QAAQ,EAAE,iKAAiK;SAC5K;QACD;YACE,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,0FAA0F;SACrG;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,mGAAmG;KAC3G;IACD,eAAe,EAAE,gMAAgM;IACjN,cAAc,EAAE;QACd,uLAAuL;KACxL;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,OAAO;QACP,IAAI;KACL;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/imshow.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltinDoc } from "../../builtins.js";
+declare const builtinDoc: BuiltinDoc;
+export default builtinDoc;
+//# sourceMappingURL=imshow.d.ts.map

package/dist/generated/builtins/imshow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imshow.d.ts","sourceRoot":"","sources":["../../../src/generated/builtins/imshow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,UAmGjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins/imshow.js

@@ -0,0 +1,104 @@
+// @generated by scripts/generate-builtins.cjs
+// Do not edit by hand.
+const builtinDoc = {
+    "title": "imshow",
+    "category": "plotting",
+    "keywords": [
+        "imshow",
+        "image display",
+        "grayscale image",
+        "binary image",
+        "rgb image",
+        "matlab imshow"
+    ],
+    "summary": "Display grayscale, binary, truecolor, or file-backed images.",
+    "gpu_support": {
+        "elementwise": false,
+        "reduction": false,
+        "precisions": [],
+        "broadcasting": "none",
+        "notes": "`imshow` is a plotting sink and does not advertise precision-specialized GPU kernels. Grayscale gpuArray inputs may use the image/surface rendering path; filename decoding and truecolor normalization run on the host."
+    },
+    "fusion": {
+        "elementwise": false,
+        "reduction": false,
+        "max_inputs": 2,
+        "constants": "inline"
+    },
+    "requires_feature": null,
+    "tested": {
+        "unit": "builtins::plotting::imshow::tests"
+    },
+    "description": "`imshow` displays image data using MATLAB-familiar defaults. Numeric and logical 2-D arrays render as grayscale images, MxNx3 and MxNx4 arrays render as truecolor images, and filename inputs are decoded through RunMat's filesystem layer before display.",
+    "behaviors": [
+        "`imshow(I)` displays 2-D numeric data with grayscale limits `[0, 1]`, matching MATLAB double-image defaults.",
+        "`imshow(BW)` displays logical image data as black and white using `[0, 1]` limits.",
+        "`imshow(RGB)` displays MxNx3 truecolor data directly.",
+        "`imshow(RGBA)` displays MxNx4 truecolor data with alpha.",
+        "`imshow(I, [low high])` displays grayscale image data using an explicit display range.",
+        "`imshow(I, [])` auto-scales grayscale image data from finite minimum to finite maximum.",
+        "`imshow(filename)` reads and decodes an image file, then displays it as truecolor data."
+    ],
+    "examples": [
+        {
+            "description": "Display a simple grayscale image",
+            "input": "row = 100;\ncol = 100;\nrsm = ones(row, col);\nimshow(rsm);"
+        },
+        {
+            "description": "Auto-scale a matrix for display",
+            "input": "A = peaks(128);\nimshow(A, []);"
+        },
+        {
+            "description": "Display truecolor RGB data",
+            "input": "R = ones(64, 64);\nG = zeros(64, 64);\nB = zeros(64, 64);\nRGB = cat(3, R, G, B);\nimshow(RGB);"
+        },
+        {
+            "description": "Display an image file",
+            "input": "imshow(\"photo.png\");"
+        }
+    ],
+    "faqs": [
+        {
+            "question": "What display range does imshow use for doubles?",
+            "answer": "`imshow(I)` uses `[0, 1]` for floating-point grayscale data. Use `imshow(I, [])` when you want RunMat to scale the visible range from the data minimum to maximum."
+        },
+        {
+            "question": "Does imshow support uint8 and uint16 image defaults?",
+            "answer": "File-backed images decode with byte pixel semantics. User-created integer image arrays currently depend on RunMat's broader numeric-class metadata model, so exact MATLAB class-dependent defaults for dense uint8/uint16 tensors are tracked separately."
+        },
+        {
+            "question": "How is imshow different from imagesc?",
+            "answer": "`imshow` is for image display and uses grayscale or truecolor image defaults. `imagesc` is for scaled matrix visualization and maps data through the active colormap."
+        }
+    ],
+    "links": [
+        {
+            "label": "image",
+            "url": "./image"
+        },
+        {
+            "label": "imagesc",
+            "url": "./imagesc"
+        },
+        {
+            "label": "colormap",
+            "url": "./colormap"
+        },
+        {
+            "label": "axis",
+            "url": "./axis"
+        }
+    ],
+    "source": {
+        "label": "`crates/runmat-runtime/src/builtins/plotting/ops/imshow.rs`",
+        "url": "https://github.com/runmat-org/runmat/blob/main/crates/runmat-runtime/src/builtins/plotting/ops/imshow.rs"
+    },
+    "key": "imshow",
+    "slug": "imshow",
+    "aliases": [],
+    "categoryPath": [
+        "plotting"
+    ]
+};
+export default builtinDoc;
+//# sourceMappingURL=imshow.js.map

package/dist/generated/builtins/imshow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imshow.js","sourceRoot":"","sources":["../../../src/generated/builtins/imshow.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uBAAuB;AAIvB,MAAM,UAAU,GAAe;IAC7B,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE;QACV,QAAQ;QACR,eAAe;QACf,iBAAiB;QACjB,cAAc;QACd,WAAW;QACX,eAAe;KAChB;IACD,SAAS,EAAE,8DAA8D;IACzE,aAAa,EAAE;QACb,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,0NAA0N;KACpO;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,QAAQ;KACtB;IACD,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE;QACR,MAAM,EAAE,mCAAmC;KAC5C;IACD,aAAa,EAAE,8PAA8P;IAC7Q,WAAW,EAAE;QACX,8GAA8G;QAC9G,oFAAoF;QACpF,uDAAuD;QACvD,0DAA0D;QAC1D,wFAAwF;QACxF,yFAAyF;QACzF,yFAAyF;KAC1F;IACD,UAAU,EAAE;QACV;YACE,aAAa,EAAE,kCAAkC;YACjD,OAAO,EAAE,6DAA6D;SACvE;QACD;YACE,aAAa,EAAE,iCAAiC;YAChD,OAAO,EAAE,iCAAiC;SAC3C;QACD;YACE,aAAa,EAAE,4BAA4B;YAC3C,OAAO,EAAE,iGAAiG;SAC3G;QACD;YACE,aAAa,EAAE,uBAAuB;YACtC,OAAO,EAAE,wBAAwB;SAClC;KACF;IACD,MAAM,EAAE;QACN;YACE,UAAU,EAAE,iDAAiD;YAC7D,QAAQ,EAAE,oKAAoK;SAC/K;QACD;YACE,UAAU,EAAE,sDAAsD;YAClE,QAAQ,EAAE,2PAA2P;SACtQ;QACD;YACE,UAAU,EAAE,uCAAuC;YACnD,QAAQ,EAAE,uKAAuK;SAClL;KACF;IACD,OAAO,EAAE;QACP;YACE,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,SAAS;SACjB;QACD;YACE,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;SAChB;KACF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE,0GAA0G;KAClH;IACD,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,EAAE;IACb,cAAc,EAAE;QACd,UAAU;KACX;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/generated/builtins-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtins-manifest.d.ts","sourceRoot":"","sources":["../../src/generated/builtins-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,eAAO,MAAM,eAAe,EAAE,oBAAoB,EAq4OjD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAuX9D,CAAC;AAEF,eAAO,MAAM,4BAA4B,sEAC0C,CAAC"}
+{"version":3,"file":"builtins-manifest.d.ts","sourceRoot":"","sources":["../../src/generated/builtins-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,eAAO,MAAM,eAAe,EAAE,oBAAoB,EAm7OjD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAyX9D,CAAC;AAEF,eAAO,MAAM,4BAA4B,sEAC0C,CAAC"}

package/dist/generated/builtins-manifest.js

@@ -3117,6 +3117,52 @@ export const builtinManifest = [
         "summary": "Filter images or N-D arrays with correlation/convolution kernels and configurable padding.",
         "exampleCount": 5
     },
+    {
+        "key": "imread",
+        "title": "imread",
+        "slug": "imread",
+        "aliases": [],
+        "category": "image/io",
+        "categoryPath": [
+            "image",
+            "io"
+        ],
+        "keywords": [
+            "imread",
+            "image",
+            "read image",
+            "png",
+            "jpeg",
+            "jpg",
+            "tiff",
+            "bmp",
+            "gif",
+            "webp",
+            "upload"
+        ],
+        "summary": "Read image data from an uploaded file into MATLAB-compatible arrays.",
+        "exampleCount": 3
+    },
+    {
+        "key": "imshow",
+        "title": "imshow",
+        "slug": "imshow",
+        "aliases": [],
+        "category": "plotting",
+        "categoryPath": [
+            "plotting"
+        ],
+        "keywords": [
+            "imshow",
+            "image display",
+            "grayscale image",
+            "binary image",
+            "rgb image",
+            "matlab imshow"
+        ],
+        "summary": "Display grayscale, binary, truecolor, or file-backed images.",
+        "exampleCount": 4
+    },
     {
         "key": "ind2sub",
         "title": "ind2sub",
@@ -7713,6 +7759,8 @@ export const builtinDocLoaders = {
     "image": () => import("./builtins/image.js").then((mod) => mod.default),
     "imagesc": () => import("./builtins/imagesc.js").then((mod) => mod.default),
     "imfilter": () => import("./builtins/imfilter.js").then((mod) => mod.default),
+    "imread": () => import("./builtins/imread.js").then((mod) => mod.default),
+    "imshow": () => import("./builtins/imshow.js").then((mod) => mod.default),
     "ind2sub": () => import("./builtins/ind2sub.js").then((mod) => mod.default),
     "input": () => import("./builtins/input.js").then((mod) => mod.default),
     "interp1": () => import("./builtins/interp1.js").then((mod) => mod.default),