VisionWorks Toolkit Reference

December 18, 2015 | 1.2 Release

 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
stable/nvgstcamera_capture/nvgstcamera_capture_user_guide.md
Go to the documentation of this file.
1 <!-- Copyright (c) 2015, NVIDIA CORPORATION. All rights reserved. -->
2 
3 @defgroup vwx_sample_nvcamera_capture (L4T R23) NVIDIA GStreamer Camera Capture Sample App
4 @brief NVIDIA GStreamer Camera Capture Sample user guide.
5 @ingroup nvx_samples
6 @{
7 
8 <a name="Introduction">
9 ## Introduction ##
10 
11 `nvx_sample_nvgstcamera_capture` demonstrates NVIDIA GStreamer camera access. The sample is tested with
12 the E2146 camera module.
13 
14 @note This sample is supported only on Jetson Embedded platforms running L4T R23 OS.
15 
16 `nvx_sample_nvgstcamera_capture` is installed in the following directory:
17 
18  /usr/share/visionworks/sources/samples/nvgstcamera_capture
19 
20 For the steps to build sample applications, see the @ref nvx_sample_building_linux section.
21 
22 <a name="Available Camera modes">
23 ## Available Camera modes
24 
25 | Resolution | Frames per second |
26 |:-----------:|:-----------------:|
27 | `2592x1944` | 30 |
28 | `2592x1458` | 30 |
29 | `1280x720` | 120 |
30 
31 <a name="Executing">
32 ## Executing the NVIDIA GStreamer Camera Capture Sample ##
33 
34  ./nvx_sample_nvgstcamera_capture [options]
35 
36 ### Command Line Options ###
37 
38 This topic provides a list of supported options and the values they consume.
39 
40 #### \-c, \--camera ####
41 - Parameter: [input camera device ID]
42 - Description: Specifies the input camera device ID.
43 - Usage:
44 
45  - `--camera=0` for the first camera
46  - `--camera=1` for the second camera.
47 
48 #### \-r, \--resolution ####
49 - Parameter: [resolution]
50 - Description: Specifies the resolution.
51 - Usage: `--resolution=1280x720` for capturing `720p` frames.
52 - Supported resolution settings:
53 
54  - `2592x1944`
55  - `2592x1458`
56  - `1280x720`
57  - `640x480`
58 
59 #### \-f, \--fps ####
60 - Parameter: [fps]
61 - Description: Specifies the frame per second.
62 - Usage: `--fps=30` to capture 30 frames per second.
63 - Supported FPS settings: `[10, 120]`
64 
65 @note The actual FPS value may differ from the specified one:
66 1. Custom resolutions such as `640x480` cannot be played with FPS higher than 30.
67 2. FPS for native resolutions cannot be higher than the native value.
68 
69 #### \-h, \--help ####
70 - Description: Prints the help message.
71 
72 ### Operational Keys ###
73 - Use `Space` to pause/resume the sample.
74 - Use `ESC` to close the sample.
75 
76 @}