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
170
171
172
173
174
175
176
177
178
179
180
|
R E L E A S E N O T E S
-------
v1.8
-------
Minor bugfix release. Last release before next generation 2.0 release.
-------
v1.7
-------
This release fixes a few bugs related to deadlocks when stopping a dv1394
capture and file permissions. Also, --duration should be slightly more accurate
especially for specifying 1 frame: --duration smpte=:::1.
P.S. You can capture a specific number of frames using --duration smpte=:::X
whereas the --frames option is used for file splitting.
-------
v1.6
-------
This is an enhancement release with some bug and compilation fixes. New options
are --timesys for timestamping filenames using the system date and time,
and --csize, and --cmincutsize for fine-grained control over sizes of
collections of files useful for creating archives to CD or DVD.
-------
v1.5
-------
This is a bugfix release. There were bugs in the AVI file creation especially
for files near or greater than 1GB. Also, the --every option was broken in
the past 2 releases. There are also changes to make dvgrab behave nicer when
a camera is in camera mode rather than VTR mode. Finally, --autosplit is
enhanced to check timecode discontinuity as well as the special flag in the
DV stream.
----
v1.4
----
This is mainly a bugfix release. To prevent issues with dvgrab running in a
non-interactive shell script, dvgrab now requires the --stdin option to
read DV from a pipe. Also, option --noavc was added to prevent any attempt
to control the camera, which is especially useful if you are capturing from
your device in camera mode as opposed to VTR mode. Another new option --guid
lets you select from more than one device by its GUID (see
/proc/bus/ieee1394/devices to lookup a GUID). Finally, some changes were made
in the AVI file to reduce memory consumption on very large file captures and
to prevent occasional segfaults.
----
v1.3
----
This is a major release prepared by Dan Dennedy that adds AV/C control and
an interactive mode. The default mode of operation is non-interactive to
prevent breaking existing users' scripts. However, dvgrab 1.3 will issue
an AV/C command to tell the camera VTR to start playing. Therefore, dvcont
may no longer be required. However, heed caution! If your camera is not in VTR
mode, but is in camera mode, the play command tells the camera to start
recording!
One enters interactive mode by supplying the -i or --interactive options.
From there, the command prompt describes the single key presses available
to control the camera and start/stop capture.
All dvgrab 1.3 messages are written to stderr (normally connected to your
terminal so you can see them) and include a consistent, easy-to-parse format
for status, event, and error messages.
dvgrab 1.3 can also write raw DV to stdout while simultaneously capturing to
a file. This behavior is automatic when you redirect stdout or pipe the command.
This is especially nice with recent versions of Xine and mplayer as they
can display DV with deinterlacing and adjusting for the non-square pixel aspect
ratio of DV. For example,
dvgrab -i | xine -D stdin://#demux:rawdv
The last part of the Xine MRL in the line above is important; otherwise, xine
does not know the data format of the pipe!
All of the above means one can build a user interface frontend (non-GPL even)
to dvgrab by fork()ing and exec()ing dvgrab with pipes established between the
frontend and dvgrab.
Building upon the pipe capabilities, in non-interactive mode dvgrab 1.3 accepts
raw DV on stdin. If detected, dvgrab forgoes any 1394-based capture method.
This allows one to leverage the file format writing and splitting options of
dvgrab in conjunction with raw DV producers such as smilutils and ffmpeg.
A grand new option is --duration, which specifies a maximum duration for
an entire capture session regardless of splitting. Furthermore, the argument
to this option is specified in SMIL2 time value formats, which is quite
expressive. Note, that in interactive mode, starting capture starts a new
session. Thus, in interactive mode, you can have multiple capture sessions
by stopping and re-starting.
Additional changes include some friendlier defaults and automatic options.
dvgrab 1.3 will look on all your 1394 buses/host adapters for your camera
without the explicit --card opion. It selects the first camera discovered.
Type 2 AVI is now the default file format for increased compatibility with
other applications. Now, supplying --frames and --size options that cause
dvgrab to generate an AVI >1GB automatically enables the --opendml option.
Finally, the base filename argument is optional now too and defaults to
"dvgrab-".
----
v1.2
----
This release is a major new release prepared by Dan Dennedy that pulls in
much of what improved upon in Kino plus more.
AVI file correctness and compatibility has been improved upon.
1.1 beta releases allowed one to specify small and large indexes.
This is no longer required; it is automatic now based upon general
practice observed in AVIs created by other applications. Instead,
now there is a new --opendml option for use with type 2 DV AVI
(--format dv2).
OpenDML is a specification of AVI extensions created by Matrox in
collaboration with others and approved by Microsoft. OpenDML
introduced a new index structure, which dvgrab 1.1 called the
"large" index. Type 1 DV AVI (dv1) is inherently OpenDML,
and it contains a large index only. dvgrab 1.2 type 2 always contain
a small index, but OpenDML adds a large index to permit type 2 AVIs
greater than 1GB.
The main difference between a type 1 and type 2 file is that a type 2
contains a separate audio stream extracted from the DV. dvgrab 1.2
can use libdv (must be detected when compiled) to create this audio stream
instead of using internal routines. There are several advantages of
using libdv the most obvious being audio block error handling. Without
error handling, one can hear "bleeps" in the audio stream.
Raw DV capture has been improved to prevent corrupt files in the event of
a dropped firewire packet. Also, one can send raw DV to stdout instead
of to a file, so it can be used in pipes. This is especially useful with
smilutils. For example, one can preview video with libdv's playdv utility:
dvgrab - | playdv --no-mmap
The '-' file designation forces the format to raw overridding whatever
you specify; the other formats are not streaming formats.
Support for Quicktime has been added if libquicktime is detected when
compiled. Use "--format qt." It creates a separate audio track in twos
complement format.
Support for JPEG has been added if jpeglib is deteced when compiled.
Use "--format jpeg" to save a series of sequentially numbered JPEG
still images. There are two number parts of the filename, the first number
is increments with each scene change while the second number increments
with each successive save. Use --jpeg-overwrite to continually update the
same file and not add any numbers to the file name stem you provide. The
JPEG option works nicely with the --every option.
There are several JPEG options you will find handy. First, is --jpeg-quality
followed by a number between 0 and 100; the default is 75.
--jpeg-deinterlace extracts one of the fields and doubles it for a cheap
form of deinterlacing. However, when used with the scaling options
--jpeg-width and --jpeg-height to reduce the resolution by 50%,
you can get perfect deinterlaced output. The scaling
options also allow one to compensate for the non-square pixels of DV.
For example, on NTSC, the following produces nice output for a webcam,
dvgrab --format jpeg --jpeg-deinterlace --jpeg-width 320 --jpeg-height 240
Due to code refactorization, all capture options work with all formats.
For example, previous versions of dvgrab did not support hardly any
options like --autosplit, --every, --timestamp, and --frames when used
with --format raw.
A new capture option --size followed by a number in mega bytes, sets
the maximum file size of any captured file.
If all this were not enough; dvgrab 1.2 also supports capture using the
new dv1394 driver! See http://www.linux1394.org/dv1394.html for more
information on this driver. By default and traditionally, dvgrab uses
raw1394; however, raw1394 requires an interrupt for each packet, which
can be too intense for some systems. dv1394 in kernel releases 2.4.21 or
recent linux1394.org Subversion snapshots drastically reduce the IRQ and
using kernel background threads and internal buffering. You must use the
--dv1394 option followed by the device file name to use dv1394 instead
of raw1394.
|
