^ jDdZddlmZddlZddlZddlZddlmZddlm Z e dZ ej dkr e dGd d ej ZejeZeZejeZdZd Zd ZGd dZGddeZGddeZejejZeeZeej ZGddeZGddeZGddej edZ GddeeZ!Gdde Z"Gd d!e!Z#d"Z$d#Z%d$Z&Gd%d&Z'eeffd0d/Z(dS)1aMinimal Windows COM interface. Allows pyglet to use COM interfaces on Windows without comtypes. Unlike comtypes, this module does not provide property interfaces, read typelibs, nice-ify return values. We don't need anything that sophisticated to work with COM's. Interfaces should derive from pIUnknown if their implementation is returned by the COM. The Python COM interfaces are actually pointers to the implementation (take note when translating methods that take an interface as argument). (example: A Double Pointer is simply POINTER(MyInterface) as pInterface is already a POINTER.) Interfaces can define methods:: class IDirectSound8(com.pIUnknown): _methods_ = [ ('CreateSoundBuffer', com.STDMETHOD()), ('GetCaps', com.STDMETHOD(LPDSCAPS)), ... ] Only use METHOD, STDMETHOD or VOIDMETHOD for the method types (not ordinary ctypes function types). The 'this' pointer is bound automatically... e.g., call:: device = IDirectSound8() DirectSoundCreate8(None, ctypes.byref(device), None) caps = DSCAPS() device.GetCaps(caps) Because STDMETHODs use HRESULT as the return type, there is no need to check the return value. Don't forget to manually manage memory... call Release() when you're done with an interface. ) annotationsN)Sequence) debug_print debug_comwin32z8pyglet.libs.win32.com requires a Windows build of PythonceZdZdejfdejfdejfdejdzfgZddZd dZ d!dZ d"dZ e d#dZ dS)$GUIDData1Data2Data3Data4lintw1w2b1b2b3b4b5b6b7b8returnNonec X||_||_||_|||||| | | f|jdd<dSN)r r r r ) selfrrrrrrrrrrrs P/home/agentuser/manim-venv/lib/python3.11/site-packages/pyglet/libs/win32/com.py__init__z GUID.__init__;s;   RRRR8 111 strc|j\}}}}}}}}d|jdd|jdd|jdd|dd|dd|dd|dd|dd|dd|dd|ddS)NzGUID(x, ))r r r r ) rrrrrrrrrs r __repr__z GUID.__repr__Bs)-&BBBBGtzGGGtzGGGtzGGGrGGGrGGGWYGGG_aGGGgiGGGoqGGGwyGGG@BGGGG Gr"otherobjectboolclt|tot|t|kSr) isinstancer bytes)rr)s r __eq__z GUID.__eq__Fs(%&&F5;;%,,+FFr"c:tt|Sr)hashr.rs r __hash__z GUID.__hash__IsE$KK   r"textcztjd|sd|}t|tdd}tdd}tdd}fdt dd D}||||g|RS) zConvert a GUID string into a GUID object. Valid: 'bd4ec2d2-0662-4bee-ba8e-6f29f032e096' and '{bd4ec2d2-0662-4bee-ba8e-6f29f032e096}' z^\{?([0-9A-Fa-f]{8})-([0-9A-Fa-f]{4})-([0-9A-Fa-f]{4})-([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})-([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})\}?$zInvalid GUID format: cVg|]%}t|d&S)r7)rgroup).0imatchs r z$GUID.from_string..\s- < < ValueErrorrr;range)clsr4msgd1d2d3d4r>s @r from_stringzGUID.from_stringLs  LNRSS "0$00CS// !Q $ $ Q $ $ Q $ $ < < < //000000000r"rec"eZdZdZfdZxZS) VOIDMETHODz COM method with no return value.c<tjdg|RdSr)rgr!ris r r!zVOIDMETHOD.__init__s(%%%%%%%r"rkrms@r roros>**&&&&&&&&&r"roc,eZdZdfd Zdfd ZxZS)_InterfaceMetaTc t|dkr0tdt|dz d|sJ|df}d|vrd|d<g}|dtjur=|dD]"}||jd#t|}t|d}t|}t||z} t| D]^\} \} } t|d| d| d d d | j Dpd d | j d n | j j sJ_td|tjfdd| Di} | |d<||d<dtj| ff|d<t||||S)Nr6z Ignoring z bases on r _methods_rU[z]: z: r&c3$K|] }|jV dSr)rL)r<ts r z)_InterfaceMeta.__new__..s$+L+L1AJ+L+L+L+L+L+Lr"voidz -> Vtable_rSc&g|]\}}||jfSrU)r^)r<nr%s r r?z*_InterfaceMeta.__new__..s'4e4e4eQUQRTUa9K5L4e4e4er"_vtbl_struct_typevtbl_own_offsetvtbl_ptr)len _debug_comrO Structureget_interface_inheritanceextend__dict__tuple enumeratejoinrZrYrL _StructMetaPOINTERrg__new__)rErabasesdctcreate_pointer_type inh_methodsinterface_type new_methodsr~ all_methodsr= method_namemtvtbl_struct_typerjs r rz_InterfaceMeta.__new__sK u::>>J#e**q.JJDJJKK K KK1XKEc!!!C  86+ + +#(8#E#E#G#G I I"">#:;#GHHHHK(( C ,-- k**K((;6 $-k$:$: Z Z A RYYYYkYY"&))+L+L +L+L+L"L"L"VPVYY+-:+=2:CVYYZZ Z ZZ Z''7'7'7(.(8':(24e4eYd4e4e4e'fhh$4  !0 &7G(H(HIKJwwsD%555r"ct||||r1td|tj|dfd|idSdS)Npr_type_)rgr!_pInterfaceMetarOr)rrarrrrjs r r!z_InterfaceMeta.__init__sk uc***  W JJJa)A)A(ChPTEU V V V V V  W Wr")T)rLrMrNrr!rlrms@r rrrrsf 6 6 6 6 6 6DWWWWWWWWWWr"rrceZdZfdZxZS)rc  |dd @|dj}td|d|fd|ddid |d<t jD]5\}\ }|| jz }||d  fd }|| <6t||||} dd l m } | | <| S) Nrr__HelperInterfacertrUF)r)_m_ictd|djd|dddtt|g|Rd sJ||g|RS)Nz Calling COM z of z (z)[z] through pointer: (r&r')rrLrmaprepr)rrrr_rtargets r pinterface_method_forwardz:_pInterfaceMeta.__new__..pinterface_method_forwards!#V#V#V#V#VB#V#VR]#V#V/3yyTD=4==9Q9Q/R/R#V#V#VWWWWWr$&r")_pointer_type_cache) getrrrrrtrbr~rgrrOr)rErarrinterface_baser=methodmr pointer_typerrrrjs @@r rz_pInterfaceMeta.__new__s94(( >"1X_N$$>$>$>$>%3$5%0#''+r2J2J$K8=???F#CM)2&2B(C(C 9 9 $A$ V$$Q)?%?MMA:; ' ' ' ' ' ' ' ' 9C  wwsD%==  /.....&2F#r")rLrMrNrrlrms@r rrs8'''''''''r"rc$eZdZedZdS) Interfacectt|jd|jtS)ahReturn a reverse iterator over the interfaces implemented by this interface, ranging from just after the base type `Interface` to this type. `Interface` does not represent an actual interface, but merely the base concept of them. Viewing it as part of an interface's inheritance chain is meaningless, so it is excluded. N)reversed__mro__indexr)rEs r rz#Interface.get_interface_inheritances/ $AS[%6%6y%A%A$ABCCCr"N)rLrMrNrTrrUr"r rrs2DD[DDDr"rF) metaclassrc(eZdZeZedZdS) pInterfacecdt|ts|S||jS)z@When dealing with a COMObject, pry a fitting interface out of it)r- COMObject as_interfacer)rEobjs r from_paramzpInterface.from_params1#y)) J +++r"N)rLrMrNrrrTrrUr"r rrs2 F,,[,,,r"r)rczeZdZdeeejfdeejfdeejfgZ dS)IUnknownQueryInterfaceAddRefReleaseN rLrMrNreREFIIDrOr]rWc_intrtrUr"r rrS 99VV_==> 66&,''( FF6<(()IIIr"rczeZdZdeeejfdeejfdeejfgZ dS) pIUnknownrrrNrrUr"r rrrr"rcfd}|S)zMCreate a callback returning E_NOTIMPL for methods not present on a COMObject.c@tddsJtS)NzNon-implemented method z called in )r E_NOTIMPL)rinterface_namers r missing_cb_funcz&_missing_impl..missing_cb_funcs.\K\\N\\]]]]]r"rU)rrrs`` r _missing_implr s* r"cfd}|S)zcIf a method was found in class, create a callback extracting self from the struct pointer. ctddsJtj|ztjtjjj}|g|R}|tn|S)NCOMObject method  called through interface )rrOcastr py_objectcontentsvalueS_OK)rr_rresultr method_funcr self_distances r self_extracting_cb_funcz,_found_impl..self_extracting_cb_funcswekeeUceefffff{1},fnV=M.N.NOOX^T)D)))~tt61r"rU)rrrrrs```` r _found_implrs6 22222222 #"r"cfd}|S)zA method implemented in a previous interface modifies the COMOboject pointer so it corresponds to an earlier interface and passes it on to the actual implementation. cPtdddsJ|zg|RS)Nrrz, adjusting pointer by )r)rr_rroffsetoriginal_methods r adjustor_cb_funcz&_adjust_impl..adjustor_cb_func*srMkMM+MMDJMMNN N NNq6z1D1111r"rU)rrrrrs```` r _adjust_implr%s6 22222222 r"c.eZdZdZfdZdZdZxZS)raA COMObject for implementing C callbacks in Python. Specify the interface types it supports in `_interfaces_`, and any methods to be implemented by those interfaces as standard python methods. If the names match, they will be run as callbacks with all arguments supplied as the types specified in the corresponding interface, and `self` available as usual. Remember to call `super().__init__()`. COMObjects can be passed to ctypes functions directly as long as the corresponding argtype is an `Interface` pointer, or a `pInterface` subclass. IUnknown's methods will be autogenerated in case IUnknown is implemented. c :tjdi||jdd}|st d|D]+}|D]&}||urt ||rt d',t jt j}g}i}i}t|D]*\} }| } | D]} | |vr| |z|| <+t|vrd} d} d}| |_ | |_ ||_t|D]\} }g}|jjD]\}}||vr)||\}}t#|j|||| z |z}nZt'||dx}t)|j|}n*t+|j||t-|| z |z}|| f||<||||j|}|t j|g}t|D]6\} }|d| t j|jf7|d t jf||_||_t;|jd t jfd |i|_dS) N _interfaces_rUz9At least one interface must be defined to use a COMObjectz Only specify the leaf interfacescxdtj|tjtjd<tS)Nr)rOrrr] E_NOINTERFACE)riid_ptrres_ptrs r rz3COMObject.__init_subclass__..QueryInterface_s*KL GV^FO%D%DEEaH$$r"c0|xjdz c_|jSNr6) _vrefcountr2s r rz+COMObject.__init_subclass__..AddRefcs1$&r"c~|jdkrtd|d|jsJ|xjdzc_|jS)Nrz COMObject z: Release while refcount was r6)rrr2s r rz,COMObject.__init_subclass__..ReleasegsZ?a''%YTYYYY1$&r" vtbl_ptr_self__StructrS) rg__init_subclass__rr TypeError issubclassrOsizeofr]rrrrrrr}rSrrLgetattrrrrappendpointerrr_interface_to_vtbl_offset_vtbl_pointersrr _struct_type)rEkwargsimplemented_leaf_interfacesrr) _ptr_sizerimplemented_methodsrr=rbaserrrwrappersr method_typefuncimplementing_vtbl_idxmth found_methodvtblfieldsitfrjs r rzCOMObject.__init_subclass__@s|!!++F+++&)l&6&6~r&J&J#* YWXX X9 H HN4 H H!U**ne44H#$FGGGH HM&/22  %'!!*+F!G!G D D A~"<<>>E D D88867)m-d3 D 0 0 0 % % % ' ' ' ' ' '"0C CJ!CK!*+F!G!G 8 8 A~H,:,L,U 2 2( ["5553Fk2R/D/&~'>'2'+(=(AY'NPPCC )0[$(G(GG P+N,C[QQ).*A*5*6+./J+K+Ka+OS\*\^^ 93X>D  ! !&."6"6 7 7 7 7 ;<< T TFAs MM?q??FN3;P,Q,QR S S S S w 01222(A%+&#,'?'?'?&BRATWaciVjkkr"cjd|_|jg|jtj|R|_dSr)rrrrOr_structr2s r r!zCOMObject.__init__s;(t(V$*=Vv?OPT?U?UVVV r"c|j|dx}td|tj|j|S)NzDoes not implement )rrrrObyrefr)rrrs r rzCOMObject.as_interfacesM 488NN NF WB.BBCC C|DL&111r")rLrMrNrcrr!rrlrms@r rr2sn  XlXlXlXlXltWWW 2 2 2 2 2 2 2r"r interfacepInterface | Interfaceguidtarget_interfaceerrors Sequence[int]rr+c ||tj|dS#t$r}|D]}|dzrYd}~dSYd}~nd}~wwxYwd|d|d}t |)a Determine if the target interface is available from the source. Args: interface: The interface to query from. guid: The GUID of the target interface. target_interface: The interface object to query from. errors: Acceptable errors to consider as caught. Returns: If the query was successful, returns True. If so, the target interface object is available. TlNFzFailed to Query Interface z with GUID: .)rrOrOSError Exception)rr r r eerrorrFs r is_availablers$  v|4D'E'EFFFt   Ez! uuuuuu       Fy E Ed E E EC C..s(, A A A  A) rr r r r r r r rr+))rc __future__rrOrBsystypingr pyglet.utilrrplatform ImportErrorrr rLPGUIDIIDrrrrrWreror_DummyPointerTypetype _PointerMetarrrrrrrrrrrrrrUr"r r sY""F#""""" ###### [ % % <7 +P Q QQ+$+$+$+$+$6 +$+$+$\           ' ' ' ' ' ' ' '00000000&&&&&&&&#FN6<00t%&& d6#$$ *W*W*W*W*W[*W*W*WZ(((((l(((V D D D D D NPU D D D D , , , , ,"o , , , ,y  # # #   u2u2u2u2u2u2u2u2p+4])Cr"