libjulius/include/julius/jfunc.h File Reference

API related functions (not all). More...

#include <julius/julius.h>
#include <stdarg.h>

Go to the source code of this file.

Functions

int j_open_stream (Recog *recog, char *file_or_dev_name)

Open input stream.

int j_recognize_stream (Recog *recog)

Recognize an input stream.

void j_request_pause (Recog *recog)

Request engine to stop recognition.

void j_request_terminate (Recog *recog)

Request engine to terminate recognition immediately.

void j_request_resume (Recog *recog)

Resume the engine which has already paused or terminated.

void schedule_grammar_update (Recog *recog)

Request engine to check update of all grammar and re-construct the glocal lexicon if needed.

void j_reset_reload (Recog *recog)

Clear the grammar re-construction flag.

void j_enable_debug_message ()

Enable debug messages in JuliusLib to log.

void j_disable_debug_message ()

Disable debug messages in JuliusLib to log.

void j_enable_verbose_message ()

Enable verbose messages in JuliusLib to log.

void j_disable_verbose_message ()

Disable verbose messages in JuliusLib to log.

void j_internal_error (char *fmt,...)

Output error message and exit the program.

int j_config_load_args (Jconf *jconf, int argc, char *argv[])

Load parameters from command argments, and set to each configuration instances in jconf.

int j_config_load_file (Jconf *jconf, char *filename)

Load parameters from a jconf file and set to each configuration instances in jconf.

Jconf * j_config_load_args_new (int argc, char *argv[])

Create a new configuration instance and load parameters from command argments.

Jconf * j_config_load_file_new (char *filename)

Create a new configuration instance and load parameters from a jconf file.

boolean j_adin_init (Recog *recog)

Initialize and setup A/D-in device specified by the configuration for recognition.

boolean j_adin_init_user (Recog *recog, void *arg)

Initialize function when using user-defined A/D-in function.

char * j_get_current_filename ()

Return current input speech file name.

void j_recog_info (Recog *recog)

Output all configurations and system informations into log.

Recog * j_create_instance_from_jconf (Jconf *jconf)

Instanciate / generate a new engine instance according to the given global configuration instance.

boolean j_regist_user_lm_func (PROCESS_LM *lm, LOGPROB(*unifunc)(WORD_INFO *winfo, WORD_ID w, LOGPROB ngram_prob), LOGPROB(*bifunc)(WORD_INFO *winfo, WORD_ID context, WORD_ID w, LOGPROB ngram_prob), LOGPROB(*probfunc)(WORD_INFO *winfo, WORD_ID *contexts, int context_len, WORD_ID w, LOGPROB ngram_prob))

Assign user-defined language scoring functions into a LM processing instance.

boolean j_regist_user_param_func (Recog *recog, boolean(*user_calc_vector)(MFCCCalc *, SP16 *, int))

Assign a user-defined parameter extraction function to engine instance.

JCONF_AM * j_get_amconf_by_name (Jconf *jconf, char *name)

Get AM configuration structure in jconf by its name.

JCONF_AM * j_get_amconf_by_id (Jconf *jconf, int id)

Get AM configuration structure in jconf by its id.

JCONF_AM * j_get_amconf_default (Jconf *jconf)

Return default AM configuration.

JCONF_LM * j_get_lmconf_by_name (Jconf *jconf, char *name)

Get LM configuration structure in jconf by its name.

JCONF_LM * j_get_lmconf_by_id (Jconf *jconf, int id)

Get LM configuration structure in jconf by its id.

JCONF_SEARCH * j_get_searchconf_by_name (Jconf *jconf, char *name)

Get SEARCH configuration structure in jconf by its name.

JCONF_SEARCH * j_get_searchconf_by_id (Jconf *jconf, int id)

Get SEARCH configuration structure in jconf by its id.

boolean j_process_deactivate (Recog *recog, char *name)

De-activate a recognition process instance designated by its name.

boolean j_process_deactivate_by_id (Recog *recog, int id)

De-activate a recognition process instance designated by its ID.

boolean j_process_activate (Recog *recog, char *name)

Activate a recognition process instance that has been made inactive, by its name.

boolean j_process_activate_by_id (Recog *recog, int id)

Activate a recognition process instance that has been made inactive, by the ID.

boolean j_process_add_lm (Recog *recog, JCONF_LM *lmconf, JCONF_SEARCH *sconf, char *name)

Create a new recognizer with a new LM and SR configurations.

boolean j_remove_search (Recog *recog, JCONF_SEARCH *sconf)

boolean j_remove_lm (Recog *recog, JCONF_LM *lmconf)

boolean j_remove_am (Recog *recog, JCONF_AM *amconf)

MFCCCalc * j_mfcccalc_new (JCONF_AM *amconf)

Allocate a new MFCC calculation instance.

void j_mfcccalc_free (MFCCCalc *mfcc)

Free an MFCC calculation instance.

PROCESS_AM * j_process_am_new (Recog *recog, JCONF_AM *amconf)

Allocate a new acoustic model processing instance.

void j_process_am_free (PROCESS_AM *am)

Free an acoustic model processing instance.

PROCESS_LM * j_process_lm_new (Recog *recog, JCONF_LM *lmconf)

Allocate a new language model processing instance.

void j_process_lm_free (PROCESS_LM *lm)

Free a language model processing instance.

RecogProcess * j_recogprocess_new (Recog *recog, JCONF_SEARCH *sconf)

Allocate a new recognition process instance.

void j_recogprocess_free (RecogProcess *process)

Free a recognition process instance.

JCONF_AM * j_jconf_am_new ()

Allocate a new acoustic model (AM) parameter structure.

void j_jconf_am_free (JCONF_AM *amconf)

Release an acoustic model (AM) parameter structure Default parameter values are set to it.

boolean j_jconf_am_regist (Jconf *jconf, JCONF_AM *amconf, char *name)

Register AM configuration to global jconf.

JCONF_LM * j_jconf_lm_new ()

Allocate a new language model (LM) parameter structure.

void j_jconf_lm_free (JCONF_LM *lmconf)

Release a language model (LM) parameter structure.

boolean j_jconf_lm_regist (Jconf *jconf, JCONF_LM *lmconf, char *name)

Register LM configuration to global jconf.

JCONF_SEARCH * j_jconf_search_new ()

Allocate a new search (SEARCH) parameter structure.

void j_jconf_search_free (JCONF_SEARCH *sconf)

Release a search (SEARCH) parameter structure.

boolean j_jconf_search_regist (Jconf *jconf, JCONF_SEARCH *sconf, char *name)

Register SEARCH configuration to global jconf.

Jconf * j_jconf_new ()

Allocate a new global configuration parameter structure.

void j_jconf_free (Jconf *jconf)

Free a global configuration parameter structure.

Recog * j_recog_new ()

Allocate memory for a new engine instance.

void j_recog_free (Recog *recog)

Free an engine instance.

Detailed Description

API related functions (not all).

Author:: Akinobu Lee

Date:: Tue Nov 6 22:41:00 2007

$Revision:$

Definition in file jfunc.h.

Function Documentation

void j_internal_error	(	char *	fmt,
			...
	)

Output error message and exit the program.

This is just for internal use.

Parameters:

	fmt	[in] format string, like printf.
	...	[in] variable length argument like printf.

Definition at line 283 of file jfunc.c.

Referenced by add_successor(), adjust_sc_index(), do_align(), get_outtrans_list(), init_param(), match_successor(), mfcc_copy_to_rest_and_shrink(), ngram_nextwords(), scan_word(), wchmm_add_word(), and wchmm_link_hmm().

MFCCCalc* j_mfcccalc_new ( JCONF_AM * amconf )

Allocate a new MFCC calculation instance.

Parameters:

amconf

[in] acoustic model configuration parameters

Returns:: the newly allocated MFCC calculation instance.

Definition at line 44 of file instance.c.

Referenced by create_mfcc_calc_instances(), and j_final_fusion().

Here is the caller graph for this function:

void j_mfcccalc_free ( MFCCCalc * mfcc )

Free an MFCC calculation instance.

Parameters:

mfcc

[i/o] MFCC calculation instance

Definition at line 91 of file instance.c.

Referenced by j_recog_free().

Here is the caller graph for this function:

PROCESS_AM* j_process_am_new	(	Recog *	recog,
		JCONF_AM *	amconf
	)

Allocate a new acoustic model processing instance.

Parameters:

	recog	[i/o] engine instance
	amconf	[in] AM configuration to assign

Returns:: newly allocated acoustic model processing instance.

Definition at line 123 of file instance.c.

Referenced by j_load_am().

Here is the caller graph for this function:

void j_process_am_free ( PROCESS_AM * am )

Free an acoustic model processing instance.

Parameters:

[i/o] AM process instance

Definition at line 160 of file instance.c.

Referenced by j_process_am_remove(), and j_recog_free().

Here is the caller graph for this function:

PROCESS_LM* j_process_lm_new	(	Recog *	recog,
		JCONF_LM *	lmconf
	)

Allocate a new language model processing instance.

Parameters:

	recog	[i/o] engine instance
	lmconf	[in] LM configuration to assign

Returns:: newly allocated language model processing instance.

Definition at line 187 of file instance.c.

Referenced by j_load_lm().

Here is the caller graph for this function:

void j_process_lm_free ( PROCESS_LM * lm )

Free a language model processing instance.

Parameters:

[i/o] LM process instance

Definition at line 230 of file instance.c.

Referenced by j_process_lm_remove(), and j_recog_free().

Here is the caller graph for this function:

RecogProcess* j_recogprocess_new	(	Recog *	recog,
		JCONF_SEARCH *	sconf
	)

Allocate a new recognition process instance.

Parameters:

	recog	[i/o] engine instance
	sconf	[in] SEARCH configuration to assign

Returns:: the newly allocated recognition process instance.

Definition at line 257 of file instance.c.

Referenced by j_launch_recognition_instance().

Here is the caller graph for this function:

void j_recogprocess_free ( RecogProcess * process )

Free a recognition process instance.

Parameters:

process

[i/o] recognition process instance

Definition at line 297 of file instance.c.

Referenced by j_process_remove(), and j_recog_free().

Here is the caller graph for this function:

Generated on Tue Dec 18 16:00:48 2007 for Julius by

1.5.4


Functions
int	j_open_stream (Recog recog, char file_or_dev_name)
	Open input stream.
int	j_recognize_stream (Recog *recog)
	Recognize an input stream.
void	j_request_pause (Recog *recog)
	Request engine to stop recognition.
void	j_request_terminate (Recog *recog)
	Request engine to terminate recognition immediately.
void	j_request_resume (Recog *recog)
	Resume the engine which has already paused or terminated.
void	schedule_grammar_update (Recog *recog)
	Request engine to check update of all grammar and re-construct the glocal lexicon if needed.
void	j_reset_reload (Recog *recog)
	Clear the grammar re-construction flag.
void	j_enable_debug_message ()
	Enable debug messages in JuliusLib to log.
void	j_disable_debug_message ()
	Disable debug messages in JuliusLib to log.
void	j_enable_verbose_message ()
	Enable verbose messages in JuliusLib to log.
void	j_disable_verbose_message ()
	Disable verbose messages in JuliusLib to log.
void	j_internal_error (char *fmt,...)
	Output error message and exit the program.
int	j_config_load_args (Jconf jconf, int argc, char argv[])
	Load parameters from command argments, and set to each configuration instances in jconf.
int	j_config_load_file (Jconf jconf, char filename)
	Load parameters from a jconf file and set to each configuration instances in jconf.
Jconf *	j_config_load_args_new (int argc, char *argv[])
	Create a new configuration instance and load parameters from command argments.
Jconf *	j_config_load_file_new (char *filename)
	Create a new configuration instance and load parameters from a jconf file.
boolean	j_adin_init (Recog *recog)
	Initialize and setup A/D-in device specified by the configuration for recognition.
boolean	j_adin_init_user (Recog recog, void arg)
	Initialize function when using user-defined A/D-in function.
char *	j_get_current_filename ()
	Return current input speech file name.
void	j_recog_info (Recog *recog)
	Output all configurations and system informations into log.
Recog *	j_create_instance_from_jconf (Jconf *jconf)
	Instanciate / generate a new engine instance according to the given global configuration instance.
boolean	j_regist_user_lm_func (PROCESS_LM lm, LOGPROB(unifunc)(WORD_INFO winfo, WORD_ID w, LOGPROB ngram_prob), LOGPROB(bifunc)(WORD_INFO winfo, WORD_ID context, WORD_ID w, LOGPROB ngram_prob), LOGPROB(probfunc)(WORD_INFO winfo, WORD_ID contexts, int context_len, WORD_ID w, LOGPROB ngram_prob))
	Assign user-defined language scoring functions into a LM processing instance.
boolean	j_regist_user_param_func (Recog recog, boolean(user_calc_vector)(MFCCCalc , SP16 , int))
	Assign a user-defined parameter extraction function to engine instance.
JCONF_AM *	j_get_amconf_by_name (Jconf jconf, char name)
	Get AM configuration structure in jconf by its name.
JCONF_AM *	j_get_amconf_by_id (Jconf *jconf, int id)
	Get AM configuration structure in jconf by its id.
JCONF_AM *	j_get_amconf_default (Jconf *jconf)
	Return default AM configuration.
JCONF_LM *	j_get_lmconf_by_name (Jconf jconf, char name)
	Get LM configuration structure in jconf by its name.
JCONF_LM *	j_get_lmconf_by_id (Jconf *jconf, int id)
	Get LM configuration structure in jconf by its id.
JCONF_SEARCH *	j_get_searchconf_by_name (Jconf jconf, char name)
	Get SEARCH configuration structure in jconf by its name.
JCONF_SEARCH *	j_get_searchconf_by_id (Jconf *jconf, int id)
	Get SEARCH configuration structure in jconf by its id.
boolean	j_process_deactivate (Recog recog, char name)
	De-activate a recognition process instance designated by its name.
boolean	j_process_deactivate_by_id (Recog *recog, int id)
	De-activate a recognition process instance designated by its ID.
boolean	j_process_activate (Recog recog, char name)
	Activate a recognition process instance that has been made inactive, by its name.
boolean	j_process_activate_by_id (Recog *recog, int id)
	Activate a recognition process instance that has been made inactive, by the ID.
boolean	j_process_add_lm (Recog recog, JCONF_LM lmconf, JCONF_SEARCH sconf, char name)
	Create a new recognizer with a new LM and SR configurations.
boolean	j_remove_search (Recog recog, JCONF_SEARCH sconf)
boolean	j_remove_lm (Recog recog, JCONF_LM lmconf)
boolean	j_remove_am (Recog recog, JCONF_AM amconf)
MFCCCalc *	j_mfcccalc_new (JCONF_AM *amconf)
	Allocate a new MFCC calculation instance.
void	j_mfcccalc_free (MFCCCalc *mfcc)
	Free an MFCC calculation instance.
PROCESS_AM *	j_process_am_new (Recog recog, JCONF_AM amconf)
	Allocate a new acoustic model processing instance.
void	j_process_am_free (PROCESS_AM *am)
	Free an acoustic model processing instance.
PROCESS_LM *	j_process_lm_new (Recog recog, JCONF_LM lmconf)
	Allocate a new language model processing instance.
void	j_process_lm_free (PROCESS_LM *lm)
	Free a language model processing instance.
RecogProcess *	j_recogprocess_new (Recog recog, JCONF_SEARCH sconf)
	Allocate a new recognition process instance.
void	j_recogprocess_free (RecogProcess *process)
	Free a recognition process instance.
JCONF_AM *	j_jconf_am_new ()
	Allocate a new acoustic model (AM) parameter structure.
void	j_jconf_am_free (JCONF_AM *amconf)
	Release an acoustic model (AM) parameter structure Default parameter values are set to it.
boolean	j_jconf_am_regist (Jconf jconf, JCONF_AM amconf, char *name)
	Register AM configuration to global jconf.
JCONF_LM *	j_jconf_lm_new ()
	Allocate a new language model (LM) parameter structure.
void	j_jconf_lm_free (JCONF_LM *lmconf)
	Release a language model (LM) parameter structure.
boolean	j_jconf_lm_regist (Jconf jconf, JCONF_LM lmconf, char *name)
	Register LM configuration to global jconf.
JCONF_SEARCH *	j_jconf_search_new ()
	Allocate a new search (SEARCH) parameter structure.
void	j_jconf_search_free (JCONF_SEARCH *sconf)
	Release a search (SEARCH) parameter structure.
boolean	j_jconf_search_regist (Jconf jconf, JCONF_SEARCH sconf, char *name)
	Register SEARCH configuration to global jconf.
Jconf *	j_jconf_new ()
	Allocate a new global configuration parameter structure.
void	j_jconf_free (Jconf *jconf)
	Free a global configuration parameter structure.
Recog *	j_recog_new ()
	Allocate memory for a new engine instance.
void	j_recog_free (Recog *recog)
	Free an engine instance.