Update embox_lib_fps_en.md

Author: deryugina

en/libs/embox_lib_fps_en.md

@@ -1,6 +1,6 @@
-# FPS: Helpful library for video output
+# FPS: Useful library for video output
 
-From the name of this library it's clear that it's supposed to be used for frame-per-second count, but it also have a number of features which can help you to work with graphics output.
+From the name of this library it's clear that it's supposed to be used for frame-per-second count, but it also have a number of features, which can help you to work with graphics output.
 
 ## Interface
 
@@ -10,16 +10,16 @@ Header file: `#include <fps/fps.h>`
 
 ## Basic usage
 
-At first make sure to be familiar with frame buffer interface: [[Frame buffer]]
+At first, make sure to be familiar with frame buffer interface: [[Frame buffer]].
 
-After your obtained `struct fb_info *`, you can use FPS library as simple as follows:
+After you obtained `struct fb_info *`, you can use FPS library as simple as follows:
 ```c
   struct fb_info *fbi = fb_lookup(0);
   fps_set_format("Hello, world!");
   fps_print(fbi);
 ```
 
-Now `Hello, world!` should appear at the left upper corner of the screen. This doesn't seem very helpful, so let's actually print FPS rate.
+Now `Hello, world!` should appear at the left upper corner of the screen. This doesn't seem very useful, so let's actually print FPS rate:
 
 ```c
   struct fb_info *fbi = fb_lookup(0);
@@ -39,7 +39,7 @@ Sometimes rendering scene takes a lot of time, so if we draw directly to frame b
 
 The idea is to store additional "back" buffer for drawing, while main frame remains unchanged.
 
-First way to use it is as follows:
+The first way to use it is as follows:
 ```c
 struct fb_info *fbi = fb_lookup(0);
 
@@ -76,5 +76,5 @@ Things can be more tricky if you want frame to be placed in certain memory area
   }
 ```
 
-NOTE: This will work in a correct way only if given FB supports chaning base of the frame buffer. Otherwise only "simple" double-buffering example will work.
+NOTE: This will work in a correct way only if given video output device supports changing base of the frame buffer. Otherwise, only "simple" double-buffering example will work.
 

ru/libs/embox_lib_fps_ru.md

@@ -0,0 +1,79 @@
+# FPS: Полезная библиотека для вывода видео
+
+Из названия библиотеки (FPS -- «frame-per-second») следует, что её можно использовать для подсчёта кадров в секунду. Но она также имеет ряд функций, которые могут помочь Вам в работе с графическим выводом.
+
+## Интерфейс
+
+Название модуля -- `embox.lib.fps`, поэтому Вам следует или добавить `depends embox.lib.fps` в Ваш модуль «Mybuild», или явно вставить `include embox.lib.fps` в `conf/mods.conf` (хотя второй вариант использовать не рекомендуется).
+
+Заголовочный файл: `#include <fps/fps.h>`.
+
+## Основное применение
+
+Для начала убедитесь, что Вы знакомы с интерфейсом фрейм-буфера: [[Frame buffer]].
+
+После того, как Вы получили `struct fb_info *`, Вы можете использовать FPS-библиотеку так же просто, как в следующем примере:
+```c
+  struct fb_info *fbi = fb_lookup(0);
+  fps_set_format("Hello, world!");
+  fps_print(fbi);
+```
+
+Теперь надпись `Hello, world!` должна появиться в левом верхнем углу экрана. Да, это не выглядит как что-то полезное, поэтому давайте выведем на экран фактическую скорость кадров в секунду:
+
+```c
+  struct fb_info *fbi = fb_lookup(0);
+  /* Формат по умолчанию -- «Embox FPS=%d» */
+  fps_set_format("Hello, world!\nFPS=%d"); /* \n работает в случае с format string */
+  while(1) {
+        fps_print(fbi);
+        msleep(100);
+  }
+```
+
+Теперь на экране (на второй строчке) должна появиться надпись наподобие «FPS=10».
+
+## Двойная буферизация
+
+Иногда рендеринг сцены занимает много времени, поэтому, если мы отрисовываем сцену непосредственно на базе фрейм-буфера, на экране появятся помехи или т. н. глитчи. Двойная буферизация -- это метод, который позволяет решить эту проблему.
+
+Идея в том, чтобы хранить дополнительный буфер «back» для отрисовки, пока основной фрейм остаётся неизменным.
+
+Ниже представлен первый способ использования «back»-буфера:
+```c
+struct fb_info *fbi = fb_lookup(0);
+
+fps_enable_swap(fbi);
+
+while (1) {
+        uint8_t *current_frame = fps_current_frame_fbi);
+        draw_something(current_frame);
+        fps_print(fbi);
+        /* Переместить содержимое «back»-буфера на экран */
+        fps_swap(fbi);
+}
+```
+
+Способы могут быть более мудрёными, если Вы хотите, чтобы фрейм был помещён в определённую область памяти (например, если это специализированная память конкретного устройства для временного буфера). В этом случае Вы можете установить основу фрейма, используя следующие функции:
+
+```c
+  void fps_set_base_frame(struct fb_info *fb, void *base_frame);
+  void fps_set_back_frame(struct fb_info *fb, void *base_back_frame);
+
+  /* Простой пример может выглядеть следующим образом */
+  struct fb_info *fbi = fb_lookup(0);
+
+  fps_set_base_frame(fbi, some_addr_1);
+  fps_set_back_frame(fbi, some_addr_2);
+
+  while (1) {
+        uint8_t *current_frame = fps_current_frame_fbi);
+        draw_something(current_frame);
+        fps_print(fbi);
+
+        /* Переместить содержимое «back»-буфера на экран */
+        fps_swap(fbi);
+  }
+```
+
+Обратите внимание: это будет корректно работать только в случае, если данное устройство вывода видео поддерживает изменение базы фрейм-буфера. В противном случае, будет работать только «простой» пример двойной буферизации.