Manual de referencia del Wrapper .NET para
Contents
1. Uer c r 0 cos IsProcessing Nos indica si el motor de reconocimiento de matr culas est pendiente de procesar resultados Sea porque tiene elementos en cola o en proceso actualmente bool IsProcessing Valor de Retorno e Cierto o falso dependiendo si el motor est procesando peticiones de lectura Ejemplo C code Stop when ends processing if VparMTInterface IsRunning while VparMTInterface IsProcessing Application DoEvents VparMTInterface QueryEnd www neurallabs net Uer c 0 cos GetLicensedCores Nos indica el n mero n cleos de procesador disponibles para los que tenemos licencia v lida Ser el numero m ximo de procesos simult neos que podemos gestionar Long GetLicensedCores Valor de Retorno e Numero de n cleos de procesador que tenemos licenciados para usar Ejemplo Ct code Busy cores labelCU Text String Format Cores used 0 VparMTInterface GetLicensedCores VparMTInterface GetFreeCores www neurallabs net Uer cL 0 abs GetFreeCores Nos indica el n mero n cleos de procesador disponibles Ser el n mero m ximo de procesos simult neos que podemos gestionar Long GetFreeCores Valor de Retorno e N mero de n cleos de procesador que tenemos libres en el momento de la consulta Ejemplo Ct code Busy cores labelCU Text String Format Cores used 0 V2. ROI LOC CODE GER 108 Germany LOC CODE PYR 109 Pyrinees Spain Andorra amp France LOC CODE POL 110 Poland LOC CODE BUL 111 Bulgaria LOC CODE CHI 201 Chile LOC CODE COL 202 Colombia LOC CODE BRA 203 Brazil LOC CODE ARG 204 Argentina LOC CODE MEX 205 Mexico LOC CODE ECU 206 Ecuador LOC CODE VEN 207 Venezuela LOC CODE RUS 301 Russia LOC CODE TUR 302 Turkey LOC CODE VIE 303 Vietnam LOC CODE SAF 401 South Africa www neurallabs net IU CIL ev as Appendix 2 Esquema Multi procesador Versi n simple VPAR Multi thread workflow NET Assembly Simple version START PROGRAM v MTinterface SetConfiguration MTinterface Init MTInterface Add I MTInterface GetFirstPlate Add Get Images results MTInterface QueryEnd END PROGRAM www neurallabs net mJ CIL ev ans Versi n detallada VPAR Multi thread workflow NET Assembly Complete version START PROGRAM MTInterface SetConfiguration MTInterface Init bitmap LoadBitmap Source If MTInterface IsRunning MTInterface Add bitmap Add images There are some ways to add images From path From memory stream From Bitmap Platelnfo ptinfo ptinfo MTInterface GetFirstPlate If NOT ptinfo is Null then plateNumber ptinfo GetPlateNumber Get results To end
3. listOfPlates Add plate GetPlateNumber Loop While Not plate Is Nothing Enqueue if more results available Else listOfPlates Add String Format Process failed End If Else Error Vpar End If www neurallabs net Uer cL 0 abs Resultados M todos avanzados Los siguientes m todos y funciones est n indicados cuando se requiere mayor funcionalidad y acceso a la informaci n una vez realizado el proceso de reconocimiento y tambi n cuando se esperan leer varias matr culas en una sola imagen Estos m todos permiten recuperar la informaci n completa de los par metros usados y de cualquier otra informaci n a adida en el momento de realizar la llamada a la funci n Add Permite conocer la informaci n de fecha y hora exactas en que se a adieron las im genes a la cola de procesamiento y otra informaci n normalmente no necesaria pero importante cuando se realizan operaciones de detecci n por radar y objetivos similares avanzados Si se usan varia c maras y se quiere recuperar la informaci n de los par metros usados o la informaci n adicional estos m todos proporcionan esta funcionalidad adicional GetFirstElement Retorna informaci n completa de la primera imagen con todos los resultados disponible Esto incluye los par metros usados para el reconocimiento de la imagen cualquier informaci n adicional pasada mediante la funci n Add e informaci n de TODAS las matr culas le das en la imagen Este m
4. 3 ptinfo GetGlobalConfidence Me fiabilidades Me activePanel Visible True Me activePanel Me activePanel 1 Mod 4 Me LabelACH Text Avg Char Heigth Convert ToInt32 ptinfo GetAverageCharacterHeigth ToString www neurallabs net Uer Ci 0 abs GetPlate Retorna la informaci n de la matr cula que se encuentra en la cola de resultados con el identificador que se le pasa por par metro y elimina esta informaci n de la cola de resultados pendientes por lo que si no la almacenamos esta informaci n se perder Platelnfo GetPlate Long id Par metros id Este par metro contiene el id de la imagen de la que queremos obtener el resultado Puede haber m s de un resultado para el mismo id Varias matr culas en una misma imagen se retorna el primer resultado encontrado Valor de Retorno Informaci n de la matr cula en la cola de resultados con el id Retornado por la funci n Add que le pasamos por par metro En caso de no haber ning n resultado con este id se retorna null o Nothing Ejemplo vb NET code If Not vpar Is Nothing Then id VparMTInterface Add Me BytesToImage image f id gt 0 Then Success enqueued Do System Threading Thread Sleep 100 plate VparMTInterface GetPlate id Loop While plate Is Nothing Loop until get result First result listOfPlates Add plate GetPlateNumber Do plate VparMTInterface GetPlate id If Not plate Is Nothing Then
5. Dim ptinfo As PlateInfo Esta propiedad retorna el id de la imagen procesada Esta propiedad retorna la ruta o Nothing Si no hay ruta disponible de la imagen procesada Esta propiedad retorna el Bitmap o Nothing si el bitmap no se encuentra disponible de la imagen procesada Los requisitos de memoria cuando se almacena informaci n de Bitmap son MUY ELEVADOS por lo que se ha de usar con cuidado y bajo el propio riesgo Esta propiedad retorna el Objeto pasado como par metro cuando se ha usado la funci n Add Esta propiedad retorna la fecha y hora del momento en el que la imagen se a adi a la cola de procesamiento Como en la propiedad anterior pero se usan Fecha y hora universales Nothing all results are ready GetFirstElement Nothing ptinfo ptElement GetFirstPlate While Not ptinfo Is Nothing DisplayInfo Me ListBoxResults ptElement ptinfo Retrieve GPS information stored when Adding image Dim gpsCoordinates As GPS ptElement ImageInformation GetObject ptinfo ptElement GetFirstPlate Application DoEvents End While www neurallabs net Ue tL 0 cos Anexo 1 C digos de pa s En CD del software contiene siempre la versi n m s actualizada de la lista LOC CODE ESP 101 Spain LOC CODE POR 102 Portugal LOC CODE FRA 103 France LOC CODE ITA 104 Italy LOC CODE UK 105 United Kingdom LOC CODE GRE 106 Greece LOC CODE IRL 107 Ireland
6. Init Inicializa el Vehicle Plates Automatic Reader VPAR Carga las Redes Neuronales Artificiales del OCR e inicializa par metros Esta funci n debe llamarse antes de usar cualquiera de las otras funciones de esta librer a excepto SetConfiguration que puede llamarse en cualquier momento long Init long CountryCode long AverageCharacterHeight long bDuplicateLines false long lreserved1 0 long lreserved2 0 long bTrace 0 bool wTrace false Parametros ICountryCode C digo de pa s para el que queremos reconocer las matr culas Referirse al fichero de definici n para una lista de todos los pa ses soportados lAvCharacterHeight Altura media aproximada de los caracteres de las matr culas a leer en pixels Si pasamos un 1 la librer a calcula de manera autom tica la altura de 20 a 50 pixeles Si se selecciona altura autom tica el tiempo de proceso aumenta considerablemente bDuplicateLines Para im genes capturadas con la mitad de las l neas pasaremos el valor 1 true Para los dem s casos 0 false www neurallabs net Uer c eL cos ILreserved1 Reordena cuando el pa s es Espaf a el resultado de las matr culas de 2 l neas Por defecto el valor O no reordena con valor 1 se reordena el resultado de la lectura lreserved2 Activamos filtro especial para tratamiento de color Los posibles valores son O Hace la media de los tres canales Recomendado por defecto 1 Usael prim
7. de la clase Platelnfo www neurallabs net Uer cL 0 abs Valor de Retorno e 1 gt Error o cola de procesamiento llena e Numero positivo incluido cero gt Ok o El n mero indica el identificador asociado a la imagen para su posterior uso www neurallabs net MWE CIL 0 ans Ejemplo Cf code Bitmap bitmap eventArgs Frame if VparMTInterface IsRunning VparMTInterface Add bitmap true www neurallabs net UJ CIL ev ans Consultas disponibles GetQueueSize Nos indica el numero de elementos en cola que tenemos pendientes de procesar por el motor de reconocimiento de matr culas Im genes a adidas Add que a n no han sido procesadas Long GetQueueSize Valor de Retorno e Numero de elementos pendientes de procesar por el motor de reconocimiento Ejemplo Cf code Wait to end processing images while VparMTInterface GetQueueSize 0 Application DoEvents www neurallabs net Uer cL 0 cos IsRunning Nos indica si el motor de reconocimiento de matr culas ha sido inicializado correctamente y no se ha detenido mediante el m todo QueryEnd bool IsRunning Valor de Retorno e Cierto o falso dependiendo si el motor est listo para recibir peticiones de lectura Ejemplo Cf code Add images while running while VparMTInterface IsRunning VparMTInterface Add image www neurallabs net
8. el c digo del pa s que se ajusta al formato de matr cula le do Por ejemplo si la matr cula es espafiola retornar 101 En caso de no identificar el pa s se retorna un cero En caso de identificar continente se retorna por ejemplo 100 para Europa Si tenemos una lista de elementos Platelnfo podemos ordenarla en funci n del valor de su coordenada izquierda utilizando el m todo sobrecargado Sort Ejemplo Ct code VPARMTWrapper PlateInfo ptinfo while VparMTInterface GetNumberOfPlates gt 0 ptinfo VparMTInterface GetFirstPlate if Convert ToDecimal ptinfo GetGlobalConfidence gt 60 String plateNumber ptinfo GetPlateNumber String lastNumber if this listBoxResults SelectedItem null lastNumber this listBoxResults SelectedItem ToString if String Equals plateNumber lastNumber ptinfo null Ejemplo 2 this listBoxResults Items Add ptinfo GetPlateNumber this listBoxResults SelectedIndex this listBoxResults Items Count 1 vb NET code Dim ptinfo As VPARMTWrapper PlateInfo WhileVparMTInterface GetNumberOfPlates gt 0 ptinfo VparMTInterface GetFirstPlate Me avgPtime Me avgPtime ptinfo GetProcessingTime If ptinfo GetGlobalConfidence gt Me NumericUpDownMinConf Value Then End If End While If Me CheckBoxBeep Checked Then System Media SystemSounds Exclamation Play Me fiabilidades Me activePanel Text String Format 0 00
9. ENSAMBLADO NET VPARMI Manual de referencia VERSI N 3 1 Ue Ur cL ev abs ndice de contenido NDICE DE CONTENIDO e cecenen entrent toten entretien tote tt tese se sten sb sp seem ener sp spes stesse nen ONO DECLARACI N CONFIGURACI N cccscccsssssssscecceccscececcessssssscsececcececececessecesecenseseees GETNUMBEROPBPLATES 5 reto reet eee vene eee EE ARES ENRETE REE REE EE ERRES RENES GETFIRSTPLATE A od GETPLA TE RESULTADOS M TODOS AVANZADOS ccssssssssssssssssssssssssascsnssasssscsncesscsucsasesnceasenses GETPIRSTEDEMENT lt a testi tay RESe TE IP Een Rep nei ANEXO 1 CODIGOS DE PA S opo serre hp iS ceri Poe CM rH EVE Ev DERE ERR APPENDIX 2 ESQUEMA MULTI PROCESADOR scssssssssssssssssesscsassssssnsessecnsensesnees VERSI N SIMPLE si ivesvesvssnstcevssniveovsaties diia VERSI N DETALLADA ccccccesscccesscesececesssesscecssseeseeeceassesssecssssesssecsassesssecascesssecsascsesescnssenuees www neurallabs net UJ CIL e as Introducci n El presente documento es el manual de referencia del ensamblado VPARMTWrapper que encapsula de una forma sencilla para su uso desde NET las funcionalidades de la librer a VPARMT Vehicle Plate Automatic Reader Multi Thread capaz de ejecutar hasta 8 procesos simult neos de reconocimiento de matr culas VPAR Para evitar problemas de concurrencia la mayor a de m todos salvo el Init son est ticos gara
10. allabs net Uer cL 0 abs angle left top width height numSteps steps Ejemplo 1 Par metro para el ngulo Si alguno de los 4 par metros left top width height es diferente de cero se utilizar esta ventana en vez de toda la imagen para buscar la matr cula Left indica la coordenada izquierda de la ventana Coordenada superior de la ventana Anchura de la ventana Altura de la ventana En caso de poner este valor a 2 se usaran las alturas del vector siguiente Array con el inicio del intervalo en la primera posici n y el final del intervalo en la segunda Por ejemplo 25 45 VB net code Private Sub SetVPARMTConfiguration Dim stepsArray 2 As Int32 If Me CheckBoxCharacterHeight Checked Then Use Automatic height stepsArray 0 stepsArray 1 lCharSize Else Use user height Convert ToInt32 Me userHeigth Split c 0 Trim Convert ToInt32 Me userHeigth Split c 1 Trim stepsArray 0 stepsArray 1 End If s 25 60 VparMTInterface SetConfiguration 0 0 0 0 0 O Convert ToInt32 Me NLeft Value Convert ToInt32 Me Ntop Value Convert ToInt32 Me NWidth Value Convert ToInt32 Me NHeight Value 2 stepsArray End Sub Ejemplo 2 Ct code Int32 stepsArray 35 65 VparMTInterface SetConfiguration 0 0 0 0 0 0 0 0 0 0 2 stepsArray www neurallabs net Ue Lr CIL ev abs Inicializaci n Finalizaci n
11. er canal rojo si la imagen buffer es RGB o azul si es BGR 2 Usa el segundo canal en principio ser a siempre el verde 3 Usa el tercer canal azul si la imagen buffer es RGB o rojo si es BGR lt 0 Error 23 Error bTrace Traza interna Este par metro debe valer 0 wTrace Traza interna Este par metro debe valer false Valor de Retorno 0 gt Error 1 gt Ok Long Init Long countryCode Realiza la llamada anterior con los valores por defecto Init IcountryCode 1 O O O 0 Ejemplo Ct code VparMTInterface SetConfiguration 0 0 0 O 0 0 O 0 0 00 2 stepsArray duplicateLines 0 return VparMTInterface Init countryCode lCharSize duplicateLines 0 0 0 www neurallabs net Uer cL 0 abs QueryEnd Libera la memoria reservada para el Vehicle Plates Automatic Reader Multi Thread VPARMT Para ello espera a que se vac e la cola de peticiones de reconocimiento acumulada y despu s libera los recursos Esta funci n puede tardar un tiempo significativo en finalizar si se encuentran muchas peticiones pendientes de procesar Ejemplo Cf code Stop VPAR when finished processing images if VparMTInterface IsRunning while VparMTInterface IsProcessing Application DoEvents VparMTInterface QueryEnd www neurallabs net Uer cL 0 abs Solicitud de lectura de matr culas Add A ade la matr cula a la cola de peticiones de lectu
12. ntizando el acceso simultaneo a la clase como por ejemplo a adir im genes o leer los resultados en paralelo Para poder utilizar el ensamblado los pasos a seguir son los siguientes 1 Crear o abrir proyecto existente en Visual Studio 2 Agregar referencia Explorador de soluciones WindowsApplication MEE E Generar ES Formi Volver a generar NET com Proyectos Examinar Reciente Limpiar Publicar Lookin Release 2 Pm Agregar gt Agregar referencia Web Date modified A Ver diagrama de clase Depurar gt 4 m Cambiar nombre 2 Propiedades File name VPARMTWrapper Files of type Archivos de componentes dll tib 0lb ocx exe manifest v Aceptar Cancelar 3 Declarar su uso en el c digo mediante la instrucci n adecuada para cada lenguaje Imports VPARMTWrapper vb net using VPARMTWrapper Ct BE 4 A partir de este momento podemos utilizar sus funciones que detallamos a continuaci n www neurallabs net Uer cL 0 abs Declaraci n Configuraci n Configuraci n El ensamblado NET est preparado para funcionar como componente est tico facilitando as la concurrencia al mismo incluso desde diferentes hilos de programaci n Por ello no es necesario declarar ninguna variable Este es un cambio importante en la versi n 2 0 del ensamblado
13. parMTInterface GetLicensedCores VparMTInterface GetFreeCores www neurallabs net mJ CIL ev ans Obtenci n de resultados GetNumberOfPlates Nos indica el n mero de matr culas que tenemos en la cola de resultados Si el valor es mayor a cero nos indica que tenemos alguna matr cula cuyo resultado a n no hemos le do Long GetNumberOfPlates Valor de Retorno N mero de matriculas en la cola de resultados Ejemplo 1 vb NET code Dim ptinfo As VPARMTWrapper PlateInfo While VparMTInterface GetNumberOfPlates gt 0 ptinfo VparMTInterface GetFirstPlate Dim plateNumber As String ptinfo GetPlateNumber End While Ejemplo 2 C code VPARMTWrapper PlateInfo ptinfo default VPARMTWrapper Platelnfo while VparMTInterface GetNumberOfPlates gt 0 ptinfo VparMTInterface GetFirstPlate www neurallabs net Uer c 0 cos GetFirstPlate Retorna la informaci n de la primera matr cula que se encuentra en la cola de resultados y elimina esta informaci n de la cola de resultados pendientes por lo que si no la almacenamos esta informaci n se perder Platelnfo GetFirstPlate Valor de Retorno Informaci n de la primera matr cula en la cola de resultados En caso de no haber ning n resultado pendiente se retorna null o Nothing Estructura Platelnfo Los m todos disponibles en la clase Platelnfo son los siguientes GetLeftPlatePo
14. ra Cuando le llegue su turno se intentar leer la matr cula contenida en una imagen Esta funci n recibe como entrada una imagen o la ruta en la que se encuentra una imagen Analiza la imagen en busca de una matr cula de veh culo y si la encuentra lee la matr cula y colocar el resultado en una cola de matr culas resultados accesibles Estas funciones retornan ID que servir de identificador de la petici n que se est procesando para la recuperaci n de resultados Esta funci n puede llamarse de dos formas diferentes Long Add Bitmap image Long Add Bitmap image Object additionalinfo Long Add Bitmap image Bool saveBitmapinfo Object additionallnfo Long Add String image Long Add String image Object additionallnfo Long Add Long width Long height IntPtr image Long Add Long width Long height IntPtr image Object additionalInfo Par metros image saveBitmapinfo Este par metro contiene la imagen a procesar en formato Windows Bitmap o la ruta en la que se encuentra la imagen o puntero a posici n de memoria de la imagen Los requisitos de memoria cuando se almacena informaci n de Bitmap son MUY ELEVADOS por lo que se ha de usar con cuidado y bajo el propio riesgo Par metro booleano true false que indica si queremos almacenar en los resultados la imagen origen de la que se obtiene la matr cula Si se activa a true la imagen se podr obtener con el m todo GetSourcelmage
15. recognition process you have to Check if recognition is running If processing queue still has images or CPU cores still have images processing you must wait them to finish After QueryEnd not readed results are LOST if MTInterface IsRunning while MTInterface IsProcessing Application DoEvents Still may get results Still may get results MTInterface QueryEnd 11 Not readed results are NOT available now END PROGRAM www neurallabs net
16. respecto la versi n 1 0 del mismo que era parcialmente est tico Las funciones de lectura preparan el motor de reconocimiento con la configuraci n pasada por par metro y generan las peticiones de lectura encol ndose para ser procesadas por el gestor multithread As pues el primer par metro de todas ellas es una estructura inicializada con la configuraci n definida para esa petici n Esta inicializaci n puede realizarse a trav s del constructor o mediante una llamada posterior En cualquier caso es obligatorio hacerla SetConfiguration ByVal Miliseconds As Int32 ByVal aplicarCorreccion As Int32 ByVal distance As Single ByVal vertCoef As Single ByVal horizCoef As Single ByVal angle As Single ByVal left As Int32 ByVal top As Int32 ByVal width As Int32 ByVal height As Int32 ByVal numSteps As Int32 ByVal steps As Integer Par metros Miliseconds Indica al motor de reconocimiento un tiempo de proceso m ximo tras el cual retornar con el resultado que haya obtenido hasta el momento Este valor est expresado en milisegundos Se recomienda O AplicarCorreccion Correcci n Coefficients En caso de poner este booleano a true los 4 par metros siguientes se aplicar n Para m s informaci n sobre estos par metros dirigirse al manual de usuario de VPAR distance Par metro para la distancia vertCoef Par metro para el coeficiente vertical horizCoef Par metro para el coeficiente horizontal www neur
17. sition Esta propiedad retorna la coordenada izquierda de la matr cula encontrada GetRightPlatePosition Esta propiedad retorna la coordenada derecha de la matricula encontrada GetTopPlatePosition Esta propiedad retorna la coordenada superior de la matr cula encontrada GetBottomPlatePosition Esta propiedad retorna la coordenada inferior de la matr cula encontrada GetPlateNumber Esta propiedad retorna el texto con la matr cula encontrada GetSourcePath Esta propiedad retorna la ruta si disponible de la imagen usada para buscar la matricula encontrada Getld Esta propiedad retorna el identificador asignado a esta solicitud de lectura de matr cula es el valor retornado por el m todo Add GetGlobalConfidence Esta propiedad retorna un valor que expresa la fiabilidad de la lectura de la matr cula analizada por el Vehicle Plates Automatic Reader Este valor est expresado en tanto por ciento 096 100 GetAverageCharacterHeigth Esta propiedad retorna el valor medio de la altura de los caracteres de la matr cula encontrada GetNumcCharacters Esta propiedad retorna el n mero de caracteres de la matr cula encontrada www neurallabs net JJ CIL ev ans GetCharConfidence Esta propiedad retorna un array conteniendo las fiabilidades de cada uno de los caracteres de la matr cula encontrada El array va de cero hasta GetNumCharacters 1 GetPlateFormat Esta propiedad retorna
18. todo elimina esta informaci n de la cola de resultados pendientes por lo que si no se guarda se perder NLInfo GetFirstElement Valor de retorno Informaci n de la primera imagen disponible en la cola de resultados Si no hay ning n resultado pendiente se retornar null o Nothing Estructura NLInfo Los m todos disponibles en la clase NLInfo son los siguientes Getld Esta propiedad retorna el id de la imagen procesada Configuration Esta propiedad retorna la estructura de informaci n MTConfiguration usada cuando se realiz la llamada al motor de reconocimiento Ver la documentaci n Vparmt Vpar multithread para disponer de m s informaci n sobre esta estructura de datos GetFirstPlate Esta propiedad retorna el primer resultado Platelnfo de la imagen PlateCount Esta propiedad retorna el n mero de matr culas disponible en la imagen procesada www neurallabs net Uer cL 0 abs ReadPlates Imagelnformation Estructura Piclnformation Esta propiedad retorna el n mero de matr culas le das de la imagen procesada Esta propiedad retorna la estructura de informacion Piclnformation de la imagen procesada Los m todos disponibles en la clase Piclnformation son los siguientes Getld GetPath Getlmage GetObject GetTimeStamp GetUTCTimeStamp Ejemplo Dim ptElement As NLInfo Get firs element wher ptElement MTInterface
Download Pdf Manuals
Related Search