# figure (MathScript RT Module Function)

LabVIEW 2012 MathScript RT Module Help

Edition Date: June 2012

Part Number: 373123C-01

»View Product Info Download Help (Windows Only)

Owning Class: plots

Requires: MathScript RT Module

## Syntax

figure

figure(a)

figure(name1, value1, ..., nameN, valueN)

obj = figure

obj = figure(a)

obj = figure(name1, value1, ..., nameN, valueN)

## Description

Generates a new plot window or activates a plot window you create with commands from the plots class. figure generates a new plot window for the next plot command. figure(a) makes plot a the current plot. figure(name1, value1, ..., nameN, valueN) sets the plot window attributes for the new or current plot window according to the attribute names and values you specify.

Examples

## Inputs

Name Description
a Specifies the reference to the plot window. a can be a reference or a positive integer. If plot window a exists, figure(a) makes that plot window visible and current. If plot window a does not exist, figure(a) creates a new plot window and assigns it the number a if a is a positive integer. figure(a) returns an error if a is an invalid reference.
name Specifies the name of the attribute. name is a string.
value Specifies the value of the attribute.

## Outputs

Name Description
obj Returns the reference to the current plot window. obj is a reference to a plot window.

## Details

The following table lists the support characteristics of this function.

 Supported in the LabVIEW Run-Time Engine No (returns error or is ignored) Supported on RT targets No

## Examples

X = 0:1:10;
plot(X)
figure
Y = X.*X;
plot(Y)

obj = figure;
set(obj, 'Color', 'g', 'Name', 'My MathScript Plot', 'NumberTitle', 'off')

t = 0:0.1:2*pi;
obj1 = figure('Position', [50, 500, 500, 400]);
plot(t, sin(t));
obj2 = figure;
plot(t, cos(t));
p = get(obj1, 'Position');
set(obj2, 'Position', [p(1) + p(3), p(2), p(3), p(4)]);