(g/ ndZdZddlmZmZmZmZmZm Z m Z m Z m Z mZmZmZmZddlZddlZddlZddlZejjZejjZdZ ej!"ej!"ej!"ej!"e#Z$e%Z&dddZ'dZ(e%Z)d Z*d Z+d Z,gZ-ddl.Z/d d d ddZ0d ddZ1dZ2dZ3dZ4dd d d d ddZ dZ5dddZ6dZ7dZ8dZ9dZ:dZ;dZddd d#Z?ddd d$Z@d d%d&d'ZAd(ZBdd)d*ZCd+d d,d-Zd+d d,d.ZDd/ZEd0ZFdd d d1d2ZGd3ZHd4ZIeIgZJd5ZKd6ZLd7ZMid8d9d:d;dd?d@d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdPdRdSdTdUdVdWdXdYdZd[d\d]ZNdad_ZOd`ZPdS)bzl This module contains utility functions specific to blender but not associated with blenders internal data. )% blend_pathsescape_identifier flip_nameunescape_identifierkeyconfig_init keyconfig_set load_scriptsmodules_from_path preset_find preset_pathsrefresh_script_pathsapp_template_pathsregister_classregister_cli_commandunregister_cli_commandregister_manual_mapunregister_manual_mapregister_preset_pathunregister_preset_pathregister_classes_factoryregister_submodule_factory register_toolmake_rna_paths manual_mapmanual_language_codepreviews resource_pathscript_path_userextension_path_user script_pathssmpte_from_framesmpte_from_secondsunitsunregister_classunregister_tool user_resourceexecfile) _utils_unitsrrrrrrrrr#rr%system_resourceN)startupmodules)modcddl}d}|j||}||j|}tj}||d}|||< |j||| |dn)|||<n##|| |dn|||<wxYw|S)a> Execute a file path as a Python script. :arg filepath: Path of the script to execute. :type filepath: str :arg mod: Optional cached module, the result of a previous execution. :type mod: ModuleType | None :return: The module which can be passed back in as ``mod``. :rtype: ModuleType r'N__main__) importlib.utilutilspec_from_file_locationmodule_from_spec_sysr+getloader exec_modulepop)filepathr, importlibmod_namemod_specr+mod_origs X/home/blender/git/blender-v430/install_release/4.3/scripts/modules/bpy/utils/__init__.pyr&r&YsH~55hIIH {n--h77 lG{{8T**HGH)##C(((   KK$ ' ' ' ' (GH     KK$ ' ' ' ' (GH  ( ( ( ( Js &B B?ctjj}||vrdSd|vr$td|dS|rddl}|} t |}n #ddl}|YdSxYw|r8td|||z | |j |S)N.z?Ignoring '{:s}', can't import files containing multiple periodsr'ztime {:s} {:.4f}) _bpyapp debug_pythonprintformattime __import__ traceback print_excadd__name__) module_nameloaded_modulesuse_timerEtr,rGs r= _test_importrO~sx$Hn$$t k OVVWbccdddt IIKK%%ttG  '' TYY[[1_EEFFFs|$$$ Js A++Bc|tjvrz load_scripts..s!L!L!L#*!L!L!LrWct|dd}|r- |dS#ddl}|YdSxYwtd|jdS)Nregisterr'z[ Warning! {!r} has no register function, this is now a requirement for registerable scripts)getattrrGrHrCrD__file__)r,rjrGs r=register_module_callz*load_scripts..register_module_calls3 D11   &  &    ##%%%%%% EEKVCLEYEY      !>ct|dd}|r- |dS#ddl}|YdSxYwdS)N unregisterr')rkrGrH)r,rprGs r=unregister_module_callz,load_scripts..unregister_module_callsiS,55  & &  &    ##%%%%%%  & &rncddl}|tkr|S ||S#ddl}|YdSxYwrQ)r9 _bpy_typesreloadrGrH)r,r9rGs r= test_reloadz!load_scripts..test_reloadsi *  J "##C(( ( "        ! ! ! ! ! !s (Acr|vrdSr|rtd||}|r,|t|jdSdS)Nz Reloading:)rC_registered_module_namesrZrJ)r,original_modulesr`rmr_rus r= test_registerz#load_scripts..test_registers  s&666 F  #c # , $ $ $+c""C  :  % % % $ + +CL 9 9 9 9 9 : :rWcg|]}||SrYrd)rfr,s r=rhz load_scripts..$s%    rWz:Warning: globally loaded modules not found in sys.modules:c.g|]}|tjv|Srd)r3r+)rfr:s r=rhz load_scripts..-s&ccchhVZVbFbFbFbFbFbrWT)keep_properties) RestrictBlend)use_userr*r_zgc.collect() -> {:d}zPython Script Load Time {:.4f} is_registeredFz'Warning, unregistered class: {:s}({:s}))-r@rArB_is_factory_startuprEsetr3r+values _preferencesaddons _addon_utilsdisablemapr4reversedrwlenrCclearcontextwindow_manager keyconfigsupdatebpy_restrict_stater}r_script_module_dirs_osrRjoinisdirrVr load_scripts_extensionstag_script_reloadgcrDcollecttypes bpy_struct__subclasses__rkrrJ)r_r`rarMuse_class_register_checkr~rEt_mainrLaddon_module_namerqryregistered_modulesr,r} base_path path_subdirrRrclssubclsrxrmrus`` @@@r=rrs+/(*??H'&&H UUN1<..004 "M!L 8K!L!L!L 4 4   !2 3 3 3 3   &&& " " " : : : : : : : : :L   t|/:R1S1STT    ! " "c*B&C&C C C Lcc*Bccc    !&&(((& ( (C " "3 ' ' ' '%  C K      #.55d5KKK000000  / /%x888 / /I2 / / x}}Y <<8>>$''/,T222#i//#4T>#J#J//C)M#.... / / / / / / / / / / / / / / / / /8 #.55777?~>>>>; #55777  $++BJJLL99:::M .55diikkF6JKKLLLo:(7799 o oCsOU33 o!0022ooF!/oGNNv`c`lmmnnn oo o osBH<<IIrcttjrddl}||~t tdd}||t`ntj |~dS)z Load extensions scripts (add-ons and app-templates) :arg reload_scripts: Causes all scripts to have their unregister method called before loading. :type reload_scripts: bool r'Nr_initialize_once) anyr@utilsr bl_app_template_utilsresetrkrr reset_all)r_rrs r=rrgs 4: ( ( * *++"$$$$##>#BBB !|-?FF#  ) )n====rWcftd}|rtj|ndS)z6returns the env var and falls back to home dir or NoneSCRIPTSN)_user_resourcerrRnormpathrUs r=rrs/ ) $ $D&* 438  T " " "4rWcg}tjjD]=}|j}|r2|t j|>|S)z5Returns a list of user preference script directories.)r filepathsscript_directories directoryrZrrRr)pathsscript_directoryrs r=script_paths_prefrsU E(2E77$.  7 LL**955 6 6 6 LrWctjdx}r tj|gSgS)zGReturns a list of system script directories from environment variables.BLENDER_SYSTEM_SCRIPTS)renvironr4rRr)env_system_paths r=script_paths_system_environmentrs<+//*BCCC4!!/2233 IrW)subdir user_pref check_allr~use_system_environmentc|s|rt\}}g}|rptdx}r3|tj|d|r|||||t |s|r|||r!|t|r!|tg} |D]} | stj | } | tj| |} | | vrKtj | sk| | | S)a Returns a list of valid script paths. :arg subdir: Optional subdir. :type subdir: str :arg user_pref: Include the user preference script paths. :type user_pref: bool :arg check_all: Include local, user and system paths rather just the paths Blender uses. :type check_all: bool :arg use_user: Include user paths :type use_user: bool :arg use_system_environment: Include BLENDER_SYSTEM_SCRIPTS variable path :type use_system_environment: bool :return: script paths. :rtype: list[str] LOCALscripts) _bpy_script_pathsrrZrrRr_script_base_dirextendrrrr) rrrr~r path_system path_user base_paths path_localrrRs r=rrs$5H5!2!4!4 YJ'&w// /: D   chmmJ BB C C C  )   i ( ( (+&&&&''' )  )   i ( ( (/+--...=9;;<<<G    x  &&  8==v..D 7?? x~~d##  t NrWcdtD]2} tj|##t$rY/wxYwtt D]Z}tD]P}tj ||}tj |rt|Q[tj D]_}t|tj |d}tj |rt|`dS)zE Run this after creating new script paths to update sys.path r+N)rTr3rRremove ValueErrorrrrrrrrVrrr[)rRrrs r=r r s0 '  I  T " " " "    D   """!^^// . / /K8==K88Dx~~d## /(... / "$$**%%%x}}T9-- 8>>$   * #D ) ) ) **s + 88rUc#K||fnd}tdtjjddg|R}|r#tj|r|Vt D]>}tjj|ddg|R}tj|r|V?t dtjjddg|R}|r%tj|r|VdSdSdS)z Returns valid application template paths. :arg path: Optional subdir. :type path: str :return: App template paths. :rtype: Iterator[str] Nrdrr*bl_app_templates_userrUbl_app_templates_system)rrrRrrrr))rR subdir_args path_tests r=r r s)"-4''2Kysx}YH_/nbm/n/n/noooISX^^I..011HM$ 3L[{[[[ 8>>) $ $ OOO  iIb0qep0q0q0qrrrISX^^I..rWcg}tdD]}tj||}||s"t d|tj|r||tj D]W}tj|d|}tj|r||XtD]W}tj|d|}tj|r||X|S)z Returns a list of paths for a specific preset. :arg subdir: preset subdirectory (must not be an absolute path). :type subdir: str :return: Script paths. :rtype: list[str] presets)rzinvalid subdir given {!r}) rrrRr startswith ExceptionrDrrZrr_preset_path_registry)rdirsrRrs r=r r sB DI...##HMM$// ##D)) #7>>vFFGG G X^^I & & # KK " " ""$$##HMM$ 6:: 8>>) $ $ # KK " " "%##HMM$ 6:: 8>>) $ $ # KK " " " KrWctt}t||ttkrtd|dSdS)a| Register a preset search path. :arg path: preset directory (must be an absolute path). This path must contain a "presets" subdirectory which will typically contain presets for add-ons. You may call ``bpy.utils.register_preset_path(os.path.dirname(__file__))`` from an add-ons ``__init__.py`` file. When the ``__init__.py`` is in the same location as a ``presets`` directory. For example an operators preset would be located under: ``presets/operator/{operator.id}/`` where ``operator.id`` is the ``bl_idname`` of the operator. :type path: str :return: success :rtype: bool z'Warning: preset path already registeredFT)rrrIrCrRset_lens r=rr-sU '((Gd####+,,,, 7>>>u 4rWctt}t||ttkrtd|dSdS)z Unregister a preset search path. :arg path: preset directory (must be an absolute path). This must match the registered path exactly. :type path: str :return: success :rtype: bool z#Warning: preset path not registeredFT)rrdiscardrCrs r=rrEsU'((G!!$'''#+,,,, 3T:::u 4rWc tjtj|gtj||grdSn&#t$rYnt $rYnt $rYnwxYwdS)NTF)rrRsamefile commonpathFileNotFoundErrorrPermissionError) parent_pathrRs r=_is_path_parent_ofrXs 8  ##[M22##[$$788   4                   5sAA"" B. B9 BBctd}dD]-}t|}|r||krt||rdS.dS)z Returns True if the path is one of the built-in paths used by Blender. :arg path: Path you want to check if it is in the built-in settings directory :type path: str :rtype: bool USER)SYSTEMrTF)rr)rR user_pathresrs r=is_path_builtinrqsif%%I"  #C((  kY66  k4 0 0 44  5rWcntjjD]"}|js t |j|rdS#dS)z Returns True if the path is from an extensions repository. :arg path: Path to check if it is within an extension repository. :type path: str :rtype: bool TF)rrareposenabledrr)rRrepos r=is_path_extensionrsO'-|   dnd 3 3 44  5rWfpsfps_basecFtt|||||S)a Returns an SMPTE formatted string from the *time*: ``HH:MM:SS:FF``. If *fps* and *fps_base* are not given the current scene is used. :arg time: time in seconds. :type time: int | float | datetime.timedelta :return: the frame string. :rtype: str r)r time_to_frame)rErrs r=r!r!s3 dh777    rWc ||tjjjj}|tjjjj}||z }|dkrdnd}t |}d|t|d|zz t|d|zz dzt||z dzt||zS)a Returns an SMPTE formatted string from the *frame*: ``HH:MM:SS:FF``. If *fps* and *fps_base* are not given the current scene is used. :arg frame: frame number. :type frame: int | float :return: the frame string. :rtype: str Nr'-z{:s}{:02d}:{:02d}:{:02d}:{:02d}i<) r@rscenerenderrrabsrDint)framerrsigns r=r r s {l '+<%,5 .C!))33D JJE *00  $ % % "s(#r) * * " # #      rWc|tjjjj}|tjjjj}||z }ddlm}|d||z S)z Returns the time from a frame number . If *fps* and *fps_base* are not given the current scene is used. :arg frame: number. :type frame: int | float :return: the time in seconds. :rtype: datetime.timedelta Nr' timedelta)r@rrrrrdatetimer)rrrrs r=time_from_framers` {l '+<%,5 .C"""""" 9Q $ $$rWc|tjjjj}|tjjjj}||z }ddlm}t||r| }||zS)aG Returns a float frame number from a time given in seconds or as a datetime.timedelta object. If *fps* and *fps_base* are not given the current scene is used. :arg time: time in seconds. :type time: float | int | datetime.timedelta :return: The frame. :rtype: float | int | datetime.timedelta Nr'r) r@rrrrrrr isinstance total_seconds)rErrrs r=rrsw {l '+<%,5 .C""""""$ ""$!!## #:rWz.py) display_namergcz|sdSt|D]}|rXd}tj|D]@}||r)|tj|dkr|}nAn||z}|rCtj||}tj|r|cSdS)NrF) title_case) r rlistdirendswithr@rRrrexists)name preset_pathrrgrfilenamefnr8s r=r r s t!+..   "Hk),,  ;;s## 0F0FrV[0F0\0\(\(\!HEczH  x}}Y99Hxx((   rWcd}tjj}t|d}t |||kr#t|d}|rt |dSdSdS)NBlender keyconfig)rkeymapactive_keyconfigr r)default_config active_configr8s r=rr!s}N '8M>;77H(&&}k::  $ ( # # # # #'& $ $rW)reportcHddlm}m}tjjrt d|tjjj }|||d}| |} d}t|n#ddl }| }YnxYw| |} |r=| |dh|t || | |kr|| dS| $| |dhd|dS| |_dS) Nr')basenamesplitextzloading preset:rERRORFzFailed to load keymap {!r}T)os.pathrrr@rArBrCrrrr4r&rG format_excrrDactive) r8rrrrr kc_old error_msgrGkc_news r=rr2sg******** x+ ***,7J 8HHX&& ' ' *D^^D ! !F+ +((** ^^D ! !F   FG9i ( ( ( i  Vv%5%5   f % % %u~   FG9:AA(KK L L Lu" ts 0BBr)rRcreatecbt||}|r|rtj|s7 tj|nd#ddl}|d}YnFxYwtj|s$td |d}|S)a Return a user resource path (normally from the users home directory). :arg resource_type: Resource type in ['DATAFILES', 'CONFIG', 'SCRIPTS', 'EXTENSIONS']. :type resource_type: str :arg path: Optional subdirectory. :type path: str :arg create: Treat the path as a directory and create it if its not existing. :type create: bool :return: a path. :rtype: str rUr'Nr&Path {!r} found but isn't a directory!) rrrRr makedirsrGrHrrCrD) resource_typerRr! target_pathrGs r=r%r%Ys!T:::K !  !8??;// !%L----%$$$$'')))"$KKKX^^K00 !>EEkRRSSS s A A)cddlm}||\}}td}|r|r$tj|d|||}n"tj|d||}|rtj|s7 tj|nd#ddl}| d}YnFxYwtj |s$td |d}|S)a Return a user writable directory associated with an extension. .. note:: This allows each extension to have it's own user directory to store files. The location of the extension it self is not a suitable place to store files because it is cleared each upgrade and the users may not have write permissions to the repository (typically "System" repositories). :arg package: The ``__package__`` of the extension. :type package: str :arg path: Optional subdirectory. :type path: str :arg create: Treat the path as a directory and create it if its not existing. :type create: bool :return: a path. :rtype: str r') _extension_module_name_decompose EXTENSIONSz.userNrr#) addon_utilsr(rrrRrr r$rGrHrrCrD)packagerRr!r( repo_module pkg_idnamer&rGs r=rr{s&*=<<<<<?>wGGK ..K!  W(-- Wk:W[\\KK(-- Wk:VVK  !8??;// !%L----%$$$$'')))"$KKKX^^K00 !>EEkRRSSS s B%%Cc fd}fd}||fS)z Utility function to create register and unregister functions which simply registers and unregisters a sequence of classes. c0D]}t|dSrY)rrclassess r=rjz*register_classes_factory..registers-  C 3      rWcJtD]}t|dSrY)rr#r0s r=rpz,register_classes_factory..unregisters5G$$ " "C S ! ! ! ! " "rWrd)r1rjrps` r=rrsB      """"" Z rWc6dgfd}fd}||fS)a3 Utility function to create register and unregister functions which simply load submodules, calling their register & unregister functions. .. note:: Modules are registered in the order given, unregistered in reverse order. :arg module_name: The module name, typically ``__name__``. :type module_name: str :arg submodule_names: List of submodule names to load and unload. :type submodule_names: list[str] :return: register and unregister functions. :rtype: tuple[Callable[[], None], Callable[[], None]] NctfdDdd<D]\}}|dS)N)r fromlistc4g|]}t||fSrd)rk)rfr:res r=rhz@register_submodule_factory..register..s(___8'&(33X>___rW)rFrj)r, _mod_namererKsubmodule_names submoduless r=rjz,register_submodule_factory..registersbGGG_______ 111 (  NC LLNNNN  rWcddlm}tD]1\}}|t |||j=2dS)Nr')r+)sysr+rrpdelattrrJr)r+r,r:rer9s r=rpz.register_submodule_factory..unregistersu%j11 & &MC NN    FH % % % %%rWrd)rKr8rjrprer9s`` @@r=rrse&FJ Z rW)after separatorgroupc`|j}|jddlm}m||"t d|j}ddl m }d| |D}t||s/t dt||j|vr't d|j~~fd } | |} |r| f} |rd| fn| f} d } d } |t|D]\}}|t!|r'|j|vr| ||}| ||d z|d z<d } n?t!|t$rt|d D]m\}}t!|rX|j|vrO|r| ||}| ||d z|d z<n/| ||}|d|d z| z||d zdz}|||<d } nn| rn| st'd|| s|| dSdS)a Register a tool in the toolbar. :arg tool_cls: A tool subclass. :type tool_cls: :class:`bpy.types.WorkSpaceTool` :arg after: Optional identifiers this tool will be added after. :type after: Sequence[str] | None :arg separator: When true, add a separator before this tool. :type separator: bool :arg group: When true, add a new nested group of tools. :type group: bool r')ToolSelectPanelHelperToolDefNSpace type {!r} has no toolbar) WorkSpaceToolc h|] }||j SrY)idname)rfitems r= z register_tool..s*     rWz)Expected WorkSpaceTool subclass, not {!r}zTool {!r} already exists!c |j|jt|d|jt|ddt|ddt|ddt|ddt|ddt|ddt|ddt|d dt|d dt|d dd }||_|j}|t|d rod dlm }|j }|j }|j }|j }|K d}n( dd} ||||j||S)Nbl_descriptionbl_icon bl_cursor bl_options bl_widgetbl_widget_properties bl_keymap bl_data_block bl_operator draw_settings draw_cursor) rFlabel descriptioniconcursoroptionswidgetwidget_propertiesr data_blockoperatorrSrTr'rAll_ ) from_dict bl_idnamebl_labelrk__doc___bl_toolrcallablebpyrrrdefaultaddonreplacetitle_km_action_simplerU) tool_clstool_def keymap_datarwmr kc_defaultkc context_descrrBr context_modes r=tool_from_classz®ister_tool..tool_from_classs$$(&"8-=x?OPPHi66h T::xt<<h T::!(3I4!P!Ph T::!(OTBB->>$XEE"8]DAA& &   %o  "x A'?'? " # # # # # #'BJ#+J!B~'$)MM$0$8$8c$B$B$H$H$J$JM%%j"mX^U`aaarWc|}|t|kr*||"|}|dz }|t|kr||"|S)N)r)seqii_prevs r=skip_to_end_of_groupz+register_tool..skip_to_end_of_group>sN#c((lls1v1F FA#c((lls1v1 rWFrxTz/bpy.utils.register_tool: could not find 'after') bl_space_typebl_context_modebl_ui.space_toolsystem_commonrArB_tool_class_from_space_typerrD_tools bpy.typesrD_tools_flatten issubclasstyperc enumeraterrFtuplerCr)rnr=r>r? space_typerAtoolsrDtools_idrvtool_convertedtool_def_insertr|changedrzrGjsub_itemrBrrus @@@r=rrsL'J+L ; ;J G GC {8?? KKLLL J| $E(''''' 5 D DU K KH h . .\CJJ4PX>>ZZ[[[X%%3::8;MNNOOO-"""""""H%_X..N +(*#, ~  G  ''  GAt|D'** ;%'',,T155A)8E!a%A+&"GE ( D%(( #,T1#5#5 " "KAx!(G44 "#?e33$0%9$8$B$B5Da!eAEk 2 2$8$8q$A$A'+FQUF|o'EQQRUVV 'T+/a&*G!EE L CU K K K & _%%%%%&&rWc|j}|j}ddlm}||}|"t d||j|}|j} | |}n#t$rd}YnwxYwd}d} |dkr||=||d} | st|D]\}} t| trt | |} n#t$rd} YnwxYw| dkrEt| } | | =|| | rt| ||<n||=||~ d} n| s"t d||`|j} | dd lm}|j}|j}|j|jfD]r}||j| d}|/t1d | d|jV|j|qdSdS) Nr')rArCc|r|d |d=|r|d |r|d |d=|r|d tt|dz ddD]}||du}|r|r||=|}dS)Nrr'rx)ranger) tool_listrzis_none prev_is_nones r=tool_list_cleanz(unregister_tool..tool_list_cleanxs IbM1"  IbM1 IaL0!  IaL0s9~~)2r22 # #Ald*G !< !aL"LL  # #rWFTzUnable to remove {!r}r^z&Warning keymap {!r} not found in {!r}!)r}r~rrArrrDrrfindexrrrrlistrrhrrrrirjkeymapsr4rCr r)rnrrurArrrorzrrrGr item_cleanrprrqrrskms r=r$r$hs'J+LCCCCCC  ; ;J G GC {8?? KKLLL J| $E H KK ! !   # # #GBww !H  ''  GAt$&&  8,,AA!AAA77!%dJ"1 #OJ///!/#(#4#4a!!H'..."#GE B/66x@@AAA/K  #] %z'78 & &Bz A//Bz>EEkRSnVXV]^^____ !!"%%%% & &s$#A99 BBC(( C76C7cttjtdd}|j|jfS)Nr+zrna_manual_reference.py)r&rrRrrurl_manual_prefixurl_manual_mapping)ref_mods r=_blender_default_maprs6sx}}%5yB[\\]]G  %w'A BBrWc:t|dSrY) _manual_maprZ manual_hooks r=rr{#####rWc:t|dSrY)rrrs r=rrrrWc#KttD]X} |\}}nA#td|ddl}|YOxYw||fVYdS)NzError calling {!r}r')rrrCrDrGrH)cbprefixrrGs r=rrs{## ) ) )+ &F&&  &--b11 2 2 2        ! ! ! H(((((( ) )s (> >C' J!.!5!5gy!I!IIh' 'C'  !!rW)r)Qre__all__r@r(r"rrrrrrrrrr#rr%rr)rhosrr;r3r*rrrrrAfactory_startuprrrRdirnamerlrrrr&rOrTrVr[r rw bpy_typesrsrrrrrr r r rrrrrr!r rrr rrrrrrr$rrrrrrrrrdrWr=rs  & P """"|' h.+8##CH$4$4SX5E5EchFVFVW_F`F`5a5a$b$bcc#"""""JD))) ))) 0$)%DXoXoXoXoXov/42555  454hl?????D***2 $8>0&28&%)4($($D#'%%%%%2 $d:49e     *$$$"'+$$$$$N*,ED*,E.....b    % % % X&*U%}&}&}&}&}&@J&J&J&dCCC$$ $$$$$$ ) ) )5 T5  T 5 T5 T5 $5  T!5" T#5. T/50 T152 T35: T;5B TC5F TG5J TK5N TO5P TQ5T TU5\  i555p 9 9 9 9"""""rW