+ KiU0csRt^RIt^RIt^RIHtHtHtHtHtH t H t H t ^RI t ^RI HtHtHtHtHt^RIHt^RIHt^RIHt^RIHtHtHt^RIHt]'d ^R IH t ^R I!H"t"^R I#H$t$R+t&R,t']!4t(R R lt)RRlt*RRlt+RRlt,RRlt-] !R]P\R7t/R-RRllt0Rt1RRlt2Rt3R.Rlt4Rt5R/R lt6R/R!lt7R"t8R0R#R$llt9R%t:R1R&lt;R'tR*t?R# ]%dRt$Li;i)3z-Various utilities using the GObject frameworkN) TYPE_CHECKINGIterableListOptionalTypeTypeVarUnioncast)Gdk GdkPixbufGioGLibGtk)settings)MissingMediaError)NotificationSource)datapathmagicsystem)loggerLutrisApplication) LutrisWindow)Imagec2V^8dQhR\R,/#returnrrZformat"=/usr/lib/python3.14/site-packages/lutris/gui/widgets/utils.py __annotate__r sDD"56DcsR\R\PP44#r)rr Application get_defaultr!rget_applicationr%s #S__%@%@%B CCr!cV^8dQhRR/#rr$rrrr r "s"5r!cs|\R\PP44pV'g \ R4hV#)rz%The LutrisApplication does not exist.)rr r"r# RuntimeError application rget_required_applicationr+"s1*COO,G,G,IJK BCC r!crrrrrrrrr r )s77.17r!csB\4pV'd VP#R#)zeReturn the application's main window, or None if it doesn't exist (though it almost alway does exist)N)r%windowr(r*rget_main_windowr.)s"#K!,;  6$6r!cr&r,r$rrrr r 0s.r!csX\4pVPpV'g \R4hV#)zPReturn the application's main window or raises an exception if it doesn't exist.zThe main window does not exist.)r+r-r')r)r- rget_required_main_windowr00s++,K   F <== Mr!csV^8dQhR\\P,R\\P,/#)rwidgetr)rr WidgetWindowrrrr r :s,hszz2x 7Kr!csV'dC\\\P,VP \P44#R#)zReturns the window that contains a widget, if any. This wll return None for a widget that is not in a window, rather than returning the widget itself like get_toplevel().N)rrr r3Z get_ancestor)r1&rget_widget_windowr5:s/HSZZ(&*=*=cjj*IJJr! TChildWidget)ZboundcsV^8dQhR\\P,R\\\,,R\ \,/#)rr1 child_typer)rr r2rr6rrrrr r Gs<   SZZ  .6tL7I.J  , r!csF\V\P4'd|V'dBVP4Uu.uF&p\W!4'gK\ \ V4NK( up#\ \ \\ ,VP444#.#uupi)zReturns the children of any widget; non-containers have no children and returns an empty list. This can filter out a specific type of child widget if child_type is not None, but otherwise it returns all children.) isinstancer Z ContainerZ get_childrenrr6Zlistr)r1r7Zw&& rget_widget_childrenr:Gsu &#--(( 393F3F3Hf3HaJWXLe)Dq)3Hf fXl3V5H5H5JKL L gs BBcs6\P!RV.4R#)z8Opens a local or remote URI with the default applicationzxdg-openN)rZspawn)Zurir4ropen_urir;Vs LL*c"#r!csFV^8dQhR\R\\,/#)rpathr)strrrrrr r [s38C=r!cs$\PPV4^,P4pVR9dR#VR8XdR#\P !V4P4pRT9dR#RT9dR#R# \ dR#i;i)zReturns the canonical file extension for an image, either 'jpg' or 'png'; we deduce this from the file extension, or if that fails the file's 'magic' prefix bytes..jpg.pngNzjpeg image datazpng image data)r>z.jpeg)osr<ZsplitextZcasefoldrZ from_fileZOSError)r<extZ file_types& rget_image_file_extensionrB[s ''  4  # , , .C  f}OOD)224 I%9$  s$B BBcsVP4wrVP4V, pVP4V, pW43#)zReturns the size of a surface, accounting for the device scale; the surface's get_width() and get_height() are in physical pixels.)Zget_device_scale get_width get_height)surfaceZdevice_scale_xZdevice_scale_ywidthheights& rget_surface_sizerHrsC&-%=%=%?"N    . 0E    !N 2F =r!cs\V4pV'gR#VP4pVP4pV^,V, V,pV^,V, V,pV'd\Wx4pTp\ WW,4p \ Wh,4p \ P !\ PPW4p \ P!V 4p V PWx4\P!W^^4V P4P\ PP 4V P#4V P%W"4V #)a Returns a Cairo surface containing the image at the path given. It has the size indicated. You specify the device_scale, and the bitmap is generated at an enlarged size accordingly, but with the device scale of the surface also set; in this way a high-DPI image can be rendered conveniently. If you pass True for preserve_aspect_ratio, the aspect ratio of the image is preserved, but will be no larger than the size (times the device_scale). If there's no file at the path, or it is empty, this function returns None. N)get_pixbuf_by_pathrCrDZminZroundcairoZ ImageSurfaceZFormatZARGB32ZContextZscalerZcairo_set_source_pixbufZ get_sourceZ set_extendZExtendZPADZpaintZset_device_scale) r<sizeZ device_scalepreserve_aspect_ratiopixbufZ pixbuf_widthZ pixbuf_heightZscale_xZscale_yZ pixel_widthZ pixel_heightrEZcrs &&&& rget_scaled_surface_by_pathrN{s  %F ##%L%%'MAw%5GAw&,6Gg' ./K01L  !4!4kPG w BHHWAq1MMOu||//0HHJ \8 Nr!csV'dV^,V^,8XdRpMRp\PP\P!4V4#)z~Returns the path to the default icon for the size given; it's a Lutris icon for a square size, and a gradient for other sizes.zmedia/default_icon.pngzmedia/default_banner.png)r@r<joinrget)rKfilename& rget_default_icon_pathrSs; 47d1g%+- 77<<  11r!cs,\P!VRR7'gR#V'dOVwr4V'd!\PP WV4#\PP WVRR7#\PP V4#)a&Reads an image file and returns the pixbuf. If you provide a size, this scales the file to fit that size, preserving the aspect ratio if preserve_aspect_ratio is True. If the file is missing or empty, or if 'path' is None or empty, this returns None. Still raises GLib.GError for corrupt files.T)Z exclude_emptyNF)rL)rZ path_existsr PixbufZnew_from_file_at_sizeZnew_from_file_at_scaleZ new_from_file)r<rKrLrFrG&&& rrIrIsv   d$ 7 7   ##99$vN N66tFbg6hh    ) )$ //r!cs\WV4pV'g \VR7hV# \Pd4p\P !RT4\\ T4TR7ThRp?ii;i)a Reads an image file and returns the pixbuf. If you provide a size, this scales the file to fit that size, preserving the aspect ratio if preserve_aspect_ratio is True. If the file is missing or unreadable, or if 'path' is None or empty, this raises MissingMediaError.)rQz!Unable to load icon from image %s)ZmessagerQN)rIrr ZGErrorrZ exceptionr=)r<rKrLrMZexrUrget_required_pixbuf_by_pathrVsb H#D0EF#T2 2 ;;H>$ r!cstV^8dQhR\\\\,3,R\R\/#)rnames fallback_namer)rr=rrrrr r s0  5hsm!34 S lo r!cst\V\4'dV.pVFp\V4'gKVu# V#)zUsed to select a stock icon that actually exists in the icon set; it tries all the names given, and returns the first where has_stock_icon is true. If none pass the test, returns fallback_name instead.)r8r=rY)rZr[rXr9rpick_stock_iconr\s:% $  K r!cs:VP4PRR4p.ROpRR.pVFlpVFcp\PP \ P WAV,4p\PPV4'gK_Vuu# Kn R#)a^Finds the icon file for an icon whose name is given; this searches the icons in Lutris's runtime directory. The name is normalized by removing spaces and lower-casing it, and both .png and .svg files with the name can be found. Arguments: icon_name -- The name of the icon to retrieve Returns: The path to the icon, or None if it wasn't found. Z Zr?z.svgN)zicons/hicolor/64x64/appszicons/hicolor/24x24/appsiconszicons/hicolor/scalable/appszicons/hicolor/symbolic/apps)ZlowerZreplacer@r<rOr RUNTIME_DIRZexists)Z icon_namerQZsearch_directoriesZ extensionsZ search_dirrAZ icon_paths& rget_runtime_icon_pathr_s ((b1H&!J( C X%9%9:RU~VIww~~i((  ) r!cs\P!V4pVPR4pVwr4\VR,4pVPwrg\WeV, ,4p\W, ^, 4p VP W3\P PR7pVPV ^W9,V34p\P!RW43R4p V PV^^W534\P!RW43R4p \P!\PP\P!4R44p V PWR7V #)z&Converts an image to a pane backgroundZRGBAg?Zresamplezmedia/mask.pngmask)rcrcrc)rZopenZconvertintrKresize ResamplingBICUBICcropZnewpaster@r<rOrrP) Zbackground_path target_sizeZcoverart target_width target_heightZ image_heightZ orig_widthZ orig_heightrFZoffsetZ coverart_bgZ backgroundrbs && rconvert_to_backgroundrms$zz/*H'H"-L}t+,L&mmJ  [89 :E %&!+ ,F4u?O?O?W?WXH}}fa)> MNH))F\$A<PKhA| BC6L#@,OJ ::bggll8<<>3CD ED[, r!csVPwr#W#, pVwrVWV, pWG8d\W&V, ,4pTp MTp\W5V, ,4p \W, ^, 4p \W, ^, 4p VPW3\PP R7pVP WW, W, 34pV#)rr`)rKrdrerrfrgrh) base_imagerj base_width base_heightZ base_ratiorkrlZ target_ratiorFrGZx_offsetZy_offsets && rthumbnail_imagerq!s(ooJ)J"-L/L!J+"=>?[:$=>?E(A-.HF*a/0H""E?U=M=M=U=U"VJ(e6FHY!Z[J r!csVPwr4VPwrV\W5, ^, 4p\WF, ^, 4pVPWWV,Wh,3VR7V#)rra)rKrdri) rnZ overlay_imageZpositionrorpZ overlay_widthZoverlay_heightZoffset_xZoffset_ys &&& r paste_overlayrr5sp(ooJ$1$6$6!MJ.!34HK0A56H(H,DnF_`gt r!c s\P!RVP44pVPwr#\PP V\P PR^W#V^,4#)z$Converts a PIL Image to a GDK PixbufZBT)arrayZtobytesrKr rTZ new_from_dataZ ColorspaceZRGB)ZimageZ image_arrayrFrGs& r image2pixbufrt@sZ++c5==?3KJJME    ) )+y7K7K7O7OQUWXZ_inqrir ssr!cs\PP4p\PP \ PR4pWP49dVPV4R#R#)z/Add the lutris icon folder to the default themer]N) r rWr#r@r<rOr r^Zget_search_pathZprepend_search_path)Z icon_themeZlocal_theme_pathr/rload_icon_themeruGsR**,Jww||H$8$8'B99;;&&'78rws3 VVV 88/1//"84   ,.D7~SZZ8  $ .$N20& H  <>(t9c  Es(C44 D?D