-
Notifications
You must be signed in to change notification settings - Fork 94
/
INSTALL
170 lines (108 loc) · 7.26 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
1. Introduction
The following section provides some preliminary information and an overview of the document.
1.1. Purpose
This document describes how to build and deploy the Qtcam application software.
Qtcam is a camera application to capture photos and record videos. It is developed based on v4l2 framework and integrated with the help of Qt framework.
All the essential informations regarding building and deploying process are unfolded:
1. How to install library dependencies.
2. How to install and run the software, and the system requirements.
In addition to that, we collected some other useful information related to the build process such as a description of the project repository and the design of the build system.
1.2. Readership
The primary audience of this document is camera application developers who wish to build the software from scratch. We assume the reader has some familiarity with the Linux, unix shells and a knowledge of the Qt framework.
This document is also very useful as a guide to new developers and is a handy reference for camera application developers in linux. Moreover, the section on the design of the build system contains important information for the development. This is more technical information and is only targeted to developers.
1.3. Document Overview
The rest of this document is organized in the following sections:
1.3.1. Project Repository: Contains useful information on how the repository is organized and how to download it from our github server.
1.3.2. Build Process: Details how to build the software from the source code and how to build the other third party softwares. Additional information on the various steps of the build process is also provided as well as a list of all required libraries.
1.3.3. Deployment: How to install and run the software.
1.3.4. Future Directions: What is coming next in the build system. Again, this section is mainly relevant to developers.
1.3.5 Legal: Licenses and copyright information.
2. Project Repository
2.1. Repository Organization
The GitHub is the git module is the repository of the software artifacts of the Qtcam project. Its contents are as follows:
2.1.1 SRC: Contains the application source files.
2.1.2 LICENSE: A README file specifies which license applies.
2.1.3 CHANGELOG: New Application features and bug fixes are listed.
2.1.4 README: README file.
2.1.4 INSTALL: Installation procedure file.
2.2. Downloading from GitHub
Download the source from the following repository,
# git clone https://github.com/econsysqtcam/qtcam.git
3. Design of the Build System
The build process is designed for linux machine. User can download the source code of the application through git server.
Also user can install dependency library packages. Using Qt qmake tool, one can build the source.
3.1. System Requirements
In order to run Qtcam application, your system must have:
1. Qt 5.9.1
2. Operating System: Linux (Tested on Ubuntu 14.04, 16.04 ,18.04 versions)
3.2. Dependencies
To run the Qtcam application your system should meet the following dependencies.
3.2.1. Install Qt5.9.1 framework
Initially download the Qt package from the below link as per your system requirement,
For 64 Bit - http://download.qt.io/official_releases/qt/5.9/5.9.1/qt-opensource-linux-x64-5.9.1.run
To configure Qt, If permission is not given for user set it by using chmod command.
# chmod u+x qt-opensource-linux-x86-5.9.1.run
(or)
# chmod u+x qt-opensource-linux-x64-5.9.1.run
Then double click the downloaded binary and install it to your local system.
3.2.2. Run following command to install following list of dependency packages
In ubuntu 14,
$ sudo apt-get install libv4l-dev qt55base qt55declarative libavcodec-dev libgl1-mesa-dev libglu1-mesa-dev libavformat-dev libavutil-dev libswscale-dev libavresample-dev libudev-dev libavcodec-extra-54 libjpeg-turbo8-dev libusb-1.0-0-dev libusb-dev libevdev-dev libpulse-dev qt55multimedia qtdeclarative5-window-plugin qtdeclarative5-dialogs-plugin qtdeclarative5-controls-plugin qtdeclarative5-qtquick2-plugin qt55-meta-full libasound2-dev
In ubuntu 16.04,
$ sudo apt-get install libv4l-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libavresample-dev libudev-dev libavcodec-extra qt5-default qtdeclarative5-dev freeglut3 freeglut3-dev libjpeg-turbo8-dev libusb-1.0-0-dev libusb-dev libevdev-dev libpulse-dev qtmultimedia5-dev qtdeclarative5-window-plugin qtdeclarative5-dialogs-plugin qtdeclarative5-controls-plugin qtdeclarative5-qtquick2-plugin qtdeclarative5-qtmultimedia-plugin libasound2-dev
In ubuntu 18.04,
$sudo apt-get install libv4l-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libavresample-dev libudev-dev libavcodec-extra qt5-default qtdeclarative5-dev freeglut3 freeglut3-dev libjpeg-turbo8-dev libusb-1.0-0-dev libusb-dev libevdev-dev libpulse-dev qtmultimedia5-dev qtdeclarative5-window-plugin qml-module-qtquick-controls qml-module-qtquick-dialogs qml-module-qtquick-extras qml-module-qtquick-privatewidgets qtdeclarative5-qtquick2-plugin libasound2-dev libturbojpeg0-dev qtquickcontrols5-doc g++-5 lsb-release
In ubuntu 20.04,
$sudo apt-get install libv4l-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libavresample-dev libudev-dev libavcodec-extra qt5-default qtdeclarative5-dev freeglut3 freeglut3-dev libjpeg-turbo8-dev libusb-1.0-0-dev libusb-dev libevdev-dev libpulse-dev qtmultimedia5-dev qml-module-qtquick-controls qml-module-qtquick-dialogs qml-module-qtquick-extras qml-module-qtquick-privatewidgets libasound2-dev libturbojpeg0-dev qtquickcontrols5-doc g++ g++-10 lsb-release
3.3 Build the application
You can build your application in two ways
1. Qt Creator
2. Console
3.3.1 Using Qt Creator:
1. Open the project in your Qt creator.
2. Provide your qmake path in the Tool->Options.(/home/@user/Qt5.9.1/5.9.1/gcc_64/bin/qmake)
3. Set LAUNCHPAD macro in common.h to 0 in "src" directory.
4. Right click in your project, click qmake.
5. Right click in your project, click build
6. Right click in your project, click run.
3.3.2 Using Console:
1. Goto your git clone path.
2. cd src/
3. Set LAUNCHPAD macro in common.h to 0.
4. qmake,(For example, /home/@user/Qt5.9.1/5.9.1/gcc_64/bin/qmake)
5. make clean
6. make
7. Execute the application.
sudo ./Qtcam
Note:
*if qmake path is not found, use command "qtpaths --find-exe qmake".It will show qmake executable path.
4. Installation
Note: If qtcam is already installed, remove the qtcam accessory files using following commands and follow 4.1 section.
$ sudo rm -rf /usr/share/qml
$ sudo rm -rf /usr/share/applications/Qtcam*.desktop
$ sudo apt-get remove qtcam
4.1 Launchpad
4.1.1 Ubuntu 14
$ sudo apt-add-repository ppa:qtcam/trusty
$ sudo apt-get update
$ sudo apt-get install qtcam
4.1.2 Ubuntu 16.04
$ sudo apt-add-repository ppa:qtcam/xenial
$ sudo apt-get update
$ sudo apt-get install qtcam
4.1.3 Ubuntu 18.04
$ sudo apt-add-repository ppa:qtcam/bionic
$ sudo apt-get update
$ sudo apt-get install qtcam
4.1.4 Ubuntu 20.04
$ sudo apt-add-repository ppa:qtcam/focal
$ sudo apt-get update
$ sudo apt-get install qtcam
5. How to run the application
* By clicking Qtcam icon from Dash home
or
* By running command from terminal,
$sudo qtcam
5. Legal
5.1 Licensing
Please look into the LICENSE file available in the parent directory.