Difference between revisions of "Video API Extensions.Ru"
(23 intermediate revisions by 8 users not shown) | |||
Line 1: | Line 1: | ||
+ | {{Manual legacy_pages}} | ||
+ | |||
+ | {{ru|en=Video_API_Extensions|cn=Video_API_Extensions.cn}} | ||
+ | |||
Данная реализация Video API имеет ряд возможностей, которые отсутствуют в стандартном Axis Video API. | Данная реализация Video API имеет ряд возможностей, которые отсутствуют в стандартном Axis Video API. | ||
− | ==Включение расширений== | + | |
+ | == Включение расширений == | ||
По умолчанию расширения Video API заблокированы. Чтобы их разблокировать необходимо установить соответствующую переменную: | По умолчанию расширения Video API заблокированы. Чтобы их разблокировать необходимо установить соответствующую переменную: | ||
<nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ElphelExtensions.Enabled=yes</nowiki> | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ElphelExtensions.Enabled=yes</nowiki> | ||
− | ==Получение статических и динамических изображений== | + | |
+ | == Получение статических и динамических изображений == | ||
Стандартный интерфейс получения статических и динамических изображений в форматах JPEG и MJPG имеет ряд дополнительных параметров. | Стандартный интерфейс получения статических и динамических изображений в форматах 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> | <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> | ||
Line 39: | Line 63: | ||
<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> | ||
− | + | == Вывод информации о сотоянии системы и значениях по умолчанию == | |
− | ==Вывод информации о сотоянии системы и значениях по умолчанию== | ||
Чтобы получить информацию о переменных состояния системы, нужно использовать путь: | Чтобы получить информацию о переменных состояния системы, нужно использовать путь: | ||
<nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState</nowiki> | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState</nowiki> | ||
Line 47: | Line 70: | ||
<nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState&responseformat=xml</nowiki> | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState&responseformat=xml</nowiki> | ||
'''Примечание'''. Если responseformat не указан или указан неверно, то используется значение по умолчанию '''"rfc".''' | '''Примечание'''. Если 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 10:43, 8 April 2009
This is a legacy page. The information bellow is not compatible with Elphel 393 or 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