GOPEN Call

Chapter Contents

Language Reference

GOPEN Call

opens a graphics segment

CALL GOPEN( <segment-name><, replace><, description>);

The inputs to the GOPEN subroutine are as follows:

segment-name: is a character matrix or quoted literal specifying the name of a graphics segment.
replace: is a numeric argument.
description: is a character matrix or quoted text string with a maximum length of 40 characters.

The GOPEN subroutine starts a new graphics segment. The window and viewport are reset to the default values ({0 0 100 100}) in both cases. Any attribute modified using a GSET call is reset to its default value, which is set by the attribute's corresponding GOPTIONS value.

A nonzero value for replace indicates that the new segment should replace the first found segment with the same name, and zero indicates otherwise. If you do not specify the replace flag, the flag set by a previous GSTART call is used. By default, the GSTART subroutine sets the flag to NOREPLACE.

The description is a text string of up to 40 characters that you want to store with the segment to describe the graph.

Two graphs cannot have the same name. If you try to create a segment, say PLOT_A, twice, the second segment is named using a name generated by IML.

To open a new segment named COSINE, set replace to replace a like-named segment, and attach a description to the segment, use the statement

   call gopen('cosine',1,'Graph of Cosine Curve');

Chapter Contents
Previous
Next
Top