|
HAL
v4.5.0-283-g3f42a39fa
The Hardware Analyzer - a comprehensive reverse engineering and manipulation framework for gate-level netlists.
|
#include </home/runner/work/hal/hal/plugins/clock_tree_viewer/include/clock_tree_viewer/clock_tree_viewer.h>


Public Member Functions | |
| ClockTreeViewer (QWidget *parent=nullptr) | |
| ~ClockTreeViewer () override | |
| void | setupToolbar (Toolbar *toolbar) override |
| bool | savePicture (const QString &filename) |
| const QSet< u32 > & | highlightedGates () const |
Public Member Functions inherited from hal::ExternalContentWidget | |
| ExternalContentWidget (const QString &pluginName, const QString &windowName, QWidget *parent=nullptr) | |
| virtual | ~ExternalContentWidget () |
| QString | pluginName () const |
Public Member Functions inherited from hal::ContentWidget | |
| ContentWidget (QString name, QWidget *parent=nullptr) | |
| virtual QList< QShortcut * > | createShortcuts () |
| void | ensureShortcuts () |
| void | repolish () |
| QString | name () const |
| QIcon | icon () const |
| void | setAnchor (ContentAnchor *anchor) |
| void | setIcon (QIcon icon) |
| void | set_name (const QString &name) |
| QString | iconStyle () |
| QString | iconPath () |
| void | setIconStyle (const QString &style) |
| void | setIconPath (const QString &path) |
Public Member Functions inherited from hal::Widget | |
| Widget (QWidget *parent=nullptr) | |
| void | setParent (QWidget *parent) |
Public Member Functions inherited from QWidget | |
| QWidget (QWidget *parent, Qt::WindowFlags f) | |
| virtual | ~QWidget () |
| WId | winId () const const |
| WId | effectiveWinId () const const |
| QStyle * | style () const const |
| void | setStyle (QStyle *style) |
| bool | isTopLevel () const const |
| bool | isWindow () const const |
| bool | isModal () const const |
| Qt::WindowModality | windowModality () const const |
| void | setWindowModality (Qt::WindowModality windowModality) |
| bool | isEnabled () const const |
| bool | isEnabledTo (const QWidget *ancestor) const const |
| bool | isEnabledToTLW () const const |
| void | setEnabled (bool) |
| void | setDisabled (bool disable) |
| void | setWindowModified (bool) |
| QRect | frameGeometry () const const |
| const QRect & | geometry () const const |
| QRect | normalGeometry () const const |
| int | x () const const |
| int | y () const const |
| QPoint | pos () const const |
| QSize | frameSize () const const |
| QSize | size () const const |
| int | width () const const |
| int | height () const const |
| QRect | rect () const const |
| QRect | childrenRect () const const |
| QRegion | childrenRegion () const const |
| QSize | minimumSize () const const |
| QSize | maximumSize () const const |
| int | minimumWidth () const const |
| int | minimumHeight () const const |
| int | maximumWidth () const const |
| int | maximumHeight () const const |
| void | setMinimumSize (const QSize &) |
| void | setMinimumSize (int minw, int minh) |
| void | setMaximumSize (const QSize &) |
| void | setMaximumSize (int maxw, int maxh) |
| void | setMinimumWidth (int minw) |
| void | setMinimumHeight (int minh) |
| void | setMaximumWidth (int maxw) |
| void | setMaximumHeight (int maxh) |
| void | setupUi (QWidget *widget) |
| QSize | sizeIncrement () const const |
| void | setSizeIncrement (const QSize &) |
| void | setSizeIncrement (int w, int h) |
| QSize | baseSize () const const |
| void | setBaseSize (const QSize &) |
| void | setBaseSize (int basew, int baseh) |
| void | setFixedSize (const QSize &s) |
| void | setFixedSize (int w, int h) |
| void | setFixedWidth (int w) |
| void | setFixedHeight (int h) |
| QPoint | mapToGlobal (const QPoint &pos) const const |
| QPoint | mapFromGlobal (const QPoint &pos) const const |
| QPoint | mapToParent (const QPoint &pos) const const |
| QPoint | mapFromParent (const QPoint &pos) const const |
| QPoint | mapTo (const QWidget *parent, const QPoint &pos) const const |
| QPoint | mapFrom (const QWidget *parent, const QPoint &pos) const const |
| QWidget * | window () const const |
| QWidget * | nativeParentWidget () const const |
| QWidget * | topLevelWidget () const const |
| const QPalette & | palette () const const |
| void | setPalette (const QPalette &) |
| void | setBackgroundRole (QPalette::ColorRole role) |
| QPalette::ColorRole | backgroundRole () const const |
| void | setForegroundRole (QPalette::ColorRole role) |
| QPalette::ColorRole | foregroundRole () const const |
| const QFont & | font () const const |
| void | setFont (const QFont &) |
| QFontMetrics | fontMetrics () const const |
| QFontInfo | fontInfo () const const |
| QCursor | cursor () const const |
| void | setCursor (const QCursor &) |
| void | unsetCursor () |
| void | setMouseTracking (bool enable) |
| bool | hasMouseTracking () const const |
| bool | underMouse () const const |
| void | setTabletTracking (bool enable) |
| bool | hasTabletTracking () const const |
| void | setMask (const QBitmap &bitmap) |
| void | setMask (const QRegion ®ion) |
| QRegion | mask () const const |
| void | clearMask () |
| void | render (QPaintDevice *target, const QPoint &targetOffset, const QRegion &sourceRegion, QWidget::RenderFlags renderFlags) |
| void | render (QPainter *painter, const QPoint &targetOffset, const QRegion &sourceRegion, QWidget::RenderFlags renderFlags) |
| QPixmap | grab (const QRect &rectangle) |
| QGraphicsEffect * | graphicsEffect () const const |
| void | setGraphicsEffect (QGraphicsEffect *effect) |
| void | grabGesture (Qt::GestureType gesture, Qt::GestureFlags flags) |
| void | ungrabGesture (Qt::GestureType gesture) |
| void | setWindowTitle (const QString &) |
| void | setStyleSheet (const QString &styleSheet) |
| QString | styleSheet () const const |
| QString | windowTitle () const const |
| void | setWindowIcon (const QIcon &icon) |
| QIcon | windowIcon () const const |
| void | setWindowIconText (const QString &) |
| QString | windowIconText () const const |
| void | setWindowRole (const QString &role) |
| QString | windowRole () const const |
| void | setWindowFilePath (const QString &filePath) |
| QString | windowFilePath () const const |
| void | setWindowOpacity (qreal level) |
| qreal | windowOpacity () const const |
| bool | isWindowModified () const const |
| void | setToolTip (const QString &) |
| QString | toolTip () const const |
| void | setToolTipDuration (int msec) |
| int | toolTipDuration () const const |
| void | setStatusTip (const QString &) |
| QString | statusTip () const const |
| void | setWhatsThis (const QString &) |
| QString | whatsThis () const const |
| QString | accessibleName () const const |
| void | setAccessibleName (const QString &name) |
| QString | accessibleDescription () const const |
| void | setAccessibleDescription (const QString &description) |
| void | setLayoutDirection (Qt::LayoutDirection direction) |
| Qt::LayoutDirection | layoutDirection () const const |
| void | unsetLayoutDirection () |
| void | setLocale (const QLocale &locale) |
| QLocale | locale () const const |
| void | unsetLocale () |
| void | setFocus () |
| bool | isActiveWindow () const const |
| void | activateWindow () |
| void | clearFocus () |
| void | setFocus (Qt::FocusReason reason) |
| Qt::FocusPolicy | focusPolicy () const const |
| void | setFocusPolicy (Qt::FocusPolicy policy) |
| bool | hasFocus () const const |
| void | setFocusProxy (QWidget *w) |
| QWidget * | focusProxy () const const |
| Qt::ContextMenuPolicy | contextMenuPolicy () const const |
| void | setContextMenuPolicy (Qt::ContextMenuPolicy policy) |
| void | grabMouse () |
| void | grabMouse (const QCursor &cursor) |
| void | releaseMouse () |
| void | grabKeyboard () |
| void | releaseKeyboard () |
| int | grabShortcut (const QKeySequence &key, Qt::ShortcutContext context) |
| void | releaseShortcut (int id) |
| void | setShortcutEnabled (int id, bool enable) |
| void | setShortcutAutoRepeat (int id, bool enable) |
| bool | updatesEnabled () const const |
| void | setUpdatesEnabled (bool enable) |
| QGraphicsProxyWidget * | graphicsProxyWidget () const const |
| void | update () |
| void | repaint () |
| void | update (int x, int y, int w, int h) |
| void | update (const QRect &rect) |
| void | update (const QRegion &rgn) |
| void | repaint (int x, int y, int w, int h) |
| void | repaint (const QRect &rect) |
| void | repaint (const QRegion &rgn) |
| virtual void | setVisible (bool visible) |
| void | setHidden (bool hidden) |
| void | show () |
| void | hide () |
| void | showMinimized () |
| void | showMaximized () |
| void | showFullScreen () |
| void | showNormal () |
| bool | close () |
| void | raise () |
| void | lower () |
| void | stackUnder (QWidget *w) |
| void | move (int x, int y) |
| void | move (const QPoint &) |
| void | resize (int w, int h) |
| void | resize (const QSize &) |
| void | setGeometry (int x, int y, int w, int h) |
| void | setGeometry (const QRect &) |
| QByteArray | saveGeometry () const const |
| bool | restoreGeometry (const QByteArray &geometry) |
| void | adjustSize () |
| bool | isVisible () const const |
| bool | isVisibleTo (const QWidget *ancestor) const const |
| bool | isHidden () const const |
| bool | isMinimized () const const |
| bool | isMaximized () const const |
| bool | isFullScreen () const const |
| Qt::WindowStates | windowState () const const |
| void | setWindowState (Qt::WindowStates windowState) |
| virtual QSize | sizeHint () const const |
| virtual QSize | minimumSizeHint () const const |
| QSizePolicy | sizePolicy () const const |
| void | setSizePolicy (QSizePolicy) |
| void | setSizePolicy (QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical) |
| virtual int | heightForWidth (int w) const const |
| virtual bool | hasHeightForWidth () const const |
| QRegion | visibleRegion () const const |
| void | setContentsMargins (int left, int top, int right, int bottom) |
| void | setContentsMargins (const QMargins &margins) |
| void | getContentsMargins (int *left, int *top, int *right, int *bottom) const const |
| QMargins | contentsMargins () const const |
| QRect | contentsRect () const const |
| QLayout * | layout () const const |
| void | setLayout (QLayout *layout) |
| void | updateGeometry () |
| void | setParent (QWidget *parent) |
| void | setParent (QWidget *parent, Qt::WindowFlags f) |
| void | scroll (int dx, int dy) |
| void | scroll (int dx, int dy, const QRect &r) |
| QWidget * | focusWidget () const const |
| QWidget * | nextInFocusChain () const const |
| QWidget * | previousInFocusChain () const const |
| bool | acceptDrops () const const |
| void | setAcceptDrops (bool on) |
| void | addAction (QAction *action) |
| void | addActions (QList< QAction * > actions) |
| void | insertActions (QAction *before, QList< QAction * > actions) |
| void | insertAction (QAction *before, QAction *action) |
| void | removeAction (QAction *action) |
| QList< QAction * > | actions () const const |
| QWidget * | parentWidget () const const |
| void | setWindowFlags (Qt::WindowFlags type) |
| Qt::WindowFlags | windowFlags () const const |
| void | setWindowFlag (Qt::WindowType flag, bool on) |
| void | overrideWindowFlags (Qt::WindowFlags flags) |
| Qt::WindowType | windowType () const const |
| QWidget * | childAt (int x, int y) const const |
| QWidget * | childAt (const QPoint &p) const const |
| void | setAttribute (Qt::WidgetAttribute attribute, bool on) |
| bool | testAttribute (Qt::WidgetAttribute attribute) const const |
| virtual QPaintEngine * | paintEngine () const const override |
| void | ensurePolished () const const |
| bool | isAncestorOf (const QWidget *child) const const |
| bool | hasEditFocus () const const |
| void | setEditFocus (bool enable) |
| bool | autoFillBackground () const const |
| void | setAutoFillBackground (bool enabled) |
| QBackingStore * | backingStore () const const |
| QWindow * | windowHandle () const const |
| QScreen * | screen () const const |
| void | windowTitleChanged (const QString &title) |
| void | windowIconChanged (const QIcon &icon) |
| void | windowIconTextChanged (const QString &iconText) |
| void | customContextMenuRequested (const QPoint &pos) |
| virtual QVariant | inputMethodQuery (Qt::InputMethodQuery query) const const |
| Qt::InputMethodHints | inputMethodHints () const const |
| void | setInputMethodHints (Qt::InputMethodHints hints) |
| QWIDGETSIZE_MAX QWIDGETSIZE_MAX | |
Public Member Functions inherited from QObject | |
| virtual const QMetaObject * | metaObject () const const |
| QObject (QObject *parent) | |
| virtual | ~QObject () |
| virtual bool | eventFilter (QObject *watched, QEvent *event) |
| QString | objectName () const const |
| void | setObjectName (const QString &name) |
| bool | isWidgetType () const const |
| bool | isWindowType () const const |
| bool | signalsBlocked () const const |
| bool | blockSignals (bool block) |
| QThread * | thread () const const |
| void | moveToThread (QThread *targetThread) |
| int | startTimer (int interval, Qt::TimerType timerType) |
| int | startTimer (std::chrono::milliseconds time, Qt::TimerType timerType) |
| void | killTimer (int id) |
| T | findChild (const QString &name, Qt::FindChildOptions options) const const |
| QList< T > | findChildren (const QString &name, Qt::FindChildOptions options) const const |
| QList< T > | findChildren (const QRegExp ®Exp, Qt::FindChildOptions options) const const |
| QList< T > | findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const |
| const QObjectList & | children () const const |
| void | setParent (QObject *parent) |
| void | installEventFilter (QObject *filterObj) |
| void | removeEventFilter (QObject *obj) |
| QMetaObject::Connection | connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const |
| bool | disconnect (const char *signal, const QObject *receiver, const char *method) const const |
| bool | disconnect (const QObject *receiver, const char *method) const const |
| void | dumpObjectTree () |
| void | dumpObjectInfo () |
| void | dumpObjectTree () const const |
| void | dumpObjectInfo () const const |
| bool | setProperty (const char *name, const QVariant &value) |
| QVariant | property (const char *name) const const |
| QList< QByteArray > | dynamicPropertyNames () const const |
| void | destroyed (QObject *obj) |
| void | objectNameChanged (const QString &objectName) |
| QObject * | parent () const const |
| bool | inherits (const char *className) const const |
| void | deleteLater () |
| Q_DISABLE_COPY (Class) | |
| Q_DISABLE_MOVE (Class) | |
| Q_DISABLE_COPY_MOVE (Class) | |
| T | qobject_cast (QObject *object) |
| T | qobject_cast (const QObject *object) |
| T | qFindChild (const QObject *obj, const QString &name) |
| QList< T > | qFindChildren (const QObject *obj, const QString &name) |
| QList< T > | qFindChildren (const QObject *obj, const QRegExp ®Exp) |
| Q_CLASSINFO (Name, Value) | |
| Q_INTERFACES (...) | |
| Q_PROPERTY (...) | |
| Q_ENUMS (...) | |
| Q_FLAGS (...) | |
| Q_ENUM (...) | |
| Q_FLAG (...) | |
| Q_ENUM_NS (...) | |
| Q_FLAG_NS (...) | |
| Q_OBJECT Q_OBJECT | |
| Q_GADGET Q_GADGET | |
| Q_NAMESPACE Q_NAMESPACE | |
| Q_NAMESPACE_EXPORT (EXPORT_MACRO) | |
| Q_SIGNALS Q_SIGNALS | |
| Q_SIGNAL Q_SIGNAL | |
| Q_SLOTS Q_SLOTS | |
| Q_SLOT Q_SLOT | |
| Q_EMIT Q_EMIT | |
| Q_INVOKABLE Q_INVOKABLE | |
| Q_REVISION Q_REVISION | |
| Q_SET_OBJECT_NAME (Object) | |
| QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT | |
Public Member Functions inherited from QPaintDevice | |
| virtual | ~QPaintDevice () |
| bool | paintingActive () const const |
| int | width () const const |
| int | height () const const |
| int | widthMM () const const |
| int | heightMM () const const |
| int | logicalDpiX () const const |
| int | logicalDpiY () const const |
| int | physicalDpiX () const const |
| int | physicalDpiY () const const |
| int | devicePixelRatio () const const |
| qreal | devicePixelRatioF () const const |
| int | colorCount () const const |
| int | depth () const const |
Static Public Member Functions | |
| static ClockTreeViewer * | instance () |
| static bool | setClockTree (const cte::ClockTree &tree, const ctv::StyleOverrides &overrides=ctv::StyleOverrides(), const std::optional< std::string > &x_key=ctv::DEFAULT_X_KEY, const std::optional< std::string > &y_key=ctv::DEFAULT_Y_KEY) |
| static std::size_t | highlightGates (const std::vector< u32 > &gateIds) |
Static Public Member Functions inherited from QWidget | |
| void | setTabOrder (QWidget *first, QWidget *second) |
| QWidget * | mouseGrabber () |
| QWidget * | keyboardGrabber () |
| QWidget * | find (WId id) |
| QWidget * | createWindowContainer (QWindow *window, QWidget *parent, Qt::WindowFlags flags) |
Static Public Member Functions inherited from QObject | |
| QString | tr (const char *sourceText, const char *disambiguation, int n) |
| QString | trUtf8 (const char *sourceText, const char *disambiguation, int n) |
| QMetaObject::Connection | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type) |
| QMetaObject::Connection | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type) |
| QMetaObject::Connection | connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type) |
| QMetaObject::Connection | connect (const QObject *sender, PointerToMemberFunction signal, Functor functor) |
| QMetaObject::Connection | connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type) |
| bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method) |
| bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method) |
| bool | disconnect (const QMetaObject::Connection &connection) |
| bool | disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method) |
Static Public Attributes | |
| static constexpr auto | sPluginName = "clock_tree_viewer" |
The content widget that plots a clock tree at the coordinates of its gates.
The plot is in the colors of HAL, as in the graph view. The background and the lines follow the theme. A gate has the color of the module it belongs to, the color of its grouping if it is in one, or the color of a selected item if it is highlighted, in that order of precedence. The plot follows all of them when they change.
Gates are highlighted by the color of a selected item and by a ring around them, which has the same size on the screen at every zoom. The gates that are selected in HAL are highlighted, as far as they are in the plot, and the highlight follows the selection. This goes one way only, from the netlist to the viewer: nothing done in the viewer changes the selection in HAL. Scripts can highlight gates, too, see highlightGates.
The viewer does not keep the clock tree it is given: it copies what it draws, so it stays valid when the clock tree or its netlist is gone.
Definition at line 78 of file clock_tree_viewer.h.
|
explicit |
Construct a new clock tree viewer, which shows nothing yet.
| [in] | parent | - The parent widget. Defaults to a nullptr. |
Definition at line 182 of file clock_tree_viewer.cpp.
References QStatusBar::addPermanentWidget(), QStackedWidget::addWidget(), QStatusBar::addWidget(), QBoxLayout::addWidget(), Qt::AlignCenter, QObject::connect(), hal::ClockTreeGraphicsView::coordinatesChanged(), hal::FileManager::fileAboutToClose(), hal::FileManager::get_instance(), hal::NetlistRelay::getModuleColorManager(), hal::gui_utility::getStyledSvgIcon(), hal::gNetlistRelay, hal::NetlistRelay::groupingColorChanged(), hal::NetlistRelay::groupingGateAssigned(), hal::NetlistRelay::groupingGateRemoved(), hal::NetlistRelay::groupingRemoved(), hal::gSelectionRelay, QWidget::hide(), hal::SettingsItemDropdown::intChanged(), hal::ContentWidget::mContentLayout, hal::ModuleColorManager::moduleColorChanged(), hal::NetlistRelay::moduleGateAssigned(), hal::NetlistRelay::moduleGateRemoved(), hal::ContentWidget::name(), hal::SelectionRelay::selectionChanged(), QLabel::setAlignment(), QAction::setIcon(), QTimer::setInterval(), QLabel::setMargin(), QTimer::setSingleShot(), QAction::setToolTip(), QLabel::setWordWrap(), hal::MainWindow::sSettingStyle, QTimer::timeout(), and QAction::triggered().
|
override |
Destroy the viewer. An extraction that is still running is waited for, since it reads the netlist.
Definition at line 279 of file clock_tree_viewer.cpp.
References QGuiApplication::restoreOverrideCursor().
Get the IDs of the gates that are highlighted. Must be called from the GUI thread.
Definition at line 163 of file clock_tree_viewer.h.
|
static |
Highlight gates in the plot of the viewer that is open, instead of the ones that were highlighted before. Gates that are not in the plot are ignored, as are those that are in the clock tree but have no coordinates, so cannot be drawn. The highlight is replaced as soon as the selection in HAL changes. Can be called from any thread, see setClockTree.
| [in] | gateIds | - The IDs of the gates. Pass none to remove the highlight. |
Definition at line 589 of file clock_tree_viewer.cpp.
References log_info.
Referenced by hal::PYBIND11_PLUGIN().
|
static |
Get the clock tree viewer that is currently open. Must be called from the GUI thread, which may delete the viewer at any time between two of its events: other threads use the static functions below instead.
nullptr if none is open. Definition at line 289 of file clock_tree_viewer.cpp.
References hal::ExternalContent::instance(), hal::ExternalContent::openWidgets, and sPluginName.
| bool hal::ClockTreeViewer::savePicture | ( | const QString & | filename | ) |
Save a picture of the whole clock tree that is displayed, independent of the zoom and the size of the window. Must be called from the GUI thread.
| [in] | filename | - The file to write. The suffix decides the format, e.g. .png. |
true on success, false otherwise. Definition at line 624 of file clock_tree_viewer.cpp.
References hal::Error::get(), hal::Result< T >::get(), hal::Result< T >::get_error(), hal::Result< T >::is_error(), log_error, log_info, hal::ClockTreeScene::renderPicture(), and QString::toStdString().
|
static |
Plot a clock tree in the viewer that is open. Can be called from any thread: the viewer is looked up in the GUI thread, and the call waits until the plot is shown there.
The gates are drawn at their coordinates, see ctv::build_layout, the sizes of the drawing follow from them unless provided. If no gate has coordinates, nothing is drawn and the error is shown instead. If only some have none, those are left out and a warning is shown. A clock tree of another netlist than the one that is open is not drawn either, since its gates cannot be matched to those HAL colors and selects.
The sizes and coordinate keys of the clock tree that is drawn are kept: extracting a clock tree with the button in the toolbar uses them again.
| [in] | tree | - The clock tree. |
| [in] | overrides | - The sizes of the drawing. Whatever is not provided is derived from the coordinates. |
| [in] | x_key | - The name of the parameter that holds the x-coordinate, or std::nullopt to use the location. Defaults to ctv::DEFAULT_X_KEY. |
| [in] | y_key | - The name of the parameter that holds the y-coordinate, or std::nullopt to use the location. Defaults to ctv::DEFAULT_Y_KEY. |
true if the clock tree is drawn, false otherwise, e.g., if no viewer is open. Definition at line 303 of file clock_tree_viewer.cpp.
References hal::gNetlist, QWidget::layout(), and hal::Widget::shown().
Referenced by hal::PYBIND11_PLUGIN().
|
overridevirtual |
Add the actions of the viewer to the given toolbar.
| [in] | toolbar | - The toolbar to add the actions to. |
Reimplemented from hal::ContentWidget.
Definition at line 295 of file clock_tree_viewer.cpp.
References QToolBar::addAction().
|
staticconstexpr |
The name of the plugin the viewer belongs to.
Definition at line 84 of file clock_tree_viewer.h.
Referenced by instance().