PtFepCmd()

Control a Front-End Processor (FEP) from an application

Synopsis:

int PtFepCmd( PtWidget_t *widget,
              long cmd,
              long sub_cmd,
              char const *data );

Arguments:

widget

A pointer to the widget on which you want any text-input boxes to appear.

cmd

The command that you want to send to the FEP; one of:

• Ph_FEP_CHANGE_MODE -- change to the mode specified by the string pointed to by data.

  The data string must be a null-terminated UTF-8 string that's identical to the string that the FEP's GUI displays in the mode-selection buttons.

• Ph_FEP_HELP -- invoke the FEP's help routine. This command doesn't require any extra data, so you should pass NULL for the data argument.
• Ph_FEP_TOGGLE_1 -- toggle the FEP's mode. This is usually the same as pressing Alt-~ in the FEP. This command doesn't require any extra data, so you should pass NULL for the data argument.

sub_cmd

Not currently used; set this argument to 0.

data

A pointer to any extra data that the specific command needs.

Library:

ph

Description:

PtFepCmd() lets you control a Photon front-end processor (FEP) from an application. This function lets you create your own front-end processor that includes all of the functionality of the GUI versions of the FEPs.

To use this function, start the FEP with the -h option to suppress the GUI interface. For more information, see the documentation for cpim and vpim.

Returns:

0

Success.

-1

An error occurred.

Classification:

Photon

See also:

cpim, vpim