forked from econsysqtcam/qtcam
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathINSTALL
168 lines (109 loc) · 6.82 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
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.2.1
2. Operating System: Linux (Tested on Ubuntu 12.04, 14.04, 15.10, 16.04 versions)
3.2. Dependencies
To run the Qtcam application your system should meet the following dependencies.
3.2.1. Install Qt5.2.1 framework
Initially download the Qt package from the below link as per your system requirement,
For 32 Bit - http://download.qt.io/archive/qt/5.2/5.2.1/qt-opensource-linux-x86-5.2.1.run
For 64 Bit - http://download.qt.io/archive/qt/5.2/5.2.1/qt-opensource-linux-x64-5.2.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.2.1.run
(or)
# chmod u+x qt-opensource-linux-x64-5.2.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 12,
$ sudo apt-get install libv4l-dev libgl1-mesa-dev libglu1-mesa-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libresample1-dev libudev-dev libavcodec-extra-53 libjpeg-turbo8-dev libusb-1.0-0-dev
$ sudo apt-add-repository ppa:qtcam/precise
$ sudo apt-get install qt52base qt52declarative qt52-meta-full
In ubuntu 14,
$ sudo apt-get install libv4l-dev qt5-default libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libavresample-dev libudev-dev libavcodec-extra-54 qtdeclarative5-dev libusb-1.0-0-dev libjpeg-turbo8-dev qtdeclarative5-window-plugin qtdeclarative5-dialogs-plugin qtdeclarative5-controls-plugin qtdeclarative5-qtquick2-plugin
In ubuntu 15.10,
$ sudo apt-get install libv4l-dev qt5-default libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libavresample-dev libudev-dev libavcodec-extra qtdeclarative5-dev libusb-1.0-0-dev libjpeg-turbo8-dev qtdeclarative5-window-plugin qtdeclarative5-dialogs-plugin qtdeclarative5-controls-plugin qtdeclarative5-qtquick2-plugin
In ubuntu 16.04,
$ sudo apt-get install libv4l-dev qt5-default libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libavresample-dev libudev-dev libavcodec-extra qtdeclarative5-dev libusb-1.0-0-dev libjpeg-turbo8-dev qtdeclarative5-window-plugin qtdeclarative5-dialogs-plugin qtdeclarative5-controls-plugin qtdeclarative5-qtquick2-plugin
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.2.1/5.2.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.2.1/5.2.1/gcc_64/bin/qmake)
5. make clean
6. make
7. Execute the application.
sudo ./Qtcam
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 12
$ sudo apt-add-repository ppa:qtcam/precise
$ sudo apt-get update
$ sudo apt-get install qtcam
4.1.3 Ubuntu 15.10 [ Note: The source code build support is not available from Dec 2016 for wily[15.10] in launchpad . So finally built Qtcam application version is 11.0.1 for wily distribution ]
$ sudo apt-add-repository ppa:qtcam/wily
$ 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
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.