API reference - Class PCellDeclarationNotation used in Ruby API documentation Description: A PCell declaration providing the parameters and code to produce the PCell Class hierarchy: PCellDeclaration
A PCell declaration is basically the recipe of how to create a PCell layout from a parameter set. The declaration includes
All these declarations are implemented by deriving from the PCellDeclaration class and reimplementing the specific methods. Reimplementing the display_name method is optional. The default implementation creates a name from the PCell name plus the parameters. By supplying the information about the layers it wants to create, KLayout is able to call the production callback with a defined set of the layer ID's which are already mapped to valid actual layout layers. This class has been introduced in version 0.22. Public constructors
Public methods
Deprecated methods (protected, public, static, non-static and constructors)
Detailed descriptionvoid _createDescription: Ensures the C++ object is created Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created. void _destroyDescription: Explicitly destroys the object Explicitly destroys the object on C++ side if it was owned by the script interpreter. Subsequent access to this object will throw an exception. If the object is not owned by the script, this method will do nothing. [const] bool _destroyed?Description: Returns a value indicating whether the object was already destroyed This method returns true, if the object was destroyed, either explicitly or by the C++ side. The latter may happen, if the object is owned by a C++ object which got destroyed itself. [const] bool _is_const_object?Description: Returns a value indicating whether the reference is a const reference This method returns true, if self is a const reference. In that case, only const methods may be called on self. void _manageDescription: Marks the object as managed by the script side. After calling this method on an object, the script side will be responsible for the management of the object. This method may be called if an object is returned from a C++ function and the object is known not to be owned by any C++ instance. If necessary, the script side may delete the object if the script's reference is no longer required. Usually it's not required to call this method. It has been introduced in version 0.24. void _unmanageDescription: Marks the object as no longer owned by the script side. Calling this method will make this object no longer owned by the script's memory management. Instead, the object must be managed in some other way. Usually this method may be called if it is known that some C++ object holds and manages this object. Technically speaking, this method will turn the script's reference into a weak reference. After the script engine decides to delete the reference, the object itself will still exist. If the object is not managed otherwise, memory leaks will occur. Usually it's not required to call this method. It has been introduced in version 0.24. void assign(const PCellDeclaration other)Description: Assigns another object to self [virtual,const] bool can_create_from_shape(const Layout layout,const Shape shape,unsigned int layer)Description: Returns true, if the PCell can be created from the given shape
KLayout offers a way to convert a shape into a PCell. To test whether the PCell can be created from a shape, it will call this method. If this method returns true, KLayout will use parameters_from_shape and transformation_from_shape to derive the parameters and instance transformation for the new PCell instance that will replace the shape. [virtual,const] variant[] coerce_parameters(const Layout layout,variant[] input)Description: Modifies the parameters to match the requirements
This method can be reimplemented to change the parameter set according to some constraints for example. The reimplementation may modify the parameters in a way that they are usable for the produce method. The method receives a reference to the layout so it is able to verify the parameters against layout properties. It can raise an exception to indicate that something is not correct. void createDescription: Ensures the C++ object is created Use of this method is deprecated. Use _create instead void destroyDescription: Explicitly destroys the object Use of this method is deprecated. Use _destroy instead [const] bool destroyed?Description: Returns a value indicating whether the object was already destroyed Use of this method is deprecated. Use _destroyed? instead [virtual,const] string display_text(variant[] parameters)Description: Returns the display text for this PCell given a certain parameter set Reimplement this method to create a distinct display text for a PCell variant with the given parameter set. If this method is not implemented, a default text is created. [const] new PCellDeclaration ptr dupDescription: Creates a copy of self [virtual,const] LayerInfo[] get_layers(variant[] parameters)Description: Returns a list of layer declarations Reimplement this method to return a list of layers this PCell wants to create. The layer declarations are returned as a list of LayerInfo objects which are used as match expressions to look up the layer in the actual layout. This method receives the PCell parameters which allows it to deduce layers from the parameters. [virtual,const] PCellParameterDeclaration[] get_parametersDescription: Returns a list of parameter declarations Reimplement this method to return a list of parameters used in that PCell implementation. A parameter declaration is a PCellParameterDeclaration object and defines the parameter name, type, description text and possible choices for the parameter value. [const] unsigned long idDescription: Gets the integer ID of the PCell declaration This ID is used to identify the PCell in the context of a Layout object for example [const] bool is_const_object?Description: Returns a value indicating whether the reference is a const reference Use of this method is deprecated. Use _is_const_object? instead [const] string nameDescription: Gets the name of the PCell [static] new PCellDeclaration ptr newDescription: Creates a new object of this class Python specific notes:This method is the default initializer of the object [virtual,const] variant[] parameters_from_shape(const Layout layout,const Shape shape,unsigned int layer)Description: Gets the parameters for the PCell which can replace the given shape
KLayout offers a way to convert a shape into a PCell. If can_create_from_shape returns true, it will use this method to derive the parameters for the PCell instance that will replace the shape. See also transformation_from_shape and can_create_from_shape. [virtual,const] void produce(const Layout layout,unsigned int[] layer_ids,variant[] parameters,Cell cell)Description: The production callback
Reimplement this method to provide the code that implements the PCell. The code is supposed to create the layout in the target cell using the provided parameters and the layers passed in the layer_ids list. [virtual,const] Trans transformation_from_shape(const Layout layout,const Shape shape,unsigned int layer)Description: Gets the instance transformation for the PCell which can replace the given shape
KLayout offers a way to convert a shape into a PCell. If can_create_from_shape returns true, it will use this method to derive the transformation for the PCell instance that will replace the shape. See also parameters_from_shape and can_create_from_shape. |