Decoding


Functions

int kate_decode_is_idheader (const kate_packet *kp)
int kate_decode_headerin (kate_info *ki, kate_comment *kc, kate_packet *kp)
int kate_decode_init (kate_state *k, kate_info *ki)
int kate_decode_packetin (kate_state *k, kate_packet *kp)
int kate_decode_eventout (kate_state *k, kate_const kate_event **event)

Detailed Description


Function Documentation

int kate_decode_eventout ( kate_state k,
kate_const kate_event **  event 
)

Requests a pointer to the event decoded by the last packet, if there is one.

Parameters:
k the kate_state to get the event from
event a pointer to where to place the pointer to the event, if any
Returns:
0 success, an event was returned

1 success, but there was no event to return

KATE_E_* error

References KATE_E_INIT, KATE_E_INVALID_PARAMETER, and kate_state::kds.

Referenced by kate_high_decode_packetin().

int kate_decode_headerin ( kate_info ki,
kate_comment kc,
kate_packet kp 
)

Decodes a header packet, and updates the kate_info and kate_comment structures from the decoded data.

Parameters:
ki the kate_info structure to update
kc the kate_comment structure to update
kp the packet to decode
Returns:
0 success

1 success, and all headers have been decoded

KATE_E_* error

References kate_packet::data, KATE_E_BAD_PACKET, KATE_E_INVALID_PARAMETER, kate_packet::nbytes, and kate_info::probe.

Referenced by kate_high_decode_packetin(), and kate_ogg_decode_headerin().

int kate_decode_init ( kate_state k,
kate_info ki 
)

Initializes a kate_state structure for decoding using the supplied kate_info structure. When done, the kate_state should be cleared using kate_clear.

Parameters:
k the kate_state to initialize for decoding
ki the kate_info structure initialized from the decoded headers
Returns:
0 success

KATE_E_* error

References KATE_E_INVALID_PARAMETER, KATE_E_OUT_OF_MEMORY, kate_state::kds, kate_state::kes, and kate_state::ki.

int kate_decode_is_idheader ( const kate_packet kp  ) 

Checks if a packet is a Kate ID header

Parameters:
kp the packet to inspect
Returns:
0 the packet is not an ID header

!=0 the packet is an ID header

References kate_packet::data, and kate_packet::nbytes.

Referenced by kate_ogg_decode_is_idheader().

int kate_decode_packetin ( kate_state k,
kate_packet kp 
)

Decodes a data packet.

Parameters:
k the kate_state to decode to
kp the packet to decode
Returns:
0 success

1 success, and we're at end of stream

KATE_E_* error

References kate_packet::data, KATE_E_INIT, KATE_E_INVALID_PARAMETER, kate_state::kds, kate_state::ki, and kate_packet::nbytes.

Referenced by kate_high_decode_packetin(), and kate_ogg_decode_packetin().


Generated on Wed Nov 26 11:53:38 2008 for libkate by  doxygen 1.5.7.1