dataTipTextRow — Create a data-tip text row object for customizing plot data tips.

dataTipTextRow(label, value) creates a MATLAB-compatible matlab.graphics.datatip.DataTipTextRow handle object with Label, Value, and Format properties. Use these rows with plot data-tip templates as RunMat's graphics template support expands.

Syntax

row = dataTipTextRow(label, value)
row = dataTipTextRow(label, value, format)

Inputs

Returns

Errors

How dataTipTextRow works

• dataTipTextRow(label, value) creates a handle-class row object and stores an empty Format property so the renderer or host can use its default formatting.
• dataTipTextRow(label, value, format) stores the supplied display format string.
• label and format accept character vectors, string scalars, and scalar string arrays.
• Value is preserved without reinterpretation, so property names such as 'YData', numeric vectors, string values, function handles, and GPU-resident values remain available to downstream graphics code.
• Returned rows support dot-property access and mutation for Label, Value, and Format; aliases refer to the same underlying handle object.

Options

• Label is the displayed row label.
• Value is the data source, value vector, expression result, or property name used by the row.
• Format is an optional numeric, datetime, duration, or text display format.

Does RunMat run dataTipTextRow on the GPU?

Object construction terminates numeric fusion because the result is a graphics metadata object.

Supplying a GPU-resident value preserves the handle in the returned object's Value property.

GPU memory and residency

dataTipTextRow is metadata-only. It does not inspect, gather, or convert the supplied Value property, so GPU-resident values remain represented by their existing handles.

Examples

Create a row that reads from plotted Y data

row = dataTipTextRow('Speed', 'YData', '%.2f');
row.Label

Expected output:

ans =
    "Speed"

Create a row from explicit values

values = [10 20 30];
row = dataTipTextRow('Amplitude', values);
row.Format = '%.1f';

Expected output:

% row is a DataTipTextRow handle object

Using dataTipTextRow with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how dataTipTextRow changes the result.

FAQ

Related Plotting functions

Open-source implementation

Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how dataTipTextRow is executed, line by line, in Rust.

• View the source for dataTipTextRow 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.

Getting started · Benchmarks · Pricing