V 0.50
UI overhaul and nearly total rewrite. Read the online help and just
play around to see what all is new.

Notable additions:
* playlist is now SMIL
* export mutliple still frames
* export audio
* online help
* timeline (scene thumbnails)

bugfix: ParseRIFF used the physical file length instead of values in file
header. Therefore, AVI files containing unused bytes at the end crashed
Kino, because ParseRIFF tried to interpret the garbage.


V 0.46
This version mostly fixes critical bugs with memory consumption, audio 
initialization, and performance during capture when audio enabled and 
preview disabled.

This version fixes a bug writing AVI type 2 DV files thereby increasing
compatibility with other programs especially Windows video editors. dvgrab
has not yet been updated with this fix. We have retained backwards 
compatibility while reading old AVI dv2 files generated by dvgrab or Kino.
Note, however xdvplay (also from Arne Schirmacher will not read new 
AVI dv2 files generated by Kino. aviplay from the avifile project is able
to play both old and new dv2 files quite nicely.

The Contour ShuttlePro driver now implements all 9 buttons at the top.
The top four buttons are for editing:
paste before, cut to start of sequence, cut to end of sequence, paste after
The second row of five buttons are for navigation:
begin, start of/prev sequence, play/pause, next sequence, end

Contents of README moved to NEWS, and new README started.

V 0.45
****************************************************************************
IMPORTANT: 
An updated video1394 driver (video1394.h, video1394.c) is supplied
with this distribution. You must replace the existing driver in your
Linux kernel sources, recompile the modules, and reload the video1394
module.
****************************************************************************
This version fixes some bugs. Added preferences to set the audio device
name. I found one system that did not have a /dev/dsp, which was the 
hardcoded device, but did have /dev/audio! There was a bug introduced with
version 0.41 affecting playback performance due to audio support: with
audio disabled, audio was still decoded from the DV frame even though it
was not played back.

The space bar behaves different now; it toggles between play and pause.
I know it's not consistent with vi, but text editors just don't typically
have functions to automatically cursor through each character in a file!
I would expect more loose interpretation of the vi command set as the
functionality of Kino increases, but the goal is to continue to be
keyboard driven and switch between modes as vi does. Therefore, I switched
:w and :W too. :w now saves the playlist, and :W saves a new, composite AVI.
I did this because very soon we will use :W to switch into a general export
mode for different file formats as well as to the camera. The Kino playlist
is the native file format that corresponds more directly with the lower case
command.

We have added a drop frame option for the preview window. (We never
intentionally drop frames capturing to disk or during export!) This only
applies to the video displayed in the editor window. The drop
frame support attempts to produce gapless audio (reduce choppiness) as
well as play back at a normal time rate. However, slow machines (my AMD-333)
may still have slight gaps in the audio because decoding and playing back
audio alone is slower than the normal frame rate. Therefore, there is no
way to guarantee gapless audio. Also, for these slow machines, the minimum
framerate is one frame-per-second so at least you see some video updates.
You may not find that desirable or acceptable, but the hardware and dv
decoder are just not fast enough.

Now, currently, enabling drop frame is also required to slow down fast
machines. I know it sounds ironic, but the logic is intertwined with drop
frame processing. Just think of this setting as an attempt to maintain the
video's normal frame rate. This is not tested well. I could only test this
by using a low decoder quality setting on my AMD 800.

Using drop frame in conjunction with the DV decoder quality at a lower
setting, you might find an acceptable combination of speed and quality.
The second lowest setting is meaningful now and displays a non-
blocky monochrome picture. I find the second highest setting to enhance
performance while still having quite good quality. Also, just a 
clarification, the DV decoder quality option does not affect the output
of the AVI files or when exporting to the camera! 

We added support for Sony Jog/Shuttle (Asia market) and Contour ShuttlePro
USB controllers thanks to Tomoaki Hayasaka! ShuttlePro is popular in the
U.S., and can be purchased from many online retailers including
http://www.dvdirect.com/ for about USD $120. Look at the comments at the 
top of Makefile.jog to figure out how to setup. There are preferences items
to enable this and set the device name.

Also, we have a man page now through a contribution from Daniel
Kobras who will be cooking up some Debian packages for us.

If you are using kernel 2.4.7, you may find that video1394 crashes. An
updated video1394.c is supplied with this version.

V. 0.44
For PAL export, the value 1076129132 is required in the SYT offset field
in the Preferences dialog.

V. 0.43
IMPORTANT: use the new libavc1394 v0.2.2.
Bug fixes, see ChangeLog.
There is a new option in the Display Options tab of the Preferences dialog:
Enable preview during capture. If this is off, then the capture window
stops displaying the video during the actual process of capture (when
you click start grabbing). This is good for slower machines to prevent
dropped or corrupt video frames.

V. 0.42
Improved DV export for NTSC users. Thanks to Yamazaki Makoto for pointing
out an error in the 50/60 flag in the 1394 isochronous CIP headers.

V. 0.41
****************************************************************************
IMPORTANT: 
From this version on, libavc1394 and librom1394 are required.
You can get them from http://sourceforge.net/projects/libavc1394/.
Also, this version requires an updated video1394 driver that is supplied
with this distribution. You must replace the existing driver in your
Linux kernel sources, recompile the modules, and reload the video1394
module.
****************************************************************************

Dan Dennedy has contributed this version as Arne is quite busy lately.
This version's goals include componentization, user interface improvements,
and most importantly empowering users to tune DV export. Hopefully, we will
hear more success stories about DV export for NTSC users.

I, Dan Dennedy, am working on a number of components for linux1394.
The first of these is libavc1394 and librom1394. These
replace some code that was in Kino because the code was originally borrowed
from gscanbus. Also, the dvcont utility borrowed the AV/C and raw1394util
code from gscanbus. Therefore, it makes sense to turn these functions into
a shared object library. This version of Kino uses these components.

Kino 0.41 includes several user interface improvements. Most noticeable, 
audio playback is implemented now but only through OSS. It can be disabled 
in the display options tab of the preferences dialog. Please do not ask
for other audio playback methods (e.g., esd, ALSA) unless you want to
contribute them. We are looking at porting to the gstreamer framework,
which is very capable of accomodating many needs including different
audio playback methods. Next, key repeat is disabled to prevent the 
event queue from filling up on slow machines thereby forcing you to wait
for each frame update to occur. Only certain keyboard navigation commands
repeat until the key is released: next and previous frame, next and previous
second. Along with that feature, the Stop button in the main window toolbar
now works. Any keystroke also stops playback. You may find that if Kino 
crashes, key repeat is disable for the entire desktop until X is restarted.
Also, the current directory is remembered between file dialogs--no need to
keep changing to your project directory. Finally, preferences are saved to
~/.gnome/kino so you do not need to set them evey time you start Kino!

DV export continues to be a sore spot for NTSC users. Some PAL users have
experienced issues as well that were easy to cleanup once they were told
what changes to try in the source code. Well, this version makes some
minor improvements to the DV export algorithms at all levels including
the video1394 kernel driver. Furthermore, this version of Kino makes these
timing values that need to be adjusted available to the end user through
the preferences dialog. This helps greatly so you do not have to recompile
code, reload a driver module, and launch Kino with a video clip just to
test a tweak one of these values. Now, you can simply adjust and try the
export again!

My NTSC camera (Panasonic PV-DV910) works great with a fairly broad
range of values. Therefore, I estimate that these values, editable in
the IEEE 1394 Options tab of the preferences dialog represent the
limits that most any device could support:

Timing (NTSC users only): 1000-3300, the default is 2436.
SYT Offset (NTSC and PAL): 10000-23000, the default is 11000.

Yours in Freedom,
+-DRD-+

V. 0.35

The patches keep coming in. Dan has improved the timing when exporting
to a NTSC DV Camcorder. He also got the AV/C commands working. Note
that the export function requires a fairly new ieee1394 subsystem.

To save a frame as a jpg file, use the extension ".jpg". Or use
extensions ".gif", ".tif", ".ps" (and more) for additional formats.

It is no longer necessary to use a modified libdv library, as the
changes have made it into the official libdv version. You do need a
new version of libdv, because all earlier versions of libdv won't
work.  An unmodified snapshot of libdv is included. Please install it.

Kino should now compile on older XFree86 versions (3.x) that do not
have the Xv extension.

I have added more error checking and a function suggesting the
equivalent keyboard command when using the menu (hey, you can now use
Kino as a vi tutor).


V. 0.34

I merged in two patches: Dan Dennedy provided a bugfix for
Xv of NTSC images and Bill Allombert sent in code for saving
a frame as an image file.


V. 0.33
Jan. 11, 2001

After I got Peter Schlaile's modified video1394 driver and sample
code, I was able to put in a DV-Out function. Very cool. It seems to
be stable, at least for PAL. See the README_DVOUT file for more
details.

I modified the libdv code slightly so that I can use a faster gdk
function for displaying. Nothing interesting, just a different byte
ordering, but I hope this modification will make it into the official
libdv distribution. The new gdk function also does not show this
"tearing" effect during display.  The function is faster only when
using 24 bit display depth. Please install the included patched
version of libdv before compiling Kino (or enable the old code in
frame.cc and display.cc).


V. 0.32
Jan. 05, 2001

Kino now uses a recent version of libdv. It is included in this
package for your convenience, but you can always get the latest
version from http://sourceforge.net/projects/libdv/ .
You must install it before compiling Kino. See the instructions
in the libdv subdirectory.

There is now some rudimentary support for the Xv extensions. This
allows Kino to use hardware accelleration if the graphics card and
the X server supports it.
It is not turned on by default, please see the README_XV document
for more info.

If you have installed Jason Howard's dvcont program in
/usr/local/bin/dvcont, then the camcorder control buttons actually
work. This is of course a workaround, but I could not get the av/c
code working from inside Kino. 
dvcont is also included.

Bug fixes: Kino does not crash anymore when grabbing very long
NTSC Type 2 AVI files.


V. 0.31
Dec. 31, 2000

During editing of a few hundred MByte of DV footage I noticed that
files having more than 4028 frames could not correctly edited. This
has been fixed. 

Progress dialog for lengthy operations added.


V. 0.3
Dec. 28, 2000

I have merged my dvgrab program into Kino. To use the new function,
connect your DV camcorder and go into the "Capture" dialog. You should
already see live video when you open the dialog (if your camcorder is
turned on and either playing a tape or in camera mode). Click on the
"start grabbing" button to start capturing, then stop it by clicking
on the "stop grabbing" button.  Enter the file name and other options
in the "prepare grabbing" dialog.

For serious DV capturing please use "dvgrab", because the merged
source code had to be modified to fit into Kino and it may be less
reliable than dvgrab.

The current version of dvgrab is 0.89 and you can download it from
http://www.schirmacher.de/arne/dvgrab/ .

In case of problems please post your question in the Kino support forum:

http://www.schirmacher.de/cgi-bin/dcboard.cgi?az=list&forum=DCForumID4&conf=conference


V. 0.21
Nov. 24, 2000

After starting Kino, use the :r command to load one or more
AVI files with Digital Video (DV) content. Use the navigation
commands listed below to move around in your movie. You can
delete frames using the x command and insert more AVI or Kino
files at the current position.

The commands are very similar to the vi editor commands. Just
think of a frame as one character, a recording as one text line
and the whole movie as one text file.
emacs commands will follow.

When you are done, save the movie using the :w command in the
AVI file format. You can also save the playlist using the :W
(uppercase) command. The playlist contains the position and 
AVI file name for each single frame in the movie. It is in
ASCII format.


Planned commands (not all of them are available yet):

a. Navigation commands

Definitions:

frame: one image of the movie

sequence: the recording of one or more frames. Any frames which
recording time differs by no more than one second to their adjacent
frames belong to the same sequence.

movie: one or more sequences

Notes: Commands marked with a * aren't implemented yet.
The :r and :w commands use a file dialog. The range is currently
the whole movie.
 
l, right-arrow, space	Move one frame forward
h, left-arrow		Move one frame backward
ctrl-h, backspace	Move one frame backward
gg			Move to the start of the movie
G			Move to the end of the movie
0, ^			Move to the start of the current sequence
$			Move to the end of the current sequence
j, return, +		Move to the start of the next sequence
down-arrow, ctrl-n	Move to the start of the next sequence
k, up-arrow, ctrl-p, -	Move to the start of the previous sequence
ctrl-f			Move forward several sequences
ctrl-b			Move backwards several sequences
w			Move forward one second (25 or 30 frames)
b			Move backwards one second

x, dl, d space, del	cut the current frame
X, dh			cut the frame before the current frame*
dd			cut the current sequence
d$			cut from current frame to end of sequence
d^, d0			cut from start of sequence just before current frame
dw			cut one second*
dG			cut to end of movie*
dgg			cut from beginning of movie*

yl, y space		copy the current frame
yy, Y			copy the current sequence
yh			copy the frame before the current frame*
y$			copy from current frame to end of sequence
y^, y0			copy from start of sequence to current frame
yw			copy one second*
yG			copy to end of movie*
ygg			copy from beginning of movie*

p			paste after current frame
P			paste before current frame
	
:[#,#]w filename	writes the range of frames to an AVI file.**
:r filename		inserts a playlist or movie before the current frame**
:q			quits the program
:wq, :x, ZZ		saves and quits
ctrl-g			prints info

