14a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project/*---------------------------------------------------------------------------* 24a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * SR_SemanticProcessor.h * 34a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * * 44a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * Copyright 2007, 2008 Nuance Communciations, Inc. * 54a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * * 64a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the 'License'); * 74a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * you may not use this file except in compliance with the License. * 84a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * * 94a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * You may obtain a copy of the License at * 104a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 * 114a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * * 124a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * Unless required by applicable law or agreed to in writing, software * 134a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * distributed under the License is distributed on an 'AS IS' BASIS, * 144a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * 154a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * See the License for the specific language governing permissions and * 164a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * limitations under the License. * 174a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * * 184a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project *---------------------------------------------------------------------------*/ 194a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 204a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project#ifndef __SR_SEMANTICPROCESSOR_H 214a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project#define __SR_SEMANTICPROCESSOR_H 224a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 234a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 244a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 254a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project#include "SR_SemprocPrefix.h" 264a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project#include "SR_SemanticGraph.h" 274a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project#include "SR_SemanticResult.h" 284a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project#include "pstdio.h" 294a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project#include "ptypes.h" 304a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project#include "ESR_ReturnCode.h" 314a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 324a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 334a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 344a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 354a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project/** 364a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * Wrapper for the eScript Semantic Processor Implementation. 374a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project */ 384a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Projecttypedef struct SR_SemanticProcessor_t 394a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project{ 404a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project /** 414a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * Parse a graph with the processor provided as argument. Store semantic results in the objects pointed to by each 424a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * element in the array provided. In other words, each element of the array is a pointer to a SemanticResult object 434a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * created (and destroyed) by the caller of the function. 444a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * The size of the array must be SWIrecResultData **result_dataindicated in resultCount. If the array is not big enough, ESR_BUFFER_OVERFLOW 454a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * is returned with resultCount set to the size required. 464a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project */ 474a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project ESR_ReturnCode(*checkParse)(struct SR_SemanticProcessor_t* self, SR_SemanticGraph* semgraph, const LCHAR* transcription, SR_SemanticResult** result, size_t* resultCount); 484a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project /** 494a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * Parse a graph with the processor provided as argument. Store semantic results in the objects pointed to by each 504a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * element in the array provided. In other words, each element of the array is a pointer to a SemanticResult object 514a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * created (and destroyed) by the caller of the function. 524a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * The size of the array must be SWIrecResultData **result_dataindicated in resultCount. If the array is not big enough, ESR_BUFFER_OVERFLOW 534a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * is returned with resultCount set to the size required. 544a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project */ 554a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project ESR_ReturnCode(*checkParseByWordID)(struct SR_SemanticProcessor_t* self, SR_SemanticGraph* semgraph, wordID* wordIDs, SR_SemanticResult** result, size_t* resultCount); 564a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project /** 574a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * Frees the memory used by the Semantic Processor. 584a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * 594a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * @param self SR_SemanticProcessor handle 604a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project */ 614a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project ESR_ReturnCode(*destroy)(struct SR_SemanticProcessor_t* self); 624a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 634a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project /** 644a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * Set a param to be read by Semantic Processor during processing. 654a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * 664a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * @param self SR_SemanticProcessor handle 674a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * @param key The name of the param 684a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * @param value The value of the param 694a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project */ 704a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project ESR_ReturnCode(*setParam)(struct SR_SemanticProcessor_t* self, const LCHAR* key, const LCHAR* value); 714a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 724a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project /** 734a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * Flush the internals of the semantic processor 744a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * 754a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * @param self SR_SemanticProcessor handle 764a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project */ 774a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project ESR_ReturnCode(*flush)(struct SR_SemanticProcessor_t* self); 784a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 794a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project} 804a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source ProjectSR_SemanticProcessor; 814a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 824a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 834a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project/** 844a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * Create a new Semantic Processor. 854a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * 864a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * @param self SR_SemanticProcessor handle 874a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project */ 884a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source ProjectSREC_SEMPROC_API ESR_ReturnCode SR_SemanticProcessorCreate(SR_SemanticProcessor** self); 894a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project/** 904a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * Create a new Semantic Processor. 914a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * 924a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project * @param self SR_SemanticProcessor handle 934a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project */ 944a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source ProjectSREC_SEMPROC_API ESR_ReturnCode SR_SemanticProcessorDestroy(SR_SemanticProcessor* self); 954a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project/** 964a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project* Set a param to be read by Semantic Processor during processing. 974a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project* 984a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project* @param self SR_SemanticProcessor handle 994a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project* @param key The name of the param 1004a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project* @param value The value of the param 1014a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project*/ 1024a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source ProjectSREC_SEMPROC_API ESR_ReturnCode SR_SemanticProcessorSetParam(SR_SemanticProcessor* self, const LCHAR* key, const LCHAR* value); 1034a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project/** 1044a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project* Flush the internals of the Semantic Processor 1054a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project* 1064a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project* @param self SR_SemanticProcessor handle 1074a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project*/ 1084a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source ProjectSREC_SEMPROC_API ESR_ReturnCode SR_SemanticProcessorFlush(SR_SemanticProcessor* self); 1094a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 1104a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 1114a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project 1124a68b3365c8c50aa93505e99ead2565ab73dcdb0The Android Open Source Project#endif /* __SR_SEMANTICPROCESSOR_H */ 113