NAME

cxOutputPortOpen - Get a handle for a port

C SPECIFICATION

#include <cx/PortAccess.h>

int cxOutputPortOpen(char *portname)

FORTRAN SPECIFICATION

integer function cxOutputPortOpen( portname )
character *(*) portname

PARAMETERS

portname
Name of the output port to open.

DESCRIPTION

cxOutputPortOpen converts an output port name into an integer port handle to be used on all subsequent port calls. The port name is typically a short name describing the purpose of the port, such as colormap or volume. If the given name does not refer to an existing port, a -1 is returned.

The name of the port is the one that was entered into the ``Output Ports'' form in the module builder. The same name appears in the I/O list menu for the module in the map editor. No particular interpretation should be placed on the values of the integer returned by this function, though typically it will be a small integer.

SEE ALSO

cxInputPortOpen(3E)
Last modified: Mon Nov 18 13:51:13 GMT 1996
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996