Generates a plot file with the indicated parameters, such as plot size, output device, and so on. The plot parameters are the same for all the different plot types (statecharts, activity charts, or module charts).The output is designated for a particular device (one of the output devices defined in Rational Statemate). The destination of the plot output is specified by one of the parameters. If its destination is not specified, the plot is included as part of the output segment file.When working with Interleaf, the plot uses the following definitions, which should be included at the beginning of the file:<!Font Definitions F46 = Typewriter 10 >
<!Class, caption, Font = F46>
<!Class, plot, Font = F46>
<!Master Frame,
Name = PltFrm,
Placement = Following Anchor,
Horizontal Alignment = Center,
Same Page = Yes,
Diagram = V6, (g9,0,0)>stm_plot (id, plot_file, width, height, with_labels,with_names, with_notes, device, date_position,title_position, title, do_rotate, with_file_header, actual_height)
Input/Output The ID number of the Rational Statemate chart to be plotted. The name of the file destination to which the plot is written. The operating system path name conventions are followed. You can specify a full path name to any directory for which you have write access.If you specify a simple file name, the plot is written to your workarea. The maximum possible width of the plot (in inches). The maximum possible length of the plot (in inches).If you specify a plot size (width and height parameters) that is larger than the paper size defined for the specific printer, the plot simply uses the maximum allowable height and width defined for that printer. Determines whether labels are plotted (TRUE) or not (FALSE). Determines whether names are plotted (TRUE) or not (FALSE). Determines whether notes are plotted (TRUE) or not (FALSE). Specifies the plotting device. This can be a supported formatting language if the plot is to be handled by a formatting processing system that has its own graphics language.To configure a new plotter or printer, select Utilities > Output Devices from the main Rational Statemate window.Plots created using Word format in the Output Device dialog box are HPGL files. To import these files into Word, rename them as .HGL or .PLT files. This is an integer parameter of typestm_plt_position
That indicates where to place the plot date. The possible values are as follows:
•stm_plt_none
- The date is not included.
•stm_plt_top
- The date is placed at the top of the plot.
•stm_plt_bottom
- The date is placed at the bottom of the plot. This is an integer parameter of typestm_plt_position
that indicates where to place the plot title. The possible values are as follows:
•stm_plt_none
- The title is not included.
•stm_plt_top
- The title is placed at the top of the plot.
•stm_plt_bottom
- The title is placed at the bottom of the plot. Specifies the title to be printed with the plot. Determines whether the orientation of the plot is landscape (TRUE) or portrait (FALSE). Indicates whether a header is added to the file (TRUE). Use this option if you do not want the plot as part of the document (FALSE). Specifies the actual height (in inches) of the plotted output.stm_id chart_id;
int status;
double real_ht;
stm_plt_position date_position;
stm_plt_position title_position;
date_position = stm_plt_bottom;
title_position = stm_plt_bottom;
chart_id = stm_r_ch ("XL25", &status);
stm_plot (chart_id, "sam/p_xl25", 5.0, 7.0,
stm_true, stm_true, stm_false, "eps100h",
date_position, title_position, "System XL25",
stm_true, stm_false, &real_ht);This produces a plot for the activity-chartXL25
in landscape orientation, limited to a maximum size of 5x7 inches, that prints full labels and names, but excludes notes. The plot is output to the file specified by the pathsam/p_xl25
. This file is suitable for printing on an Epson FX100 graphics printer. The date and the title System XL25 appear at the bottom of the plot. The actual scaled height of the plot is returned in the variablereal_ht
.