Difference between revisions of "Video API Extensions.Ru"

From ElphelWiki
Jump to: navigation, search
(Получение статических и динамических изображений)
Line 8: Line 8:
 
Стандартный интерфейс получения статических и динамических изображений в форматах JPEG и MJPG имеет ряд дополнительных параметров.
 
Стандартный интерфейс получения статических и динамических изображений в форматах JPEG и MJPG имеет ряд дополнительных параметров.
  
*e_dcm_hor - horisontal decimation
+
{| border="0" cellpadding="2"
*e_dcm_vert - vertical decimation
+
|-
*e_woi_width - window width
+
|e_dcm_hor ||-|| horisontal decimation (resolution/image size reduction)
*e_woi_height - window height
+
|-
*e_woi_left - window left top corner X-coordinate
+
|e_dcm_vert ||-|| vertical decimation (resolution/image size reduction)
*e_woi_top - window left top corner Y-coordinate
+
|-
*e_gamma
+
|e_woi_width ||-|| sensor active window width (before decimation)
*e_expos
+
|-
*e_bin_hor
+
|e_woi_height ||-|| sensor active window height (before decimation)
*e_bin_vert
+
|-
* ......
+
|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 ||-||
 +
| ||-||
 +
|}
  
 
Пример получения статического изображения с использованием данных параметров:
 
Пример получения статического изображения с использованием данных параметров:
Line 38: Line 56:
 
Изменить значение по умолчанию можно стандартным для Axis Video API способом. Например :
 
Изменить значение по умолчанию можно стандартным для Axis Video API способом. Например :
 
  <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_DcmHor=1</nowiki>
 
  <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_DcmHor=1</nowiki>
 
  
 
==Вывод информации о сотоянии системы и значениях по умолчанию==
 
==Вывод информации о сотоянии системы и значениях по умолчанию==

Revision as of 21:02, 12 December 2005

Данная реализация 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".