B ä^•\Œ~ã@sJdZddlZddlZddlZdd„Zedkr2eƒdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZd ZdZdZdZejjdkZejZdZGdd„dƒZGdd„dƒZ Gdd„de ƒZ!Gdd„dƒZ"Gdd„dƒZ#Gdd„dƒZ$Gdd„dƒZ%Gd d!„d!ƒZ&Gd"d#„d#ƒZ'Gd$d%„d%ƒZ(Gd&d'„d'ƒZ)e(ƒZ*d(d)„Z+d…d+d,„Z,d†d-d,„Z,d‡d.d/„Z-d0d1„Z.d2d3„Z/d4d5„Z0dˆd7d8„Z1d9d8„Z1d:d8„Z1d;d8„Z1d„Z2d?d>„Z2d@d>„Z2dAdB„Z3d‰dDdE„Z4dŠdGdH„Z5dIdJ„Z6dKdJ„Z6d‹dMdN„Z7dŒdPdQ„Z8dRdS„Z9ddUdV„Z:dŽdXdY„Z;dZd[„Zdd`da„Z?dbdc„Z@d‘ddd]„Z=d’deda„Z?d“dfdg„ZAd”dhdH„Z5did>„Z2djd>„Z2dkd>„Z2dldB„Z3d•dmdE„Z4dndJ„Z6dodJ„Z6d–dpdN„Z7d—dqdQ„Z8drdS„Z9d˜dsdV„Z:d™dtdY„Z;dšdudv„ZBdwd,„Z,dxdH„Z5dydJ„Z6dzdN„Z7d{dE„Z4d|d8„Z1d}d>„Z2d~dB„Z3ddQ„Z8d€dS„Z9ddV„Z:d‚dY„Z;dƒd]„Z=d„da„Z?dS)›aÐ A (very) simple UI lib built on top of OpenCV drawing primitives. Version: 2.7 Use of cvui revolves around calling cvui.init() to initialize the lib, rendering cvui components to a np.ndarray (that you handle yourself) and finally showing that np.ndarray on the screen using cvui.imshow(), which is cvui's version of cv2.imshow(). Alternatively you can use cv2.imshow() to show things, but in such case you must call cvui.update() yourself before calling cv.imshow(). E.g.: import numpy as np import cv2 import cvui WINDOW_NAME = 'CVUI Hello World!' frame = np.zeros((200, 500, 3), np.uint8) cvui.init(WINDOW_NAME) while (True): # Fill the frame with a nice color frame[:] = (49, 52, 49) cvui.text(frame, x, y, 'Hello world!') cvui.imshow(WINDOW_NAME, frame) if cv2.waitKey(20) == 27: break Read the full documentation at https://dovyski.github.io/cvui/ Copyright (c) 2018 Fernando Bevilacqua Licensed under the MIT license. éNcCsdS)Nr©rrrú-C:\software\vidtrack\examples\bb-tool\cvui.pyÚmain+srÚ__main__z2.7éééééééééé éÿÿÿÿc@seZdZddd„Zdd„ZdS)ÚPointrcCs||_||_dS)N)ÚxÚy)ÚselfÚtheXÚtheYrrrÚ__init__SszPoint.__init__cCs | |¡S)N)Úcontains)rÚtheRectrrrÚinsideWsz Point.insideN)rr)Ú__name__Ú __module__Ú __qualname__rrrrrrrRs rc@s&eZdZd dd„Zdd„Zdd„ZdS) ÚRectrcCs||_||_||_||_dS)N)rrÚwidthÚheight)rrrÚtheWidthÚ theHeightrrrr\sz Rect.__init__cCs<|j|jko:|j|j|jko:|j|jko:|j|j|jkS)N)rrrr )rZthePointrrrrbsz Rect.containscCs |j|jS)N)rr )rrrrÚareaesz Rect.areaN)rrrr)rrrrrr#rrrrr[s rc@seZdZddd„ZdS)ÚSizercCsd|_d|_||_||_dS)Nr)rrrr )rr!r"rrrrksz Size.__init__N)rr)rrrrrrrrr$jsr$c@seZdZdd„Zdd„ZdS)ÚBlockcCs6d|_tƒ|_tƒ|_tƒ|_d|_t|_|  ¡dS)Nr) ÚwhererÚrectÚfillrÚanchorÚpaddingÚROWÚtypeÚreset)rrrrrsszBlock.__init__cCsRd|j_d|j_d|j_d|j_|j|_d|j_d|j_d|j_d|j_d|_dS)Nr)r'rrrr r(r)r*)rrrrr-}sz Block.resetN)rrrrr-rrrrr%rs r%c@seZdZdd„ZdS)ÚLabelcCsd|_d|_d|_d|_dS)NFÚ)Ú hasShortcutÚshortcutÚtextBeforeShortcutÚtextAfterShortcut)rrrrr“szLabel.__init__N)rrrrrrrrr.’sr.c@seZdZdd„Zdd„ZdS)Ú MouseButtoncCsd|_d|_d|_dS)NF)Ú justReleasedÚ justPressedÚpressed)rrrrr›szMouseButton.__init__cCsd|_d|_d|_dS)NF)r6r5r7)rrrrr- szMouseButton.resetN)rrrrr-rrrrr4šsr4c@seZdZdd„ZdS)ÚMousecCs0ttƒttƒttƒi|_tƒ|_tddƒ|_dS)Nr)Ú LEFT_BUTTONr4Ú MIDDLE_BUTTONÚ RIGHT_BUTTONÚbuttonsÚ anyButtonrÚposition)rrrrr§s  zMouse.__init__N)rrrrrrrrr8¦sr8c@seZdZdd„ZdS)ÚContextcCsd|_tƒ|_dS)Nr/)Ú windowNamer8Úmouse)rrrrr²szContext.__init__N)rrrrrrrrr?±sr?c@seZdZd dd„ZdS) ÚTrackbarParamsçç9@çð?rú%.0LfcCs(||_||_||_||_||_||_dS)N)ÚminÚmaxÚstepÚsegmentsÚoptionsÚ labelFormat)rÚtheMinÚtheMaxÚtheStepÚ theSegmentsÚtheLabelFormatÚ theOptionsrrrr¸s zTrackbarParams.__init__N)rCrDrErrFr)rrrrrrrrrB·srBc@s@eZdZdd„Zdd„ZdOdd„Zdd „Zd d „Zd d „Zdd„Z dd„Z dd„Z dd„Z dPdd„Z dd„Zdd„Zdd„Zdd„Zd d!„Zd"d#„Zd$d%„Zd&d'„Zd(d)„Zd*d+„Zd,d-„Zd.d/„Zd0d1„Zd2d3„Zd4d5„Zd6d7„Zd8d9„Zd:d;„Zdd?„Z!d@dA„Z"dBdC„Z#dDdE„Z$dFdG„Z%dHdI„Z&dJdK„Z'dLdM„Z(dNS)QÚInternalcCs`d|_d|_i|_g|_d|_d|_tƒ|_dd„tdƒDƒ|_ d|_ d|_ t ƒ|_ ||j _dS)Nr/rcSsg|] }tƒ‘qSr)r%)Ú.0Úirrrú Ësz%Internal.__init__..édé)ÚdefaultContextÚcurrentContextÚcontextsÚbufferÚlastKeyPressedÚ delayWaitKeyr%ÚscreenÚrangeÚstackÚ stackCountÚtrackbarMarginXÚRenderÚ_renderÚ _internal)rrrrrÃszInternal.__init__cCs>d}|tks|tkr|j}n|tkr,|j}n|tkr:|j}|S)NF)ÚCLICKÚUPr5ÚDOWNr6ÚIS_DOWNr7)rÚ theButtonÚtheQueryÚaRetrrrÚ isMouseButtonÒszInternal.isMouseButtonr/cCs| |¡jjS)ag Return the last position of the mouse. \param theWindowName name of the window whose mouse cursor will be used. If nothing is informed (default), the function will return the position of the mouse cursor for the default window (the one informed in `cvui::init()`). eturn a point containing the position of the mouse cursor in the speficied window. )Ú getContextrAr>)rÚ theWindowNamerrrÚmouseWÞszInternal.mouseWcCs | d|¡S)at Query the mouse for events, e.g. "is any button down now?". Available queries are: * `cvui::DOWN`: any mouse button was pressed. `cvui::mouse()` returns `true` for a single frame only. * `cvui::UP`: any mouse button was released. `cvui::mouse()` returns `true` for a single frame only. * `cvui::CLICK`: any mouse button was clicked (went down then up, no matter the amount of frames in between). `cvui::mouse()` returns `true` for a single frame only. * `cvui::IS_DOWN`: any mouse button is currently pressed. `cvui::mouse()` returns `true` for as long as the button is down/pressed. It is easier to think of this function as the answer to a questions. For instance, asking if any mouse button went down: ``` if (cvui::mouse(cvui::DOWN)) { // Any mouse button just went down. } ``` The window whose mouse will be queried depends on the context. If `cvui::mouse(query)` is being called after `cvui::context()`, the window informed in the context will be queried. If no context is available, the default window (informed in `cvui::init()`) will be used. Parameters ---------- theQuery: int Integer describing the intended mouse query. Available queries are `cvui::DOWN`, `cvui::UP`, `cvui::CLICK`, and `cvui::IS_DOWN`. \sa mouse(const cv::String&) \sa mouse(const cv::String&, int) \sa mouse(const cv::String&, int, int) \sa mouse(int, int) r/)ÚmouseWQ)rrlrrrÚmouseQçszInternal.mouseQcCs| |¡jj}| ||¡}|S)a  Query the mouse for events in a particular window. This function behave exactly like `cvui::mouse(int theQuery)` with the difference that queries are targeted at a particular window. \param theWindowName name of the window that will be queried. \param theQuery an integer describing the intended mouse query. Available queries are `cvui::DOWN`, `cvui::UP`, `cvui::CLICK`, and `cvui::IS_DOWN`. \sa mouse(const cv::String&) \sa mouse(const cv::String&, int, int) \sa mouse(int, int) \sa mouse(int) )rorAr=rn)rrprlÚaButtonrmrrrrrs  zInternal.mouseWQcCs| d||¡S)af Query the mouse for events in a particular button. This function behave exactly like `cvui::mouse(int theQuery)`, with the difference that queries are targeted at a particular mouse button instead. \param theButton an integer describing the mouse button to be queried. Possible values are `cvui::LEFT_BUTTON`, `cvui::MIDDLE_BUTTON` and `cvui::LEFT_BUTTON`. \param theQuery an integer describing the intended mouse query. Available queries are `cvui::DOWN`, `cvui::UP`, `cvui::CLICK`, and `cvui::IS_DOWN`. \sa mouse(const cv::String&) \sa mouse(const cv::String&, int, int) \sa mouse(int) r/)ÚmouseWBQ)rrkrlrrrÚmouseBQs zInternal.mouseBQcCsF|tkr$|tkr$|tkr$t dd¡| |¡jj|}| ||¡}|S)aŠ Query the mouse for events in a particular button in a particular window. This function behave exactly like `cvui::mouse(int theButton, int theQuery)`, with the difference that queries are targeted at a particular mouse button in a particular window instead. \param theWindowName name of the window that will be queried. \param theButton an integer describing the mouse button to be queried. Possible values are `cvui::LEFT_BUTTON`, `cvui::MIDDLE_BUTTON` and `cvui::LEFT_BUTTON`. \param theQuery an integer describing the intended mouse query. Available queries are `cvui::DOWN`, `cvui::UP`, `cvui::CLICK`, and `cvui::IS_DOWN`. r z[Invalid mouse button. Are you using one of the available: cvui.{RIGHT,MIDDLE,LEFT}_BUTTON ?) r;r:r9Z_Internal__internalÚerrorrorAr<rn)rrprkrlrtrmrrrru(s   zInternal.mouseWBQcCs||_||_||_d|_dS)Nr)rYrZr^r])rrpÚtheDelayWaitKeyrrrÚinit:sz Internal.initcCs ||@dkS)Nrr)rZ theBitsetÚtheValuerrrÚ bitsetHas@szInternal.bitsetHascCs&td|d|ƒt d¡t d¡dS)Nz[CVUI] Fatal error (code z): i †r)ÚprintÚcv2ÚwaitKeyÚsysÚexit)rZtheIdZ theMessagerrrrwCs zInternal.errorcCsZt|ƒdkr|j|St|jƒdkr0|j|jSt|jƒdkrJ|j|jS| dd¡dS)Nrr z;Unable to read context. Did you forget to call cvui.init()?)Úlenr[rZrYrw)rrprrrroHs    zInternal.getContextcCsš|jtkrL|j|j}|jj|7_|jj|7_t|j|jjƒ|j_nJ|jt kr–|j|j}|jj |7_ |jj|7_t|j|jjƒ|j_dS)N) r,r+rr*r)rr(rHr ÚCOLUMNr)rÚtheBlockZtheSizeÚaValuerrrÚupdateLayoutFlowZs    zInternal.updateLayoutFlowcCs |jdkS)Nr)rb)rrrrÚblockStackEmptyiszInternal.blockStackEmptycCs"|jdkr| dd¡|j|jS)NrrzrYou are using a function that should be enclosed by begin*() and end*(), but you probably forgot to call begin*().)rbrwra)rrrrÚtopBlockls  zInternal.topBlockcCs|jd7_|j|jS)Nr)rbra)rrrrÚ pushBlockrszInternal.pushBlockcCs4|jdkr| dd¡|j}|jd8_|j|S)NrrzYMismatch in the number of begin*()/end*() calls. You are calling one more than the other.)rbrwra)rZaIndexrrrÚpopBlockvs   zInternal.popBlockcCs®d}d}d}tƒ}d|_d|_d|_d|_xr|t|ƒkrœ||}|dkrv|t|ƒdkrvd|_||d|_|d7}n|jdkrŠ||7}n||7}|d7}q,W||_||_|S)Nrr/Fú&rT)r.r0r1r2r3r)rÚtheLabelrUZaBeforeZaAfterÚaLabelÚcrrrÚ createLabel€s*    zInternal.createLabelc Csnt |tj|d¡\}} t|d|dƒ} t||| jƒ} |j ||| ||¡|rj| jd7_| || ¡dS)Nrr) r}Ú getTextSizeÚFONT_HERSHEY_SIMPLEXr$rr reÚtextr…) rrƒrrÚtheTextÚ theFontScaleÚtheColorÚtheUpdateLayoutÚ aSizeInfoÚ aBaselineÚ aTextSizeÚaPosrrrr‘œsz Internal.textc Cs¨t|d|ddƒ}| |||dddd¡r8|d|8<||d}|j |||¡| ||j|j|dddd¡r‚|d|7<td|j|jƒ} | || ¡|dS)Néé0ú-Frú+é,) rÚbuttonWHreÚcounterrrr$r r…) rrƒrrrzrOÚ theFormatÚ aContentAreaÚaTextÚaSizerrrr ©s  zInternal.countercCsô| ¡j}t||ddƒ}t |tjdd¡\} } tdd| d| dƒ} t|||j| jd|jƒ} |  |j ¡} | r˜|j   |t |¡|j jr¨|d |d<n|j   |t|¡|j  |||| |¡|drÒ|j  ||¡t| j| jƒ}| ||¡|dS)Négš™™™™™Ù?rrr )rorArr}rrrr rr>reÚcheckboxÚOVERr=r5ÚOUTÚ checkboxLabelÚ checkboxCheckr$r…)rrƒrrr‹ÚtheStater”ÚaMouseÚaRectr–r—r˜ZaHitAreaÚ aMouseIsOverr¤rrrr¦»s"   zInternal.checkboxcCs$|dkr dn|}|dkrdn|}|S)Ngð?gr)rrzrrrÚclamp01ÖszInternal.clamp01cCsP| |jt¡rL|jdkrLt|d|jƒ|j}t|ƒ}|j|j||d<dS)Ngr)r{rKÚTRACKBAR_DISCRETErIÚfloatrGÚround)rÚ theParamsrzÚkrrrÚ)trackbarForceValuesAsMultiplesOfSmallStepÛsz2Internal.trackbarForceValuesAsMultiplesOfSmallStepcCsHt||j|jƒ|jd|j}| |¡}|j||j|j}|S)Nr)r±rrcrr¯rGrH)rr³Ú theBoundingZ thePixelXÚaRatior„rrrÚtrackbarXPixelToValueás$ zInternal.trackbarXPixelToValuecCsLt||jƒ|j|j}| |¡}|j|j||jd|j}t|ƒS)Nr)r±rGrHr¯rrcrÚint)rr³r¶rzr·ZaPixelsXrrrÚtrackbarValueToXPixelçs  zInternal.trackbarValueToXPixelcCsN| ¡j}t}t||||ƒ |j¡}|r:|jjr6t}nt }|rJ|jj rJt }|S)N) rorAr¨rrr>r=r7rir§r5rg)rrrr!r"r¬rmr®rrrÚiareaís  zInternal.iareacCsÔt |tjdd¡\}} tdd|d|dƒ} t||||ƒ} | ||| j| j¡} |j || | |¡|j  || | || ¡|rŽt ||ƒ} |  || ¡d}|j dkrÈ|  |¡}|jrÈ|j ¡t|j ƒ ¡krÈd}| tkpÒ|S)Ngš™™™™™Ù?rrFrT)r}rrrr»rr reÚbuttonÚ buttonLabelr$r…r]rŽr0r1ÚlowerÚchrrg)rrƒrrr!r"r‹r•r–r—r˜r­ÚaStatusr¤ZaWasShortcutPressedrŒrrrrŸs    zInternal.buttonWHc CsNt |tjdd¡\}}tdd|d|dƒ}| ||||jd|jd|d¡S)Ngš™™™™™Ù?rrééT)r}rrrrŸrr )rrƒrrr‹r–r—r˜rrrr¼!szInternal.buttonc Cs¨|jd}|jd} t||| |ƒ} | ||| j| j¡} | tkrP|j || |¡n2| tkrj|j || |¡n| t kr‚|j || |¡|r t | j| jƒ} |  || ¡| t kS)Nrr) Úshaperr»rr r¨reÚimager§rir$r…rg) rrƒrrÚtheIdleÚtheOverÚtheDownr•Z aIdleRowsZ aIdleColsr­rÀr¤rrrÚbuttonI)s   zInternal.buttonIc CsL|jd}|jd}t||||ƒ}|j |||¡t||ƒ}| ||¡dS)Nrr)rÃrrerÄr$r…) rrƒrrÚtheImageZ aImageRowsZ aImageColsr­r¤rrrrÄ=s    zInternal.imagec Cs | ¡j}t|||dƒ}| |j¡} |d} |j || rreÚtrackbarr§r¨r=r7r¸rr{rKr°rµr…) rrƒrrr!rzr³r¬r¢r®r„rrrrËJs      zInternal.trackbarc CsTt|||dƒ}t|||j|||jƒ}|j ||||¡t||ƒ} | || ¡dS)Né)rr reÚwindowr$r…) rrƒrrr!r"ÚtheTitleZ aTitleBarZaContentr¤rrrrÍ^s  zInternal.windowc Csœt||ƒ}t||||ƒ} | jdkr.|j| jn|j| _| jdkrL|j| jn|j| _t| jƒ| _t| jƒ| _|j || ||¡t | j| jƒ} |  || ¡dS)Nr) rrrrr rÚabsrer'r$r…) rrƒrrr!r"ÚtheBorderColorÚtheFillingColorZaAnchorr­r¤rrrr'hs   z Internal.rectc Cs€t||||ƒ}t|ƒ} | dkrD| |¡\} } |j |||| | |¡n"| |||| dkrZdndddd¡t||ƒ} | || ¡dS)NrrzNo data.zInsufficient data points.gš™™™™™Ù?iÎÎÎF)rrÚ findMinMaxreÚ sparkliner‘r$r…) rrƒÚ theValuesrrr!r"r”r­ZaHowManyValuesÚaMinÚaMaxr¤rrrrÓws" zInternal.sparklinecCs8|d?d@}|d?d@}|d?d@}|d@}||||fS)Nééÿrr r)rr”ÚaAlphaZaRedZaGreenZaBluerrrÚ hexToScalar…s    zInternal.hexToScalarcCst|tr tntƒS)N)Ú isinstanceÚ_IS_PY2Ú basestringÚstr)rZtheObjrrrÚisStringszInternal.isStringc Csf| ¡}||_||j_||j_||j_||j_|j|_d|j_d|j_||j_||j_||_ ||_ dS)Nr) rˆr&r'rrrr r(r)r*r,) rÚtheTypeÚtheWhererrr!r"Ú thePaddingÚaBlockrrrÚbeginszInternal.begincCs„| ¡}|j|kr| dd¡| ¡dkr€| ¡}tƒ}|jjdkrL|jjn|jj|_|jj dkrj|jj n|jj |_ |  ||¡dS)Nr z‘Calling wrong type of end*(). E.g. endColumn() instead of endRow(). Check if your begin*() calls are matched with their appropriate end*() calls.Fr) r‰r,rwr†r‡r$r'rr(r r…)rràrãZaTopr¤rrrÚend¤s    z Internal.endcCs>|d}|d}x$|D]}||kr&|}||kr|}qW||fS)Nrr)rrÔrÕrÖr„rrrrÒ¿s zInternal.findMinMaxN)r/)r/))rrrrrnrqrsrrrvruryr{rwror…r†r‡rˆr‰rŽr‘r r¦r¯rµr¸rºr»rŸr¼rÈrÄrËrÍr'rÓrÚrßrärårÒrrrrrSÂsL !     rSc@s¶eZdZdZdefdd„Zdd„Zdd„Zd d „Zd d „Z d d„Z dd„Z dd„Z dd„Z dd„Zdd„Zdd„Zdd„Zdd„Zdd „Zd!d"„Zd#d$„Zd%d&„Zd'd(„Zd)d*„ZdS)+rdNrcCsLt|jƒt|jƒf}t|j|jƒt|j|jƒf}t ||||||¡dS)N)r¹rrrr r}Ú rectangle)rráÚtheShaper”Z theThicknessZ theLineTypeZ aStartPointZ aEndPointrrrræÐs zRender.rectanglec Cs>t|jƒt|jƒf}t |j||tj||j |¡dtj ¡dS)Nr) r¹rrr}ÚputTextr&rrfrÚÚLINE_AA)rrƒr’ÚthePosr“r”Ú aPositionrrrr‘Ösz Render.textc Cs´| |j|dt¡| |j|d¡t |tjdd¡\}}tdd|d|dƒ}t|j|j d|j d|j |j d|j dƒ}t  |j|t |jƒt |j ƒftjdddt¡dS)N)é)rìrì)éErírígš™™™™™Ù?rrr)éÎrîrî)rær&Ú CVUI_FILLEDr}rrrrrrrr rèr¹ÚCVUI_ANTIALISED)rrƒrçrzr–r—r˜r™rrrr Ús 6zRender.countercCs¾| |j|d¡|jd7_|jd7_|jd8_|jd8_| |j|d¡|jd7_|jd7_|jd8_|jd8_| |j||tkr¦dn|tkr²dndt¡dS)N)rìrìrìrr)éJrñrñ)éBròrò)éRróró)é2rôrô) rær&rrrr r¨r§rï)rrƒr«rçr‹rrrr¼äsz Render.buttoncCs.||j|j|j|j…|j|j|j…f<dS)N)r&rr rr)rrƒrrÉrrrrÄösz Render.imagec Cs€|tkr dnd}tƒ}|dkrzt|jƒt|jƒf}t |j||tj||dt ¡t  |tj|d¡\} } tdd| d| dƒ}|j S)Ngö(\ÂõØ?gš™™™™™Ù?r/rr) rirr¹rrr}rèr&rrðrr) rrƒr«r”r’Ú thePositionÚ aFontScaler˜rër–r—rrrrèùszRender.putTextc Cszd}t |tj|d¡\}}tdd|d|dƒ}t|j|jd|jƒ}t |j |t |jƒt |jƒftj|ddt ¡|jS)Ng333333Ó?rrr)rîrîrî) r}rrrrrrrrèr&r¹rð) rrƒrõr’rör–r—r˜ZaPositionDecenteredrrrÚputTextCentereds ,zRender.putTextCenteredc Cst|j|jd|jd|j|jd|jdƒ}d}|j |¡}|jdkrd| |||||¡n°| ||||j |¡} |j| } |j| 7_d} | |j 7} | |||| |¡} | | } |j| 7_| ||||j |¡t   |jt| ƒt|jdƒft| ƒt|jdƒf|dt¡dS)Nr)rîrîrîFr/rr)rrrrr rfrŽr0rèr2r1r3r}Úliner&r¹rð) rrƒr«rr‹Ú theTextSizer™ÚaColorrŒÚaWidthZaStartZ aShortcutZaEndrrrr½s6    zRender.buttonLabelcCs0t|j|j|jdƒ}d}|j |||¡} d} d} t| | |j| ƒ} t| | |j|| ƒ} t| j| j| j| j| j| jƒ}|tkrŽdnd}| ||dd¡|jd7_|jd7_|j d8_ |jd8_| ||d |¡|j  |j t ¡d k}|r,t| | jd ƒ}|j |}| |||¡dS) Nrr rr iRRRiBBBi!!!riQQQFé )rrrr rfrºrr§r'rr{rKÚTRACKBAR_HIDE_VALUE_LABELrLr÷)rrƒr«rçrzr³ÚtheWorkingAreaÚ aBarTopLeftÚ aBarHeightÚaPixelXZaIndicatorWidthZaIndicatorHeightÚaPoint1ÚaPoint2r­Z aFillColorZ aShowLabelÚaTextPosr£rrrÚtrackbarHandle(s(" zRender.trackbarHandlec Cs¤d}t|j|j|jdƒ}t|j|j|j|ƒ} |tkr>>i)))r)rXrXrX) rrrr rrr§r'r}rør&r¹) rrƒr«rçrzr³rþrrÿr­Ú aBorderColorrrrÚ trackbarPathEs zRender.trackbarPathcCs®t|j|j|jdƒ}d}|j |jt¡} | r6|jn|j |j d} |j } x\| |j kr¨t |j  ||| ¡ƒ} | t |jƒf} | t |jdƒf}t  |j| ||¡| | 7} qNWdS)Nr)éQrrrÌr)rrrr rfr{rKr°rIrHrGr¹rºr}rør&)rrƒr«rçrzr³rþrÿrúZ aDiscreteZ aFixedStepr„rrrrrrÚ trackbarStepsOs zRender.trackbarStepscCs’d}t|j|j|jdƒ}t|j |||¡ƒ} | t|jƒf} | t|jdƒf} t |j | | |¡|rŽ|j |} t| |jdƒ} |  || | ¡dS)N)rrrrr rü) rrrr r¹rfrºr}rør&rLr÷)rrƒrçr³rzrþZ theShowLabelrúrÿrrrr£rrrrÚtrackbarSegmentLabel_s zRender.trackbarSegmentLabelc Cs²|jdkrdn|j}t|j|jƒ|}|j |jt¡dk} | ||||j|| ¡|j |jt ¡dk} |j} x*| |jkr–| |||| || ¡| |7} qnW| ||||j|| ¡dS)NrF) rJr±rHrGrfr{rKÚTRACKBAR_HIDE_MIN_MAX_LABELSr ÚTRACKBAR_HIDE_SEGMENT_LABELS) rrƒr«rçrzr³rþÚ aSegmentsZaSegmentLengthZaHasMinMaxLabelsZaHasSegmentLabelsr„rrrÚtrackbarSegmentsns  zRender.trackbarSegmentsc Cs¶t|j|jj|j|jd|jj|jƒ}| ||||||¡|j |j t ¡}|j |j t ¡dk}|r‚|dkr‚|  ||||||¡|dkrž|  ||||||¡| ||||||¡dS)NrF)rrrfrcrrr rr{rKÚTRACKBAR_HIDE_LABELSÚTRACKBAR_HIDE_STEP_SCALEr rr) rrƒr«rçrzr³Z aWorkingAreaZaHideAllLabelsZ aShowStepsrrrrË‚s* zRender.trackbarcCs²| |j||tkrdnd¡|jd7_|jd7_|jd8_|jd8_| |j|d¡|jd7_|jd7_|jd8_|jd8_| |j|dt¡dS)N)écrr)é€rrrr)érr)rìrìrì)rær&r¨rrrr rï)rrƒr«rçrrrr¦’szRender.checkboxcCsLt|j|jd|j|j|jd|jddƒ}| |||d|¡dS)Nr rrgš™™™™™Ù?)rrrrr r‘)rrƒrr‹rùr”r™rrrr©¤s6zRender.checkboxLabelcCsN|jd7_|jd7_|jd8_|jd8_| |j|dt¡dS)Nrr)rØé¿éu)rrrr rær&rï)rrƒrçrrrrª¨s zRender.checkboxCheckc Cs^d}d}|j ¡}| |j|d¡|jd7_|jd7_|jd8_|jd8_| |j|dt¡t|jd|jdƒ}t   |j|t |jƒt |jƒft j d d dt ¡| |j|d¡|jd7_|jd7_|jd8_|jd8_| ||d t¡|rHt ||j¡| ||d t¡t  |||jd |d |j¡n| |j|d t¡dS)NFg333333Ó?)rñrñrñrr)é!rrr é gš™™™™™Ù?)rîrîrî)é1rrgð?g)r&Úcopyrærrrr rïrr}rèr¹rrðÚnpÚcopytoÚ addWeighted) rrƒZ theTitleBarZ theContentrÎZ aTransparecyrÙZaOverlayr™rrrrͯs, ,z Render.windowcCsP|j |¡}|j |¡}|ddk}|r<| |j||tt¡| |j||¡dS)NrrØ)rfrÚrær&rïrð)rrƒrêrÐrÑrÚ aFillingColorZ aHasFillingrrrr'Ós    z Render.rectcCst|ƒ}d}||} t|jƒ|} |j} xÖ||dkrþ| } |||| |jd |j|jd} t| | ƒ}| | } ||d|| |jd |j|jd} t| | ƒ}t |j t |jƒt |jƒft |jƒt |jƒf|j   |¡¡| | 7} |d7}q*WdS)Nrrr r) rr±rrr rrr}rør&r¹rfrÚ)rrƒrÔrrMrNr”r¤rUZaScaleZaGapZaPosXrrrrrrrrÓßs, 0 :zRender.sparkline)rrrrfrðrær‘r r¼rÄrèr÷r½rrr r rrËr¦r©rªrÍr'rÓrrrrrdÍs*    $ rdc CsÜtttg}tjtjtjg}tjtjtj g}x˜t ttdƒD]†}||} |||kr„d|j j _ d|j j _d|j j| _ d|j j| _q:|||kr:d|j j _d|j j _d|j j| _d|j j| _q:W||j j_||j j_dS)NrTF)r9r:r;r}ÚEVENT_LBUTTONDOWNÚEVENT_MBUTTONDOWNÚEVENT_RBUTTONDOWNÚEVENT_LBUTTONUPÚEVENT_MBUTTONUPÚEVENT_RBUTTONUPr`rAr=r6r7r<r5r>rr) ZtheEventrrZtheFlagsZ theContextZaButtonsZ aEventsDownZ aEventsUprUZaBtnrrrÚ _handleMouse÷s"        r$TcCs tdƒdS)a1 Initializes cvui. You must provide the name of the window where components will be added. It is also possible to tell cvui to handle OpenCV's event queue automatically (by informing a value greater than zero in the `theDelayWaitKey` parameter of the function). In that case, cvui will automatically call `cv2.waitKey()` within `cvui.update()`, so you don't have to worry about it. The value passed to `theDelayWaitKey` will be used as the delay for `cv2.waitKey()`. Parameters ---------- theWindowName: str name of the window where the components will be added. theDelayWaitKey: int delay value passed to `cv2.waitKey()`. If a negative value is informed (default is `-1`), cvui will not automatically call `cv2.waitKey()` within `cvui.update()`, which will disable keyboard shortcuts for all components. If you want to enable keyboard shortcut for components (e.g. using & in a button label), you must specify a positive value for this param. theCreateNamedWindow: bool if an OpenCV window named `theWindowName` should be created during the initialization. Windows are created using `cv2.namedWindow()`. If this parameter is `False`, ensure you call `cv2.namedWindow(WINDOW_NAME)` *before* initializing cvui, otherwise it will not be able to track UI interactions. See Also ---------- watch() context() z5This is wrapper function to help code autocompletion.N)r|)rprxÚtheCreateNamedWindowrrrrysrycCs tdƒdS)aö Initialize cvui using a list of names of windows where components will be added. It is also possible to tell cvui to handle OpenCV's event queue automatically (by informing a value greater than zero in the `theDelayWaitKey` parameter of the function). In that case, cvui will automatically call `cv2.waitKey()` within `cvui.update()`, so you don't have to worry about it. The value passed to `theDelayWaitKey` will be used as the delay for `cv2.waitKey()`. Parameters ---------- theWindowNames: str array containing the name of the windows where components will be added. Those windows will be automatically if `theCreateNamedWindows` is `True`. theHowManyWindows: int how many window names exist in the `theWindowNames` array. theDelayWaitKey: int delay value passed to `cv2.waitKey()`. If a negative value is informed (default is `-1`), cvui will not automatically call `cv2.waitKey()` within `cvui.update()`, which will disable keyboard shortcuts for all components. If you want to enable keyboard shortcut for components (e.g. using & in a button label), you must specify a positive value for this param. theCreateNamedWindows: bool if OpenCV windows named according to `theWindowNames` should be created during the initialization. Windows are created using `cv2.namedWindow()`. If this parameter is `False`, ensure you call `cv2.namedWindow(WINDOW_NAME)` for all windows *before* initializing cvui, otherwise it will not be able to track UI interactions. See Also ---------- watch() context() z5This is wrapper function to help code autocompletion.N)r|)ZtheWindowNamesZtheHowManyWindowsrxZtheCreateNamedWindowsrrrry(scCsŒ|rt |¡tƒ}||_d|jj_d|jj_|jj  ¡|jj t   ¡|jj t   ¡|jj t   ¡|tj|<t |ttj|¡dS)aÇ Track UI interactions of a particular window. This function must be invoked for any window that will receive cvui components. cvui automatically calls `cvui.watch()` for any window informed in `cvui.init()`, so generally you don't have to watch them yourself. If you initialized cvui and told it *not* to create windows automatically, you need to call `cvui.watch()` on those windows yourself. `cvui.watch()` can automatically create a window before watching it, if it does not exist. Parameters ---------- theWindowName: str name of the window whose UI interactions will be tracked. theCreateNamedWindow: bool if an OpenCV window named `theWindowName` should be created before it is watched. Windows are created using `cv2.namedWindow()`. If this parameter is `False`, ensure you have called `cv2.namedWindow(WINDOW_NAME)` to create the window, otherwise cvui will not be able to track its UI interactions. See Also ---------- init() context() rN)r}Ú namedWindowr?r@rAr>rrr=r-r<r;r:r9Ú __internalr[ÚsetMouseCallbackr$)rpr%ZaContexrrrÚwatchCs     r)cCs |t_dS)aŸ Inform cvui that all subsequent component calls belong to a window in particular. When using cvui with multiple OpenCV windows, you must call cvui component calls between `cvui.contex(NAME)` and `cvui.update(NAME)`, where `NAME` is the name of the window. That way, cvui knows which window you are using (`NAME` in this case), so it can track mouse events, for instance. E.g. ``` # Code for window 'window1'. cvui.context('window1') cvui.text(frame, ...) cvui.button(frame, ...) cvui.update('window1') # somewhere else, code for 'window2' cvui.context('window2') cvui.printf(frame, ...) cvui.printf(frame, ...) cvui.update('window2') # Show everything in a window cv2.imshow(frame) ``` Pay attention to the pair `cvui.context(NAME)` and `cvui.update(NAME)`, which encloses the component calls for that window. You need such pair for each window of your application. After calling `cvui.update()`, you can show the result in a window using `cv2.imshow()`. If you want to save some typing, you can use `cvui.imshow()`, which calls `cvui.update()` for you and then shows the frame in a window. E.g.: ``` # Code for window 'window1'. cvui.context('window1') cvui.text(frame, ...) cvui.button(frame, ...) cvui.imshow('window1') # somewhere else, code for 'window2' cvui.context('window2') cvui.printf(frame, ...) cvui.printf(frame, ...) cvui.imshow('window2') ``` In that case, you don't have to bother calling `cvui.update()` yourself, since `cvui.imshow()` will do it for you. Parameters ---------- theWindowName: str name of the window that will receive components from all subsequent cvui calls. See Also ---------- init() watch() N)r'rZ)rprrrÚcontexthsAr*cCst|ƒt ||¡dS)aà Display an image in the specified window and update the internal structures of cvui. This function can be used as a replacement for `cv2.imshow()`. If you want to use `cv2.imshow() instead of `cvui.imshow()`, you must ensure you call `cvui.update()` *after* all component calls and *before* `cv2.imshow()`, so cvui can update its internal structures. In general, it is easier to call `cvui.imshow()` alone instead of calling `cvui.update()' immediately followed by `cv2.imshow()`. Parameters ---------- theWindowName: str name of the window that will be shown. theFrame: np.ndarray image, i.e. `np.ndarray`, to be shown in the window. See Also ---------- update() context() watch() N)Úupdater}Úimshow)rpZtheFramerrrr,«sr,cCstjS)zÀ Return the last key that was pressed. This function will only work if a value greater than zero was passed to `cvui.init()` as the delay waitkey parameter. See Also ---------- init() )r'r]rrrrr]Æs r]r/cCs tdƒdS)a‰ Return the last position of the mouse. Parameters ---------- theWindowName: str name of the window whose mouse cursor will be used. If nothing is informed (default), the function will return the position of the mouse cursor for the default window (the one informed in `cvui.init()`). Returns ---------- a point containing the position of the mouse cursor in the speficied window. z5This is wrapper function to help code autocompletion.N)r|)rprrrrAÒs rAcCs tdƒdS)a# Query the mouse for events, e.g. 'is any button down now?'. Available queries are: * `cvui.DOWN`: any mouse button was pressed. `cvui.mouse()` returns `True` for a single frame only. * `cvui.UP`: any mouse button was released. `cvui.mouse()` returns `True` for a single frame only. * `cvui.CLICK`: any mouse button was clicked (went down then up, no matter the amount of frames in between). `cvui.mouse()` returns `True` for a single frame only. * `cvui.IS_DOWN`: any mouse button is currently pressed. `cvui.mouse()` returns `True` for as long as the button is down/pressed. It is easier to think of this function as the answer to a questions. For instance, asking if any mouse button went down: ``` if cvui.mouse(cvui.DOWN): # Any mouse button just went down. ``` The window whose mouse will be queried depends on the context. If `cvui.mouse(query)` is being called after `cvui.context()`, the window informed in the context will be queried. If no context is available, the default window (informed in `cvui.init()`) will be used. Parameters ---------- theQuery: int an integer describing the intended mouse query. Available queries are `cvui.DOWN`, `cvui.UP`, `cvui.CLICK`, and `cvui.IS_DOWN`. See Also ---------- mouse(str) mouse(str, int) mouse(str, int, int) mouse(int, int) z5This is wrapper function to help code autocompletion.N)r|)rlrrrrAás!cCs tdƒdS)aù Query the mouse for events in a particular window. This function behave exactly like `cvui.mouse(int theQuery)` with the difference that queries are targeted at a particular window. Parameters ---------- theWindowName: str name of the window that will be queried. theQuery: int an integer describing the intended mouse query. Available queries are `cvui.DOWN`, `cvui.UP`, `cvui.CLICK`, and `cvui.IS_DOWN`. See Also ---------- mouse(str) mouse(str, int, int) mouse(int, int) mouse(int) z5This is wrapper function to help code autocompletion.N)r|)rprlrrrrAscCs tdƒdS)aU Query the mouse for events in a particular button. This function behave exactly like `cvui.mouse(int theQuery)`, with the difference that queries are targeted at a particular mouse button instead. Parameters ---------- theButton: int an integer describing the mouse button to be queried. Possible values are `cvui.LEFT_BUTTON`, `cvui.MIDDLE_BUTTON` and `cvui.LEFT_BUTTON`. theQuery: int an integer describing the intended mouse query. Available queries are `cvui.DOWN`, `cvui.UP`, `cvui.CLICK`, and `cvui.IS_DOWN`. See Also ---------- mouse(str) mouse(str, int, int) mouse(int) z5This is wrapper function to help code autocompletion.N)r|)rkrlrrrrAscCs tdƒdS)a Query the mouse for events in a particular button in a particular window. This function behave exactly like `cvui.mouse(int theButton, int theQuery)`, with the difference that queries are targeted at a particular mouse button in a particular window instead. Parameters ---------- theWindowName: str name of the window that will be queried. theButton: int an integer describing the mouse button to be queried. Possible values are `cvui.LEFT_BUTTON`, `cvui.MIDDLE_BUTTON` and `cvui.LEFT_BUTTON`. theQuery: int an integer describing the intended mouse query. Available queries are `cvui.DOWN`, `cvui.UP`, `cvui.CLICK`, and `cvui.IS_DOWN`. z5This is wrapper function to help code autocompletion.N)r|)rprkrlrrrrA-scCs tdƒdS)aÉ Display a button. The size of the button will be automatically adjusted to properly house the label content. Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theLabel: str text displayed inside the button. Returns ---------- `true` everytime the user clicks the button. z5This is wrapper function to help code autocompletion.N)r|)rárrr‹rrrr¼>sr¼cCs tdƒdS)a$ Display a button. The button size will be defined by the width and height parameters, no matter the content of the label. Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theWidth: int width of the button. theHeight: int height of the button. theLabel: str text displayed inside the button. Returns ---------- `true` everytime the user clicks the button. z5This is wrapper function to help code autocompletion.N)r|)rárrr!r"r‹rrrr¼TscCs tdƒdS)a Display a button whose graphics are images (np.ndarray). The button accepts three images to describe its states, which are idle (no mouse interaction), over (mouse is over the button) and down (mouse clicked the button). The button size will be defined by the width and height of the images. Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theIdle: np.ndarray an image that will be rendered when the button is not interacting with the mouse cursor. theOver: np.ndarray an image that will be rendered when the mouse cursor is over the button. theDown: np.ndarray an image that will be rendered when the mouse cursor clicked the button (or is clicking). Returns ---------- `true` everytime the user clicks the button. See Also ---------- button() image() iarea() z5This is wrapper function to help code autocompletion.N)r|)rárrrÅrÆrÇrrrr¼nscCs tdƒdS)at Display an image (np.ndarray). Parameters ---------- theWhere: np.ndarray image/frame where the provded image should be rendered. theX: int position X where the image should be placed. theY: int position Y where the image should be placed. theImage: np.ndarray image to be rendered in the specified destination. See Also ---------- button() iarea() z5This is wrapper function to help code autocompletion.N)r|)rárrrÉrrrrÄsrÄéÎÎÎcCs tdƒdS)a  Display a checkbox. You can use the state parameter to monitor if the checkbox is checked or not. Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theLabel: str text displayed besides the clickable checkbox square. theState: [bool] array or list of booleans whose first position, i.e. theState[0], will be used to store the current state of the checkbox: `True` means the checkbox is checked. theColor: uint color of the label in the format `0xRRGGBB`, e.g. `0xff0000` for red. Returns ---------- a boolean value that indicates the current state of the checkbox, `true` if it is checked. z5This is wrapper function to help code autocompletion.N)r|)rárrr‹r«r”rrrr¦¥sr¦çš™™™™™Ù?cCs tdƒdS)aÀ Display a piece of text. Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theText: str the text content. theFontScale: float size of the text. theColor: uint color of the text in the format `0xRRGGBB`, e.g. `0xff0000` for red. See Also ---------- printf() z5This is wrapper function to help code autocompletion.N)r|)rárrr’r“r”rrrr‘¿sr‘cCs tdƒdS)aá Display a piece of text that can be formated using `C stdio's printf()` style. For instance if you want to display text mixed with numbers, you can use: ``` printf(frame, 10, 15, 0.4, 0xff0000, 'Text: %d and %f', 7, 3.1415) ``` Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theFontScale: float size of the text. theColor: uint color of the text in the format `0xRRGGBB`, e.g. `0xff0000` for red. theFmt: str formating string as it would be supplied for `stdio's printf()`, e.g. `'Text: %d and %f', 7, 3.1415`. See Also ---------- text() z5This is wrapper function to help code autocompletion.N)r|)rárrr“r”ÚtheFmtrrrÚprintfØsr0cCs tdƒdS)aª Display a piece of text that can be formated using `C stdio's printf()` style. For instance if you want to display text mixed with numbers, you can use: ``` printf(frame, 10, 15, 0.4, 0xff0000, 'Text: %d and %f', 7, 3.1415) ``` The size and color of the text will be based on cvui's default values. Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theFmt: str formating string as it would be supplied for `stdio's printf()`, e.g. `'Text: %d and %f', 7, 3.1415`. See Also ---------- text() z5This is wrapper function to help code autocompletion.N)r|)rárrr/rrrr0ösú%dcCs tdƒdS)az Display a counter for integer values that the user can increase/descrease by clicking the up and down arrows. Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theValue: [number] array or list of numbers whose first position, i.e. theValue[0], will be used to store the current value of the counter. theStep: number amount that should be increased/decreased when the user interacts with the counter buttons theFormat: str how the value of the counter should be presented, as it was printed by `stdio's printf()`. E.g. `'%d'` means the value will be displayed as an integer, `'%0d'` integer with one leading zero, etc. Returns ---------- number that corresponds to the current value of the counter. z5This is wrapper function to help code autocompletion.N)r|)rárrrzrOr¡rrrr sr ú%.1Lfc Cs tdƒdS)a¹ Display a trackbar for numeric values that the user can increase/decrease by clicking and/or dragging the marker right or left. This component can use different types of data as its value, so it is imperative provide the right label format, e.g. '%d' for ints, otherwise you might end up with weird errors. Example: ``` # using float trackbar(where, x, y, width, &floatValue, 0.0, 50.0) # using float trackbar(where, x, y, width, &floatValue, 0.0f, 50.0f) # using char trackbar(where, x, y, width, &charValue, (char)1, (char)10) ``` Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theWidth: int width of the trackbar. theValue: [number] array or list of numbers whose first position, i.e. theValue[0], will be used to store the current value of the trackbar. It will be modified when the user interacts with the trackbar. Any numeric type can be used, e.g. int, float, long double, etc. theMin: number minimum value allowed for the trackbar. theMax: number maximum value allowed for the trackbar. theSegments: int number of segments the trackbar will have (default is 1). Segments can be seen as groups of numbers in the scale of the trackbar. For example, 1 segment means a single groups of values (no extra labels along the scale), 2 segments mean the trackbar values will be divided in two groups and a label will be placed at the middle of the scale. theLabelFormat: str formating string that will be used to render the labels. If you are using a trackbar with integers values, for instance, you can use `%d` to render labels. theOptions: uint options to customize the behavior/appearance of the trackbar, expressed as a bitset. Available options are defined as `cvui.TRACKBAR_` constants and they can be combined using the bitwise `|` operand. Available options are: `TRACKBAR_HIDE_SEGMENT_LABELS` (do not render segment labels, but do render min/max labels), `TRACKBAR_HIDE_STEP_SCALE` (do not render the small lines indicating values in the scale), `TRACKBAR_DISCRETE` (changes of the trackbar value are multiples of theDiscreteStep param), `TRACKBAR_HIDE_MIN_MAX_LABELS` (do not render min/max labels), `TRACKBAR_HIDE_VALUE_LABEL` (do not render the current value of the trackbar below the moving marker), `TRACKBAR_HIDE_LABELS` (do not render labels at all). theDiscreteStep: number amount that the trackbar marker will increase/decrease when the marker is dragged right/left (if option TRACKBAR_DISCRETE is ON) Returns ---------- `true` when the value of the trackbar changed. See Also ---------- counter() z5This is wrapper function to help code autocompletion.N)r|) rárrr!rzrMrNrPrQrRÚtheDiscreteSteprrrrË,s5rËcCs tdƒdS)aÁ Display a window (a block with a title and a body). Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theWidth: int width of the window. theHeight: int height of the window. theTitle: str text displayed as the title of the window. See Also ---------- rect() z5This is wrapper function to help code autocompletion.N)r|)rárrr!r"rÎrrrrÍcsrÍì~cCs tdƒdS)an Display a filled rectangle. Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theWidth: int width of the rectangle. theHeight: int height of the rectangle. theBorderColor: uint color of rectangle's border in the format `0xRRGGBB`, e.g. `0xff0000` for red. theFillingColor: uint color of rectangle's filling in the format `0xAARRGGBB`, e.g. `0x00ff0000` for red, `0xff000000` for transparent filling. See Also ---------- image() z5This is wrapper function to help code autocompletion.N)r|)rárrr!r"rÐrÑrrrr'|sr'éÿcCs tdƒdS)aB Display the values of a vector as a sparkline. Parameters ---------- theWhere: np.ndarray image/frame where the component should be rendered. theValues: number[] array or list containing the numeric values to be used in the sparkline. theX: int position X where the component should be placed. theY: int position Y where the component should be placed. theWidth: int width of the sparkline. theHeight: int height of the sparkline. theColor: uint color of sparkline in the format `0xRRGGBB`, e.g. `0xff0000` for red. See Also ---------- trackbar() z5This is wrapper function to help code autocompletion.N)r|)rárÔrrr!r"r”rrrrÓ—srÓcCst ||||¡S)ap Create an interaction area that reports activity with the mouse cursor. The tracked interactions are returned by the function and they are: `OUT` when the cursor is not over the iarea. `OVER` when the cursor is over the iarea. `DOWN` when the cursor is pressed over the iarea, but not released yet. `CLICK` when the cursor clicked (pressed and released) within the iarea. This function creates no visual output on the screen. It is intended to be used as an auxiliary tool to create interactions. Parameters ---------- theX: int position X where the interactive area should be placed. theY: int position Y where the interactive area should be placed. theWidth: int width of the interactive area. theHeight: int height of the interactive area. Returns ---------- integer value representing the current state of interaction with the mouse cursor. It can be `OUT` (cursor is not over the area), `OVER` (cursor is over the area), `DOWN` (cursor is pressed over the area, but not released yet) and `CLICK` (cursor clicked, i.e. pressed and released, within the area). See Also ---------- button() image() )r'r»)rrr!r"rrrr»²s!r»cCs tdƒdS)aå Start a new row. One of the most annoying tasks when building UI is to calculate where each component should be placed on the screen. cvui has a set of methods that abstract the process of positioning components, so you don't have to think about assigning a X and Y coordinate. Instead you just add components and cvui will place them as you go. You use `beginRow()` to start a group of elements. After `beginRow()` has been called, all subsequent component calls don't have to specify the frame where the component should be rendered nor its position. The position of the component will be automatically calculated by cvui based on the components within the group. All components are placed side by side, from left to right. E.g. ``` beginRow(frame, x, y, width, height) text('test') button('btn') endRow() ``` Rows and columns can be nested, so you can create columns/rows within columns/rows as much as you want. It's important to notice that any component within `beginRow()` and `endRow()` *do not* specify the position where the component is rendered, which is also True for `beginRow()`. As a consequence, **be sure you are calling `beginRow(width, height)` when the call is nested instead of `beginRow(x, y, width, height)`**, otherwise cvui will throw an error. E.g. ``` beginRow(frame, x, y, width, height) text('test') button('btn') beginColumn() # no frame nor x,y parameters here! text('column1') text('column2') endColumn() endRow() ``` Don't forget to call `endRow()` to finish the row, otherwise cvui will throw an error. Parameters ---------- theWhere: np.ndarray image/frame where the components within this block should be rendered. theX: int position X where the row should be placed. theY: int position Y where the row should be placed. theWidth: int width of the row. If a negative value is specified, the width of the row will be automatically calculated based on the content of the block. theHeight: int height of the row. If a negative value is specified, the height of the row will be automatically calculated based on the content of the block. thePadding: int space, in pixels, among the components of the block. See Also ---------- beginColumn() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)rárrr!r"rârrrÚbeginRowÕsHr6cCst t¡dS)zº End a row. You must call this function only if you have previously called its counter part, the `beginRow()` function. See Also ---------- beginRow() beginColumn() endColumn() N)r'rår+rrrrÚendRows r7cCs tdƒdS)a1 Start a new column. One of the most annoying tasks when building UI is to calculate where each component should be placed on the screen. cvui has a set of methods that abstract the process of positioning components, so you don't have to think about assigning a X and Y coordinate. Instead you just add components and cvui will place them as you go. You use `beginColumn()` to start a group of elements. After `beginColumn()` has been called, all subsequent component calls don't have to specify the frame where the component should be rendered nor its position. The position of the component will be automatically calculated by cvui based on the components within the group. All components are placed below each other, from the top of the screen towards the bottom. E.g. ``` beginColumn(frame, x, y, width, height) text('test') button('btn') endColumn() ``` Rows and columns can be nested, so you can create columns/rows within columns/rows as much as you want. It's important to notice that any component within `beginColumn()` and `endColumn()` *do not* specify the position where the component is rendered, which is also True for `beginColumn()`. As a consequence, **be sure you are calling `beginColumn(width, height)` when the call is nested instead of `beginColumn(x, y, width, height)`**, otherwise cvui will throw an error. E.g. ``` beginColumn(frame, x, y, width, height) text('test') button('btn') beginRow() # no frame nor x,y parameters here! text('column1') text('column2') endRow() endColumn() ``` Don't forget to call `endColumn()` to finish the column, otherwise cvui will throw an error. Parameters ---------- theWhere: np.ndarray image/frame where the components within this block should be rendered. theX: int position X where the row should be placed. theY: int position Y where the row should be placed. theWidth: int width of the column. If a negative value is specified, the width of the column will be automatically calculated based on the content of the block. theHeight: int height of the column. If a negative value is specified, the height of the column will be automatically calculated based on the content of the block. thePadding: int space, in pixels, among the components of the block. See Also ---------- beginRow() endColumn() endRow() z5This is wrapper function to help code autocompletion.N)r|)rárrr!r"rârrrÚ beginColumn,sHr8cCst t¡dS)zµ End a column. You must call this function only if you have previously called its counter part, i.e. `beginColumn()`. See Also ---------- beginColumn() beginRow() endRow() N)r'rår‚rrrrÚ endColumnvs r9cCs tdƒdS)a1 Start a row. This function behaves in the same way as `beginRow(frame, x, y, width, height)`, however it is suposed to be used within `begin*()/end*()` blocks since they require components not to inform frame nor x,y coordinates. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theWidth: int width of the row. If a negative value is specified, the width of the row will be automatically calculated based on the content of the block. theHeight: int height of the row. If a negative value is specified, the height of the row will be automatically calculated based on the content of the block. thePadding: int space, in pixels, among the components of the block. See Also ---------- beginColumn() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)r!r"rârrrr6ƒscCs tdƒdS)aC Start a column. This function behaves in the same way as `beginColumn(frame, x, y, width, height)`, however it is suposed to be used within `begin*()/end*()` blocks since they require components not to inform frame nor x,y coordinates. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theWidth: int width of the column. If a negative value is specified, the width of the column will be automatically calculated based on the content of the block. theHeight: int height of the column. If a negative value is specified, the height of the column will be automatically calculated based on the content of the block. thePadding: int space, in pixels, among the components of the block. See Also ---------- beginColumn() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)r!r"rârrrr8œscCs"t ¡}t||ƒ}t ||¡dS)a4 Add an arbitrary amount of space between components within a `begin*()` and `end*()` block. The function is aware of context, so if it is used within a `beginColumn()` and `endColumn()` block, the space will be vertical. If it is used within a `beginRow()` and `endRow()` block, space will be horizontal. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theValue: int the amount of space to be added. See Also ---------- beginColumn() beginRow() endRow() endColumn() N)r'r‡r$r…)rzrãr¤rrrÚspaceµs r:cCs tdƒdS)a¶ Display a piece of text within a `begin*()` and `end*()` block. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theText: str text content. theFontScale: float size of the text. theColor: uint color of the text in the format `0xRRGGBB`, e.g. `0xff0000` for red. See Also ---------- printf() beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)r’r“r”rrrr‘ÏscCs tdƒdS)ai Display a button within a `begin*()` and `end*()` block. The button size will be defined by the width and height parameters, no matter the content of the label. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theWidth: int width of the button. theHeight: int height of the button. theLabel: str text displayed inside the button. You can set shortcuts by pre-pending them with '&' Returns ---------- `true` everytime the user clicks the button. See Also ---------- beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)r!r"r‹rrrr¼èscCs tdƒdS)a  Display a button within a `begin*()` and `end*()` block. The size of the button will be automatically adjusted to properly house the label content. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theLabel: str text displayed inside the button. You can set shortcuts by pre-pending them with '&' Returns ---------- `true` everytime the user clicks the button. See Also ---------- beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)r‹rrrr¼scCs tdƒdS)aŽ Display a button whose graphics are images (np.ndarray). IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. The button accepts three images to describe its states, which are idle (no mouse interaction), over (mouse is over the button) and down (mouse clicked the button). The button size will be defined by the width and height of the images. Parameters ---------- theIdle: np.ndarray image that will be rendered when the button is not interacting with the mouse cursor. theOver: np.ndarray image that will be rendered when the mouse cursor is over the button. theDown: np.ndarray image that will be rendered when the mouse cursor clicked the button (or is clicking). Returns ---------- `true` everytime the user clicks the button. See Also ---------- button() image() iarea() beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)rÅrÆrÇrrrr¼s!cCs tdƒdS)aq Display an image (np.ndarray) within a `begin*()` and `end*()` block IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theImage: np.ndarray image to be rendered in the specified destination. See Also ---------- button() iarea() beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)rÉrrrrÄBscCs tdƒdS)a Display a checkbox within a `begin*()` and `end*()` block. You can use the state parameter to monitor if the checkbox is checked or not. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theLabel: str text displayed besides the clickable checkbox square. theState: [bool] array or list of booleans whose first position, i.e. theState[0], will be used to store the current state of the checkbox: `True` means the checkbox is checked. theColor: uint color of the label in the format `0xRRGGBB`, e.g. `0xff0000` for red. Returns ---------- a boolean value that indicates the current state of the checkbox, `true` if it is checked. See Also ---------- beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)r‹r«r”rrrr¦XscCs tdƒdS)aÕ Display a piece of text within a `begin*()` and `end*()` block. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. The text can be formated using `C stdio's printf()` style. For instance if you want to display text mixed with numbers, you can use: ``` printf(0.4, 0xff0000, 'Text: %d and %f', 7, 3.1415) ``` Parameters ---------- theFontScale: float size of the text. theColor: uint color of the text in the format `0xRRGGBB`, e.g. `0xff0000` for red. theFmt: str formating string as it would be supplied for `C stdio's printf()`, e.g. `'Text: %d and %f', 7, 3.1415`. See Also ---------- text() beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)r“r”r/rrrr0uscCs tdƒdS)a~ Display a piece of text that can be formated using `C stdio's printf()` style. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. For instance if you want to display text mixed with numbers, you can use: ``` printf(frame, 10, 15, 0.4, 0xff0000, 'Text: %d and %f', 7, 3.1415) ``` The size and color of the text will be based on cvui's default values. Parameters ---------- theFmt: str formating string as it would be supplied for `stdio's printf()`, e.g. `'Text: %d and %f', 7, 3.1415`. See Also ---------- text() beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)r/rrrr0•scCs tdƒdS)aq Display a counter for integer values that the user can increase/descrease by clicking the up and down arrows. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theValue: [number] array or list of numbers whose first position, i.e. theValue[0], will be used to store the current value of the counter. theStep: number amount that should be increased/decreased when the user interacts with the counter buttons. theFormat: str how the value of the counter should be presented, as it was printed by `C stdio's printf()`. E.g. `'%d'` means the value will be displayed as an integer, `'%0d'` integer with one leading zero, etc. Returns ---------- number that corresponds to the current value of the counter. See Also ---------- printf() beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)rzrOr¡rrrr ²scCs tdƒdS)a` Display a trackbar for numeric values that the user can increase/decrease by clicking and/or dragging the marker right or left. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. This component uses templates so it is imperative that you make it very explicit the type of `theValue`, `theMin`, `theMax` and `theStep`, otherwise you might end up with weird compilation errors. Example: ``` # using float trackbar(width, &floatValue, 0.0, 50.0) # using float trackbar(width, &floatValue, 0.0f, 50.0f) # using char trackbar(width, &charValue, (char)1, (char)10) ``` Parameters ---------- theWidth: int the width of the trackbar. theValue: [number] array or list of numbers whose first position, i.e. theValue[0], will be used to store the current value of the trackbar. It will be modified when the user interacts with the trackbar. Any numeric type can be used, e.g. int, float, long double, etc. theMin: number minimum value allowed for the trackbar. theMax: number maximum value allowed for the trackbar. theSegments: int number of segments the trackbar will have (default is 1). Segments can be seen as groups of numbers in the scale of the trackbar. For example, 1 segment means a single groups of values (no extra labels along the scale), 2 segments mean the trackbar values will be divided in two groups and a label will be placed at the middle of the scale. theLabelFormat: str formating string that will be used to render the labels, e.g. `%.2Lf`. No matter the type of the `theValue` param, internally trackbar stores it as a `long float`, so the formating string will *always* receive a `long float` value to format. If you are using a trackbar with integers values, for instance, you can supress decimals using a formating string as `%.0Lf` to format your labels. theOptions: uint options to customize the behavior/appearance of the trackbar, expressed as a bitset. Available options are defined as `TRACKBAR_` constants and they can be combined using the bitwise `|` operand. Available options are: `TRACKBAR_HIDE_SEGMENT_LABELS` (do not render segment labels, but do render min/max labels), `TRACKBAR_HIDE_STEP_SCALE` (do not render the small lines indicating values in the scale), `TRACKBAR_DISCRETE` (changes of the trackbar value are multiples of informed step param), `TRACKBAR_HIDE_MIN_MAX_LABELS` (do not render min/max labels), `TRACKBAR_HIDE_VALUE_LABEL` (do not render the current value of the trackbar below the moving marker), `TRACKBAR_HIDE_LABELS` (do not render labels at all). theDiscreteStep: number amount that the trackbar marker will increase/decrease when the marker is dragged right/left (if option TRACKBAR_DISCRETE is ON) Returns ---------- `true` when the value of the trackbar changed. See Also ---------- counter() beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)r!rzrMrNrPrQrRr3rrrrËÐs7cCs tdƒdS)a» Display a window (a block with a title and a body) within a `begin*()` and `end*()` block. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theWidth: int width of the window. theHeight: int height of the window. theTitle: str text displayed as the title of the window. See Also ---------- rect() beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)r!r"rÎrrrrÍ scCs tdƒdS)ab Display a rectangle within a `begin*()` and `end*()` block. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theWidth: int width of the rectangle. theHeight: int height of the rectangle. theBorderColor: uint color of rectangle's border in the format `0xRRGGBB`, e.g. `0xff0000` for red. theFillingColor: uint color of rectangle's filling in the format `0xAARRGGBB`, e.g. `0x00ff0000` for red, `0xff000000` for transparent filling. See Also ---------- window() beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)r!r"rÐrÑrrrr'" scCs tdƒdS)a- Display the values of a vector as a sparkline within a `begin*()` and `end*()` block. IMPORTANT: this function can only be used within a `begin*()/end*()` block, otherwise it does nothing. Parameters ---------- theValues: number[] array or list of numeric values that will be rendered as a sparkline. theWidth: int width of the sparkline. theHeight: int height of the sparkline. theColor: uint color of sparkline in the format `0xRRGGBB`, e.g. `0xff0000` for red. See Also ---------- beginColumn() beginRow() endRow() endColumn() z5This is wrapper function to help code autocompletion.N)r|)rÔr!r"r”rrrrÓ= scCst |¡}d|jj_d|jj_x2tttdƒD] }d|jj |_d|jj |_q.Wtj   ¡tj dkrtt  tj ¡t_t ¡dkrŒt dd¡dS)a† Update the library internal things. You need to call this function **AFTER** you are done adding/manipulating UI elements in order for them to react to mouse interactions. Parameters ---------- theWindowName: str name of the window whose components are being updated. If no window name is provided, cvui uses the default window. See Also ---------- init() watch() context() Frrrz½Calling update() before finishing all begin*()/end*() calls. Did you forget to call a begin*() or an end*()? Check if every begin*() has an appropriate end*() call before you call update().N)r'rorAr=r5r6r`r9r;r<r_r-r^r}r~r]r†rw)rpZaContextrUrrrr+W s      r+cGsÔt |d¡r^|d}t|ƒdkr*|dnd}t|ƒdkrB|dnd}t ||¡t||ƒnr|d}|d}t|ƒdkr‚|dnd}t|ƒdkrš|dnd}t |d|¡x td|ƒD]}t|||ƒqºWdS)NrrrrrTr )r'rßrryr)r`)ÚtheArgsÚ aWindowNameZ aDelayWaitKeyZaCreateNamedWindowZ aWindowNamesZaHowManyWindowsZaCreateNamedWindowsrUrrrryz s  c GsÚt|dtjƒrp|d}|d}|d}|d}t|ƒdkrD|dnd}t|ƒdkr\|dnd }|tj_tj}nPt ¡}|jj }|jj }|d}t|ƒdkr¤|dnd}t|ƒdkr¼|dnd }t  ||||||d ¡dS) Nrrrrr r gš™™™™™Ù?r iÎÎÎT) rÛrÚndarrayrr'r_r&r‡r)rrr‘)r;ÚaWhereÚaXÚaYr£rörúrãrrrr‘ s c GsÒt|dtjƒrD|d}|d}|d}|tj_tj}|dd…}nt ¡}|jj}|jj }|}t  |d¡rŒd}d}|d}|dd…} n$|d}|d}|d}|dd…} || } t  |||| ||d¡dS)Nrrrrgš™™™™™Ù?iÎÎÎT) rÛrr=r'r_r&r‡r)rrrßr‘) r;r>r?r@rãÚaArgsrörúZaFmtZaFmtArgsr£rrrr0¦ s, c Gst|dtjƒrp|d}|d}|d}|d}t|ƒdkrD|dnd}t|ƒdkr\|dnd}|tj_tj}nPt ¡}|jj }|jj }|d}t|ƒdkr¤|dnd}t|ƒdkr¼|dnd}|sìt|dt ƒd koÞt|t ƒ}|rèd nd }t  ||||||¡S) Nrrrrr r r r/Tz%dz%.1f) rÛrr=rr'r_r&r‡r)rrr¹r ) r;r>r?r@r„ZaStepZaFormatrãZaIsIntrrrr È s& cGs´t|dtjƒr`|d}|d}|d}|d}|d}t|ƒdkrL|dnd}|tj_tj}n@t ¡}|jj }|jj }|d}|d}t|ƒdkrœ|dnd}t  ||||||¡S) Nrrrrr r r iÎÎÎ) rÛrr=rr'r_r&r‡r)rrr¦)r;r>r?r@rŒZaStaterúrãrrrr¦ã s cGsØt|ƒdkr2|d}|d}|d}t |||¡St|ƒdkr†t |d¡rh|d}|d}t ||¡S|d}|d}t ||¡SnNt|ƒdkr²t|dtƒr²|d}t |¡St|ƒdkrÆ|dnd}t  |¡SdS)Nrrrrr/) rr'rurßrrrvrÛr¹rsrq)r;r<rtZaQueryrrrrAú s$    c Gst|dtjƒrXt|dtjƒdkrX|d}|d}|d}|tj_tj}|dd…}nt ¡}|jj}|jj }|}t |ƒdkr˜|d}t  ||||¡St |ƒdkrt|dt ƒrâ|d}|d}|d}t  ||||||d¡S|d} |d} |d} t |||| | | d¡SntdƒdS)NrrFrrTzProblem?)rÛrr=r'r_r&r‡r)rrrr¼r¹rŸrÈr|) r;r>r?r@rãrArŒrûÚaHeightZaIdleZaOverZaDownrrrr¼ s2$ cGs„t|dtjƒrXt|ƒdkrX|d}|d}|d}|d}|tj_t tj|||¡n(|d}t ¡}t ||j j |j j |¡dS)Nrrrr) rÛrr=rr'r_r&rÄr‡r)rr)r;r>r?r@ZaImagerãrrrrÄ> scGs‚t|dtjƒr¸|d}|d}|d}|d}|d}|d}|d}t|ƒdkr\|d nd}t|ƒd krt|dnd } t|ƒd krŒ|d nd} t|ƒd kr¤|d nd} |tj_tj} n t ¡} | jj }| jj }|d}|d}|d}|d}t|ƒdkr|dnd}t|ƒdkr |dnd } t|ƒd kr:|dnd} t|ƒdkrT|d nd} t ||| || | ƒ} t  | ||||| ¡}|S)Nrrrrr r r r r é z%.1Lfé rü) rÛrr=rr'r_r&r‡r)rrrBrË)r;r>r?r@rûr„rÕrÖr Z aLabelFormatZaOptionsZ aDiscreteSteprãZaParamsZaResultrrrrËO s8cGs t|dtjƒr`|d}|d}|d}|d}|d}|d}|tj_t tj|||||¡n<|d}|d}|d}t ¡}t ||jj |jj |||¡dS)Nrrrrr r ) rÛrr=r'r_r&rÍr‡r)rr)r;r>r?r@rûrBZaTitlerãrrrrÍu sc GsÊt|dtjƒrh|d}|d}|d}|d}|d}|d}t|ƒdkrT|dnd }|tj_tj}nHt ¡}|jj }|jj }|d}|d}|d}t|ƒdkr¬|dnd }t  |||||||¡dS) Nrrrrr r r r l~) rÛrr=rr'r_r&r‡r)rrr') r;r>r?r@rûrBrrrãrrrr'Š s$c GsÊt|dtjƒrh|d}|d}|d}|d}|d}|d}t|ƒdkrT|dnd }|tj_tj}nHt ¡}|d}|jj }|jj }|d}|d}t|ƒdkr¬|dnd }t  |||||||¡dS) Nrrrrr r r r iÿ) rÛrr=rr'r_r&r‡r)rrrÓ) r;r>ZaValuesr?r@rûrBrúrãrrrrÓ£ s$c Gst|ƒrt|dtjƒr|d}|d}|d}t|ƒdkrD|dnd}t|ƒdkr\|dnd}t|ƒdkrt|dnd}t t||||||¡npt|ƒdkr¤|dnd}t|ƒdkr¼|dnd}t|ƒdkrÔ|dnd}t ¡}t t|j|j j |j j |||¡dS) Nrrrr rrr r ) rrÛrr=r'rär+r‡r&r)rr)r;r>r?r@rûrBÚaPaddingrãrrrr6¼ sc Gst|ƒdkr”t|dtjƒr”|d}|d}|d}t|ƒdkrH|dnd}t|ƒdkr`|dnd}t|ƒdkrx|dnd}t t||||||¡npt|ƒdkr¨|dnd}t|ƒdkrÀ|dnd}t|ƒdkrØ|dnd}t ¡}t t|j|j j |j j |||¡dS) Nrrrr rrr r ) rrÛrr=r'rär‚r‡r&r)rr)r;r>r?r@rûrBrErãrrrr8Ð s)rT)rT)T)r/)r-)r.r-)rr1)rr2rr)r4)r5)rrr)rrr)rrr)rrr)r )r.r-)r-)rr1)rr2rr)r4)r5)r/)CÚ__doc__r}ÚnumpyrrrrÚVERSIONr+r‚rirgr§r¨rhrjr9r:r;r rr°r rýrÚ version_infoÚmajorrÜrérðrïrrr$r%r.r4r8r?rBrSrdr'r$ryr)r*r,r]rAr¼rÄr¦r‘r0r rËrÍr'rÓr»r6r7r8r9r:r+rrrrÚ%sÔ      *   %C #!    7  # J J    #    9   #"(&