/* * Copyright (c) Contributors to the Open 3D Engine Project. * For complete copyright and license terms please see the LICENSE at the root of this distribution. * * SPDX-License-Identifier: Apache-2.0 OR MIT * */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace O3DE::ProjectManager { constexpr const char* k_templateIndexProperty = "TemplateIndex"; NewProjectSettingsScreen::NewProjectSettingsScreen(QWidget* parent) : ProjectSettingsScreen(parent) { const QString defaultName = GetDefaultProjectName(); const QString defaultPath = QDir::toNativeSeparators(GetDefaultProjectPath() + "/" + defaultName); m_projectName->lineEdit()->setText(defaultName); m_projectPath->lineEdit()->setText(defaultPath); // if we don't use a QFrame we cannot "contain" the widgets inside and move them around // as a group QFrame* projectTemplateWidget = new QFrame(this); projectTemplateWidget->setObjectName("projectTemplate"); QVBoxLayout* containerLayout = new QVBoxLayout(); containerLayout->setAlignment(Qt::AlignTop); { QLabel* projectTemplateLabel = new QLabel(tr("Select a Project Template")); projectTemplateLabel->setObjectName("projectTemplateLabel"); containerLayout->addWidget(projectTemplateLabel); QLabel* projectTemplateDetailsLabel = new QLabel(tr("Project templates are pre-configured with relevant Gems that provide " "additional functionality and content to the project.")); projectTemplateDetailsLabel->setWordWrap(true); projectTemplateDetailsLabel->setObjectName("projectTemplateDetailsLabel"); containerLayout->addWidget(projectTemplateDetailsLabel); // we might have enough templates that we need to scroll QScrollArea* templatesScrollArea = new QScrollArea(this); QWidget* scrollWidget = new QWidget(); FlowLayout* flowLayout = new FlowLayout(0, s_spacerSize, s_spacerSize); scrollWidget->setLayout(flowLayout); templatesScrollArea->setWidget(scrollWidget); templatesScrollArea->setWidgetResizable(true); m_projectTemplateButtonGroup = new QButtonGroup(this); m_projectTemplateButtonGroup->setObjectName("templateButtonGroup"); // QButtonGroup has overloaded buttonClicked methods so we need the QOverload connect( m_projectTemplateButtonGroup, QOverload::of(&QButtonGroup::buttonClicked), this, [=](QAbstractButton* button) { if (button && button->property(k_templateIndexProperty).isValid()) { int projectTemplateIndex = button->property(k_templateIndexProperty).toInt(); if (m_selectedTemplateIndex != projectTemplateIndex) { const int oldIndex = m_selectedTemplateIndex; m_selectedTemplateIndex = projectTemplateIndex; UpdateTemplateDetails(m_templates.at(m_selectedTemplateIndex)); emit OnTemplateSelectionChanged(/*oldIndex=*/oldIndex, /*newIndex=*/m_selectedTemplateIndex); } } }); auto templatesResult = PythonBindingsInterface::Get()->GetProjectTemplates(); if (templatesResult.IsSuccess() && !templatesResult.GetValue().isEmpty()) { m_templates = templatesResult.GetValue(); // sort alphabetically by display name (but putting Standard first) because they could be in any order std::sort(m_templates.begin(), m_templates.end(), [](const ProjectTemplateInfo& arg1, const ProjectTemplateInfo& arg2) { if (arg1.m_displayName == "Standard") { return true; } else if (arg2.m_displayName == "Standard") { return false; } else { return arg1.m_displayName.toLower() < arg2.m_displayName.toLower(); } }); for (int index = 0; index < m_templates.size(); ++index) { ProjectTemplateInfo projectTemplate = m_templates.at(index); QString projectPreviewPath = QDir(projectTemplate.m_path).filePath(ProjectPreviewImagePath); QFileInfo doesPreviewExist(projectPreviewPath); if (!doesPreviewExist.exists() || !doesPreviewExist.isFile()) { projectPreviewPath = ":/DefaultTemplate.png"; } TemplateButton* templateButton = new TemplateButton(projectPreviewPath, projectTemplate.m_displayName, this); templateButton->setCheckable(true); templateButton->setProperty(k_templateIndexProperty, index); m_projectTemplateButtonGroup->addButton(templateButton); flowLayout->addWidget(templateButton); } // Select the first project template (default selection). SelectProjectTemplate(0, /*blockSignals=*/true); } containerLayout->addWidget(templatesScrollArea); } projectTemplateWidget->setLayout(containerLayout); m_verticalLayout->addWidget(projectTemplateWidget); QFrame* projectTemplateDetails = CreateTemplateDetails(s_templateDetailsContentMargin); projectTemplateDetails->setObjectName("projectTemplateDetails"); m_horizontalLayout->addWidget(projectTemplateDetails); } QString NewProjectSettingsScreen::GetDefaultProjectPath() { QString defaultPath = QStandardPaths::writableLocation(QStandardPaths::DocumentsLocation); AZ::Outcome engineInfoResult = PythonBindingsInterface::Get()->GetEngineInfo(); if (engineInfoResult.IsSuccess()) { QDir path(QDir::toNativeSeparators(engineInfoResult.GetValue().m_defaultProjectsFolder)); if (path.exists()) { defaultPath = path.absolutePath(); } } return defaultPath; } QString NewProjectSettingsScreen::GetDefaultProjectName() { return "NewProject"; } QString NewProjectSettingsScreen::GetProjectAutoPath() { const QString projectName = m_projectName->lineEdit()->text(); return QDir::toNativeSeparators(GetDefaultProjectPath() + "/" + projectName); } ProjectManagerScreen NewProjectSettingsScreen::GetScreenEnum() { return ProjectManagerScreen::NewProjectSettings; } void NewProjectSettingsScreen::NotifyCurrentScreen() { if (!m_templates.isEmpty()) { UpdateTemplateDetails(m_templates.first()); } Validate(); } QString NewProjectSettingsScreen::GetProjectTemplatePath() { AZ_Assert(m_selectedTemplateIndex == m_projectTemplateButtonGroup->checkedButton()->property(k_templateIndexProperty).toInt(), "Selected template index not in sync with the currently checked project template button."); return m_templates.at(m_selectedTemplateIndex).m_path; } QFrame* NewProjectSettingsScreen::CreateTemplateDetails(int margin) { QFrame* projectTemplateDetails = new QFrame(this); projectTemplateDetails->setObjectName("projectTemplateDetails"); QVBoxLayout* templateDetailsLayout = new QVBoxLayout(); templateDetailsLayout->setContentsMargins(margin, margin, margin, margin); templateDetailsLayout->setAlignment(Qt::AlignTop); { m_templateDisplayName = new QLabel(this); m_templateDisplayName->setObjectName("displayName"); templateDetailsLayout->addWidget(m_templateDisplayName); m_templateSummary = new QLabel(this); m_templateSummary->setObjectName("summary"); m_templateSummary->setWordWrap(true); templateDetailsLayout->addWidget(m_templateSummary); QLabel* includedGemsTitle = new QLabel(tr("Included Gems"), this); includedGemsTitle->setObjectName("includedGemsTitle"); templateDetailsLayout->addWidget(includedGemsTitle); m_templateIncludedGems = new TagContainerWidget(this); m_templateIncludedGems->setObjectName("includedGems"); templateDetailsLayout->addWidget(m_templateIncludedGems); #ifdef TEMPLATE_GEM_CONFIGURATION_ENABLED QLabel* moreGemsLabel = new QLabel(tr("Looking for more Gems?"), this); moreGemsLabel->setObjectName("moreGems"); templateDetailsLayout->addWidget(moreGemsLabel); QLabel* browseCatalogLabel = new QLabel(tr("Browse the Gems Catalog to further customize your project."), this); browseCatalogLabel->setObjectName("browseCatalog"); browseCatalogLabel->setWordWrap(true); templateDetailsLayout->addWidget(browseCatalogLabel); QPushButton* configureGemsButton = new QPushButton(tr("Configure with more Gems"), this); connect(configureGemsButton, &QPushButton::clicked, this, [=]() { emit ChangeScreenRequest(ProjectManagerScreen::GemCatalog); }); templateDetailsLayout->addWidget(configureGemsButton); #endif // TEMPLATE_GEM_CONFIGURATION_ENABLED } projectTemplateDetails->setLayout(templateDetailsLayout); return projectTemplateDetails; } void NewProjectSettingsScreen::UpdateTemplateDetails(const ProjectTemplateInfo& templateInfo) { m_templateDisplayName->setText(templateInfo.m_displayName); m_templateSummary->setText(templateInfo.m_summary); m_templateIncludedGems->Update(templateInfo.m_includedGems); } void NewProjectSettingsScreen::SelectProjectTemplate(int index, bool blockSignals) { const QList buttons = m_projectTemplateButtonGroup->buttons(); if (index >= buttons.size()) { return; } if (blockSignals) { m_projectTemplateButtonGroup->blockSignals(true); } QAbstractButton* button = buttons.at(index); button->setChecked(true); m_selectedTemplateIndex = button->property(k_templateIndexProperty).toInt(); if (blockSignals) { m_projectTemplateButtonGroup->blockSignals(false); } } void NewProjectSettingsScreen::OnProjectNameUpdated() { if (ValidateProjectName() && !m_userChangedProjectPath) { m_projectPath->setText(GetProjectAutoPath()); } } void NewProjectSettingsScreen::OnProjectPathUpdated() { const QString defaultPath = QDir::toNativeSeparators(GetDefaultProjectPath() + "/" + GetDefaultProjectName()); const QString autoPath = GetProjectAutoPath(); const QString path = m_projectPath->lineEdit()->text(); m_userChangedProjectPath = path != defaultPath && path != autoPath; ValidateProjectPath(); } } // namespace O3DE::ProjectManager