PGPAP — change the size of the view surface

PGPAP 改变视图表面的大小

对应的C函数为 void cpgpap(float width, float aspect);
               这个函数用于改变视图的大小到一个指定的宽度和纵横比的视图。获取一个比标准大小还小的视图总是可行的,
如果比标准大小大,则只适用于一些设备。
               这个函数应该在PGBEG之后或者PGPAGE之前调用。
随后的图形将采用设置的属性,直到下一次调用PGPAP
参数:
 WIDTH  (输入)  : 视图图形的宽度(英寸计),如果 WIDTH=0.0PGPAP 将获得最大与ASPECT参数一致的视图表面。 
 ASPECT (输入)  : 视图表面的综合比 (height/width)ASPECT=1.0正方形, ASPECT<1.0水平型的矩形,ASPECT>1.0垂直型的矩形。

PGPANL — switch to a different panel on the view surface

PGPANL 切换到当前视图的不同面板

对应的C函数为 void cpgpanl(int nxc, int nyc);
               开始在一个不同的面板作图。如果视口被PGBEG 或者PGSUBP划分为几个子窗口,
这个函数可以移动到一个不同的面板。
 
注:PGPLOT不记录使用哪个视口和窗口。需要通过PGPANL来设定。
PGPLOT不清空这个面板,在调用PGPANL再调用PGERAS来清空面板。
参数:
 IX     (输入)  : 水平索引值
 IY     (输入)  : 垂直索引值

PGPAGE — advance to new page

PGPAGE 前进到新的页面

对应的C函数为 void cpgpage(void);
             在一个新页或者面板显示图形,如果需要也可以清空屏幕。
如果“提示状态”是打开的(参考PGASK),那么清空屏幕前需要用户的确认。
如果视图被PGBEG  PGSUBP 分成了几个子面板,PGPAGE将前进到下一个面板,如果当前的面板已经是最后一个了,
那么PGPAGE将清空屏幕或者打开一个新的页。PGPAGE不会改变PGPLOT的窗口或视图,
但是如果由于设备的不同,
而导致的视图面的大小改变,PGPAGE将同比例改变。
参数: 

PGOPEN — open a graphics device

PGOPEN 打开一个图形设备

对应的C函数为 int cpgopen(const char *device);
               PGPLOT的输出打开一个图形设备。如果设备打开成功,图形将输出到该设备直到使用PGSLCT选择了其他的设备或者使用PGCLOS关闭了该设备。
               PGOPEN的返回值应该加以辨别是否打开成功。例如:
      ISTAT = PGOPEN('plot.ps/PS')
      如果 (ISTAT .LE. 0 ) STOP
DEVICE 参数的值为一个字符串,取值如下所示:
(1) 完整的设备描述形式“device/type”或者“file/type”;其中的'type'PGPLOT支持设备类型的一种。
(2) 单纯的设备描述形式'/type'
(3) 设备描述形式'/type'被省略时,使用环境变量定义好的PGPLOT_TYPE
(4) 空字符串 ( );这种情况下,PGOPEN将使用设定好的环境变量PGPLOT_DEV。如果环境变量未定义使用'/NULL'
(5) 双引号加一个问号 (?);这种情况下将提示用户键入要输出的设备类型,也可以输入?来查看设备列表。
(6) 非空字符串但是第一个字符为问号的 (比如'?Device: ');这种情况下PGPLOT将给用户提示信息,不过前缀是?后面的字符串。
对于情况 (5) (6),设备的类型将由输入确定。
               设备的类型是不区分大小写的(例如'/ps''/PS'是相同的)。
 
有效地DEVICE参数示例:
(1)  'plot.ps/ps', 'dir/plot.ps/ps', '"dir/plot.ps"/ps', 'user:[tjp.plots]plot.ps/PS'
(2)  '/ps'      (PGPLOT默认为'PGPLOT.ps/ps')
(3)  'plot.ps'  (如果PGPLOT_TYPE定义为'ps', PGPLOT将解释为'plot.ps/ps')
(4)  '   '      (取决于定义的PGPLOT_DEV)
(5)  '?  '
(6)  '?Device specification for PGPLOT: '
[这个函数是在5.1.0版本加入的,老程序用PGBEG替代。
 
返回值:
 PGOPEN   : 返回值(正值)将被PGSLCT使用。 如果返回0或者负值,将有错误信息输入到标准错误单元。
参数:
 DEVICE  (输入) : 设备描述符(参考上面的描述)