chore: refine project documentation

This commit is contained in:
2026-08-25 22:44:36 +03:00
parent 8237f03930
commit 98d90e1e5a
45 changed files with 457 additions and 516 deletions
+11 -13
View File
@@ -266,7 +266,7 @@ type
FWebSpecPixels: Integer; // потолок точек кадра спектра/водопада для web
// --- CAT ---
FCATAdapter: TCATAdapter; // адаптер CAT поверх контроллера (движок+транспорты+контекст)
FTCIAdapter: TTCIAdapter; // адаптер TCI (WebSocket-сервер Expert Electronics)
FTCIAdapter: TTCIAdapter; // адаптер TCI для WebSocket-сервера
FTCICfg: TTCISettings; // текущие настройки TCI (UI/persist)
FCATLastGlobal: TGlobalSettings; // текущие CAT-настройки (UI/persist; ApplySettings → адаптер)
// Виджеты построены (конец FormCreate). До этого рендер состояния запрещён:
@@ -749,7 +749,7 @@ type
procedure OnPanBandClick(Sender: TObject); // «20m» шапки пана N (3.6)
procedure OnPanBandSelect(Tag: Integer); // выбор диапазона из flat-меню
function CurrentAppTheme: TAppTheme; // тек. тема (light/dark)
procedure ApplyPanBand(P: TPanafallPanel; BandIdx: Integer); // Flex-style смена банда пана
procedure ApplyPanBand(P: TPanafallPanel; BandIdx: Integer); // смена диапазона отдельного пана
function PanBandSelectorVisible: Boolean; // КВ (не XVTR, не Pluto)
procedure OnPanADCClick(Sender: TObject); // бейдж «RX1/RX2» (3.4)
// Per-pan дисплей (3.6): «◑» → поповер палитры/gamma/уровней.
@@ -4027,7 +4027,7 @@ begin
end;
end;
// Панорама и водопад теперь рисуются независимо по факту новых кадров.
// Это лучше совпадает с Thetis: маленький FFT даёт новые строки чаще.
// Маленький FFT даёт новые строки чаще.
if FSpectrumDirty then
begin
FSpecView.DrawSpectrum;
@@ -4986,12 +4986,11 @@ end;
// CTUN ВЫКЛ (классический режим):
// FController.FCenterFreq = FController.FVfoA — спектр центрирован на VFO, маркер всегда в центре
//
// CTUN ВКЛ (piHPSDR/Thetis режим):
// CTUN ВКЛ:
// FController.FCenterFreq статичен — спектр/водопад не двигаются
// FController.FVfoA движется по дисплею (маркер гуляет)
// Перецентрирование — только когда КРАЙ ПОЛОСЫ ФИЛЬТРА выходит за край дисплея
// (по образцу OpenHPSDR/PowerSDR: "re-centering occurs as the edge of the passband
// hits the edge of the display")
// Перецентрирование — только когда край полосы фильтра выходит за границу
// дисплея.
// ---------------------------------------------------------------------------
procedure TMainForm.ApplyVfoA(NewFreq: Int64);
begin
@@ -5067,7 +5066,7 @@ begin
end;
// ---------------------------------------------------------------------------
// DUP toggle (Thetis-style local display mode — без аппаратной команды)
// DUP toggle — локальный режим дисплея без аппаратной команды.
// ---------------------------------------------------------------------------
procedure TMainForm.ApplyDUP(Active: Boolean);
begin
@@ -5401,7 +5400,7 @@ begin
end;
// ---------------------------------------------------------------------------
// TUN — Thetis-style тон: WDSP TXA PostGen + MOX с отдельным уровнем Drive
// TUN — тон WDSP TXA PostGen + MOX с отдельным уровнем Drive.
// ---------------------------------------------------------------------------
procedure TMainForm.ApplyTUN(Active: Boolean);
begin
@@ -6095,8 +6094,7 @@ end;
procedure TMainForm.BtnFilterMouseDown(Sender: TObject; Button: TMouseButton;
Shift: TShiftState; X, Y: Integer);
// ПКМ по кнопке фильтра открывает редактор на этом слоте (эталон Thetis:
// у них это пункт контекстного меню «RX1 Filter Configure»). ЛКМ не трогаем —
// ПКМ по кнопке фильтра открывает редактор на этом слоте. ЛКМ не трогаем —
// иначе окно вылезало бы при каждом обычном переключении фильтра.
begin
if Button = mbRight then OpenFilterEditor((Sender as TFlatButton).Tag);
@@ -7185,7 +7183,7 @@ begin
end;
procedure TMainForm.ApplyPanBand(P: TPanafallPanel; BandIdx: Integer);
// Flex-style смена диапазона пана N: ретюн DDC на VfoA диапазона (из общего
// Смена диапазона пана N: ретюн DDC на VfoA диапазона (из общего
// band-кэша, как пан 0), активный приёмник садится на VfoA с mode/filter/AGC
// (+zoom/pan) диапазона, прочие слайсы пана убираются (они вне новой полосы).
var
@@ -8904,7 +8902,7 @@ end;
// Передаёт XVTR-режим в сетевой слой. Вызывается при смене XVTR или его
// настроек. Управляет XVTR Enable bit, T/R relay suppression.
// XVTR DDC In (Alex bits 8+11) управляется через галочку XVTR в Antenna/Alex
// tab для IF-диапазона (Alex.RxOnly[IF_band]=3) — аналогично Thetis.
// tab для IF-диапазона (Alex.RxOnly[IF_band]=3).
procedure TMainForm.ApplyXvtrToNetwork;
begin
// Логика перенесена в контроллер; обёртка для существующих вызовов в UI.