next up previous contents index
Next: Placement Blocks Up: The !assemble Command: Merge Previous: Source Blocks   Contents   Index

Source Block Directives

The Source Block directives can be given in the context of the Header Block, in which case they serve as defaults for the Source Blocks that follow. They can also be given in a Source Block, in which case they apply in that Source Block only, and override a similar directive active from a definition in the Header Block context. The term ``Header Block context'' means that the definition appears before any Source Block, or after an EndSource line (-i- option) but before the next Source line (-i option.

The Source Block directives can not appear inside of Placement Blocks, where they would have no meaning. Thus, in a Source Block, Source Block directives can appear before the Placement Blocks, or between EndPlace lines (-c- option) and the next Place (-c option) or PlaceTop line (-ctop option). The directives that apply are those logically in force at the end of the Source Block. The Source Block directives apply to the Source Block, and will have the same effect for all contained Placement Blocks, regardless of ordering.

The following lines define Source Block directives:

LayerList list_of_layer_names
(option: -l list_of_layer_names)
This saves a list of space-separated layer names or hex-encoded pseudo-names to be used with the layer filtering directives OnlyLayers (-n option) and SkipLayers (-k option). This directive in itself does not alter output. This list is implied when a list_of_layer_names is provided with these keywords. In the command line, the list of layer names must be quoted if it contains more than one entry, but this is not required in a file.

OnlyLayers [list_of_layer_names]
(option: -n)
When active, only the listed layers will be used in output, geometry on other layers will be skipped. Arguments following this keyword will be used to set or reset the LayerList, and have the same interpretation as for that keyword. If no arguments follow, the LayerList currently in scope will be used. The -n command line token does not accept a list of layer names, unlike the corresponding keyword. This must be separately specified with a -l option.

NoOnlyLayers
(option: -n-)
Turn off restriction to layers in the LayerList, if the OnlyLayers directive (-n option) is in force. The corresponding LayerList remains defined.

SkipLayers [list_of_layer_names]
(option: -k)
When active, listed layers will not appear in output, geometry on layers not listed will appear in output. Arguments following this keyword will be used to set or reset the LayerList, and have the same interpretation as for that keyword. If no arguments follow, the LayerList currently in scope will be used. The -k command line token does not accept a list of layer names, unlike the corresponding keyword. This must be separately specified with a -l option.

NoSkipLayers
(option: -k-)
Turn off layer skipping, if the SkipLayers directive (-k option) is currently in force. The associated LayerList remains defined.

LayerAliases name1=alias1 name2=alias2 ...
(option: -a name1=alias1 name2=alias2 ...)
This keyword provides a list a layer aliasing definitions to apply in output. The layer names can be hex-encoded pseudo-names when applicable. This is similar to the layer aliasing found in the Format Conversion panel and elsewhere. In the command line, the list must be quoted if it contains more than one entry, but this is not required in a file.

ConvertScale scale_factor
(option: -cs scale_factor)
This directive has effect only in the case where there are no Placement Blocks, and is ignored otherwise. This will scale all coordinates read from the source by the given factor, which can be in the range 0.001 through 1000.0. Thus, in output, the corresponding cell definitions will be scaled by this factor. This is similar to the Scale Placement Block directive (-s option), but applies when there are no Placement Blocks and Placement Block directive are ignored.

ToLower
(option: -tlo)
This sets a flag to indicate conversion of upper case cell names to lower case in output. Mixed-case cell names are unaffected.

NoToLower
(option: -tlo-)
Turn off lower-casing, if the ToLower directive (-tlo option) is currently in force.

ToUpper
(option: -tup)
This sets a flag to indicate conversion of lower case cell names to upper case. Mixed-case cell names are unaffected.

NoToUpper
(option: -tup-)
Turn off upper-casing, if the ToUpper directive (-tup option) is currently in force.

CellNamePrefix prefix_string
(option: -p prefix_string)
Cell name change prefix. This operation occurs after case conversion. The prefix_string is interpreted in the manner of the InCellNamePrefix variable.

CellNameSuffix suffix_string
(option: -u suffix_string)
Cell name change suffix. This operation occurs after case conversion. The suffix_string is interpreted in the manner of the InCellNameSuffix variable.


next up previous contents index
Next: Placement Blocks Up: The !assemble Command: Merge Previous: Source Blocks   Contents   Index
Stephen R. Whiteley 2024-09-29