hgload — Load graphics object hierarchies from RunMat FIG files.
hgload(filename) loads top-level graphics objects from a RunMat FIG file. The two-output form returns previous property values for overridden top-level figure properties.
Syntax
h = hgload(filename)
[h, old_prop_values] = hgload(filename, property_structure)Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
args | Any | Variadic | — | MATLAB-compatible figure persistence arguments. |
Returns
| Name | Type | Description |
|---|---|---|
fig | NumericArray | Figure handle or array of figure handles. |
h | NumericArray | Top-level graphics handles loaded from the file. |
old_prop_values | Any | Cell array of previous top-level property values overridden by hgload. |
Returned values from hgload depend on how many outputs the caller requests.
Errors
| Identifier | When | Message |
|---|---|---|
RunMat:figurePersistence:InvalidArgument | Arguments are missing, malformed, or incompatible with the requested figure persistence operation. | figure persistence: invalid argument |
RunMat:figurePersistence:UnsupportedFormat | The requested save/load format is recognized but not supported by RunMat's active plotting exporter. | figure persistence: unsupported format |
RunMat:figurePersistence:IoFailure | The target file cannot be read, written, flushed, synced, or atomically replaced. | figure persistence: file I/O failed |
RunMat:figurePersistence:RenderFailed | The plotting renderer or scene exporter cannot serialize the requested figure. | figure persistence: export failed |
RunMat:figurePersistence:ImportFailed | The figure file is missing, corrupt, unsupported, or incompatible with RunMat's scene importer. | figure persistence: import failed |
RunMat:figurePersistence:Internal | Internal runtime control-flow or conversion fails. | figure persistence: internal operation failed |
How hgload works
hgload(filename)appends.figwhen the filename has no extension and returns a scalar handle or row vector of handles.[h, old] = hgload(filename, property_structure)applies recognized top-level figure property overrides after import.- Unrecognized override fields are ignored and omitted from
old, matching MATLAB's documented top-level override behavior. - Numeric and GPU-resident arguments are rejected without gathering; this file-loading surface has no integer computation contract.
Does RunMat run hgload on the GPU?
No numeric GPU kernel is launched.
Loaded figure content can render through the normal plotting renderer.
GPU memory and residency
hgload returns host graphics handles and optional host cell/struct metadata.
Example
Load and override figure name
plot(1:3);
hgsave(gcf, "named.fig");
[h, old] = hgload("named.fig", struct("Name", "Loaded"));Using hgload with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how hgload changes the result.
Run a small hgload example, explain the result, then change one input and compare the output.
Related Plotting functions
2D Charts
area · bar · errorbar · heatmap · hist · histogram · loglog · pie · plot · scatter · semilogx · semilogy · stairs · stem
Other
addpoints · ancestor · animatedline · axes · barh · caxis · cla · clf · clim · colorcube · colororder · copyobj · daspect · datacursormode · dataTipTextRow · fcontour · figure · fill · fill3 · findobj · fsurf · gobjects · groot · hgsave · hidden · histogram2 · hold · line · linkaxes · openfig · opengl · pan · parula · patch · plotmatrix · plotyy · polarhistogram · polarplot · polarscatter · print · quiver3 · ribbon · saveas · savefig · sphere · stackedplot · subtitle · suptitle · text · textscatter · textscatter3 · triplot · waitbar · wordcloud · xlabel · xlim · xline · xscale · xtickangle · xtickformat · xticklabels · xticks · ylabel · ylim · yline · yscale · ytickangle · ytickformat · yticklabels · yticks · zlim · zoom
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how hgload is executed, line by line, in Rust.
- View the source for hgload in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.