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.The function can generate the hyperlinks in the chart, print a sequence diagram with numbered scenarios, break a sequence diagram across multiple pages and print a sequence diagram with the names of lifelines on every page.stm_plot_ext (id, plot_file_name, width, height, device, data_position, title_position, title, actual_h, pages_in_x, pages_in_y, page_index_in_x, page_index_in_y, headerline_y, options)
Input/Output The ID number of the Rational Statemate chart of be plotted The name of the file destination to which the plot is written. The operating system pathname conventions are followed. You can specify a full path name to any directory for which you have writeaccess.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 (ininches).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. 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 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. The position of the date.This is an integer parameter of type stm_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 atthe bottom of the plot.stm_plot_posi
tion
This is an integer parameter of type stm_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. Specifies the actual height (in inches) of the plotted output. Specifies how many pages the tool attempted to break the SD into along the x-axis. Note that ifpages_in_x==0 and pages_in_y==0, the tool calculates a break pages scheme and assigns these variables so they can be read by the user after the call. Specifies how many pages the tool attempted to break the SD into along the x-axis. Note that ifpages_in_x==0 and pages_in_y==0, the tool calculates a break pages scheme and assigns these variables so they an be read by the user after the call. Specifies how many pages the tool attempted to break the SD into along the y-axis. Defines the vertical coordinate on the page of the header line. This is usually 1.0. A list of strings of the form 'key=value'. See notes below for supported options
●
For External-Activity:
When this option is 'no', the External_activity is hyperlinked to the 'Dictionary' description, if it exists, of the Activity it resolves to. When the 'Dictionary' description is empty, no link is created.
When this option is 'yes', the External-Activity is hyperlinked to the chart in which the Activity it resolves to is in. If the resolved Activity is an Off-Page Activity, the link is to the off-page chart. If the resolved Activity is an Instance of generic, the link is to the generic chart. If the External-Activity resolves to a higher-level unresolved External-Activity, then the link is to the Chart where the Upper most instance of this External-Activity. If the External-Activity does not resolve to any Activity, no hyperlink is created.
●
For External-Router:
When this options is 'no', External_router is hyperlinked to the 'Dictionary' description, if it exists, of the Router it resolves to. When the 'Dictionary' description is empty, no link is created, When this option is 'yes', External-Router is hyperlinked to the chart that the Router it resolves to is in.
● hyperlink_lifeline_to_graphics
When this option is 'no', Lifelines are hyperlinked to the 'Dictionary' description, if it exists, of the Activity they resolve to.
When this option is 'yes', Lifelines are hyperlinked to the chart that the Activity they resolve to are in. If the resolved Activity is an Off-Page Activity, the link is to the off-page chart. If the resolved Activity is an Instance of generic, the link is to the generic chart. If the Lifeline resolves to an unresolved External- Activity, no link is created. If the Lifeline does not resolve to any Activity, no hyperlink is created.