Imaging solutions with Free Software &
Open Hardware

Who's online

There are currently 0 users online.

Video API Extensions.Ru

From ElphelWiki

m
 
(3 intermediate revisions not shown)
Line 1: Line 1:
 +
{{Manual legacy_pages}}
 +
{{ru|en=Video_API_Extensions|cn=Video_API_Extensions.cn}}
{{ru|en=Video_API_Extensions|cn=Video_API_Extensions.cn}}
Line 6: Line 8:
== Включение расширений ==
== Включение расширений ==
По умолчанию расширения Video API заблокированы. Чтобы их разблокировать необходимо установить соответствующую переменную:
По умолчанию расширения Video API заблокированы. Чтобы их разблокировать необходимо установить соответствующую переменную:
-
  <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update</nowiki>
+
  <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ElphelExtensions.Enabled=yes</nowiki>
 +
 
 +
 
 +
== Получение статических и динамических изображений ==
 +
Стандартный интерфейс получения статических и динамических изображений в форматах JPEG и MJPG имеет ряд дополнительных параметров.
 +
 
 +
{| border="0" cellpadding="2"
 +
|-
 +
|e_dcm_hor ||-|| horisontal decimation (resolution/image size reduction)
 +
|-
 +
|e_dcm_vert ||-|| vertical decimation (resolution/image size reduction)
 +
|-
 +
|e_bin_hor ||-|| horizontal binning (sensitivity for lower resolution)
 +
|-
 +
|e_bin_vert ||-|| vertical binning (sensitivity for lower resolution)
 +
|-
 +
|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_fliph ||-|| flip (mirror) image horizontally (uses in-sensor capabilities)
 +
|-
 +
|e_flipv ||-|| flip (mirror) image vertically (uses in-sensor capabilities)
 +
|-
 +
|e_quality ||-|| JPEG Quality (%)
 +
|-
 +
|}
 +
 
 +
=== Примеры ===
 +
Пример получения статического изображения с использованием данных параметров:
 +
<nowiki>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</nowiki>
 +
 
 +
Пример получения динамического изображения (MPJPG) с использованием данных параметров:
 +
 
 +
<nowiki>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</nowiki>
 +
 
 +
Этот видеопоток можно воспроизвести, например, программой mplayer (более подробно см. [[Using Mplayer With Video API.Ru]]) :
 +
 
 +
<nowiki>$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"</nowiki>
 +
 
 +
Если какой-то из параметров не указан, то используется значение по умолчанию. Узнать эти значения можно по адресу :
 +
<nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.Sensor</nowiki>
 +
'''Примечание'''. Все расширения API имеют префикс "E_".
 +
 
 +
Изменить значение по умолчанию можно стандартным для 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=list&group=ImageSource.I0.E_CurrentState</nowiki>
 +
 
 +
Кроме стандартного формата вывода "'''rfc'''" есть также вывод в виде XML. Для этого необходимо использовать параметр '''responseformat'''. Например :
 +
<nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState&responseformat=xml</nowiki>
 +
'''Примечание'''. Если responseformat не указан или указан неверно, то используется значение по умолчанию '''"rfc".'''
 +
 
 +
 
 +
== Потоковое видео RTP/MJPG и RTP/Theora ==
 +
Камеры Elphel могут передавать потоковое видео по протоколу RTP.
 +
=== RTP/MJPG ===
 +
=== RTP/Theora ===
 +
 
 +
 
 +
== Управление экспозицией ==
 +
Камеры Elphel поддерживают как стандартный так и расширенный интерфейс управления экспозицией. О стандартных настройках см. [[Video_API.Ru]]
 +
 
 +
Чтобы включить автоавтоэкспозицию необходимо дать следующую команду :
 +
 
 +
<nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.Exposure=auto</nowiki>
 +
 
 +
Включить ручное управление экспозицией :
 +
<nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.Exposure=manual</nowiki>
 +
 
 +
Получить сведения о состоянии экспозиции можно так :
 +
<nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState.E_Exposure</nowiki>
 +
 
 +
Установить параметры окна:
 +
<nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_Exposure.E_WinWidth=30&ImageSource.I0.Sensor.E_Exposure.E_WinHeight=45&ImageSource.I0.Sensor.E_Exposure.E_WinLeft=10&ImageSource.I0.Sensor.E_Exposure.E_WinTop=20</nowiki>
 +
 
 +
Максимальные значения экспозиции :
 +
<nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_Exposure.E_Max=3000&ImageSource.I0.Sensor.E_Exposure.E_OverMax=30</nowiki>

Latest revision as of 17:43, 8 April 2009

This is a legacy page. The information bellow is not compatible with Elphel 353/363 series cameras.

in English | autotranslate | по-русски | 中文版

Данная реализация Video API имеет ряд возможностей, которые отсутствуют в стандартном Axis Video API.


Contents

Включение расширений

По умолчанию расширения 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_bin_hor - horizontal binning (sensitivity for lower resolution)
e_bin_vert - vertical binning (sensitivity for lower resolution)
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_fliph - flip (mirror) image horizontally (uses in-sensor capabilities)
e_flipv - flip (mirror) image vertically (uses in-sensor capabilities)
e_quality - JPEG Quality (%)

Примеры

Пример получения статического изображения с использованием данных параметров:

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".


Потоковое видео RTP/MJPG и RTP/Theora

Камеры Elphel могут передавать потоковое видео по протоколу RTP.

RTP/MJPG

RTP/Theora

Управление экспозицией

Камеры Elphel поддерживают как стандартный так и расширенный интерфейс управления экспозицией. О стандартных настройках см. Video_API.Ru

Чтобы включить автоавтоэкспозицию необходимо дать следующую команду :

http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.Exposure=auto

Включить ручное управление экспозицией :

http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.Exposure=manual

Получить сведения о состоянии экспозиции можно так :

http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState.E_Exposure

Установить параметры окна:

http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_Exposure.E_WinWidth=30&ImageSource.I0.Sensor.E_Exposure.E_WinHeight=45&ImageSource.I0.Sensor.E_Exposure.E_WinLeft=10&ImageSource.I0.Sensor.E_Exposure.E_WinTop=20

Максимальные значения экспозиции :

http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_Exposure.E_Max=3000&ImageSource.I0.Sensor.E_Exposure.E_OverMax=30