.TH fame_encode_slice 3 "Febrary 19, 2002" "libfame" "fame_encode_slice"
.SH NAME
fame_encode_slice \- encode a single slice
.SH SYNOPSIS
.nf
.B #include <fame.h>
.sp
.BI "int fame_encode_slice(fame_context_t *" context );
.fi
.SH DESCRIPTION
.B fame_encode_slice()
encodes a single slice (part of frame).
Slices are processed from top to bottom of frame. The number of slices to process depends on the slices_per_frame parameter specified during
.I fame_init
.PP
.I fame_start_frame
should be called before coding the first slice and
.I fame_end_frame
should be called after coding the last slice.

.PP
.I context
is the context handle previously returned by 
.I fame_open

.SH "RETURN VALUE"
.BR fame_encode_slice
returns the number of bytes written to the bitstream buffer. If all slices have been coded, zero is returned.

.SH "EXAMPLE"
.sp
.nf
.in +2
    fame_start_frame(fc, &yuv, NULL);

    while((length = fame_encode_slice(fc)) != 0)
	write(output, buffer, length);

    fame_end_frame(fc, NULL);
.in -2
.fi

.SH "BUGS"
MMX arithmetic performs bad at quality > 95%.
Encoding of B frames is not yet supported.

.SH "SEE ALSO"
.BR fame_open (3),
.BR fame_init (3),
.BR fame_close (3),
.BR fame_start_frame (3),
.BR fame_end_frame (3)