diff --git a/docs/ru/client.md b/docs/ru/client.md index 3c53f05..616aaf3 100644 --- a/docs/ru/client.md +++ b/docs/ru/client.md @@ -116,16 +116,19 @@ После разделения анимации на ключевые этапы модуль формирует выходную последовательность кадров, определяющих положение коптера и цвет его подсветки, а также последовательность действий при полёте к первой точке анимации. Настройка модуля производится с помощью следующих параметров: * `start_action` - первое действие при запуске воспроизведения анимации. Доступные варианты: - * `auto` - автоматический выбор действия между `takeoff` (взлёт) или `fly` (мгновенный полёт по точкам) на основе текущего уровня высоты коптера. Если (`z` в начальной точке анимации) - (текущая высота коптера) > (уровень взлета `takeoff_level`), то значение устанавливается в `takeoff`, иначе значение устанавливается в `fly`. - * `takeoff` - выполнение *логики полёта к первой точке*. + * `auto` - автоматический выбор действия между `takeoff` (взлёт) или `fly` (мгновенный полёт по точкам) на основе текущего уровня высоты коптера. Если (`z` в начальной точке анимации) > (уровень взлета `takeoff_level`), то значение устанавливается в `takeoff`, иначе значение устанавливается в `fly`. * `fly` - выполнение *логики немедленного полёта* + * `takeoff` - выполнение *логики полёта к первой точке*. - Если в файле анимации коптер взлетает с земли, при старте анимации будет применена *логика немедленного воспроизведения*: коптер включает двигатели через время, которое требуется для выполнения начальных кадров анимации, которые не включены в выходную последовательность, затем через время `arming_time` начинает следовать точкам, указанным в анимации. Если в файле анимации коптер начинает полёт в воздухе, при старте анимации будет применена *логика полёта к первой точке*: через время, которое требуется для выполнения начальных кадров анимации, которые не включены в выходную последовательность, коптер в начале взлетает на высоту `takeoff_height` за время `takeoff_time`, затем перемещается к первой точке за время `reach_first_point_time`, и затем начинает следовать точкам, указанным в анимации. + Если в файле анимации коптер взлетает с земли, при старте анимации будет применена **логика немедленного воспроизведения (fly)**: коптер с выключенными моторами воспроизводит цвет из анимации, пока неподвижен, включает двигатели перед моментом взлёта, затем через время `arming_time` начинает следовать точкам, указанным в анимации. + + Если в файле анимации коптер начинает полёт в воздухе, при старте анимации будет применена **логика полёта к первой точке (takeoff)**: коптер с выключенными моторами воспроизводит цвет из анимации, пока неподвижен, включает двигатели перед моментом взлёта, затем взлетает на высоту `takeoff_height` за время `takeoff_time`, затем перемещается к первой точке за время `reach_first_point_time`, и затем начинает следовать точкам, указанным в анимации. * `takeoff_level` - уровень взлёта для автоматического определения первого действия коптера при старте анимации * `ground_level` - уровень земли, используется для проверки, не попытается ли коптер улететь под землю при воспроизведении анимации. Доступные варианты настройки: * `current` - за уровень земли принимается текущий уровень высоты коптера перед стартом. * координата z в метрах +* `check_ground` - логическое значение, определяет, нужно ли производить проверку уровня земли в анимации. * `frame_delay` - время воспроизведения одного кадра в секундах. * `yaw` - поворот коптера при полёте по точкам, в градусах. Если значение `nan` - коптер сохраняет изначальную ориентацию в полёте. Если значение `animation` - коптер берёт поворот по yaw из файла с анимацией. * `ratio` - масштаб анимации (ratio_x, ratio_y, ratio_z) по осям (x, y, z) diff --git a/examples/animations/basic/basic_real.gif b/examples/animations/basic/basic_real.gif new file mode 100644 index 0000000..07a78e5 Binary files /dev/null and b/examples/animations/basic/basic_real.gif differ