OptimizedDrawingHotkeys — это cBot для cTrader Automate, который ускоряет аннотирование графиков, позволяя создавать инструменты рисования с помощью горячих клавиш и кликов мыши. Включает живой предварительный просмотр «призрака» размещения, привязку (к максимуму/минимуму бара или OHLC с опциональным округлением тиков), HUD на графике, отмену последнего рисунка, ценовые метки с корректировкой по знакам, правое расширение в барах и пользовательскую систему уровней Фибоначчи, которая может автоматически восстанавливать отсутствующие линии/метки уровней Фибоначчи (и слои заполненных прямоугольников) после изменения таймфрейма.

OptimizedDrawingHotkeys cBot — Руководство пользователя

Что делает этот cBot

OptimizedDrawingHotkeys — это ассистент рисования для графиков cTrader. Он позволяет быстро размещать распространённые объекты рисования с помощью горячих клавиш + кликов мыши, с опциональными превью-призраками, привязкой, HUD на графике, отменой и системой самовосстановления, которая восстанавливает линии/метки уровней Фибоначчи (и слои заполненных прямоугольников), если они исчезают после изменения таймфрейма.

• Он не совершает сделки (AccessRights.None).
• Он рисует объекты на графике и управляет связанными «дочерними» объектами (метки, уровни Фибоначчи, слой заполнения прямоугольника и т.д.).

Быстрый старт (типичный рабочий процесс)

1. Прикрепите cBot к графику (cTrader Automate).
2. Нажмите горячую клавишу (например, F для Фибоначчи, R для прямоугольника).
3. Кликните по графику, чтобы разместить необходимые точки.
4. Нажмите Esc, чтобы отменить текущий рисунок.
5. Нажмите Z (по умолчанию), чтобы отменить последний завершённый рисунок.
6. Нажмите U (по умолчанию), чтобы показать/скрыть HUD.

Горячие клавиши и режимы рисования

Горячие клавиши по умолчанию

• H = Горизонтальная линия (1 клик)
• V = Вертикальная линия (1 клик)
• T = Трендовая линия (2 клика)
• R = Прямоугольник (2 клика)
• E = Эллипс (2 клика)
• F = Фибоначчи (2 клика)
• A = Стрелка (2 клика)
• X = Текст (1 клик)
• C = Равносторонний канал (3 клика)
• Z = Отмена последнего рисунка
• U = Переключение HUD
• Esc = Отмена текущего режима рисования (во время размещения)

Если параметр горячей клавиши пустой или содержит только пробелы, эта горячая клавиша фактически отключена.

Сколько кликов требуется каждому инструменту

• Инструменты с 1 кликом: Горизонтальная, Вертикальная, Текст
• Инструменты с 2 кликами: Трендовая линия, Прямоугольник, Эллипс, Фибоначчи, Стрелка
• Инструменты с 3 кликами: Канал
• • Клик 1: начальная точка
  • Клик 2: конечная точка (базовая линия)
  • Клик 3: точка высоты (расстояние от базовой линии; высота используется как абсолютное расстояние)

HUD (статус на графике)

Если включено, HUD показывает:

• Текущий режим (или Ожидание)
• Прогресс, например (1/2) во время размещения
• Текущий стиль профиля и режим привязки
• Напоминания о горячих клавишах

Управление:

• Параметр Show HUD задаёт начальную видимость.
• Горячая клавиша Toggle HUD включает/выключает HUD.

Предварительный просмотр размещения («превью-призрак»)

Если Enable Placement Preview = true, инструменты с несколькими точками показывают живой предварительный просмотр, пока вы перемещаете мышь между кликами:

• Трендовая линия, Прямоугольник, Эллипс, Стрелка: превью после первого клика
• Канал: превью после клика 1, затем превью канала после клика 2
• Фибоначчи: превью базовой линии + уровней после первого клика

Временные объекты превью автоматически удаляются при завершении или отмене.

Привязка

Привязка корректирует цену по оси Y перед размещением точек.

Режимы привязки

• None: без привязки
• Tick: (не используется напрямую как режим в коде; округление происходит через «Snap Then Tick», когда Snap != None)
• HighLow: привязка к ближайшему максимуму или минимуму бара, ближайшего к времени клика
• OHLC: привязка к ближайшему открытию/максимуму/минимуму/закрытию этого бара

Snap Then Tick

Если Snap Then Tick = true и режим Snap не None, то привязанная цена дополнительно округляется до ближайшего Symbol.TickSize.

Система стилей

Профиль стиля

Профиль стиля изменяет поведение толщины/цвета по умолчанию:

• Custom: использует ваш цвет по умолчанию и базовую толщину
• Scalping: более тонкие и тусклые настройки по умолчанию (быстро/чисто)
• Swing: более толстые настройки по умолчанию (более заметно)

Цвета инструментов

Каждый инструмент может опционально переопределять цвет через собственный параметр «Tool Colors».

• Оставьте пустым, чтобы использовать цвет профиля/по умолчанию.
• Если имя цвета недействительно, используется цвет профиля/по умолчанию.

Метки и расширения

Цены с корректировкой по знакам

Ценовые метки используют форматирование Symbol.Digits (например, для 5-знаковых символов отображается 1.23456).

Правое расширение (в барах)

Правое расширение (в барах) контролирует, куда доходят «метки справа» и расширенные линии Фибоначчи.

• cBot конвертирует «бары» во время, используя текущий интервал бара на вашем таймфрейме.

Заполнение прямоугольника (цвет + прозрачность)

Заполненные и контурные прямоугольники

• Если Rectangle Filled = false: рисуется обычный контурный прямоугольник.
• Если Rectangle Filled = true: cBot рисует два прямоугольника:
• 1. Слой заполнения (*_fill): неинтерактивный, заполненный, полупрозрачный
  2. Слой контура (*_border): интерактивный, только контур

Это сделано потому, что стилизация объекта прямоугольника в cTrader не поддерживает надёжно независимое оформление контура и заливки в одном объекте.

Цвет заливки / Прозрачность заливки %

• Цвет заливки: имя цвета (например, DodgerBlue)
• Прозрачность заливки %: 0–100
• • 0 = полностью прозрачный
  • 100 = полностью непрозрачный

Важное поведение:

• Перетаскивание/изменение размера осуществляется через слой контура (интерактивный).
• Если вы удалите либо слой заливки, либо слой контура, cBot удалит всю группу заполненного прямоугольника (чтобы избежать «осиротевших» слоёв).

Инструмент Фибоначчи (пользовательская реализация)

Что создаётся

Когда вы размещаете Фибоначчи:

• Создаётся базовая трендовая линия: ..._base (интерактивная)
• Для каждого включённого уровня:
• • Создаётся объект линии (..._lvl_i) и текстовая метка (..._lvl_i_lab) как дочерние
  • Дочерние объекты по дизайну неинтерактивны (перемещается базовая линия)

Расширять уровни Фибоначчи

• Если Extend Fib Levels = true: каждый уровень рисуется как трендовая линия от начала базовой линии до вычисленного времени правого расширения.
• Если Extend Fib Levels = false: каждый уровень — это горизонтальная линия.

cBot запоминает «расширять или не расширять» для каждой группы Фибоначчи (так что старые Фибоначчи сохраняют стиль, даже если вы позже измените параметр).

Смещение меток Фибоначчи влево (в барах)

Сдвигает процентные метки Фибоначчи влево от начала базовой линии на N баров (ограничено, чтобы не выходить за первый бар).

Автоматический ремонт / поведение самовосстановления

Исчезновение уровней Фибоначчи при смене таймфрейма

Некоторые сборки cTrader удаляют определённые неинтерактивные/дочерние объекты при смене таймфрейма. Этот cBot может их восстанавливать.

• Управляется параметром Auto-Repair Fib Levels
• Запускается:
• • При запуске (OnStart)
  • Каждую 1 секунду в режиме ожидания (не во время размещения нового рисунка)

Ключевое правило:

• Он восстанавливает линии/метки уровней Фибоначчи только если ни одна из линий уровней не существует для данного Фиба.
  Это предотвращает конфликт с вашими ручными удалениями (например, если вы намеренно удалили отдельную линию уровня).

Ремонт слоя заполненного прямоугольника

Заполненные прямоугольники также проверяются и восстанавливаются:

• Если контур существует, а заливка отсутствует → заливка восстанавливается.
• Если заливка существует, а контур отсутствует → контур восстанавливается (с использованием текущих параметров цвета/толщины контура прямоугольника).

Поведение отмены и удаления

Отмена последнего рисунка

• Горячая клавиша: Undo Last (по умолчанию Z)
• Удаляет последнюю созданную «группу владельца»:
• • Отдельные объекты: удаляются напрямую
  • Метки трендовой линии: удаляются вместе с линией
  • Фибоначчи: базовая линия + все уровни + все метки Фибоначчи удаляются вместе
  • Заполненный прямоугольник: заливка и контур удаляются вместе

Отмена работает по принципу «стека»: удаляется только то, что cBot создал последним, а не произвольные ручные изменения.

Ручное удаление объектов

• Удаление «владельца» объекта удаляет его дочерние объекты, где это применимо.
• Для заполненных прямоугольников удаление любого слоя приводит к удалению другого слоя cBot.

Справочник параметров (по группам)

Горячие клавиши

• Горизонтальная, Вертикальная, Трендовая линия, Прямоугольник, Эллипс, Фибоначчи, Стрелка, Текст, Канал
• Отмена последнего
• Переключение HUD

UX

• Показать HUD (начальное состояние HUD)
• Включить предварительный просмотр размещения
• Автоматический ремонт уровней Фибоначчи

Стиль

• Профиль стиля (Custom, Scalping, Swing)
• Базовая толщина
• Цвет по умолчанию

Цвета инструментов

Опциональные переопределения для каждого инструмента (пусто = использовать профиль/по умолчанию):

• Горизонтальная, Вертикальная, Трендовая линия, Прямоугольник, Эллипс, Стрелка, Текст, Канал, Базовая линия Фибоначчи

Текст

• Содержимое текста
• Размер шрифта текста
  Примечание: также используется для различных меток (метки Фибоначчи, метки конечных точек линий и т.д.).

Прямоугольник

• Заполнение прямоугольника
• Цвет заливки
• Прозрачность заливки %

Время/Метки

• Правое расширение (в барах)

Привязка

• Режим привязки (None, HighLow, OHLC)
• Snap Then Tick

Фибоначчи

• Расширять уровни Фибоначчи
• Смещение меток Фибоначчи влево (в барах)

Уровни Фибоначчи

Для каждого уровня:

• Переключатель отображения
• Процентное значение
• Цвет
• Стиль линии

Советы, подводные камни, устранение неполадок

Горячие клавиши не работают

• Убедитесь, что график в фокусе (кликните по графику один раз).
• Убедитесь, что нет дублирующихся горячих клавиш (две функции, привязанные к одной клавише, могут работать непредсказуемо).
• Попробуйте использовать одиночные символы для горячих клавиш.

Уровни/метки Фибоначчи изменились после изменения параметров

• Существующие группы Фибоначчи запоминают «расширять или не расширять», но:
• • Если уровни полностью отсутствовали и их пришлось воссоздавать, cBot использует ваши текущие настройки уровней Фибоначчи (цвета/стили/видимость).
  • Это ожидаемо: происходит «повторное наполнение» из вашей текущей конфигурации.

Цвет/прозрачность заполненного прямоугольника кажется глобальными

• Это глобально: Цвет заливки и Прозрачность заливки % — это параметры, а не хранятся для каждого прямоугольника отдельно.
• Если слой заливки исчезает и восстанавливается позже, он будет использовать ваши текущие настройки заливки.

Объекты всё ещё исчезают при смене таймфрейма

• Убедитесь, что Auto-Repair Fib Levels = true.
• Примечание: бот восстанавливает уровни Фибоначчи только если все линии уровней отсутствуют для данного Фиба.