DESIGN (xvlang) functions


LIBRARY ROUTINE

xvw_create_port - create a port object

LIBRARY CALL

xvobject xvw_create_port(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

The port object on success, NULL on failure

DESCRIPTION

The purpose of the Port object is to provide a general mechanism for representing a "port" within a visual program. Typically these are used by the glyph to represent input and output connections within the visual program. Normally the port is created by other visual programming components, such as the Node object, but is provided so that other styles of visual programs can be created.

The Port object is really available to reduce the complexity of the application programmer in dealing with the user interactions of connecting Glyphs together. It also manages the complexity of representing the connections and the UIS that is used to represent the Port. So if the user updates the filename represented by the Port, and the Port is an output, then the contains of the Ports connected to the output, are updated appropriately.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DESIGN/objects/library/xvlang/src/Port.c

SEE ALSO

xvlang(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.