Video API Extensions.Ru
Данная реализация Video API имеет ряд возможностей, которые отсутствуют в стандартном Axis Video API.
Включение расширений
По умолчанию расширения Video API заблокированы. Чтобы их разблокировать необходимо установить соответствующую переменную:
http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ElphelExtensions.Enabled=yes
Получение статических и динамических изображений
Стандартный интерфейс получения статических и динамических изображений в форматах JPEG и MJPG имеет ряд дополнительных параметров.
e_dcm_hor | - | horisontal decimation (resolution/image size reduction) | |||
e_dcm_vert | - | vertical decimation (resolution/image size reduction) | |||
e_woi_width | - | sensor active window width (before decimation) | |||
e_woi_height | - | sensor active window height (before decimation) | |||
e_woi_left | - | sensor active window left margin (before decimation) | |||
e_woi_top | - | sensor active window top margin (before decimation) | |||
e_virt_width | - | virtual frame width | |||
e_virt_height | - | virtual frame height | |||
e_color | - | consider sensor to be the color one, if not - skip Bayer color filters processing | |||
e_gamma | - | ||||
e_expos | - | ||||
e_bin_hor | - | ||||
e_bin_vert | - | - |
Пример получения статического изображения с использованием данных параметров:
http://192.168.0.9/axis-cgi/jpg/image.cgi?e_dcm_hor=2&e_dcm_vert=2&e_woi_width=1000&e_woi_height=900&e_woi_left=600
Пример получения динамического изображения (MPJPG) с использованием данных параметров:
http://192.168.0.9/axis-cgi/mjpg/video.cgi?e_dcm_hor=2&e_dcm_vert=2&e_woi_width=1000&e_woi_height=900&e_woi_left=600
Этот видеопоток можно воспроизвести, например, программой mplayer (более подробно см. Using Mplayer With Video API.Ru) :
$mplayer -demuxer lavf "http://192.168.0.9/axis-cgi/mjpg/video.cgi?e_dcm_hor=2&e_dcm_vert=2&e_woi_width=1000&e_woi_height=900&e_woi_left=600&bogus.mjpg"
Если какой-то из параметров не указан, то используется значение по умолчанию. Узнать эти значения можно по адресу :
http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.Sensor
Примечание. Все расширения API имеют префикс "E_".
Изменить значение по умолчанию можно стандартным для Axis Video API способом. Например :
http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_DcmHor=1
Вывод информации о сотоянии системы и значениях по умолчанию
Чтобы получить информацию о переменных состояния системы, нужно использовать путь:
http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState
Кроме стандартного формата вывода "rfc" есть также вывод в виде XML. Для этого необходимо использовать параметр responseformat. Например :
http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState&responseformat=xml
Примечание. Если responseformat не указан или указан неверно, то используется значение по умолчанию "rfc".