Input: remember registered ldd controllers

- Don't reset ldd pads when saving a pad config
- Prevent configuration of registered ldd pads in the gui while ingame
This commit is contained in:
Megamouse 2020-05-08 21:41:05 +02:00
parent 69ea573b0d
commit eb5ec211c2
9 changed files with 172 additions and 56 deletions

View file

@ -924,19 +924,6 @@ error_code cellPadLddRegisterController()
if (handle < 0) if (handle < 0)
return CELL_PAD_ERROR_TOO_MANY_DEVICES; return CELL_PAD_ERROR_TOO_MANY_DEVICES;
const auto product = input::get_product_info(input::product_type::playstation_3_controller);
auto& pads = handler->GetPads();
pads[handle]->Init
(
CELL_PAD_STATUS_CONNECTED | CELL_PAD_STATUS_ASSIGN_CHANGES | CELL_PAD_STATUS_CUSTOM_CONTROLLER,
CELL_PAD_CAPABILITY_PS3_CONFORMITY,
CELL_PAD_DEV_TYPE_LDD,
CELL_PAD_PCLASS_TYPE_STANDARD,
product.pclass_profile,
product.vendor_id,
product.product_id
);
config->port_setting[handle] = 0; config->port_setting[handle] = 0;
return not_an_error(handle); return not_an_error(handle);

View file

@ -1,5 +1,6 @@
#include "stdafx.h" #include "stdafx.h"
#include "pad_thread.h" #include "pad_thread.h"
#include "product_info.h"
#include "ds3_pad_handler.h" #include "ds3_pad_handler.h"
#include "ds4_pad_handler.h" #include "ds4_pad_handler.h"
#ifdef _WIN32 #ifdef _WIN32
@ -24,9 +25,10 @@ namespace pad
struct pad_setting struct pad_setting
{ {
u32 port_status; u32 port_status = 0;
u32 device_capability; u32 device_capability = 0;
u32 device_type; u32 device_type = 0;
s32 ldd_handle = -1;
}; };
pad_thread::pad_thread(void *_curthread, void *_curwindow, std::string_view title_id) : curthread(_curthread), curwindow(_curwindow) pad_thread::pad_thread(void *_curthread, void *_curwindow, std::string_view title_id) : curthread(_curthread), curwindow(_curwindow)
@ -52,19 +54,33 @@ void pad_thread::Init()
std::lock_guard lock(pad::g_pad_mutex); std::lock_guard lock(pad::g_pad_mutex);
// Cache old settings if possible // Cache old settings if possible
std::vector<pad_setting> pad_settings; std::array<pad_setting, CELL_PAD_MAX_PORT_NUM> pad_settings;
for (u32 i = 0; i < CELL_PAD_MAX_PORT_NUM; i++) // max 7 pads for (u32 i = 0; i < CELL_PAD_MAX_PORT_NUM; i++) // max 7 pads
{ {
if (!m_pads[i]) if (m_pads[i])
{ {
pad_settings.push_back({ CELL_PAD_STATUS_DISCONNECTED, CELL_PAD_CAPABILITY_PS3_CONFORMITY | CELL_PAD_CAPABILITY_PRESS_MODE | CELL_PAD_CAPABILITY_ACTUATOR, CELL_PAD_DEV_TYPE_STANDARD }); pad_settings[i] =
{
m_pads[i]->m_port_status,
m_pads[i]->m_device_capability,
m_pads[i]->m_device_type,
m_pads[i]->ldd ? static_cast<s32>(i) : -1
};
} }
else else
{ {
pad_settings.push_back({ m_pads[i]->m_port_status, m_pads[i]->m_device_capability, m_pads[i]->m_device_type }); pad_settings[i] =
{
CELL_PAD_STATUS_DISCONNECTED,
CELL_PAD_CAPABILITY_PS3_CONFORMITY | CELL_PAD_CAPABILITY_PRESS_MODE | CELL_PAD_CAPABILITY_ACTUATOR,
CELL_PAD_DEV_TYPE_STANDARD,
-1
};
} }
} }
num_ldd_pad = 0;
m_info.now_connect = 0; m_info.now_connect = 0;
handlers.clear(); handlers.clear();
@ -81,7 +97,8 @@ void pad_thread::Init()
{ {
std::shared_ptr<PadHandlerBase> cur_pad_handler; std::shared_ptr<PadHandlerBase> cur_pad_handler;
const auto &handler_type = g_cfg_input.player[i]->handler; const bool is_ldd_pad = pad_settings[i].ldd_handle == static_cast<s32>(i);
const auto handler_type = is_ldd_pad ? pad_handler::null : g_cfg_input.player[i]->handler.get();
if (handlers.count(handler_type) != 0) if (handlers.count(handler_type) != 0)
{ {
@ -125,10 +142,14 @@ void pad_thread::Init()
m_pads[i] = std::make_shared<Pad>(CELL_PAD_STATUS_DISCONNECTED, pad_settings[i].device_capability, pad_settings[i].device_type); m_pads[i] = std::make_shared<Pad>(CELL_PAD_STATUS_DISCONNECTED, pad_settings[i].device_capability, pad_settings[i].device_type);
if (cur_pad_handler->bindPadToDevice(m_pads[i], g_cfg_input.player[i]->device.to_string()) == false) if (is_ldd_pad)
{
InitLddPad(pad_settings[i].ldd_handle);
}
else if (cur_pad_handler->bindPadToDevice(m_pads[i], g_cfg_input.player[i]->device.to_string()) == false)
{ {
// Failed to bind the device to cur_pad_handler so binds to NullPadHandler // Failed to bind the device to cur_pad_handler so binds to NullPadHandler
input_log.error("Failed to bind device %s to handler %s", g_cfg_input.player[i]->device.to_string(), handler_type.to_string()); input_log.error("Failed to bind device %s to handler %s", g_cfg_input.player[i]->device.to_string(), handler_type);
nullpad->bindPadToDevice(m_pads[i], g_cfg_input.player[i]->device.to_string()); nullpad->bindPadToDevice(m_pads[i], g_cfg_input.player[i]->device.to_string());
} }
} }
@ -239,6 +260,30 @@ void pad_thread::ThreadFunc()
} }
} }
void pad_thread::InitLddPad(u32 handle)
{
if (handle >= m_pads.size())
{
return;
}
static const auto product = input::get_product_info(input::product_type::playstation_3_controller);
m_pads[handle]->ldd = true;
m_pads[handle]->Init
(
CELL_PAD_STATUS_CONNECTED | CELL_PAD_STATUS_ASSIGN_CHANGES | CELL_PAD_STATUS_CUSTOM_CONTROLLER,
CELL_PAD_CAPABILITY_PS3_CONFORMITY,
CELL_PAD_DEV_TYPE_LDD,
0, // CELL_PAD_PCLASS_TYPE_STANDARD
product.pclass_profile,
product.vendor_id,
product.product_id
);
num_ldd_pad++;
}
s32 pad_thread::AddLddPad() s32 pad_thread::AddLddPad()
{ {
// Look for first null pad // Look for first null pad
@ -246,8 +291,7 @@ s32 pad_thread::AddLddPad()
{ {
if (g_cfg_input.player[i]->handler == pad_handler::null && !m_pads[i]->ldd) if (g_cfg_input.player[i]->handler == pad_handler::null && !m_pads[i]->ldd)
{ {
m_pads[i]->ldd = true; InitLddPad(i);
num_ldd_pad++;
return i; return i;
} }
} }

View file

@ -28,6 +28,7 @@ public:
void UnregisterLddPad(u32 handle); void UnregisterLddPad(u32 handle);
protected: protected:
void InitLddPad(u32 handle);
void ThreadFunc(); void ThreadFunc();
// List of all handlers // List of all handlers

View file

@ -871,10 +871,10 @@
</ClCompile> </ClCompile>
<ClCompile Include="util\cereal.cpp"> <ClCompile Include="util\cereal.cpp">
<Filter>Utilities</Filter> <Filter>Utilities</Filter>
</ClCompile> </ClCompile>
<ClCompile Include="util\shared_cptr.cpp"> <ClCompile Include="util\shared_cptr.cpp">
<Filter>Utilities</Filter> <Filter>Utilities</Filter>
</ClCompile> </ClCompile>
<ClCompile Include="util\fixed_typemap.cpp"> <ClCompile Include="util\fixed_typemap.cpp">
<Filter>Utilities</Filter> <Filter>Utilities</Filter>
</ClCompile> </ClCompile>
@ -1764,7 +1764,7 @@
</ClInclude> </ClInclude>
<ClInclude Include="Emu\RSX\Overlays\overlay_osk_panel.h"> <ClInclude Include="Emu\RSX\Overlays\overlay_osk_panel.h">
<Filter>Emu\GPU\RSX\Overlays</Filter> <Filter>Emu\GPU\RSX\Overlays</Filter>
</ClInclude> </ClInclude>
<ClInclude Include="util\yaml.hpp"> <ClInclude Include="util\yaml.hpp">
<Filter>Utilities</Filter> <Filter>Utilities</Filter>
</ClInclude> </ClInclude>
@ -1788,7 +1788,7 @@
</ClInclude> </ClInclude>
<ClInclude Include="util\typeindices.hpp"> <ClInclude Include="util\typeindices.hpp">
<Filter>Utilities</Filter> <Filter>Utilities</Filter>
</ClInclude> </ClInclude>
<ClInclude Include="Emu\RSX\Common\ShaderInterpreter.h"> <ClInclude Include="Emu\RSX\Common\ShaderInterpreter.h">
<Filter>Emu\GPU\RSX\Common</Filter> <Filter>Emu\GPU\RSX\Common</Filter>
</ClInclude> </ClInclude>
@ -1799,6 +1799,6 @@
</None> </None>
<None Include="Emu\RSX\Common\Interpreter\VertexInterpreter.glsl"> <None Include="Emu\RSX\Common\Interpreter\VertexInterpreter.glsl">
<Filter>Emu\GPU\RSX\Common\Interpreter</Filter> <Filter>Emu\GPU\RSX\Common\Interpreter</Filter>
</None> </None>
</ItemGroup> </ItemGroup>
</Project> </Project>

View file

@ -119,13 +119,26 @@ void gs_frame::keyPressEvent(QKeyEvent *keyEvent)
switch (keyEvent->key()) switch (keyEvent->key())
{ {
case Qt::Key_L: case Qt::Key_L:
if (keyEvent->modifiers() == Qt::AltModifier) { static int count = 0; screenshot.success("Made forced mark %d in log", ++count); } if (keyEvent->modifiers() == Qt::AltModifier)
{
static int count = 0;
screenshot.success("Made forced mark %d in log", ++count);
return;
}
break; break;
case Qt::Key_Return: case Qt::Key_Return:
if (keyEvent->modifiers() == Qt::AltModifier) { toggle_fullscreen(); return; } if (keyEvent->modifiers() == Qt::AltModifier)
{
toggle_fullscreen();
return;
}
break; break;
case Qt::Key_Escape: case Qt::Key_Escape:
if (visibility() == FullScreen) { toggle_fullscreen(); return; } if (visibility() == FullScreen)
{
toggle_fullscreen();
return;
}
break; break;
case Qt::Key_P: case Qt::Key_P:
if (keyEvent->modifiers() == Qt::ControlModifier && !m_disable_kb_hotkeys && Emu.IsRunning()) if (keyEvent->modifiers() == Qt::ControlModifier && !m_disable_kb_hotkeys && Emu.IsRunning())
@ -135,14 +148,14 @@ void gs_frame::keyPressEvent(QKeyEvent *keyEvent)
} }
break; break;
case Qt::Key_S: case Qt::Key_S:
if (keyEvent->modifiers() == Qt::ControlModifier && !m_disable_kb_hotkeys && (!Emu.IsStopped())) if (keyEvent->modifiers() == Qt::ControlModifier && !m_disable_kb_hotkeys && !Emu.IsStopped())
{ {
Emu.Stop(); Emu.Stop();
return; return;
} }
break; break;
case Qt::Key_R: case Qt::Key_R:
if (keyEvent->modifiers() == Qt::ControlModifier && !m_disable_kb_hotkeys && (!Emu.GetBoot().empty())) if (keyEvent->modifiers() == Qt::ControlModifier && !m_disable_kb_hotkeys && !Emu.GetBoot().empty())
{ {
Emu.Restart(); Emu.Restart();
return; return;
@ -151,8 +164,16 @@ void gs_frame::keyPressEvent(QKeyEvent *keyEvent)
case Qt::Key_E: case Qt::Key_E:
if (keyEvent->modifiers() == Qt::ControlModifier && !m_disable_kb_hotkeys) if (keyEvent->modifiers() == Qt::ControlModifier && !m_disable_kb_hotkeys)
{ {
if (Emu.IsReady()) { Emu.Run(true); return; } if (Emu.IsReady())
else if (Emu.IsPaused()) { Emu.Resume(); return; } {
Emu.Run(true);
return;
}
else if (Emu.IsPaused())
{
Emu.Resume();
return;
}
} }
break; break;
case Qt::Key_F12: case Qt::Key_F12:

View file

@ -17,7 +17,7 @@ public:
explicit pad_led_settings_dialog(const int& colorR, const int& colorG, const int& colorB, const bool& led_low_battery_blink, const bool& led_battery_indicator, const int& led_battery_indicator_brightness, QDialog* parent = Q_NULLPTR); explicit pad_led_settings_dialog(const int& colorR, const int& colorG, const int& colorB, const bool& led_low_battery_blink, const bool& led_battery_indicator, const int& led_battery_indicator_brightness, QDialog* parent = Q_NULLPTR);
~pad_led_settings_dialog(); ~pad_led_settings_dialog();
signals: Q_SIGNALS:
void pass_led_settings(int m_cR, int m_cG, int m_cB, bool m_low_battery_blink, bool m_battery_indicator, int m_battery_indicator_brightness); void pass_led_settings(int m_cR, int m_cG, int m_cB, bool m_low_battery_blink, bool m_battery_indicator, int m_battery_indicator_brightness);
private Q_SLOTS: private Q_SLOTS:

View file

@ -13,8 +13,10 @@
#include "ui_pad_settings_dialog.h" #include "ui_pad_settings_dialog.h"
#include "tooltips.h" #include "tooltips.h"
#include "Emu/System.h"
#include "Emu/Io/Null/NullPadHandler.h" #include "Emu/Io/Null/NullPadHandler.h"
#include "Input/pad_thread.h"
#include "Input/product_info.h" #include "Input/product_info.h"
#include "Input/keyboard_pad_handler.h" #include "Input/keyboard_pad_handler.h"
#include "Input/ds3_pad_handler.h" #include "Input/ds3_pad_handler.h"
@ -89,14 +91,6 @@ pad_settings_dialog::pad_settings_dialog(QWidget *parent, const GameInfo *game)
mainLayout->addWidget(m_tabs); mainLayout->addWidget(m_tabs);
setLayout(mainLayout); setLayout(mainLayout);
// Fill input type combobox
std::vector<std::string> str_inputs = g_cfg_input.player[0]->handler.to_list();
for (size_t index = 0; index < str_inputs.size(); index++)
{
const QString item_data = qstr(str_inputs[index]);
ui->chooseHandler->addItem(GetLocalizedPadHandler(item_data, static_cast<pad_handler>(index)), QVariant(item_data));
}
// Combobox: Input type // Combobox: Input type
connect(ui->chooseHandler, &QComboBox::currentTextChanged, this, &pad_settings_dialog::ChangeInputType); connect(ui->chooseHandler, &QComboBox::currentTextChanged, this, &pad_settings_dialog::ChangeInputType);
@ -1009,10 +1003,22 @@ void pad_settings_dialog::ChangeInputType()
{ {
bool force_enable = false; // enable configs even with disconnected devices bool force_enable = false; // enable configs even with disconnected devices
const int player = m_tabs->currentIndex(); const int player = m_tabs->currentIndex();
const bool is_ldd_pad = GetIsLddPad(player);
std::string handler;
std::string device;
std::string profile;
const std::string handler = sstr(ui->chooseHandler->currentData().toString()); if (is_ldd_pad)
const std::string device = g_cfg_input.player[player]->device.to_string(); {
const std::string profile = g_cfg_input.player[player]->profile.to_string(); handler = fmt::format("%s", pad_handler::null);
}
else
{
handler = sstr(ui->chooseHandler->currentData().toString());
device = g_cfg_input.player[player]->device.to_string();
profile = g_cfg_input.player[player]->profile.to_string();
}
// Change this player's current handler // Change this player's current handler
if (!g_cfg_input.player[player]->handler.from_string(handler)) if (!g_cfg_input.player[player]->handler.from_string(handler))
@ -1037,7 +1043,11 @@ void pad_settings_dialog::ChangeInputType()
switch (m_handler->m_type) switch (m_handler->m_type)
{ {
case pad_handler::null: case pad_handler::null:
description = tooltips.gamepad_settings.null; break; if (is_ldd_pad)
description = tooltips.gamepad_settings.ldd_pad;
else
description = tooltips.gamepad_settings.null;
break;
case pad_handler::keyboard: case pad_handler::keyboard:
description = tooltips.gamepad_settings.keyboard; break; description = tooltips.gamepad_settings.keyboard; break;
#ifdef _WIN32 #ifdef _WIN32
@ -1091,6 +1101,15 @@ void pad_settings_dialog::ChangeInputType()
force_enable = true; force_enable = true;
break; break;
} }
case pad_handler::null:
{
if (is_ldd_pad)
{
ui->chooseDevice->addItem(tr("Custom Controller"));
break;
}
[[fallthrough]];
}
default: default:
{ {
for (size_t i = 0; i < device_list.size(); i++) for (size_t i = 0; i < device_list.size(); i++)
@ -1120,14 +1139,15 @@ void pad_settings_dialog::ChangeInputType()
m_handler->get_next_button_press(info.name, m_handler->get_next_button_press(info.name,
[this](u16, std::string, std::string pad_name, u32, pad_preview_values) { SwitchPadInfo(pad_name, true); }, [this](u16, std::string, std::string pad_name, u32, pad_preview_values) { SwitchPadInfo(pad_name, true); },
[this](std::string pad_name) { SwitchPadInfo(pad_name, false); }, false); [this](std::string pad_name) { SwitchPadInfo(pad_name, false); }, false);
if (info.name == device) if (info.name == device)
{ {
ui->chooseDevice->setCurrentIndex(i); ui->chooseDevice->setCurrentIndex(i);
} }
} }
QString profile_dir = qstr(PadHandlerBase::get_config_dir(m_handler->m_type, m_title_id)); const QString profile_dir = qstr(PadHandlerBase::get_config_dir(m_handler->m_type, m_title_id));
QStringList profiles = gui::utils::get_dir_entries(QDir(profile_dir), QStringList() << "*.yml"); const QStringList profiles = gui::utils::get_dir_entries(QDir(profile_dir), QStringList() << "*.yml");
if (profiles.isEmpty()) if (profiles.isEmpty())
{ {
@ -1153,13 +1173,20 @@ void pad_settings_dialog::ChangeInputType()
else else
{ {
ui->chooseProfile->addItem(tr("No Profiles")); ui->chooseProfile->addItem(tr("No Profiles"));
ui->chooseDevice->addItem(tr("No Device Detected"), -1);
if (ui->chooseDevice->count() == 0)
{
ui->chooseDevice->addItem(tr("No Device Detected"), -1);
}
} }
// enable configuration and profile list if possible // enable configuration and profile list if possible
SwitchButtons(config_enabled && m_handler->m_type == pad_handler::keyboard); SwitchButtons(config_enabled && m_handler->m_type == pad_handler::keyboard);
ui->b_addProfile->setEnabled(config_enabled); ui->b_addProfile->setEnabled(config_enabled);
ui->chooseProfile->setEnabled(config_enabled); ui->chooseProfile->setEnabled(config_enabled);
ui->b_reset->setEnabled(!is_ldd_pad);
ui->chooseHandler->setEnabled(!is_ldd_pad);
} }
void pad_settings_dialog::ChangeProfile() void pad_settings_dialog::ChangeProfile()
@ -1292,11 +1319,29 @@ void pad_settings_dialog::HandleDeviceClassChange(int index)
void pad_settings_dialog::RefreshInputTypes() void pad_settings_dialog::RefreshInputTypes()
{ {
const auto& handler = g_cfg_input.player[m_tabs->currentIndex()]->handler; const int index = m_tabs->currentIndex();
// Set the current input type from config. Disable signal to have ChangeInputType always executed exactly once // Set the current input type from config. Disable signal to have ChangeInputType always executed exactly once
ui->chooseHandler->blockSignals(true); ui->chooseHandler->blockSignals(true);
ui->chooseHandler->setCurrentText(GetLocalizedPadHandler(qstr(handler.to_string()), handler)); ui->chooseHandler->clear();
if (GetIsLddPad(index))
{
ui->chooseHandler->addItem(tr("Reserved"));
}
else
{
const std::vector<std::string> str_inputs = g_cfg_input.player[0]->handler.to_list();
for (size_t index = 0; index < str_inputs.size(); index++)
{
const QString item_data = qstr(str_inputs[index]);
ui->chooseHandler->addItem(GetLocalizedPadHandler(item_data, static_cast<pad_handler>(index)), QVariant(item_data));
}
const auto& handler = g_cfg_input.player[index]->handler;
ui->chooseHandler->setCurrentText(GetLocalizedPadHandler(qstr(handler.to_string()), handler));
}
ui->chooseHandler->blockSignals(false); ui->chooseHandler->blockSignals(false);
// Force Change // Force Change
@ -1398,3 +1443,17 @@ QString pad_settings_dialog::GetLocalizedPadHandler(const QString& original, pad
} }
return original; return original;
} }
bool pad_settings_dialog::GetIsLddPad(int index) const
{
// We only check for ldd pads if the current dialog may affect the running application.
// To simplify this we include the global pad config indiscriminately as well as the relevant custom pad config.
if (index >= 0 && !Emu.IsStopped() && (m_title_id.empty() || m_title_id == Emu.GetTitleID()))
{
std::lock_guard lock(pad::g_pad_mutex);
const auto handler = pad::get_current_handler();
return handler && handler->GetPads().at(index)->ldd;
}
return false;
}

View file

@ -176,9 +176,12 @@ private:
void RepaintPreviewLabel(QLabel* l, int deadzone, int desired_width, int x, int y); void RepaintPreviewLabel(QLabel* l, int deadzone, int desired_width, int x, int y);
std::shared_ptr<PadHandlerBase> GetHandler(pad_handler type); std::shared_ptr<PadHandlerBase> GetHandler(pad_handler type);
QString GetLocalizedPadHandler(const QString& original, pad_handler handler); QString GetLocalizedPadHandler(const QString& original, pad_handler handler);
/** Checks if the port at the given index is already reserved by the application as custom controller (ldd pad) */
bool GetIsLddPad(int index) const;
protected: protected:
/** Handle keyboard handler input */ /** Handle keyboard handler input */
void keyPressEvent(QKeyEvent *keyEvent) override; void keyPressEvent(QKeyEvent *keyEvent) override;

View file

@ -195,6 +195,7 @@ public:
const struct gamepad_settings const struct gamepad_settings
{ {
const QString null = tr("This controller is disabled and will appear as disconnected to software. Choose another handler to enable it."); const QString null = tr("This controller is disabled and will appear as disconnected to software. Choose another handler to enable it.");
const QString ldd_pad = tr("This port is currently assigned to a custom controller by the application and can't be changed.");
const QString keyboard = tr("While it is possible to use a keyboard as a pad in RPCS3, the use of an actual controller is strongly recommended.\nTo bind mouse movement to a button or joystick, click on the desired button to activate it, then click and hold while dragging the mouse to a direction."); const QString keyboard = tr("While it is possible to use a keyboard as a pad in RPCS3, the use of an actual controller is strongly recommended.\nTo bind mouse movement to a button or joystick, click on the desired button to activate it, then click and hold while dragging the mouse to a direction.");
const QString ds3_windows = tr("In order to use the DualShock 3 handler, you need to install the official DualShock 3 driver first.\nSee the <a href=\"https://wiki.rpcs3.net/index.php?title=Help:Controller_Configuration\">RPCS3 Wiki</a> for instructions."); const QString ds3_windows = tr("In order to use the DualShock 3 handler, you need to install the official DualShock 3 driver first.\nSee the <a href=\"https://wiki.rpcs3.net/index.php?title=Help:Controller_Configuration\">RPCS3 Wiki</a> for instructions.");
const QString ds3_linux = tr("In order to use the DualShock 3 handler, you might need to add udev rules to let RPCS3 access the controller.\nSee the <a href=\"https://wiki.rpcs3.net/index.php?title=Help:Controller_Configuration\">RPCS3 Wiki</a> for instructions."); const QString ds3_linux = tr("In order to use the DualShock 3 handler, you might need to add udev rules to let RPCS3 access the controller.\nSee the <a href=\"https://wiki.rpcs3.net/index.php?title=Help:Controller_Configuration\">RPCS3 Wiki</a> for instructions.");