The PMF_RESET option, more so than the other array options, controls the effects of other array options. This option allows a total reset of the presentation space and provides further control of the following presentation space environmental attributes:
Warning: If the metafile page units, page dimensions and page coordinate format do not match those in the presentation space, playing the metafile will cause an error.
The PMF_RESET option can have one of the values shown in the following table.
PMF_RESET Options for GpiPlayMetaFile
┌────────────────┬────────────────────────────────────────────┐│Value │Description │ ├────────────────┼────────────────────────────────────────────┤ │RES_RESET │Allows the presentation space to be │ │ │completely reset, just as if it were newly │ │ │created, and the values of the │ │ │aforementioned environmental attributes to │ │ │be specified from the metafile into the │ │ │presentation space. │ │ │ │ │ │This option is equivalent to specifying │ │ │GRES_ALL on GpiResetPS. If this option is │ │ │used, the target presentation page is │ │ │redefined so that it is the same size, and │ │ │defined in the same units, as the metafile. │ │ │It also ensures that the physical size of │ │ │the metafile picture is preserved if the │ │ │presentation page is defined in units other │ │ │than pels, or arbitrary units. │ ├────────────────┼────────────────────────────────────────────┤ │RES_NORESET │Prevents resetting of the presentation │ │RES_DEFAULT │space. The existing presentation space │ │ │values of the environmental attributes will │ │ │be preserved, and their values in the │ │ │metafile will be discarded. │ │ │ │ │ │If this option is used, ensure that the │ │ │presentation-page units of the target │ │ │presentation space are the same as those │ │ │with which the metafile was generated, │ │ │before you play a metafile into the │ │ │presentation space. For example, if the │ │ │original presentation page is defined in │ │ │increments of 0.1 mm, the target │ │ │presentation page must be defined in the │ │ │same way. │ │ │ │ │ │To change the format of the target │ │ │presentation page, if the presentation-page │ │ │formats do not match, issue GpiSetPS, but │ │ │only if you know the metafile │ │ │presentation-page units. │ └────────────────┴────────────────────────────────────────────┘
If you are certain that the settings of the current presentation space are appropriate for the metafile, then you can play the metafile with the NO_RESET option. To reset some or all of the current values in the target presentation space, without redefining the presentation page, call:
The PMF_LCID option may be used to append or replace fonts from the metafile to the fonts in the presentation space. The PMF_COLORTABLES option may be used to append or replace color table entries in the presentation space from the metafile. Other options (PMF_LOADTYPE, PMF_DEFAULTS, and so on) can be used to selectively replace settings in the presentation space from the metafile.
Like the PMF_RESET option, other options, except for PMF_SUPPRESS, either:
If the first choice is used with RES_RESET, then the items controlled by the PMF_options will be left set to their default reset state, otherwise it will occur as described in the first choice above.
If the second choice is used with RES_RESET, then the items controlled by the PMF_options are as described above. If it is used with RES_NORESET, then the fonts and color tables in the metafile can append to the existing color tables and fonts in the presentation space. Existing presentation space color table entries and fonts, such as viewing transform will be replaced if respecified in the metafile.
Note: If your application uses the attributes from the metafile, the attributes that were specified in the presentation space before the metafile was played are overwritten.