1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336
|
/*
quickscenecontrolwidget.cpp
This file is part of GammaRay, the Qt application inspection and manipulation tool.
SPDX-FileCopyrightText: 2014 Klarälvdalens Datakonsult AB, a KDAB Group company <info@kdab.com>
Author: Christoph Sterz <christoph.sterz@kdab.com>
SPDX-License-Identifier: GPL-2.0-or-later
Contact KDAB at <info@kdab.com> for commercial licensing options.
*/
#include "quickscenecontrolwidget.h"
#include "quickoverlaylegend.h"
#include "quickscenepreviewwidget.h"
#include "gridsettingswidget.h"
#include <ui/uiresources.h>
#include <QAction>
#include <QActionGroup>
#include <QComboBox>
#include <QLabel>
#include <QMenu>
#include <QToolBar>
#include <QToolButton>
#include <QVBoxLayout>
#include <QWidgetAction>
using namespace GammaRay;
namespace {
static QAction *checkedAction(QActionGroup *group)
{
// For some reason QActionGroup::checkedAction() is not yet synced when needed
// Might be because of our direct QAction::setChecked() calls in between
foreach (QAction *action, group->actions()) {
if (action->isChecked())
return action;
}
return nullptr;
}
}
QuickSceneControlWidget::QuickSceneControlWidget(QuickInspectorInterface *inspector, QWidget *parent)
: QWidget(parent)
, m_gridSettingsWidget(new GridSettingsWidget) // Owned by the QWidgetAction
, m_legendTool(new QuickOverlayLegend(this))
, m_inspectorInterface(inspector)
{
m_layout = new QVBoxLayout(this);
m_layout->setContentsMargins(QMargins());
m_previewWidget = new QuickScenePreviewWidget(this, this);
m_toolBar = new QToolBar(this);
m_toolBar->setAutoFillBackground(true);
// Our icons are 16x16 and support hidpi, so let force iconSize on every styles
m_toolBar->setIconSize(QSize(16, 16));
m_toolBar->setToolButtonStyle(Qt::ToolButtonIconOnly);
m_visualizeGroup = new QActionGroup(this);
m_visualizeGroup->setExclusive(false); // we need 0 or 1 selected, not exactly 1
m_visualizeClipping = new QAction(UIResources::themedIcon(QLatin1String("visualize-clipping.png")),
tr("Visualize Clipping"),
this);
m_visualizeClipping->setObjectName("aVisualizeClipping");
m_visualizeClipping->setActionGroup(m_visualizeGroup);
m_visualizeClipping->setData(QuickInspectorInterface::VisualizeClipping);
m_visualizeClipping->setCheckable(true);
m_visualizeClipping->setToolTip(tr("<b>Visualize Clipping</b><br/>"
"Items with the property <i>clip</i> set to true, will cut off their and their "
"children's rendering at the items' bounds. While this is a handy feature it "
"comes with quite some cost, like disabling some performance optimizations.<br/>"
"With this tool enabled the QtQuick renderer highlights items, that have clipping "
"enabled, so you can check for items, that have clipping enabled unnecessarily. "));
m_visualizeOverdraw = new QAction(UIResources::themedIcon(QLatin1String("visualize-overdraw.png")),
tr("Visualize Overdraw"),
this);
m_visualizeOverdraw->setObjectName("aVisualizeOverdraw");
m_visualizeOverdraw->setActionGroup(m_visualizeGroup);
m_visualizeOverdraw->setData(QuickInspectorInterface::VisualizeOverdraw);
m_visualizeOverdraw->setCheckable(true);
m_visualizeOverdraw->setToolTip(tr("<b>Visualize Overdraw</b><br/>"
"The QtQuick renderer doesn't detect if an item is obscured by another "
"opaque item, is completely outside the scene or outside a clipped ancestor and "
"thus doesn't need to be rendered. You thus need to take care of setting "
"<i>visible: false</i> for hidden items, yourself.<br/>"
"With this tool enabled the QtQuick renderer draws a 3D-Box visualizing the "
"layers of items that are drawn."));
m_visualizeBatches = new QAction(UIResources::themedIcon(QLatin1String("visualize-batches.png")),
tr("Visualize Batches"), this);
m_visualizeBatches->setObjectName("aVisualizeBatches");
m_visualizeBatches->setActionGroup(m_visualizeGroup);
m_visualizeBatches->setData(QuickInspectorInterface::VisualizeBatches);
m_visualizeBatches->setCheckable(true);
m_visualizeBatches->setToolTip(tr("<b>Visualize Batches</b><br/>"
"Where a traditional 2D API, such as QPainter, Cairo or Context2D, is written to "
"handle thousands of individual draw calls per frame, OpenGL is a pure hardware "
"API and performs best when the number of draw calls is very low and state "
"changes are kept to a minimum. Therefore the QtQuick renderer combines the "
"rendering of similar items into single batches.<br/>"
"Some settings (like <i>clip: true</i>) will cause the batching to fail, though, "
"causing items to be rendered separately. With this tool enabled the QtQuick "
"renderer visualizes those batches, by drawing all items that are batched using "
"the same color. The fewer colors you see in this mode the better."));
m_visualizeChanges = new QAction(UIResources::themedIcon(QLatin1String("visualize-changes.png")),
tr("Visualize Changes"), this);
m_visualizeChanges->setObjectName("aVisualizeChanges");
m_visualizeChanges->setActionGroup(m_visualizeGroup);
m_visualizeChanges->setData(QuickInspectorInterface::VisualizeChanges);
m_visualizeChanges->setCheckable(true);
m_visualizeChanges->setToolTip(tr("<b>Visualize Changes</b><br>"
"The QtQuick scene is only repainted, if some item changes in a visual manner. "
"Unnecessary repaints can have a bad impact on the performance. With this tool "
"enabled, the QtQuick renderer will thus on each repaint highlight the item(s), "
"that caused the repaint."));
m_visualizeTraces = new QAction(UIResources::themedIcon(QLatin1String("visualize-traces.png")),
tr("Visualize Controls"), this);
m_visualizeTraces->setObjectName("aVisualizeTraces");
m_visualizeTraces->setActionGroup(m_visualizeGroup);
m_visualizeTraces->setData(QuickInspectorInterface::VisualizeTraces);
m_visualizeTraces->setCheckable(true);
m_visualizeTraces->setToolTip(tr("<b>Visualize Controls</b><br>"
"The QtQuick scene is rendered normally, in addition overlays will "
"highlight Qt Quick Controls."));
m_serverSideDecorationsEnabled = new QAction(UIResources::themedIcon(QLatin1String("server-decorations.png")),
tr("Decorate Target"), this);
m_serverSideDecorationsEnabled->setObjectName("aServerSideDecorationsEnabled");
m_serverSideDecorationsEnabled->setCheckable(true);
m_serverSideDecorationsEnabled->setToolTip(tr("<b>Decorate Target</b><br>"
"This enables diagnostic decorations on the target application, "
"such as anchor and layout information, helper grids or control overlays."));
auto *gridSettingsAction = new QWidgetAction(this);
gridSettingsAction->setObjectName("aGridSettingsAction");
gridSettingsAction->setDefaultWidget(m_gridSettingsWidget);
m_gridSettingsMenu = new QMenu(tr("Layout Grid"), this);
m_gridSettingsMenu->setObjectName("mLayoutGrid");
m_gridSettingsMenu->menuAction()->setObjectName("aLayoutGrid");
m_gridSettingsMenu->setIcon(UIResources::themedIcon(QLatin1String("grid-settings.png")));
m_gridSettingsMenu->setToolTip(tr("<b>Layout Grid</b><br>"
"Configure the layout helper grid."));
m_gridSettingsMenu->setToolTipsVisible(true);
m_gridSettingsMenu->addAction(gridSettingsAction);
#if defined(Q_OS_MAC)
// Workaround QTBUG-60424
connect(m_gridSettingsMenu, &QMenu::aboutToShow,
m_gridSettingsWidget, static_cast<void (QWidget::*)()>(&QWidget::update));
#endif
m_toolBar->addActions(m_visualizeGroup->actions());
connect(m_visualizeGroup, &QActionGroup::triggered, this,
&QuickSceneControlWidget::visualizeActionTriggered);
m_toolBar->addSeparator();
m_toolBar->addActions(m_previewWidget->interactionModeActions()->actions());
m_toolBar->addSeparator();
m_toolBar->addAction(m_serverSideDecorationsEnabled);
connect(m_serverSideDecorationsEnabled, &QAction::triggered, this,
&QuickSceneControlWidget::serverSideDecorationsTriggered);
m_toolBar->addSeparator();
m_toolBar->addAction(m_previewWidget->zoomOutAction());
m_zoomCombobox = new QComboBox(this);
m_zoomCombobox->setModel(m_previewWidget->zoomLevelModel());
// macOS and some platforms expect to use *small* controls in such small toolbar
m_zoomCombobox->setAttribute(Qt::WA_MacSmallSize);
connect(m_zoomCombobox, static_cast<void (QComboBox::*)(int)>(&QComboBox::currentIndexChanged),
m_previewWidget, &RemoteViewWidget::setZoomLevel);
connect(m_previewWidget, &RemoteViewWidget::zoomLevelChanged, m_zoomCombobox,
&QComboBox::setCurrentIndex);
m_zoomCombobox->setCurrentIndex(m_previewWidget->zoomLevelIndex());
QAction *zoomComboBox = m_toolBar->addWidget(m_zoomCombobox);
zoomComboBox->setObjectName("aZoomComboBox");
m_toolBar->addAction(m_previewWidget->zoomInAction());
connect(m_gridSettingsWidget, &GridSettingsWidget::enabledChanged, this, &QuickSceneControlWidget::gridEnabledChanged);
connect(m_gridSettingsWidget, &GridSettingsWidget::offsetChanged, this, &QuickSceneControlWidget::gridOffsetChanged);
connect(m_gridSettingsWidget, &GridSettingsWidget::cellSizeChanged, this, &QuickSceneControlWidget::gridCellSizeChanged);
setMinimumWidth(std::max(minimumWidth(), m_toolBar->sizeHint().width()));
m_layout->setMenuBar(m_toolBar);
m_layout->addWidget(m_previewWidget);
connect(m_previewWidget, &RemoteViewWidget::stateChanged, this, &QuickSceneControlWidget::stateChanged);
auto *menuSeparator = new QAction(this);
menuSeparator->setSeparator(true);
addActions(m_toolBar->actions()
<< menuSeparator
<< m_legendTool->visibilityAction()
<< m_gridSettingsMenu->menuAction());
}
void QuickSceneControlWidget::resizeEvent(QResizeEvent *e)
{
m_toolBar->setGeometry(0, 0, width(), m_toolBar->sizeHint().height());
QWidget::resizeEvent(e);
}
void QuickSceneControlWidget::visualizeActionTriggered(QAction *current)
{
if (!current || !current->isChecked()) {
m_inspectorInterface->setCustomRenderMode(QuickInspectorInterface::NormalRendering);
} else {
// QActionGroup requires exactly one selected, but we need 0 or 1 selected
foreach (auto action, m_visualizeGroup->actions()) {
if (action != current)
action->setChecked(false);
}
m_inspectorInterface->setCustomRenderMode(static_cast<QuickInspectorInterface::RenderMode>(current->data().toInt()));
}
emit m_previewWidget->stateChanged();
}
void QuickSceneControlWidget::serverSideDecorationsTriggered(bool enabled)
{
m_serverSideDecorationsEnabled->setChecked(enabled);
m_inspectorInterface->setServerSideDecorationsEnabled(enabled);
emit m_previewWidget->stateChanged();
}
void QuickSceneControlWidget::gridEnabledChanged(bool enabled)
{
QuickDecorationsSettings settings = m_previewWidget->overlaySettings();
settings.gridEnabled = enabled;
setOverlaySettings(settings);
}
void QuickSceneControlWidget::gridOffsetChanged(const QPoint &value)
{
QuickDecorationsSettings settings = m_previewWidget->overlaySettings();
settings.gridOffset = value;
setOverlaySettings(settings);
}
void QuickSceneControlWidget::gridCellSizeChanged(const QSize &value)
{
QuickDecorationsSettings settings = m_previewWidget->overlaySettings();
settings.gridCellSize = value;
setOverlaySettings(settings);
}
void QuickSceneControlWidget::setOverlaySettings(const QuickDecorationsSettings &settings)
{
m_inspectorInterface->setOverlaySettings(settings);
}
void QuickSceneControlWidget::setSupportsCustomRenderModes(
QuickInspectorInterface::Features supportedCustomRenderModes)
{
m_visualizeClipping->setEnabled(
supportedCustomRenderModes & QuickInspectorInterface::CustomRenderModeClipping);
m_visualizeBatches->setEnabled(
supportedCustomRenderModes & QuickInspectorInterface::CustomRenderModeBatches);
m_visualizeOverdraw->setEnabled(
supportedCustomRenderModes & QuickInspectorInterface::CustomRenderModeOverdraw);
m_visualizeChanges->setEnabled(
supportedCustomRenderModes & QuickInspectorInterface::CustomRenderModeChanges);
m_visualizeTraces->setEnabled(
supportedCustomRenderModes & QuickInspectorInterface::CustomRenderModeTraces);
}
void QuickSceneControlWidget::setServerSideDecorationsState(bool enabled)
{
m_serverSideDecorationsEnabled->setChecked(enabled);
}
void QuickSceneControlWidget::setOverlaySettingsState(const QuickDecorationsSettings &settings)
{
m_previewWidget->setOverlaySettings(settings);
m_gridSettingsWidget->setOverlaySettings(settings);
m_legendTool->setOverlaySettings(settings);
emit m_previewWidget->stateChanged();
}
QuickInspectorInterface::RenderMode QuickSceneControlWidget::customRenderMode() const
{
const QAction *checkedAction = ::checkedAction(m_visualizeGroup);
if (checkedAction) {
return static_cast<QuickInspectorInterface::RenderMode>(checkedAction->data().toInt());
}
return QuickInspectorInterface::NormalRendering;
}
void QuickSceneControlWidget::setCustomRenderMode(QuickInspectorInterface::RenderMode customRenderMode)
{
if (this->customRenderMode() == customRenderMode)
return;
foreach (auto action, m_visualizeGroup->actions()) {
if (action)
action->setChecked(static_cast<QuickInspectorInterface::RenderMode>(action->data().toInt()) == customRenderMode);
}
visualizeActionTriggered(checkedAction(m_visualizeGroup));
}
QuickScenePreviewWidget *QuickSceneControlWidget::previewWidget()
{
return m_previewWidget;
}
bool QuickSceneControlWidget::serverSideDecorationsEnabled() const
{
return m_serverSideDecorationsEnabled->isChecked();
}
void QuickSceneControlWidget::setServerSideDecorationsEnabled(bool enabled)
{
if (m_serverSideDecorationsEnabled->isChecked() == enabled)
return;
m_serverSideDecorationsEnabled->setChecked(enabled);
serverSideDecorationsTriggered(enabled);
}
|