luke
/
magic
mirror of https://github.com/RTimothyEdwards/magic.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
magic/calma/calma.h

103 lines
4.0 KiB
C
Raw Normal View History

Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
/*
* calma.h --
*
* This file defines things that are exported by the
* calma module to the rest of the world.
*
Updates from running the fix-ending-whitespace script.
2020-05-23 23:13:14 +02:00
* *********************************************************************
* * Copyright (C) 1985, 1990 Regents of the University of California. *
* * Permission to use, copy, modify, and distribute this *
* * software and its documentation for any purpose and without *
* * fee is hereby granted, provided that the above copyright *
* * notice appear in all copies. The University of California *
* * makes no representations about the suitability of this *
* * software for any purpose. It is provided "as is" without *
* * express or implied warranty. Export of this software outside *
* * of the United States of America may require an export license. *
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
* *********************************************************************
*
* rcsid $Header: /usr/cvsroot/magic-8.0/calma/calma.h,v 1.1.1.1 2008/02/03 20:43:50 tim Exp $
*/
#ifndef _CALMA_H
#define _CALMA_H
#include "utils/magic.h"
/* Externally visible variables */
Modified the "gds subcell polygon" command option to split into three types: "none", "temporary", and "keep" (instead of "true" or "false"). "none" now reverts back to the original behavior, because it was found that saving polygons in subcells prevents them from participating in boolean operations. The "keep" option is the original option (polygons kept in subcells), and "temporary" is the one recently introduced (which puts polygons in subcells and then flattens them). This restores the original method while retaining the recently implemented method. However, a proper solution needs to be found that deals with the problem of boolean operators.
2023-01-18 02:14:38 +01:00
extern unsigned char CalmaSubcellPolygons;
Modified the gds command options to separate "gds path subcell" from "gds polygon subcell". Previously both polygons and paths were put into subcells named polygonXXXXX (substitute numbers for XXXXX). Now polygons go into cells named polygonXXXXX and paths go into cells named pathXXXXX. This makes it easier to keep track of the original path. NOTE: The path centerline should be kept as a cell property in this case, and the path options like endcap style can also be held as properties. The polygon boundary should be treated similarly.
2017-10-07 04:32:52 +02:00
extern bool CalmaSubcellPaths;
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
extern bool CalmaDoLabels;
Added a "calma library" command option, to generate a GDS library from the subcircuits of a top-level layout without also writing the top level.
2020-07-16 14:55:46 +02:00
extern bool CalmaDoLibrary;
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
extern bool CalmaDoLower;
Added experimental "calma addendum" option to output only references to readonly cells but not the readonly cells themselves when writing a GDS library.
2020-10-13 15:47:54 +02:00
extern bool CalmaAddendum;
Several enhancements: (1) Added command option "gds no_duplicates" to allow a "gds read" command to ignore cells in the GDS which already exist in memory. This allows magic to be "pre-seeded" with specific views of cells in the GDS. Default is false, which is backwards- compatble behavior. (2) Changed the behavior of the the way the use path is written to and read from a .mag file, checking the path prefix against Tcl variables PDK_PATH, PDKPATH, PDK_ROOT, and PDKROOT, and replacing any such leading path component with the variable name. On reading a .mag file, any variable name at the start of the path that matches a Tcl variable will be substituted.
2020-12-04 22:56:51 +01:00
extern bool CalmaNoDuplicates;
Changed the "gds nodatestamp" option to "gds datestamp" and added "gds datestamp <value>" as an option to force a specific datestamp on the GDS output. This is a third option beyond the previous two which were either to use the current time or to write zero. The new option allows an entire library to get a common timestamp, for example, related to a PDK version number. The "gds nodatestamp" option has been retained for backwards compatibility.
2022-01-21 16:26:29 +01:00
extern time_t *CalmaDateStamp;
Added a "gds unique" option that behaves like the default CIF behavior, in which if a cell is read from GDS that has the same name as a cell in memory, then the cell in memory is renamed to keep all cell names unique in the database.
2021-04-27 19:07:27 +02:00
extern bool CalmaUnique;
Refined the new "gds maskhints" command option for GDS input from yesterday's commit to allow the syntax "gds maskhints <types>", in which mask hints can be restricted to a specific list of layers rather than all layers which define mask hints in the cifoutput rule.
2022-01-21 20:48:59 +01:00
extern TileTypeBitMask *CalmaMaskHints;
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
extern bool CalmaMergeTiles;
extern bool CalmaFlattenArrays;
extern bool CalmaNoDRCCheck;
extern bool CalmaFlattenUses;
Implemented a new command option "gds magscale" to reinterpret the meaning of the MAG record in GDS files. Most available GDS documentation is decidedly vague about what MAG means. Most layout tools seem to interpret a MAG of 1 as corresponding to a text height of 1um. However, there are a few tools that interpret it as 1 centimicron, and there's no reason to assume that any given interpretation is correct. "gds magscale" allows the scale to be redefined.
2023-07-20 02:33:01 +02:00
extern int CalmaFlattenLimit;
extern float CalmaMagScale;
Added an option "gds flatglob [<string>|none]" that allows flattening of input cells on a per-cellname basis, using glob-style pattern matching. This is probably the best way to deal with 3rd-party vendor GDS with unfortunate practices like dividing devices up among cells in a hierarchy, even though it comes across as a bit of a hack solution.
2020-12-22 20:44:30 +01:00
extern char **CalmaFlattenUsesByName;
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
extern bool CalmaReadOnly;
extern bool CalmaContactArrays;
Implemented native gzip compression/decompression using zlib routines. Compression levels of the output can be controlled with the "gds compress [<value>]" command, where <value> 0 (default) is uncompressed output, 6 is "normal" gzip compression, and 9 is maximum compression.
2022-05-10 15:19:39 +02:00
#ifdef HAVE_ZLIB
Compatibility with C99 standard This commit makes the code (mostly) C99-compatible, enabling to compile it without the -Wno-error=implicit-function-declaration flag. This way, Magic becomes usable on arm64 architectures, specifically on Apple computers with M1/M2 SoC.
2022-10-10 11:50:15 +02:00
extern int CalmaCompression;
Implemented native gzip compression/decompression using zlib routines. Compression levels of the output can be controlled with the "gds compress [<value>]" command, where <value> 0 (default) is uncompressed output, 6 is "normal" gzip compression, and 9 is maximum compression.
2022-05-10 15:19:39 +02:00
#endif
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
extern bool CalmaPostOrder;
Implemented a return value for the cell read-in checks with an option to stop the search whenever a cell is not found. Used this to implement a new option for GDS writes, "gds undefined allow|disallow" (default "disallow") controls whether or not GDS with undefined references will be allowed to be written. Similarly affects CIF and LEF writes, extraction, and DRC (when running "drc check" from the top).
2021-01-14 21:21:39 +01:00
extern bool CalmaAllowUndefined;
Changed the behavior of GDS writing to halt with an error if an attempt is made to write an abstract view to GDS. This behavior can be overridded with the new command option "gds abstract [enable|disable]". Also: Corrected extraction to allow split tiles to be set as the reference tile for a node. Previously this was allowed only if the tile was the first to be searched, but that can cause different tiles to be marked as the reference depending on where the search starts, resulting in different names for the same node in .ext files, which is bad. Also: Modified the LEF annotation to avoid bad entries in the LEF that would create layers in the layout where none exist.
2022-11-02 14:40:20 +01:00
extern bool CalmaAllowAbstract;
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
Modified the "gds subcell polygon" command option to split into three types: "none", "temporary", and "keep" (instead of "true" or "false"). "none" now reverts back to the original behavior, because it was found that saving polygons in subcells prevents them from participating in boolean operations. The "keep" option is the original option (polygons kept in subcells), and "temporary" is the one recently introduced (which puts polygons in subcells and then flattens them). This restores the original method while retaining the recently implemented method. However, a proper solution needs to be found that deals with the problem of boolean operators.
2023-01-18 02:14:38 +01:00
/* Definitions used by the return value for CalmaSubcellPolygons */
/* CALMA_POLYGON_NONE: Process polygons immediately */
/* CALMA_POLYGON_TEMP: Create temporary polygon subcells */
/* CALMA_POLYGON_KEEP: Keep polygons in subcells */
#define CALMA_POLYGON_NONE 0
#define CALMA_POLYGON_TEMP 1
#define CALMA_POLYGON_KEEP 2
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
/* Externally-visible procedures: */
K&R calma.h: conversion to ANSI K&R obsolete syntax removal for C23 compatibility series
2024-10-04 12:17:39 +02:00
extern bool CalmaWrite(CellDef *rootDef, FILE *f);
extern void CalmaReadFile(FILETYPE file, char *filename);
extern void CalmaTechInit(void);
extern bool CalmaGenerateArray(FILE *f, TileType type, int llx, int lly, int pitch, int cols, int rows);
quick and dirty emscripten port
2023-07-11 17:31:37 +02:00
extern void CalmaReadError(char *format, ...);
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
Compatibility with C99 standard This commit makes the code (mostly) C99-compatible, enabling to compile it without the -Wno-error=implicit-function-declaration flag. This way, Magic becomes usable on arm64 architectures, specifically on Apple computers with M1/M2 SoC.
2022-10-10 11:50:15 +02:00
/* C99 compat */
K&R calma.h: conversion to ANSI K&R obsolete syntax removal for C23 compatibility series
2024-10-04 12:17:39 +02:00
extern int calmaAddSegment(LinkedBoundary **lbptr, int poly_edge, int p1x, int p1y, int p2x, int p2y);
extern void calmaDelContacts(void);
extern void calmaElementBoundary(void);
extern void calmaElementBox(void);
extern void calmaElementPath(void);
extern void calmaElementText(void);
extern bool calmaIsUseNameDefault(char *defName, char *useName);
extern bool calmaParseStructure(char *filename);
extern int calmaProcessDef(CellDef *def, FILE *outf, bool do_library);
extern int calmaProcessDefZ(CellDef *def, gzFile outf, bool do_library);
extern bool calmaReadI2Record(int type, int *pvalue);
extern bool calmaReadI4Record(int type, int *pvalue);
extern void calmaReadPoint(Point *p, int iscale);
extern bool calmaReadR8(double *pd);
extern bool calmaReadStampRecord(int type, int *stampptr);
extern bool calmaReadStringRecord(int type, char **str);
extern bool calmaReadStringRecord(int type, char **str);
extern bool calmaReadTransform(Transform *ptrans, char *name);
extern bool calmaSkipBytes(int nbytes);
extern bool calmaSkipExact(int type);
extern bool calmaSkipTo(int what);
extern void calmaUnexpected(int wanted, int got);
extern void calmaMergeSegments(LinkedBoundary *edge, BoundaryTop **blist, int num_points);
extern void calmaRemoveDegenerate(BoundaryTop *blist);
extern void calmaRemoveColinear(BoundaryTop *blist);
Compatibility with C99 standard This commit makes the code (mostly) C99-compatible, enabling to compile it without the -Wno-error=implicit-function-declaration flag. This way, Magic becomes usable on arm64 architectures, specifically on Apple computers with M1/M2 SoC.
2022-10-10 11:50:15 +02:00
A number of other corrections around CalmaFullDump, which had mistakenly recast the input file routines from zlib back to stdio; only the output file routines should have been changed.
2022-05-12 15:55:38 +02:00
#ifdef HAVE_ZLIB
K&R calma.h: conversion to ANSI K&R obsolete syntax removal for C23 compatibility series
2024-10-04 12:17:39 +02:00
extern bool CalmaWriteZ(CellDef *rootDef, gzFile f);
extern bool CalmaGenerateArrayZ(gzFile f, TileType type, int llx, int lly, int pitch, int cols, int rows);
A number of other corrections around CalmaFullDump, which had mistakenly recast the input file routines from zlib back to stdio; only the output file routines should have been changed.
2022-05-12 15:55:38 +02:00
#endif
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
#endif /* _CALMA_H */