deNew

deNew( 
[ l_fileSpec ] 
[ g_winSpec ] 
[ t_accessMode ] 
[ t_appName ] 
) 
=> w_windowId / nil

Description

Creates a new cellview and opens it in a window.

If the library name, cell name, view name, and cellview type are not specified in l_fileSpec, or if l_fileSpec is not specified, the New File form opens, partially filled out with the information specified in l_fileSpec. The New File form requires a library name, cell name, view name, and application.

The following environment variables set the defaults for the New File form:

graphic defaultNewCellName
graphic defaultNewLibName
graphic defaultNewViewName
graphic defaultOpenCellName
graphic defaultOpenLibName
graphic defaultOpenViewName
graphic defaultToolName 
graphic viewNameToTypeList

The environment variable graphic viewNameToTypeList maps view names to view types in the New File form. This variable contains the user’s mappings, which are in addition to, and take precedence over, the built-in mappings (listed below). This variable is automatically updated (in memory) each time a new viewName/viewType is used. You can save new mappings with the Options – Save Defaults command.

The view name to view type mapping is stored in memory and the view type-to-tool-mapping is stored in the registry.

When you enter a view name, the view names to view type mapping is used to determine the view type and then the registry is used to set the tool cyclic. When a tool is chosen, the registry is read to determine the view type and then the view name to view type mapping is used to set the view name.

This automatic setting of tool or view name happens until you manually change the updated field. This means if you choose a tool and then change the view name, the tool is not changed and vice-versa.

If you enter a new view name which does not yet map to a view type a dialog box appears that lets you select another tool or keep the current one.

The following are the built-in view name to view type mappings:

      Name                    Type

( "abstract"              "maskLayout"            )
( "cmos.sch"              "schematic"         )
( "compacted"             "maskLayout"         )
( "extracted"             "maskLayout"         )
( "layout"                "maskLayout"         )
( "schematic"             "schematic"         )
( "symbol"                "schematicSymbol"         )
( "symbolic"              "maskLayout"         )
( "config"                "config"         )

The following are the built-in view type to view name mappings:

      Type                       Name

( "schematic"                 "schematic"       )
( "maskLayout"                "layout"       )
( "schematicSymbol"           "symbol"       )
( "config"                    "config"       )

If a configuration cellview is given as an argument, a SKILL symbol named 'hierEditor is returned. The value of hierEditor is as follows:

When a configuration cellview is opened in the hierarchy editor, the value of hierEditor is t. If a cellview is not open or fails to open, the value of hierEditor is nil.

When opening a new configuration cellview the matching top level schematic is not defined so it is not possible to return a window ID for the value of 'hierEditor.

The API also stores the history for all new cellviews.

Arguments

l_fileSpec	Symbol with the following property list:
	libName is the library name
	cellName is the cell name
	viewName is the view name
	viewType is the type of data in view directory. To view a list of valid values, enter deGetAllViewTypes() in the CIW.
	accessMode is the access mode. Valid values: "a" (edit), "r" (read), and "w" clears the old data and edit from scratch.
g_winSpec	Creates a window.
	The valid values are:
	nil creates window using .Xdefaults
	interactive creates a window letting user specify location
	l_bBox creates a window using l_bBox as screenBox
	w_window use w_window
t_accessMode	File access mode. Should be "w" to allow editing, start from scratch.
t_appName	Overrides default application if supplied. To view a list of valid values, enter deGetAppInfo viewType in the CIW.

Value Returned

w_windowId	The ID of the window that opened.
nil	No window opened.

Examples

Opens a mask layout window for editing that contains the layout view of the cell called top from the test library. Returns the ID of the window.

deNew(list(nil 
?libName "test" 
?cellName "top" 
?viewName "layout" 
?viewType "maskLayout"))

Return to top