rhubarb-lip-sync/lib/pocketsphinx-rev13216/src/libpocketsphinx/ps_alignment.h

191 lines
5.1 KiB
C

/* -*- c-basic-offset: 4; indent-tabs-mode: nil -*- */
/* ====================================================================
* Copyright (c) 2010 Carnegie Mellon University. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* This work was supported in part by funding from the Defense Advanced
* Research Projects Agency and the National Science Foundation of the
* United States of America, and the CMU Sphinx Speech Consortium.
*
* THIS SOFTWARE IS PROVIDED BY CARNEGIE MELLON UNIVERSITY ``AS IS'' AND
* ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY
* NOR ITS EMPLOYEES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* ====================================================================
*
*/
/**
* @file ps_alignment.h Multi-level alignment structure
*/
#ifndef __PS_ALIGNMENT_H__
#define __PS_ALIGNMENT_H__
/* System headers. */
/* SphinxBase headers. */
#include <sphinxbase/prim_type.h>
/* Local headers. */
#include "dict2pid.h"
#include "hmm.h"
#define PS_ALIGNMENT_NONE ((uint16)0xffff)
struct ps_alignment_entry_s {
union {
int32 wid;
struct {
uint16 ssid;
uint16 cipid;
uint16 tmatid;
} pid;
uint16 senid;
} id;
int16 start;
int16 duration;
int32 score;
uint16 parent;
uint16 child;
};
typedef struct ps_alignment_entry_s ps_alignment_entry_t;
struct ps_alignment_vector_s {
ps_alignment_entry_t *seq;
uint16 n_ent, n_alloc;
};
typedef struct ps_alignment_vector_s ps_alignment_vector_t;
struct ps_alignment_s {
dict2pid_t *d2p;
ps_alignment_vector_t word;
ps_alignment_vector_t sseq;
ps_alignment_vector_t state;
};
typedef struct ps_alignment_s ps_alignment_t;
struct ps_alignment_iter_s {
ps_alignment_t *al;
ps_alignment_vector_t *vec;
int pos;
};
typedef struct ps_alignment_iter_s ps_alignment_iter_t;
/**
* Create a new, empty alignment.
*/
ps_alignment_t *ps_alignment_init(dict2pid_t *d2p);
/**
* Release an alignment
*/
int ps_alignment_free(ps_alignment_t *al);
/**
* Append a word.
*/
int ps_alignment_add_word(ps_alignment_t *al,
int32 wid, int duration);
/**
* Populate lower layers using available word information.
*/
int ps_alignment_populate(ps_alignment_t *al);
/**
* Populate lower layers using context-independent phones.
*/
int ps_alignment_populate_ci(ps_alignment_t *al);
/**
* Propagate timing information up from state sequence.
*/
int ps_alignment_propagate(ps_alignment_t *al);
/**
* Number of words.
*/
int ps_alignment_n_words(ps_alignment_t *al);
/**
* Number of phones.
*/
int ps_alignment_n_phones(ps_alignment_t *al);
/**
* Number of states.
*/
int ps_alignment_n_states(ps_alignment_t *al);
/**
* Iterate over the alignment starting at the first word.
*/
ps_alignment_iter_t *ps_alignment_words(ps_alignment_t *al);
/**
* Iterate over the alignment starting at the first phone.
*/
ps_alignment_iter_t *ps_alignment_phones(ps_alignment_t *al);
/**
* Iterate over the alignment starting at the first state.
*/
ps_alignment_iter_t *ps_alignment_states(ps_alignment_t *al);
/**
* Get the alignment entry pointed to by an iterator.
*/
ps_alignment_entry_t *ps_alignment_iter_get(ps_alignment_iter_t *itor);
/**
* Move alignment iterator to given index.
*/
ps_alignment_iter_t *ps_alignment_iter_goto(ps_alignment_iter_t *itor, int pos);
/**
* Move an alignment iterator forward.
*/
ps_alignment_iter_t *ps_alignment_iter_next(ps_alignment_iter_t *itor);
/**
* Move an alignment iterator back.
*/
ps_alignment_iter_t *ps_alignment_iter_prev(ps_alignment_iter_t *itor);
/**
* Get a new iterator starting at the parent of the current node.
*/
ps_alignment_iter_t *ps_alignment_iter_up(ps_alignment_iter_t *itor);
/**
* Get a new iterator starting at the first child of the current node.
*/
ps_alignment_iter_t *ps_alignment_iter_down(ps_alignment_iter_t *itor);
/**
* Release an iterator before completing all iterations.
*/
int ps_alignment_iter_free(ps_alignment_iter_t *itor);
#endif /* __PS_ALIGNMENT_H__ */