1L2P(1)                     CAO-VLSI Reference Manual                    L2P(1)


6       l2p    -  Creates a PostScript file from a symbolic layout file,or from
7              a physical layout file.


11       This software belongs to the  ALLIANCE CAD SYSTEM developed by the ASIM
12       team  at LIP6 laboratory of Université Pierre et Marie CURIE, in Paris,
13       France.
15       Web : http://asim.lip6.fr/recherche/alliance/
16       E-mail : alliance-users@asim.lip6.fr


19       l2p    [-color]  [-drawingsize=<w>x<h>]  [-fA3]  [-fLETTER]   [-fLEGAL]
20              [-givebwdict]   [-givecolordict]  [-help]  [-noheader]  [-paper‐
21              size=<x>x<y>x<w>x<h>]  [-pages=<x>x<y>]  [-tsize=<s>]  [-nrname]
22              [-ncname]   [-nrfname]   [-niname]  [-nsname]  [-mfeed]  [-real]
23              [-resol=<x>]   [-rflattencatal]    [-rflattentrans]    [-rotate]
24              [-scale=<f.f>] [-usedict=<f>] cellname


27       Two main kind of cells can be used as inputs for l2p :
28       First, you can use l2p to print symbolic layout cells. File formats can
29       be .ap or .cp . This is given by an environment variable MBK_IN_PH that
30       gives the appropriate symbolic layout file format.
31       Second,  you  can use l2p to print real layout cells whose file formats
32       can be .cif or .gds .  This is given by an environment variable  RDS_IN
33       that gives the appropriate real layout file format.
34       The  path  to  the  input  file is set up by two environment variables:
35       MBK_WORK_LIB(3) and if not found MBK_CATA_LIB(3).  The output of l2p is
36       a  PostScript  file  in the current directory. The drawing size and the
37       paper size can be specified by the user. So, you can split your drawing
38       in  as many pages as wanted. The resulting file can be then used on any
39       adequat Postcript printer.
40       l2p will generate in the current directory, either a single file called
41       <cellname>.ps,  either several files suffixed by -<x>x<y>.ps, depending
42       on whether you've asked for a monopage plot or for a drawing that  will
43       be  split  on  several  pages.  If you do something like l2p -pages=2x1
44       cell, it will generate two files called cell-1x1.ps, and cell-2x1.ps.


47       With no options, l2p generate a 'standard file', with all options  off.
48       This is ok for leaf cells, but not for large circuits.
50       -color generates  a  color  PostScript  file  for use with color inter‐
51              preters.  The default value gives a black  and  white  PostCript
52              file.
54       -drawingsize=<width>x<height>
55              specifies the drawing area in centh of inch.  By default, wide =
56              725 and height = 1068 for french A4 paper. If the  drawing  size
57              is bigger than the paper area, then the drawing will be split on
58              several pages.
60       -fA3   The drawing is done on A3 format paper.
62       -fLETTER
63              The drawing is done on LETTER format paper.
65       -fLEGAL
66              The drawing is done on LEGAL format paper.
68       -givebwdict
69              give the Black &  White  internal  PostScript  dictionary.   See
70              below.
72       -givecolordict
73              This option must be unique on the  command  line.  When used  as
74              in  'l2p  -givebwdict', l2p then gives on  the  standard  output
75              its  Black  &  White   internal  Postscript dictionary.  A Post‐
76              Script dictionary is a set of mac- ros that will be used  during
77              interpretation   of   your  PostScript  file.  The macros in the
78              internal PostScript dictionnaries of l2p allows you  to  control
79              which  layer to  output,  how  to  plot  rectangles, and specify
80              the colors of the rectangles. You get the standard diction- nary
81              by   a  line  of  the  form  'l2p -givecolordict > dict.ps'. You
82              can then edit it, in order to reuse it with l2p, see the  '-use‐
83              dict' option below.
85       -help  gives you this man page that explains how to use l2p.
87       -noheader
88              prevents  the  border  and various info, as the cellname and the
89              position of the page in the drawing, from being printed.
91       -papersize=<x_low_left>x<y_low_left>x<width>x<height>
92              specifies  the  paper  area  in  centh  of  inch.  By   default,
93              50x50x726x1069 for a4 paper.
95       -pages=<number_of_x_pages>x<number_of_y_pages>
96              specifies  the  drawing area in pages. It can be useful, instead
97              of having to calculate the size in cenths of inch of  the  draw‐
98              ing, to give it in numbers of pages. It takes care of the resiz‐
99              ing of the paper and whether there is a header.
101       -tsize=<s>
102              Available sizes:6,8,10,12,14.The default value is 8.
104       -nrname
105              No name at all will be displayed.
107       -ncname
108              The external connector's names won't be displayed.
110       -nrfname
111              The references's names won't be displayed.
113       -niname
114              The instances's names won't be displayed.
116       -nsname
117              The segments's names won't be displayed.
119       -mfeed Manualfeed:if set,informs the printer that it will be fed by the
120              user himself,for each printing .
122       -real  uses real file (cif, gds). By default, uses symbolic layout file
123              (ap, cp).
125       -resol=<x>
126              is the resolution of the file in dots per inch (dpi). This value
127              has been introducted to limitate the size of the generated Post‐
128              Script files. Each rectangle whose width and height are  smaller
129              than  the  resolution  will not be printed. The default value is
130              72dpi. It should only be changed in one specifical case  :  when
131              you  want to produce a plot of several meter large. Usually, you
132              must provide a PostScript file sized for A4 paper  with  a  much
133              better  resolution  than 72dpi. You can then increase that value
134              to up to 1000dpi, but be aware that the size of  the  file  will
135              probably be bigger than a 44Mb SyQuest cartridge that is used in
136              PAO for exchanging data files.
138       -rflattencatal
139              flattens the cell to the catalog level. see  catal(5)  for  more
140              details  on the use of the catalog file. Be careful, this option
141              requires a lot of memory...
143       -rflattentrans
144              flattens the cell to the transistor level  before  printing.  Be
145              careful, this option requires a lot more memory...
147       -rotate
148              rotate  the  cell  from  90 degree. This is useful if you have a
149              wide cell, and you want to have it printed in landscape mode.
151       -scale=<f.f>
152              forces the cell to be printed with a certain scale (a  floating-
153              point  number).   This  is  very useful, when you are printing a
154              whole library of cells, and you want all cells to be printed  to
155              the same scale.
156              You can find at which scale a cell was printed by looking at the
157              beginning of the file : 'head n1_y-1x1.ps' will show you a Post‐
158              Script comment beginning by '%SCALE=3.78435' for example.
160       -usedict=<filename>
161              The  output  Postcript  file  contains a Postcript dictionary of
162              macros.
163              There are two standard dictionnaries used by l2p for  black  and
164              white or color prints.  This allows you to use a PostScript dic‐
165              tionary different from the two internally encoded into  l2p.  By
166              modifying  one  of  the  standard l2p dictionary, you can choose
167              which layer to  output,  how  to  fill  the  rectangles  (empty,
168              hashed,  filled),  which  color to choose, ... and lots of other
169              possibilities. The rest of  the  generated  postscript  file  is
170              mainly  orders  of  drawing  rectangles. PostScript is a reverse
171              polish notation language, that is easy to read for  simple  pro‐
172              grams.
173              If you use this functionality, and think that your dictionnaries
174              are worth it, please mail them  to  alliance-users@asim.lip6.fr,
175              in  order  to submit them for inclusion in future version of l2p
176              (Thanks).


180       for symbolic file(s) :
181              setenv MBK_IN_PH ap
182              setenv MBK_WORK_LIB .
183              setenv MBK_CATA_LIB /labo/cells/scr
184              setenv MBK_CATAL_NAME CATAL
185              setenv RDS_TECHNO_NAME cmos_1.rds
187       for real file(s) :
188              setenv RDS_IN cif
189              setenv MBK_CATAL_NAME CATAL_ROUT
190              setenv RDS_TECHNO_NAME prol12_1.rds


194       l2p -color n1_y
195              will create a colored n1_y.ps file in the  current  directory  :
196              the 'standard' way.
198       l2p -real cell
199              will  create  a  cell.ps  file  in  the  current  directory from
200              cell.cif or cell.gds, depending on the RDS_IN environment  vari‐
201              able.
203       l2p -pages=3x2 na2_y
204              size of the created drawing:3 horizontal pages,2 vertical ones;
208       SEE ALSO
209              mbk(1),  rds(1), MBK_IN_PH(3), MBK_CATA_LIB(3), MBK_WORK_LIB(3),
210              MBK_CATAL_NAME(3),   RDS_TECHNO_NAME(3),   pageview(1),   gs(1),
211              ghostview(1), lpr(1).


215       You  will  not be able to generate more than approximativly 30 pages at
216       the same time (because of the FOPEN_MAX of your environment).  In  this
217       case, see the option that is not implemented yet.
218       The  generated  PostScript is Level 1 for black& white plots.  When you
219       use color, it generates Level 1 with color extensions.  It may not  run
220       with  strict Level 1 interpreters, although it runs here with our Apple
221       Personal LaserWriter, Sun Sparcprinters, and Canon CLC-300-PS.  It fol‐
222       lows  the  Adobe  Document Structuring Conventions 1, and as there is a
223       fake bitmap image inside each generated files, you can re-use  them  in
224       your word-processors, or publishing software, because the PostScript is
225       EPSF-1.2 compliant.
231ASIM/LIP6                       October 1, 1997                         L2P(1)