Skip to content

Commit fbd3c18

Browse files
sarxossarxos
authored
Merge pull request #609 from yuripourre/master
Update READMEs
2 parents 3a238cf + 7ea25f7 commit fbd3c18

File tree

9 files changed

+174
-38
lines changed

9 files changed

+174
-38
lines changed

‎webcam-capture-drivers/driver-ffmpeg-cli/README.md‎

Lines changed: 25 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,16 +15,35 @@ code, or you would like to perform any enhancement, feel free to
1515
send pull request. Due to other urgent issues, I wont put any effort
1616
to enhance and/or fix this driver.
1717

18-
## How To Use It
18+
19+
## How To Use
1920

2021
Set new driver before you start using Webcam class:
2122

2223
```java
23-
Webcam.setDriver(new FFmpegCliDriver());
24-
Webcam webcam = Webcam.getDefault();
25-
webcam.open();
26-
// ... do your stuff
27-
webcam.close();
24+
public class TakePictureExample {
25+
26+
// set capture driver for ffmpeg tool
27+
static {
28+
Webcam.setDriver(new FFmpegCliDriver());
29+
}
30+
31+
public static void main(String[] args) throws IOException {
32+
33+
// get default webcam and open it
34+
Webcam webcam = Webcam.getDefault();
35+
webcam.open();
36+
37+
// get image from webcam device
38+
BufferedImage image = webcam.getImage();
39+
40+
// save image to PNG file
41+
ImageIO.write(image, "JPG", new File("test.jpg"));
42+
43+
// close webcam
44+
webcam.close();
45+
}
46+
}
2847
```
2948

3049
## License

‎webcam-capture-drivers/driver-fswebcam/README.md‎

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,9 @@ $ sudo apt-get install fswebcam
1010

1111
## Download
1212

13-
The latest **stable** ZIP bundle can be downloaded [here](http://repo.sarxos.pl/maven2/com/github/sarxos/webcam-capture-driver-fswebcam/0.3.10/webcam-capture-driver-fswebcam-0.3.10-dist.zip).
14-
15-
The latest **development** version JAR (aka SNAPSHOT) can be downloaded [here](https://oss.sonatype.org/service/local/artifact/maven/redirect?r=snapshots&g=com.github.sarxos&a=webcam-capture-driver-fswebcam&v=0.3.11-SNAPSHOT).
13+
The latest **development** version JAR (aka SNAPSHOT) can be downloaded [here](https://oss.sonatype.org/content/repositories/snapshots/com/github/sarxos/webcam-capture-driver-fswebcam/0.3.12-SNAPSHOT/webcam-capture-driver-fswebcam-0.3.12-20171213.184511-7.jar).
1614

15+
The latest **stable** ZIP bundle can be downloaded [here](http://repo.sarxos.pl/maven2/com/github/sarxos/webcam-capture-driver-fswebcam/0.3.11/webcam-capture-driver-fswebcam-0.3.11-dist.zip).
1716

1817
## Maven
1918

@@ -23,7 +22,7 @@ Stable:
2322
<dependency>
2423
<groupId>com.github.sarxos</groupId>
2524
<artifactId>webcam-capture-driver-fswebcam</artifactId>
26-
<version>0.3.10</version>
25+
<version>0.3.11</version>
2726
</dependency>
2827
```
2928

@@ -39,7 +38,7 @@ Snapshot:
3938
<dependency>
4039
<groupId>com.github.sarxos</groupId>
4140
<artifactId>webcam-capture-driver-fswebcam</artifactId>
42-
<version>0.3.11-SNAPSHOT</version>
41+
<version>0.3.12-SNAPSHOT</version>
4342
</dependency>
4443
```
4544

@@ -85,7 +84,7 @@ There are several known issues. If you have an idea of how those can be fixed, p
8584

8685
## License
8786

88-
Copyright (C) 2014 - 2015 Bartosz Firyn
87+
Copyright (C) 2012 - 2017 Bartosz Firyn
8988

9089
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
9190

‎webcam-capture-drivers/driver-gstreamer/README.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ the correct one! It is **not** compatible with GStreamer 1.0 and above!
1818

1919
## Download
2020

21-
The latest **development** version JAR (aka SNAPSHOT) can be downloaded [here](https://oss.sonatype.org/service/local/artifact/maven/redirect?r=snapshots&g=com.github.sarxos&a=webcam-capture-driver-gstreamer&v=0.3.10-SNAPSHOT).
21+
The latest **development** version JAR (aka SNAPSHOT) can be downloaded [here](https://oss.sonatype.org/content/repositories/snapshots/com/github/sarxos/webcam-capture-driver-gstreamer/0.3.12-SNAPSHOT/webcam-capture-driver-gstreamer-0.3.12-20171213.184528-7.jar).
2222

23-
The latest **stable** version ZIP bundle can be downloaded [here](http://repo.sarxos.pl/maven2/com/github/sarxos/webcam-capture-driver-gstreamer/0.3.10-RC7/webcam-capture-driver-gstreamer-0.3.10-RC7-dist.zip).
23+
The latest **stable** version ZIP bundle can be downloaded [here](http://repo.sarxos.pl/maven2/com/github/sarxos/webcam-capture-driver-gstreamer/0.3.11/webcam-capture-driver-gstreamer-0.3.11-dist.zip).
2424

2525
## Maven
2626

@@ -30,7 +30,7 @@ Stable:
3030
<dependency>
3131
<groupId>com.github.sarxos</groupId>
3232
<artifactId>webcam-capture-driver-gstreamer</artifactId>
33-
<version>0.3.10</version>
33+
<version>0.3.11</version>
3434
</dependency>
3535
```
3636

@@ -46,7 +46,7 @@ Snapshot:
4646
<dependency>
4747
<groupId>com.github.sarxos</groupId>
4848
<artifactId>webcam-capture-driver-gstreamer</artifactId>
49-
<version>0.3.11-SNAPSHOT</version>
49+
<version>0.3.12-SNAPSHOT</version>
5050
</dependency>
5151
```
5252

@@ -68,7 +68,7 @@ public static void main(String[] args) {
6868

6969
## License
7070

71-
Copyright (C) 2012 - 2014 Bartosz Firyn
71+
Copyright (C) 2012 - 2017 Bartosz Firyn
7272

7373
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
7474

‎webcam-capture-drivers/driver-ipcam/README.md‎

Lines changed: 4 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -25,25 +25,19 @@ help :) Later, when your class is ready, I will be happy to merge it with offici
2525

2626
## Download
2727

28-
The latest **development** version JAR (aka SNAPSHOT) can be downloaded [here](https://oss.sonatype.org/service/local/artifact/maven/redirect?r=snapshots&g=com.github.sarxos&a=webcam-capture-driver-ipcam&v=0.3.10-SNAPSHOT).
28+
The latest **development** version JAR (aka SNAPSHOT) can be downloaded [here](https://oss.sonatype.org/content/repositories/snapshots/com/github/sarxos/webcam-capture-driver-ipcam/0.3.12-SNAPSHOT/webcam-capture-driver-ipcam-0.3.12-20171213.184535-7.jar).
2929

30-
The latest **stable** version ZIP bundle can be downloaded [here](http://repo.sarxos.pl/maven2/com/github/sarxos/webcam-capture-driver-ipcam/0.3.10-RC7/webcam-capture-driver-ipcam-0.3.10-RC7-dist.zip).
30+
The latest **stable** version ZIP bundle can be downloaded [here](http://repo.sarxos.pl/maven2/com/github/sarxos/webcam-capture-driver-ipcam/0.3.11/webcam-capture-driver-ipcam-0.3.11-dist.zip).
3131

3232
## Maven
3333

3434
Stable:
3535

36-
```xml
37-
<repository>
38-
<id>SarXos Repository</id>
39-
<url>http://www.sarxos.pl/repo/maven2</url>
40-
</repository>
41-
```
4236
```xml
4337
<dependency>
4438
<groupId>com.github.sarxos</groupId>
4539
<artifactId>webcam-capture-driver-ipcam</artifactId>
46-
<version>0.3.10-RC7</version>
40+
<version>0.3.11</version>
4741
</dependency>
4842
```
4943

@@ -59,7 +53,7 @@ Snapshot:
5953
<dependency>
6054
<groupId>com.github.sarxos</groupId>
6155
<artifactId>webcam-capture-driver-ipcam</artifactId>
62-
<version>0.3.10-SNAPSHOT</version>
56+
<version>0.3.12-SNAPSHOT</version>
6357
</dependency>
6458
```
6559

‎webcam-capture-drivers/driver-jmf/README.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ It can also be used with the alternative [FMJ](http://fmj-sf.net/).
1010

1111
## Download
1212

13-
The latest **development** version JAR (aka SNAPSHOT) can be downloaded [here](https://oss.sonatype.org/service/local/artifact/maven/redirect?r=snapshots&g=com.github.sarxos&a=webcam-capture-driver-jmf&v=0.3.10-SNAPSHOT).
13+
The latest **development** version JAR (aka SNAPSHOT) can be downloaded [here](https://oss.sonatype.org/content/repositories/snapshots/com/github/sarxos/webcam-capture-driver-jmf/0.3.12-SNAPSHOT/webcam-capture-driver-jmf-0.3.12-20171213.184548-7.jar).
1414

15-
The latest **stable** version ZIP bundle can be downloaded [here](http://repo.sarxos.pl/maven2/com/github/sarxos/webcam-capture-driver-jmf/0.3.10-RC7/webcam-capture-driver-jmf-0.3.10-RC7-dist.zip).
15+
The latest **stable** version ZIP bundle can be downloaded [here](http://repo.sarxos.pl/maven2/com/github/sarxos/webcam-capture-driver-jmf/0.3.11/webcam-capture-driver-jmf-0.3.11-dist.zip).
1616

1717

1818
## Maven
@@ -23,7 +23,7 @@ Release:
2323
<dependency>
2424
<groupId>com.github.sarxos</groupId>
2525
<artifactId>webcam-capture-driver-jmf</artifactId>
26-
<version>0.3.9</version>
26+
<version>0.3.11</version>
2727
</dependency>
2828
```
2929

@@ -39,7 +39,7 @@ Stable:
3939
<dependency>
4040
<groupId>com.github.sarxos</groupId>
4141
<artifactId>webcam-capture-driver-jmf</artifactId>
42-
<version>0.3.10-RC7</version>
42+
<version>0.3.12-SNAPSHOT</version>
4343
</dependency>
4444
```
4545

@@ -77,7 +77,7 @@ public static void main(String[] args) {
7777

7878
## License
7979

80-
Copyright (C) 2012 - 2014 Bartosz Firyn
80+
Copyright (C) 2012 - 2017 Bartosz Firyn
8181

8282
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
8383

‎webcam-capture-drivers/driver-lti-civil/README.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,9 @@ do not have Mac OS machine to perform tests.
1515

1616
## Download
1717

18-
TBD
18+
The latest **development** version JAR (aka SNAPSHOT) can be downloaded [here](https://oss.sonatype.org/content/repositories/snapshots/com/github/sarxos/webcam-capture-driver-lti-civil/0.3.12-SNAPSHOT/webcam-capture-driver-lti-civil-0.3.12-20171213.184558-6.jar).
19+
20+
The latest **stable** version ZIP bundle can be downloaded [here](http://repo.sarxos.pl/maven2/com/github/sarxos/webcam-capture-driver-lti-civil/0.3.11/webcam-capture-driver-lti-civil-0.3.11-dist.zip).
1921

2022
## Maven
2123

‎webcam-capture-drivers/driver-opencv/README.md‎

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,20 @@
1-
# webcam-capture-driver-jmf
1+
# webcam-capture-driver-opencv
22

33
This is capture driver which uses [JavaCV](https://github.com/bytedeco/javacv)
44
interface to [OpenCV](http://opencv.org/) to access camera devices.
55

66
## Maven
77

8+
Stable:
9+
10+
```xml
11+
<dependency>
12+
<groupId>com.github.sarxos</groupId>
13+
<artifactId>webcam-capture-driver-javacv</artifactId>
14+
<version>0.3.11</version>
15+
</dependency>
16+
```
17+
818
Snapshot:
919

1020
```xml
@@ -25,11 +35,11 @@ Snapshot:
2535

2636
```java
2737
static {
28-
Webcam.setDriver(new JmfDriver());
38+
Webcam.setDriver(new JavaCvDriver());
2939
}
3040

3141
public static void main(String[] args) {
32-
JFrame frame = new JFrame("JMF Webcam Capture Driver Demo");
42+
JFrame frame = new JFrame("JavaCv Capture Driver Demo");
3343
frame.add(new WebcamPanel(Webcam.getDefault()));
3444
frame.pack();
3545
frame.setVisible(true);

‎webcam-capture-drivers/driver-openimaj/README.md‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# webcam-capture-driver-openimaj
2+
3+
This is capture driver which uses [OpenIMAJ](http://openimaj.org) to access camera devices.
4+
5+
## Maven
6+
7+
Stable:
8+
9+
```xml
10+
<dependency>
11+
<groupId>com.github.sarxos</groupId>
12+
<artifactId>webcam-capture-driver-openimaj</artifactId>
13+
<version>0.3.11</version>
14+
</dependency>
15+
```
16+
17+
Snapshot:
18+
19+
```xml
20+
<repository>
21+
<id>Sonatype OSS Snapshot Repository</id>
22+
<url>http://oss.sonatype.org/content/repositories/snapshots</url>
23+
</repository>
24+
```
25+
```xml
26+
<dependency>
27+
<groupId>com.github.sarxos</groupId>
28+
<artifactId>webcam-capture-driver-openimaj</artifactId>
29+
<version>0.3.12-SNAPSHOT</version>
30+
</dependency>
31+
```
32+
33+
## Example
34+
35+
```java
36+
static {
37+
Webcam.setDriver(new OpenImajDriver());
38+
}
39+
40+
public static void main(String[] args) {
41+
JFrame frame = new JFrame("OpenIMAJDriver Capture Driver Demo");
42+
frame.add(new WebcamPanel(Webcam.getDefault()));
43+
frame.pack();
44+
frame.setVisible(true);
45+
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
46+
}
47+
```
48+
49+
## License
50+
51+
Copyright (C) 2012 - 2017 Bartosz Firyn
52+
53+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
54+
55+
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
56+
57+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
58+

‎webcam-capture-drivers/driver-vlcj/README.md‎

Lines changed: 56 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,65 @@ The vlcj library is distributed according to the terms of the [GPL](http://www.g
88

99
## Maven
1010

11-
Not yet available.
11+
Stable:
12+
13+
```xml
14+
<dependency>
15+
<groupId>com.github.sarxos</groupId>
16+
<artifactId>webcam-capture-driver-vlcj</artifactId>
17+
<version>0.3.11</version>
18+
</dependency>
19+
```
20+
21+
Snapshot:
22+
23+
```xml
24+
<repository>
25+
<id>Sonatype OSS Snapshot Repository</id>
26+
<url>http://oss.sonatype.org/content/repositories/snapshots</url>
27+
</repository>
28+
```
29+
```xml
30+
<dependency>
31+
<groupId>com.github.sarxos</groupId>
32+
<artifactId>webcam-capture-driver-vlcj</artifactId>
33+
<version>0.3.12-SNAPSHOT</version>
34+
</dependency>
35+
```
36+
37+
## How To Use
38+
39+
Set capture driver before you start using Webcam class:
40+
41+
```java
42+
public class TakePictureExample {
43+
44+
// set capture driver for fswebcam tool
45+
static {
46+
Webcam.setDriver(new VlcjDriver());
47+
}
48+
49+
public static void main(String[] args) throws IOException {
50+
51+
// get default webcam and open it
52+
Webcam webcam = Webcam.getDefault();
53+
webcam.open();
54+
55+
// get image from webcam device
56+
BufferedImage image = webcam.getImage();
57+
58+
// save image to PNG file
59+
ImageIO.write(image, "JPG", new File("test.jpg"));
60+
61+
// close webcam
62+
webcam.close();
63+
}
64+
}
65+
```
1266

1367
## Capture Driver License
1468

15-
Copyright (C) 2012 - 2015 Bartosz Firyn <https://github.com/sarxos>
69+
Copyright (C) 2012 - 2017 Bartosz Firyn <https://github.com/sarxos>
1670

1771
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
1872

0 commit comments

Comments
 (0)