GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ADDPHCON (3)

[Include document man1/alc_contents.mac]

   addphcon    addphcon

NAME

addphcon - create a physical connector

[Include document man1/alc_origin.1]

CONTENTS

Synopsys
Parameters
Description
Return Value
Errors
Example
See Also

SYNOPSYS






#include "mph.h"
phcon_list *addphcon(ptfig, orient, conname, x, y, layer, width)
phfig_list *ptfig;
char orient;
char *conname;
long x, y;
char layer;
long width;


PARAMETERS

ptfig Pointer to the figure in which the connector should be added
orient Face of the connector
conname Name of the connector
x, y Absolute connector coordinates
layer Connector symbolic layer
width Connector symbolic width

DESCRIPTION

addphcon creates a new connector called conname and adds it to the list of connectors pointed to by ptfig->PHCON. The new connector is added in front of the list, and becomes itself the list head.
The parameters conname, orient, x, y, layer, width fill respectivly the NAME, ORIENT, XCON, YCON, LAYER, WIDTH fields of the phcon structure. See phcon(3) for details.
The INDEX field is computed by the addphcon function in order to warranty index unicity. A topological sort is performed, checking x, then y, then the layer. So for a given figure, each connector will have a constant INDEX.
The x, y coordinates must be placed inside the butment box of the figure.
The width is a layer extension that takes place in parallel to the connector face.
For a list of valid orient and layers, see locon(3).

RETURN VALUE

addphcon returns a pointer to the newly created connector.

ERRORS

"*** mbk error *** illegal addphcon unknow layer layer in conname"
The layer parameter is out of range, and does not represent a legal symbolic layer. See locon(3) for a complete list of layers.
"*** mbk error *** illegal addphcon connector conname not in abutment box"
The connector coordinates are not included in the rectangle of the figure abutment box. This means that the abutment box field of the phfig must be filled befor any call to addphcon.
"*** mbk error *** illegal addphcon orientation is orient in conname"
The orient parameter is not in the set of legal values. See locon(3) for the complete list of orientations.

EXAMPLE






#include "mph.h"
phcon_list *du_con(ptfig, ptcon) /* duplicate connector */
phfig_list *ptfig;
phcon_list *ptcon;
{
   /* the index depends from what’s in ptfig->PHCON, not from me */
   return addphcon(ptfig, ptcon->ORIENT, ptcon->NAME,
                   ptcon->XCON, ptcon->YCON,
                   ptcon->LAYER, ptcon->WIDTH);
}


SEE ALSO

mbk(1), phfig(3), phcon(3), getphcon(3), delphcon(3), locon(3).

[Include document man1/alc_bug_report.1]

Search for    or go to Top of page |  Section 3 |  Main Index


ASIM/LIP6 ADDPHCON (3) October 1, 1997

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.