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  -  ADDPHSEG (3)

[Include document man1/alc_contents.mac]

   addphseg    addphseg

NAME

addphseg - create a physical segment

[Include document man1/alc_origin.1]

CONTENTS

Synopsys
Parameters
Description
Return Value
Errors
Example
See Also

SYNOPSYS






#include "mph.h"
phseg_list *addphseg(ptfig, layer, width, x1, y1, x2, y2, nodename)
phfig_list *ptfig;
char layer;
long width;
long x1, y1, x2, y2;
char *nodename;


PARAMETERS

ptfig Pointer to the figure in which the segment should be added
layer Segment symbolic layer
width Segment symbolic width
x1, y1, x2, y2 Segment endpoints coordinates
nodename Name of the segment

DESCRIPTION

addphseg creates a new segment at the given coordinates, possibly called segname, and adds it to the list of segments pointed to by ptfig->PHSEG. The new segment is added in front of the list, and becomes itself the list head. The segment name is an optional information, and does not allow the segment identification. When not needed, this parameter should be set to NULL.
The parameters nodename, layer and width fill respectivly the NAME, LAYER and WIDTH fields of the phseg structure.
x1, y1, x2, y2 are sorted to warranty that the fields X1 and Y1 contain the minimum of, respectivly, x1, x2 and y1, y2, and the X2, Y2 fields the maximum.
The TYPE field is computed by the addphseg function. It will be either VER if x1 equals x2, or HOR if y1 equals y2.
The width is a layer extension that takes place in perpendicular to the segment TYPE.
For a list of valid layers, and details on the structure, see phseg(3).

RETURN VALUE

addphseg returns a pointer to the newly created segment.

ERRORS

"*** mbk error *** illegal addphseg wrong layer code layer in x1, y1, x2, y2"
The layer parameter is out of range, and does not represent a legal symbolic layer. See phseg(3) for a complete list of layers.
"*** mbk error *** illegal addphseg : x1, y1, x2, y2"
The segment coordinates are such that the segment is neither vertical nor horizontal. So it’s not a legal symbolic segment.

EXAMPLE






#include "mph.h"
phseg_list *du_seg(pfd, pfs)
phfig_list *pfd, *pfs;
{
phseg_list *ps;
   /* names don’t matter */
   for (ps = pfs->PHSEG; ps != NULL; ps = ps->NEXT)
      addphseg(pfd, ps->LAYER, ps->WIDTH, ps->X1, ps->Y1,
            ps->X2, ps->Y2, NULL);
}


SEE ALSO

mbk(1), phfig(3), phseg(3), delphseg(3).

[Include document man1/alc_bug_report.1]

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


ASIM/LIP6 ADDPHSEG (3) October 1, 1997

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