fake-bpy-module 20240803__py3-none-any.whl → 20240804__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of fake-bpy-module might be problematic. Click here for more details.

Files changed (72) hide show
  1. aud/__init__.pyi +77 -77
  2. bmesh/ops/__init__.pyi +54 -36
  3. bmesh/types/__init__.pyi +24 -24
  4. bpy/ops/action/__init__.pyi +55 -32
  5. bpy/ops/anim/__init__.pyi +22 -22
  6. bpy/ops/armature/__init__.pyi +47 -20
  7. bpy/ops/asset/__init__.pyi +5 -2
  8. bpy/ops/boid/__init__.pyi +12 -2
  9. bpy/ops/brush/__init__.pyi +18 -12
  10. bpy/ops/buttons/__init__.pyi +10 -4
  11. bpy/ops/cachefile/__init__.pyi +12 -6
  12. bpy/ops/clip/__init__.pyi +54 -38
  13. bpy/ops/console/__init__.pyi +17 -6
  14. bpy/ops/constraint/__init__.pyi +28 -28
  15. bpy/ops/curve/__init__.pyi +72 -34
  16. bpy/ops/curves/__init__.pyi +16 -16
  17. bpy/ops/dpaint/__init__.pyi +4 -4
  18. bpy/ops/ed/__init__.pyi +5 -2
  19. bpy/ops/export_anim/__init__.pyi +3 -2
  20. bpy/ops/export_scene/__init__.pyi +55 -45
  21. bpy/ops/file/__init__.pyi +40 -16
  22. bpy/ops/font/__init__.pyi +59 -16
  23. bpy/ops/geometry/__init__.pyi +55 -20
  24. bpy/ops/gpencil/__init__.pyi +155 -122
  25. bpy/ops/graph/__init__.pyi +131 -52
  26. bpy/ops/grease_pencil/__init__.pyi +78 -58
  27. bpy/ops/image/__init__.pyi +77 -54
  28. bpy/ops/import_anim/__init__.pyi +11 -8
  29. bpy/ops/import_scene/__init__.pyi +20 -18
  30. bpy/ops/info/__init__.pyi +4 -4
  31. bpy/ops/lattice/__init__.pyi +8 -8
  32. bpy/ops/marker/__init__.pyi +6 -6
  33. bpy/ops/mask/__init__.pyi +13 -12
  34. bpy/ops/mball/__init__.pyi +6 -6
  35. bpy/ops/mesh/__init__.pyi +290 -150
  36. bpy/ops/nla/__init__.pyi +28 -20
  37. bpy/ops/node/__init__.pyi +43 -32
  38. bpy/ops/object/__init__.pyi +651 -210
  39. bpy/ops/outliner/__init__.pyi +113 -32
  40. bpy/ops/paint/__init__.pyi +65 -56
  41. bpy/ops/palette/__init__.pyi +4 -4
  42. bpy/ops/particle/__init__.pyi +14 -14
  43. bpy/ops/pose/__init__.pyi +121 -44
  44. bpy/ops/preferences/__init__.pyi +9 -6
  45. bpy/ops/render/__init__.pyi +3 -2
  46. bpy/ops/rigidbody/__init__.pyi +45 -14
  47. bpy/ops/scene/__init__.pyi +69 -22
  48. bpy/ops/screen/__init__.pyi +78 -16
  49. bpy/ops/sculpt/__init__.pyi +131 -74
  50. bpy/ops/sculpt_curves/__init__.pyi +2 -2
  51. bpy/ops/sequencer/__init__.pyi +156 -60
  52. bpy/ops/sound/__init__.pyi +40 -16
  53. bpy/ops/surface/__init__.pyi +12 -12
  54. bpy/ops/text/__init__.pyi +65 -20
  55. bpy/ops/texture/__init__.pyi +2 -2
  56. bpy/ops/transform/__init__.pyi +344 -72
  57. bpy/ops/ui/__init__.pyi +9 -6
  58. bpy/ops/uilist/__init__.pyi +2 -2
  59. bpy/ops/uv/__init__.pyi +90 -66
  60. bpy/ops/view3d/__init__.pyi +36 -30
  61. bpy/ops/wm/__init__.pyi +443 -156
  62. bpy/types/__init__.pyi +28064 -2857
  63. {fake_bpy_module-20240803.dist-info → fake_bpy_module-20240804.dist-info}/METADATA +1 -1
  64. {fake_bpy_module-20240803.dist-info → fake_bpy_module-20240804.dist-info}/RECORD +72 -72
  65. freestyle/chainingiterators/__init__.pyi +4 -4
  66. freestyle/types/__init__.pyi +76 -63
  67. idprop/types/__init__.pyi +2 -2
  68. imbuf/types/__init__.pyi +2 -2
  69. mathutils/__init__.pyi +1004 -970
  70. mathutils/bvhtree/__init__.pyi +2 -2
  71. {fake_bpy_module-20240803.dist-info → fake_bpy_module-20240804.dist-info}/WHEEL +0 -0
  72. {fake_bpy_module-20240803.dist-info → fake_bpy_module-20240804.dist-info}/top_level.txt +0 -0
bpy/ops/wm/__init__.pyi CHANGED
@@ -33,7 +33,10 @@ def alembic_export(
33
33
  filter_folder: bool | None = True,
34
34
  filter_blenlib: bool | None = False,
35
35
  filemode: int | None = 8,
36
- display_type: str | None = "DEFAULT",
36
+ display_type: typing.Literal[
37
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
38
+ ]
39
+ | None = "DEFAULT",
37
40
  sort_method: str | None = "",
38
41
  filter_glob: str = "*.abc",
39
42
  start: int | None = -2147483648,
@@ -58,13 +61,16 @@ def alembic_export(
58
61
  use_instancing: bool | None = True,
59
62
  global_scale: float | None = 1.0,
60
63
  triangulate: bool | None = False,
61
- quad_method: str | None = "SHORTEST_DIAGONAL",
62
- ngon_method: str | None = "BEAUTY",
64
+ quad_method: typing.Literal[
65
+ "BEAUTY", "FIXED", "FIXED_ALTERNATE", "SHORTEST_DIAGONAL", "LONGEST_DIAGONAL"
66
+ ]
67
+ | None = "SHORTEST_DIAGONAL",
68
+ ngon_method: typing.Literal["BEAUTY", "CLIP"] | None = "BEAUTY",
63
69
  export_hair: bool | None = True,
64
70
  export_particles: bool | None = True,
65
71
  export_custom_properties: bool | None = True,
66
72
  as_background_job: bool | None = False,
67
- evaluation_mode: str | None = "RENDER",
73
+ evaluation_mode: typing.Literal["RENDER", "VIEWPORT"] | None = "RENDER",
68
74
  init_scene_frame_range: bool | None = True,
69
75
  ):
70
76
  """Export current scene in an Alembic archive
@@ -125,7 +131,7 @@ def alembic_export(
125
131
 
126
132
  THUMBNAIL
127
133
  Thumbnails -- Display files as thumbnails.
128
- :type display_type: str | None
134
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
129
135
  :param sort_method: File sorting mode
130
136
  :type sort_method: str | None
131
137
  :type filter_glob: str
@@ -174,9 +180,9 @@ def alembic_export(
174
180
  :param triangulate: Triangulate, Export polygons (quads and n-gons) as triangles
175
181
  :type triangulate: bool | None
176
182
  :param quad_method: Quad Method, Method for splitting the quads into triangles
177
- :type quad_method: str | None
183
+ :type quad_method: typing.Literal['BEAUTY', 'FIXED', 'FIXED_ALTERNATE', 'SHORTEST_DIAGONAL', 'LONGEST_DIAGONAL'] | None
178
184
  :param ngon_method: N-gon Method, Method for splitting the n-gons into triangles
179
- :type ngon_method: str | None
185
+ :type ngon_method: typing.Literal['BEAUTY', 'CLIP'] | None
180
186
  :param export_hair: Export Hair, Exports hair particle systems as animated curves
181
187
  :type export_hair: bool | None
182
188
  :param export_particles: Export Particles, Exports non-hair particle systems
@@ -192,7 +198,7 @@ def alembic_export(
192
198
 
193
199
  VIEWPORT
194
200
  Viewport -- Use Viewport settings for object visibility, modifier settings, etc.
195
- :type evaluation_mode: str | None
201
+ :type evaluation_mode: typing.Literal['RENDER','VIEWPORT'] | None
196
202
  :type init_scene_frame_range: bool | None
197
203
  """
198
204
 
@@ -227,7 +233,10 @@ def alembic_import(
227
233
  filter_blenlib: bool | None = False,
228
234
  filemode: int | None = 8,
229
235
  relative_path: bool | None = True,
230
- display_type: str | None = "DEFAULT",
236
+ display_type: typing.Literal[
237
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
238
+ ]
239
+ | None = "DEFAULT",
231
240
  sort_method: str | None = "",
232
241
  filter_glob: str = "*.abc",
233
242
  scale: float | None = 1.0,
@@ -301,7 +310,7 @@ def alembic_import(
301
310
 
302
311
  THUMBNAIL
303
312
  Thumbnails -- Display files as thumbnails.
304
- :type display_type: str | None
313
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
305
314
  :param sort_method: File sorting mode
306
315
  :type sort_method: str | None
307
316
  :type filter_glob: str
@@ -350,7 +359,10 @@ def append(
350
359
  filter_folder: bool | None = True,
351
360
  filter_blenlib: bool | None = True,
352
361
  filemode: int | None = 1,
353
- display_type: str | None = "DEFAULT",
362
+ display_type: typing.Literal[
363
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
364
+ ]
365
+ | None = "DEFAULT",
354
366
  sort_method: str | None = "",
355
367
  link: bool | None = False,
356
368
  do_reuse_local_id: bool | None = False,
@@ -426,7 +438,7 @@ def append(
426
438
 
427
439
  THUMBNAIL
428
440
  Thumbnails -- Display files as thumbnails.
429
- :type display_type: str | None
441
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
430
442
  :param sort_method: File sorting mode
431
443
  :type sort_method: str | None
432
444
  :param link: Link, Link the objects or data-blocks rather than appending
@@ -456,8 +468,30 @@ def batch_rename(
456
468
  execution_context: int | str | None = None,
457
469
  undo: bool | None = None,
458
470
  *,
459
- data_type: str | None = "OBJECT",
460
- data_source: str | None = "SELECT",
471
+ data_type: typing.Literal[
472
+ "OBJECT",
473
+ "COLLECTION",
474
+ "MATERIAL",
475
+ "MESH",
476
+ "CURVE",
477
+ "META",
478
+ "VOLUME",
479
+ "GPENCIL",
480
+ "ARMATURE",
481
+ "LATTICE",
482
+ "LIGHT",
483
+ "LIGHT_PROBE",
484
+ "CAMERA",
485
+ "SPEAKER",
486
+ "BONE",
487
+ "NODE",
488
+ "SEQUENCE_STRIP",
489
+ "ACTION_CLIP",
490
+ "SCENE",
491
+ "BRUSH",
492
+ ]
493
+ | None = "OBJECT",
494
+ data_source: typing.Literal["SELECT", "ALL"] | None = "SELECT",
461
495
  actions: bpy.types.bpy_prop_collection[bl_operators.wm.BatchRenameAction]
462
496
  | None = None,
463
497
  ):
@@ -467,9 +501,9 @@ def batch_rename(
467
501
  :type execution_context: int | str | None
468
502
  :type undo: bool | None
469
503
  :param data_type: Type, Type of data to rename
470
- :type data_type: str | None
504
+ :type data_type: typing.Literal['OBJECT','COLLECTION','MATERIAL','MESH','CURVE','META','VOLUME','GPENCIL','ARMATURE','LATTICE','LIGHT','LIGHT_PROBE','CAMERA','SPEAKER','BONE','NODE','SEQUENCE_STRIP','ACTION_CLIP','SCENE','BRUSH'] | None
471
505
  :param data_source: Source
472
- :type data_source: str | None
506
+ :type data_source: typing.Literal['SELECT','ALL'] | None
473
507
  :param actions: actions
474
508
  :type actions: bpy.types.bpy_prop_collection[bl_operators.wm.BatchRenameAction] | None
475
509
  """
@@ -604,15 +638,23 @@ def collada_export(
604
638
  filter_folder: bool | None = True,
605
639
  filter_blenlib: bool | None = False,
606
640
  filemode: int | None = 8,
607
- display_type: str | None = "DEFAULT",
641
+ display_type: typing.Literal[
642
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
643
+ ]
644
+ | None = "DEFAULT",
608
645
  sort_method: str | None = "",
609
646
  filter_glob: str = "*.dae",
610
- prop_bc_export_ui_section: str | None = "main",
647
+ prop_bc_export_ui_section: typing.Literal[
648
+ "main", "geometry", "armature", "animation", "collada"
649
+ ]
650
+ | None = "main",
611
651
  apply_modifiers: bool | None = False,
612
652
  export_mesh_type: int | None = 0,
613
- export_mesh_type_selection: str | None = "view",
614
- export_global_forward_selection: str | None = "Y",
615
- export_global_up_selection: str | None = "Z",
653
+ export_mesh_type_selection: typing.Literal["view", "render"] | None = "view",
654
+ export_global_forward_selection: typing.Literal["X", "Y", "Z", "-X", "-Y", "-Z"]
655
+ | None = "Y",
656
+ export_global_up_selection: typing.Literal["X", "Y", "Z", "-X", "-Y", "-Z"]
657
+ | None = "Z",
616
658
  apply_global_orientation: bool | None = False,
617
659
  selected: bool | None = False,
618
660
  include_children: bool | None = False,
@@ -621,7 +663,7 @@ def collada_export(
621
663
  deform_bones_only: bool | None = False,
622
664
  include_animations: bool | None = True,
623
665
  include_all_actions: bool | None = True,
624
- export_animation_type_selection: str | None = "sample",
666
+ export_animation_type_selection: typing.Literal["sample", "keys"] | None = "sample",
625
667
  sampling_rate: int | None = 1,
626
668
  keep_smooth_curves: bool | None = False,
627
669
  keep_keyframes: bool | None = False,
@@ -633,9 +675,13 @@ def collada_export(
633
675
  use_blender_profile: bool | None = True,
634
676
  sort_by_name: bool | None = False,
635
677
  export_object_transformation_type: int | None = 0,
636
- export_object_transformation_type_selection: str | None = "matrix",
678
+ export_object_transformation_type_selection: typing.Literal["matrix", "decomposed"]
679
+ | None = "matrix",
637
680
  export_animation_transformation_type: int | None = 0,
638
- export_animation_transformation_type_selection: str | None = "matrix",
681
+ export_animation_transformation_type_selection: typing.Literal[
682
+ "matrix", "decomposed"
683
+ ]
684
+ | None = "matrix",
639
685
  open_sim: bool | None = False,
640
686
  limit_precision: bool | None = False,
641
687
  keep_bind_info: bool | None = False,
@@ -698,7 +744,7 @@ def collada_export(
698
744
 
699
745
  THUMBNAIL
700
746
  Thumbnails -- Display files as thumbnails.
701
- :type display_type: str | None
747
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
702
748
  :param sort_method: File sorting mode
703
749
  :type sort_method: str | None
704
750
  :type filter_glob: str
@@ -718,7 +764,7 @@ def collada_export(
718
764
 
719
765
  collada
720
766
  Extra -- Collada export section.
721
- :type prop_bc_export_ui_section: str | None
767
+ :type prop_bc_export_ui_section: typing.Literal['main','geometry','armature','animation','collada'] | None
722
768
  :param apply_modifiers: Apply Modifiers, Apply modifiers to exported mesh (non destructive)
723
769
  :type apply_modifiers: bool | None
724
770
  :param export_mesh_type: Resolution, Modifier resolution for export
@@ -730,7 +776,7 @@ def collada_export(
730
776
 
731
777
  render
732
778
  Render -- Apply modifier's render settings.
733
- :type export_mesh_type_selection: str | None
779
+ :type export_mesh_type_selection: typing.Literal['view','render'] | None
734
780
  :param export_global_forward_selection: Global Forward Axis, Global Forward axis for export
735
781
 
736
782
  X
@@ -750,7 +796,7 @@ def collada_export(
750
796
 
751
797
  -Z
752
798
  -Z -- Global Forward is negative Z Axis.
753
- :type export_global_forward_selection: str | None
799
+ :type export_global_forward_selection: typing.Literal['X','Y','Z','-X','-Y','-Z'] | None
754
800
  :param export_global_up_selection: Global Up Axis, Global Up axis for export
755
801
 
756
802
  X
@@ -770,7 +816,7 @@ def collada_export(
770
816
 
771
817
  -Z
772
818
  -Z -- Global UP is negative Z Axis.
773
- :type export_global_up_selection: str | None
819
+ :type export_global_up_selection: typing.Literal['X','Y','Z','-X','-Y','-Z'] | None
774
820
  :param apply_global_orientation: Apply Global Orientation, Rotate all root objects to match the global orientation settings otherwise set the global orientation per Collada asset
775
821
  :type apply_global_orientation: bool | None
776
822
  :param selected: Selection Only, Export only selected elements
@@ -794,7 +840,7 @@ def collada_export(
794
840
 
795
841
  keys
796
842
  Curves -- Export Curves (note: guided by curve keys).
797
- :type export_animation_type_selection: str | None
843
+ :type export_animation_type_selection: typing.Literal['sample','keys'] | None
798
844
  :param sampling_rate: Sampling Rate, The distance between 2 keyframes (1 to key every frame)
799
845
  :type sampling_rate: int | None
800
846
  :param keep_smooth_curves: Keep Smooth curves, Export also the curve handles (if available) (this does only work when the inverse parent matrix is the unity matrix, otherwise you may end up with odd results)
@@ -824,7 +870,7 @@ def collada_export(
824
870
 
825
871
  decomposed
826
872
  Decomposed -- Use <rotate>, <translate> and <scale> representation for exported transformations.
827
- :type export_object_transformation_type_selection: str | None
873
+ :type export_object_transformation_type_selection: typing.Literal['matrix','decomposed'] | None
828
874
  :param export_animation_transformation_type: Transform, Transformation type for translation, scale and rotation. Note: The Animation transformation type in the Anim Tab is always equal to the Object transformation type in the Geom tab
829
875
  :type export_animation_transformation_type: int | None
830
876
  :param export_animation_transformation_type_selection: Transform, Transformation type for translation, scale and rotation. Note: The Animation transformation type in the Anim Tab is always equal to the Object transformation type in the Geom tab
@@ -834,7 +880,7 @@ def collada_export(
834
880
 
835
881
  decomposed
836
882
  Decomposed -- Use <rotate>, <translate> and <scale> representation for exported transformations.
837
- :type export_animation_transformation_type_selection: str | None
883
+ :type export_animation_transformation_type_selection: typing.Literal['matrix','decomposed'] | None
838
884
  :param open_sim: Export to SL/OpenSim, Compatibility mode for Second Life, OpenSimulator and other compatible online worlds
839
885
  :type open_sim: bool | None
840
886
  :param limit_precision: Limit Precision, Reduce the precision of the exported data to 6 digits
@@ -870,7 +916,10 @@ def collada_import(
870
916
  filter_folder: bool | None = True,
871
917
  filter_blenlib: bool | None = False,
872
918
  filemode: int | None = 8,
873
- display_type: str | None = "DEFAULT",
919
+ display_type: typing.Literal[
920
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
921
+ ]
922
+ | None = "DEFAULT",
874
923
  sort_method: str | None = "",
875
924
  filter_glob: str = "*.dae",
876
925
  import_units: bool | None = False,
@@ -939,7 +988,7 @@ def collada_import(
939
988
 
940
989
  THUMBNAIL
941
990
  Thumbnails -- Display files as thumbnails.
942
- :type display_type: str | None
991
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
943
992
  :param sort_method: File sorting mode
944
993
  :type sort_method: str | None
945
994
  :type filter_glob: str
@@ -982,7 +1031,7 @@ def context_collection_boolean_set(
982
1031
  *,
983
1032
  data_path_iter: str = "",
984
1033
  data_path_item: str = "",
985
- type: str | None = "TOGGLE",
1034
+ type: typing.Literal["TOGGLE", "ENABLE", "DISABLE"] | None = "TOGGLE",
986
1035
  ):
987
1036
  """Set boolean values for a collection of items
988
1037
 
@@ -994,7 +1043,7 @@ def context_collection_boolean_set(
994
1043
  :param data_path_item: data_path_item, The data path from each iterable to the value (int or float)
995
1044
  :type data_path_item: str
996
1045
  :param type: Type
997
- :type type: str | None
1046
+ :type type: typing.Literal['TOGGLE','ENABLE','DISABLE'] | None
998
1047
  """
999
1048
 
1000
1049
  ...
@@ -1513,13 +1562,17 @@ def gpencil_export_pdf(
1513
1562
  filter_folder: bool | None = True,
1514
1563
  filter_blenlib: bool | None = False,
1515
1564
  filemode: int | None = 8,
1516
- display_type: str | None = "DEFAULT",
1565
+ display_type: typing.Literal[
1566
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
1567
+ ]
1568
+ | None = "DEFAULT",
1517
1569
  sort_method: str | None = "",
1518
1570
  use_fill: bool | None = True,
1519
- selected_object_type: str | None = "SELECTED",
1571
+ selected_object_type: typing.Literal["ACTIVE", "SELECTED", "VISIBLE"]
1572
+ | None = "SELECTED",
1520
1573
  stroke_sample: float | None = 0.0,
1521
1574
  use_normalized_thickness: bool | None = False,
1522
- frame_mode: str | None = "ACTIVE",
1575
+ frame_mode: typing.Literal["ACTIVE", "SELECTED", "SCENE"] | None = "ACTIVE",
1523
1576
  ):
1524
1577
  """Export grease pencil to PDF
1525
1578
 
@@ -1579,7 +1632,7 @@ def gpencil_export_pdf(
1579
1632
 
1580
1633
  THUMBNAIL
1581
1634
  Thumbnails -- Display files as thumbnails.
1582
- :type display_type: str | None
1635
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
1583
1636
  :param sort_method: File sorting mode
1584
1637
  :type sort_method: str | None
1585
1638
  :param use_fill: Fill, Export strokes with fill enabled
@@ -1594,7 +1647,7 @@ def gpencil_export_pdf(
1594
1647
 
1595
1648
  VISIBLE
1596
1649
  Visible -- Include all visible objects.
1597
- :type selected_object_type: str | None
1650
+ :type selected_object_type: typing.Literal['ACTIVE','SELECTED','VISIBLE'] | None
1598
1651
  :param stroke_sample: Sampling, Precision of stroke sampling. Low values mean a more precise result, and zero disables sampling
1599
1652
  :type stroke_sample: float | None
1600
1653
  :param use_normalized_thickness: Normalize, Export strokes with constant thickness
@@ -1609,7 +1662,7 @@ def gpencil_export_pdf(
1609
1662
 
1610
1663
  SCENE
1611
1664
  Scene -- Include all scene frames.
1612
- :type frame_mode: str | None
1665
+ :type frame_mode: typing.Literal['ACTIVE','SELECTED','SCENE'] | None
1613
1666
  """
1614
1667
 
1615
1668
  ...
@@ -1639,10 +1692,14 @@ def gpencil_export_svg(
1639
1692
  filter_folder: bool | None = True,
1640
1693
  filter_blenlib: bool | None = False,
1641
1694
  filemode: int | None = 8,
1642
- display_type: str | None = "DEFAULT",
1695
+ display_type: typing.Literal[
1696
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
1697
+ ]
1698
+ | None = "DEFAULT",
1643
1699
  sort_method: str | None = "",
1644
1700
  use_fill: bool | None = True,
1645
- selected_object_type: str | None = "SELECTED",
1701
+ selected_object_type: typing.Literal["ACTIVE", "SELECTED", "VISIBLE"]
1702
+ | None = "SELECTED",
1646
1703
  stroke_sample: float | None = 0.0,
1647
1704
  use_normalized_thickness: bool | None = False,
1648
1705
  use_clip_camera: bool | None = False,
@@ -1705,7 +1762,7 @@ def gpencil_export_svg(
1705
1762
 
1706
1763
  THUMBNAIL
1707
1764
  Thumbnails -- Display files as thumbnails.
1708
- :type display_type: str | None
1765
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
1709
1766
  :param sort_method: File sorting mode
1710
1767
  :type sort_method: str | None
1711
1768
  :param use_fill: Fill, Export strokes with fill enabled
@@ -1720,7 +1777,7 @@ def gpencil_export_svg(
1720
1777
 
1721
1778
  VISIBLE
1722
1779
  Visible -- Include all visible objects.
1723
- :type selected_object_type: str | None
1780
+ :type selected_object_type: typing.Literal['ACTIVE','SELECTED','VISIBLE'] | None
1724
1781
  :param stroke_sample: Sampling, Precision of stroke sampling. Low values mean a more precise result, and zero disables sampling
1725
1782
  :type stroke_sample: float | None
1726
1783
  :param use_normalized_thickness: Normalize, Export strokes with constant thickness
@@ -1760,7 +1817,10 @@ def gpencil_import_svg(
1760
1817
  filter_blenlib: bool | None = False,
1761
1818
  filemode: int | None = 8,
1762
1819
  relative_path: bool | None = True,
1763
- display_type: str | None = "DEFAULT",
1820
+ display_type: typing.Literal[
1821
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
1822
+ ]
1823
+ | None = "DEFAULT",
1764
1824
  sort_method: str | None = "",
1765
1825
  resolution: int | None = 10,
1766
1826
  scale: float | None = 10.0,
@@ -1829,7 +1889,7 @@ def gpencil_import_svg(
1829
1889
 
1830
1890
  THUMBNAIL
1831
1891
  Thumbnails -- Display files as thumbnails.
1832
- :type display_type: str | None
1892
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
1833
1893
  :param sort_method: File sorting mode
1834
1894
  :type sort_method: str | None
1835
1895
  :param resolution: Resolution, Resolution of the generated strokes
@@ -1990,7 +2050,10 @@ def lib_reload(
1990
2050
  filter_blenlib: bool | None = False,
1991
2051
  filemode: int | None = 8,
1992
2052
  relative_path: bool | None = True,
1993
- display_type: str | None = "DEFAULT",
2053
+ display_type: typing.Literal[
2054
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
2055
+ ]
2056
+ | None = "DEFAULT",
1994
2057
  sort_method: str | None = "",
1995
2058
  ):
1996
2059
  """Reload the given library
@@ -2061,7 +2124,7 @@ def lib_reload(
2061
2124
 
2062
2125
  THUMBNAIL
2063
2126
  Thumbnails -- Display files as thumbnails.
2064
- :type display_type: str | None
2127
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
2065
2128
  :param sort_method: File sorting mode
2066
2129
  :type sort_method: str | None
2067
2130
  """
@@ -2100,7 +2163,10 @@ def lib_relocate(
2100
2163
  filter_blenlib: bool | None = False,
2101
2164
  filemode: int | None = 8,
2102
2165
  relative_path: bool | None = True,
2103
- display_type: str | None = "DEFAULT",
2166
+ display_type: typing.Literal[
2167
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
2168
+ ]
2169
+ | None = "DEFAULT",
2104
2170
  sort_method: str | None = "",
2105
2171
  ):
2106
2172
  """Relocate the given library to one or several others
@@ -2173,7 +2239,7 @@ def lib_relocate(
2173
2239
 
2174
2240
  THUMBNAIL
2175
2241
  Thumbnails -- Display files as thumbnails.
2176
- :type display_type: str | None
2242
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
2177
2243
  :param sort_method: File sorting mode
2178
2244
  :type sort_method: str | None
2179
2245
  """
@@ -2210,7 +2276,10 @@ def link(
2210
2276
  filter_blenlib: bool | None = True,
2211
2277
  filemode: int | None = 1,
2212
2278
  relative_path: bool | None = True,
2213
- display_type: str | None = "DEFAULT",
2279
+ display_type: typing.Literal[
2280
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
2281
+ ]
2282
+ | None = "DEFAULT",
2214
2283
  sort_method: str | None = "",
2215
2284
  link: bool | None = True,
2216
2285
  do_reuse_local_id: bool | None = False,
@@ -2286,7 +2355,7 @@ def link(
2286
2355
 
2287
2356
  THUMBNAIL
2288
2357
  Thumbnails -- Display files as thumbnails.
2289
- :type display_type: str | None
2358
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
2290
2359
  :param sort_method: File sorting mode
2291
2360
  :type sort_method: str | None
2292
2361
  :param link: Link, Link the objects or data-blocks rather than appending
@@ -2346,23 +2415,32 @@ def obj_export(
2346
2415
  filter_folder: bool | None = True,
2347
2416
  filter_blenlib: bool | None = False,
2348
2417
  filemode: int | None = 8,
2349
- display_type: str | None = "DEFAULT",
2418
+ display_type: typing.Literal[
2419
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
2420
+ ]
2421
+ | None = "DEFAULT",
2350
2422
  sort_method: str | None = "",
2351
2423
  export_animation: bool | None = False,
2352
2424
  start_frame: int | None = -2147483648,
2353
2425
  end_frame: int | None = 2147483647,
2354
- forward_axis: str | None = "NEGATIVE_Z",
2355
- up_axis: str | None = "Y",
2426
+ forward_axis: typing.Literal[
2427
+ "X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"
2428
+ ]
2429
+ | None = "NEGATIVE_Z",
2430
+ up_axis: typing.Literal["X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"]
2431
+ | None = "Y",
2356
2432
  global_scale: float | None = 1.0,
2357
2433
  apply_modifiers: bool | None = True,
2358
- export_eval_mode: str | None = "DAG_EVAL_VIEWPORT",
2434
+ export_eval_mode: typing.Literal["DAG_EVAL_RENDER", "DAG_EVAL_VIEWPORT"]
2435
+ | None = "DAG_EVAL_VIEWPORT",
2359
2436
  export_selected_objects: bool | None = False,
2360
2437
  export_uv: bool | None = True,
2361
2438
  export_normals: bool | None = True,
2362
2439
  export_colors: bool | None = False,
2363
2440
  export_materials: bool | None = True,
2364
2441
  export_pbr_extensions: bool | None = False,
2365
- path_mode: str | None = "AUTO",
2442
+ path_mode: typing.Literal["AUTO", "ABSOLUTE", "RELATIVE", "MATCH", "STRIP", "COPY"]
2443
+ | None = "AUTO",
2366
2444
  export_triangulated_mesh: bool | None = False,
2367
2445
  export_curves_as_nurbs: bool | None = False,
2368
2446
  export_object_groups: bool | None = False,
@@ -2431,7 +2509,7 @@ def obj_export(
2431
2509
 
2432
2510
  THUMBNAIL
2433
2511
  Thumbnails -- Display files as thumbnails.
2434
- :type display_type: str | None
2512
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
2435
2513
  :param sort_method: File sorting mode
2436
2514
  :type sort_method: str | None
2437
2515
  :param export_animation: Export Animation, Export multiple frames instead of the current frame only
@@ -2459,7 +2537,7 @@ def obj_export(
2459
2537
 
2460
2538
  NEGATIVE_Z
2461
2539
  -Z -- Negative Z axis.
2462
- :type forward_axis: str | None
2540
+ :type forward_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
2463
2541
  :param up_axis: Up Axis
2464
2542
 
2465
2543
  X
@@ -2479,7 +2557,7 @@ def obj_export(
2479
2557
 
2480
2558
  NEGATIVE_Z
2481
2559
  -Z -- Negative Z axis.
2482
- :type up_axis: str | None
2560
+ :type up_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
2483
2561
  :param global_scale: Scale, Value by which to enlarge or shrink the objects with respect to the world's origin
2484
2562
  :type global_scale: float | None
2485
2563
  :param apply_modifiers: Apply Modifiers, Apply modifiers to exported meshes
@@ -2491,7 +2569,7 @@ def obj_export(
2491
2569
 
2492
2570
  DAG_EVAL_VIEWPORT
2493
2571
  Viewport -- Export objects as they appear in the viewport.
2494
- :type export_eval_mode: str | None
2572
+ :type export_eval_mode: typing.Literal['DAG_EVAL_RENDER','DAG_EVAL_VIEWPORT'] | None
2495
2573
  :param export_selected_objects: Export Selected Objects, Export only selected objects instead of all supported objects
2496
2574
  :type export_selected_objects: bool | None
2497
2575
  :param export_uv: Export UVs
@@ -2523,7 +2601,7 @@ def obj_export(
2523
2601
 
2524
2602
  COPY
2525
2603
  Copy -- Copy the file to the destination path.
2526
- :type path_mode: str | None
2604
+ :type path_mode: typing.Literal['AUTO','ABSOLUTE','RELATIVE','MATCH','STRIP','COPY'] | None
2527
2605
  :param export_triangulated_mesh: Export Triangulated Mesh, All ngons with four or more vertices will be triangulated. Meshes in the scene will not be affected. Behaves like Triangulate Modifier with ngon-method: "Beauty", quad-method: "Shortest Diagonal", min vertices: 4
2528
2606
  :type export_triangulated_mesh: bool | None
2529
2607
  :param export_curves_as_nurbs: Export Curves as NURBS, Export curves in parametric form instead of exporting as mesh
@@ -2574,12 +2652,19 @@ def obj_import(
2574
2652
  filter_folder: bool | None = True,
2575
2653
  filter_blenlib: bool | None = False,
2576
2654
  filemode: int | None = 8,
2577
- display_type: str | None = "DEFAULT",
2655
+ display_type: typing.Literal[
2656
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
2657
+ ]
2658
+ | None = "DEFAULT",
2578
2659
  sort_method: str | None = "",
2579
2660
  global_scale: float | None = 1.0,
2580
2661
  clamp_size: float | None = 0.0,
2581
- forward_axis: str | None = "NEGATIVE_Z",
2582
- up_axis: str | None = "Y",
2662
+ forward_axis: typing.Literal[
2663
+ "X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"
2664
+ ]
2665
+ | None = "NEGATIVE_Z",
2666
+ up_axis: typing.Literal["X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"]
2667
+ | None = "Y",
2583
2668
  use_split_objects: bool | None = True,
2584
2669
  use_split_groups: bool | None = False,
2585
2670
  import_vertex_groups: bool | None = False,
@@ -2649,7 +2734,7 @@ def obj_import(
2649
2734
 
2650
2735
  THUMBNAIL
2651
2736
  Thumbnails -- Display files as thumbnails.
2652
- :type display_type: str | None
2737
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
2653
2738
  :param sort_method: File sorting mode
2654
2739
  :type sort_method: str | None
2655
2740
  :param global_scale: Scale, Value by which to enlarge or shrink the objects with respect to the world's origin
@@ -2675,7 +2760,7 @@ def obj_import(
2675
2760
 
2676
2761
  NEGATIVE_Z
2677
2762
  -Z -- Negative Z axis.
2678
- :type forward_axis: str | None
2763
+ :type forward_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
2679
2764
  :param up_axis: Up Axis
2680
2765
 
2681
2766
  X
@@ -2695,7 +2780,7 @@ def obj_import(
2695
2780
 
2696
2781
  NEGATIVE_Z
2697
2782
  -Z -- Negative Z axis.
2698
- :type up_axis: str | None
2783
+ :type up_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
2699
2784
  :param use_split_objects: Split By Object, Import each OBJ 'o' as a separate object
2700
2785
  :type use_split_objects: bool | None
2701
2786
  :param use_split_groups: Split By Group, Import each OBJ 'g' as a separate object
@@ -2738,7 +2823,10 @@ def open_mainfile(
2738
2823
  filter_folder: bool | None = True,
2739
2824
  filter_blenlib: bool | None = False,
2740
2825
  filemode: int | None = 8,
2741
- display_type: str | None = "DEFAULT",
2826
+ display_type: typing.Literal[
2827
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
2828
+ ]
2829
+ | None = "DEFAULT",
2742
2830
  sort_method: str | None = "",
2743
2831
  load_ui: bool | None = True,
2744
2832
  use_scripts: bool | None = True,
@@ -2805,7 +2893,7 @@ def open_mainfile(
2805
2893
 
2806
2894
  THUMBNAIL
2807
2895
  Thumbnails -- Display files as thumbnails.
2808
- :type display_type: str | None
2896
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
2809
2897
  :param sort_method: File sorting mode
2810
2898
  :type sort_method: str | None
2811
2899
  :param load_ui: Load UI, Load user interface setup in the .blend file
@@ -2997,17 +3085,24 @@ def ply_export(
2997
3085
  filter_folder: bool | None = True,
2998
3086
  filter_blenlib: bool | None = False,
2999
3087
  filemode: int | None = 8,
3000
- display_type: str | None = "DEFAULT",
3088
+ display_type: typing.Literal[
3089
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
3090
+ ]
3091
+ | None = "DEFAULT",
3001
3092
  sort_method: str | None = "",
3002
- forward_axis: str | None = "Y",
3003
- up_axis: str | None = "Z",
3093
+ forward_axis: typing.Literal[
3094
+ "X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"
3095
+ ]
3096
+ | None = "Y",
3097
+ up_axis: typing.Literal["X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"]
3098
+ | None = "Z",
3004
3099
  global_scale: float | None = 1.0,
3005
3100
  apply_modifiers: bool | None = True,
3006
3101
  export_selected_objects: bool | None = False,
3007
3102
  collection: str = "",
3008
3103
  export_uv: bool | None = True,
3009
3104
  export_normals: bool | None = False,
3010
- export_colors: str | None = "SRGB",
3105
+ export_colors: typing.Literal["NONE", "SRGB", "LINEAR"] | None = "SRGB",
3011
3106
  export_attributes: bool | None = True,
3012
3107
  export_triangulated_mesh: bool | None = False,
3013
3108
  ascii_format: bool | None = False,
@@ -3071,7 +3166,7 @@ def ply_export(
3071
3166
 
3072
3167
  THUMBNAIL
3073
3168
  Thumbnails -- Display files as thumbnails.
3074
- :type display_type: str | None
3169
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
3075
3170
  :param sort_method: File sorting mode
3076
3171
  :type sort_method: str | None
3077
3172
  :param forward_axis: Forward Axis
@@ -3093,7 +3188,7 @@ def ply_export(
3093
3188
 
3094
3189
  NEGATIVE_Z
3095
3190
  -Z -- Negative Z axis.
3096
- :type forward_axis: str | None
3191
+ :type forward_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
3097
3192
  :param up_axis: Up Axis
3098
3193
 
3099
3194
  X
@@ -3113,7 +3208,7 @@ def ply_export(
3113
3208
 
3114
3209
  NEGATIVE_Z
3115
3210
  -Z -- Negative Z axis.
3116
- :type up_axis: str | None
3211
+ :type up_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
3117
3212
  :param global_scale: Scale, Value by which to enlarge or shrink the objects with respect to the world's origin
3118
3213
  :type global_scale: float | None
3119
3214
  :param apply_modifiers: Apply Modifiers, Apply modifiers to exported meshes
@@ -3136,7 +3231,7 @@ def ply_export(
3136
3231
 
3137
3232
  LINEAR
3138
3233
  Linear -- Vertex colors in the file are in linear color space.
3139
- :type export_colors: str | None
3234
+ :type export_colors: typing.Literal['NONE','SRGB','LINEAR'] | None
3140
3235
  :param export_attributes: Export Vertex Attributes, Export custom vertex attributes
3141
3236
  :type export_attributes: bool | None
3142
3237
  :param export_triangulated_mesh: Export Triangulated Mesh, All ngons with four or more vertices will be triangulated. Meshes in the scene will not be affected. Behaves like Triangulate Modifier with ngon-method: "Beauty", quad-method: "Shortest Diagonal", min vertices: 4
@@ -3177,14 +3272,21 @@ def ply_import(
3177
3272
  filter_folder: bool | None = True,
3178
3273
  filter_blenlib: bool | None = False,
3179
3274
  filemode: int | None = 8,
3180
- display_type: str | None = "DEFAULT",
3275
+ display_type: typing.Literal[
3276
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
3277
+ ]
3278
+ | None = "DEFAULT",
3181
3279
  sort_method: str | None = "",
3182
3280
  global_scale: float | None = 1.0,
3183
3281
  use_scene_unit: bool | None = False,
3184
- forward_axis: str | None = "Y",
3185
- up_axis: str | None = "Z",
3282
+ forward_axis: typing.Literal[
3283
+ "X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"
3284
+ ]
3285
+ | None = "Y",
3286
+ up_axis: typing.Literal["X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"]
3287
+ | None = "Z",
3186
3288
  merge_verts: bool | None = False,
3187
- import_colors: str | None = "SRGB",
3289
+ import_colors: typing.Literal["NONE", "SRGB", "LINEAR"] | None = "SRGB",
3188
3290
  import_attributes: bool | None = True,
3189
3291
  filter_glob: str = "*.ply",
3190
3292
  ):
@@ -3250,7 +3352,7 @@ def ply_import(
3250
3352
 
3251
3353
  THUMBNAIL
3252
3354
  Thumbnails -- Display files as thumbnails.
3253
- :type display_type: str | None
3355
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
3254
3356
  :param sort_method: File sorting mode
3255
3357
  :type sort_method: str | None
3256
3358
  :param global_scale: Scale
@@ -3276,7 +3378,7 @@ def ply_import(
3276
3378
 
3277
3379
  NEGATIVE_Z
3278
3380
  -Z -- Negative Z axis.
3279
- :type forward_axis: str | None
3381
+ :type forward_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
3280
3382
  :param up_axis: Up Axis
3281
3383
 
3282
3384
  X
@@ -3296,7 +3398,7 @@ def ply_import(
3296
3398
 
3297
3399
  NEGATIVE_Z
3298
3400
  -Z -- Negative Z axis.
3299
- :type up_axis: str | None
3401
+ :type up_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
3300
3402
  :param merge_verts: Merge Vertices, Merges vertices by distance
3301
3403
  :type merge_verts: bool | None
3302
3404
  :param import_colors: Vertex Colors, Import vertex color attributes
@@ -3309,7 +3411,7 @@ def ply_import(
3309
3411
 
3310
3412
  LINEAR
3311
3413
  Linear -- Vertex colors in the file are in linear color space.
3312
- :type import_colors: str | None
3414
+ :type import_colors: typing.Literal['NONE','SRGB','LINEAR'] | None
3313
3415
  :param import_attributes: Vertex Attributes, Import custom vertex attributes
3314
3416
  :type import_attributes: bool | None
3315
3417
  :param filter_glob: Extension Filter
@@ -3415,7 +3517,22 @@ def previews_clear(
3415
3517
  execution_context: int | str | None = None,
3416
3518
  undo: bool | None = None,
3417
3519
  *,
3418
- id_type: set[str] | None = {},
3520
+ id_type: set[
3521
+ typing.Literal[
3522
+ "ALL",
3523
+ "GEOMETRY",
3524
+ "SHADING",
3525
+ "SCENE",
3526
+ "COLLECTION",
3527
+ "OBJECT",
3528
+ "MATERIAL",
3529
+ "LIGHT",
3530
+ "WORLD",
3531
+ "TEXTURE",
3532
+ "IMAGE",
3533
+ ]
3534
+ ]
3535
+ | None = {},
3419
3536
  ):
3420
3537
  """Clear data-block previews (only for some types like objects, materials, textures, etc.)
3421
3538
 
@@ -3456,7 +3573,7 @@ def previews_clear(
3456
3573
 
3457
3574
  IMAGE
3458
3575
  Images.
3459
- :type id_type: set[str] | None
3576
+ :type id_type: set[typing.Literal['ALL','GEOMETRY','SHADING','SCENE','COLLECTION','OBJECT','MATERIAL','LIGHT','WORLD','TEXTURE','IMAGE']] | None
3460
3577
  """
3461
3578
 
3462
3579
  ...
@@ -3518,7 +3635,18 @@ def properties_edit(
3518
3635
  *,
3519
3636
  data_path: str = "",
3520
3637
  property_name: str = "",
3521
- property_type: str | None = "FLOAT",
3638
+ property_type: typing.Literal[
3639
+ "FLOAT",
3640
+ "FLOAT_ARRAY",
3641
+ "INT",
3642
+ "INT_ARRAY",
3643
+ "BOOL",
3644
+ "BOOL_ARRAY",
3645
+ "STRING",
3646
+ "DATA_BLOCK",
3647
+ "PYTHON",
3648
+ ]
3649
+ | None = "FLOAT",
3522
3650
  is_overridable_library: bool | None = False,
3523
3651
  description: str = "",
3524
3652
  use_soft_limits: bool | None = False,
@@ -3638,7 +3766,48 @@ def properties_edit(
3638
3766
  step_float: float | None = 0.1,
3639
3767
  subtype: str | None = "",
3640
3768
  default_string: str = "",
3641
- id_type: str | None = "OBJECT",
3769
+ id_type: typing.Literal[
3770
+ "ACTION",
3771
+ "ARMATURE",
3772
+ "BRUSH",
3773
+ "CACHEFILE",
3774
+ "CAMERA",
3775
+ "COLLECTION",
3776
+ "CURVE",
3777
+ "CURVES",
3778
+ "FONT",
3779
+ "GREASEPENCIL",
3780
+ "GREASEPENCIL_V3",
3781
+ "IMAGE",
3782
+ "KEY",
3783
+ "LATTICE",
3784
+ "LIBRARY",
3785
+ "LIGHT",
3786
+ "LIGHT_PROBE",
3787
+ "LINESTYLE",
3788
+ "MASK",
3789
+ "MATERIAL",
3790
+ "MESH",
3791
+ "META",
3792
+ "MOVIECLIP",
3793
+ "NODETREE",
3794
+ "OBJECT",
3795
+ "PAINTCURVE",
3796
+ "PALETTE",
3797
+ "PARTICLE",
3798
+ "POINTCLOUD",
3799
+ "SCENE",
3800
+ "SCREEN",
3801
+ "SOUND",
3802
+ "SPEAKER",
3803
+ "TEXT",
3804
+ "TEXTURE",
3805
+ "VOLUME",
3806
+ "WINDOWMANAGER",
3807
+ "WORKSPACE",
3808
+ "WORLD",
3809
+ ]
3810
+ | None = "OBJECT",
3642
3811
  eval_string: str = "",
3643
3812
  ):
3644
3813
  """Change a custom property's type, or adjust how it is displayed in the interface
@@ -3678,7 +3847,7 @@ def properties_edit(
3678
3847
 
3679
3848
  PYTHON
3680
3849
  Python -- Edit a Python value directly, for unsupported property types.
3681
- :type property_type: str | None
3850
+ :type property_type: typing.Literal['FLOAT','FLOAT_ARRAY','INT','INT_ARRAY','BOOL','BOOL_ARRAY','STRING','DATA_BLOCK','PYTHON'] | None
3682
3851
  :param is_overridable_library: Library Overridable, Allow the property to be overridden when the data-block is linked
3683
3852
  :type is_overridable_library: bool | None
3684
3853
  :param description: Description
@@ -3720,7 +3889,7 @@ def properties_edit(
3720
3889
  :param default_string: Default Value
3721
3890
  :type default_string: str
3722
3891
  :param id_type: ID Type
3723
- :type id_type: str | None
3892
+ :type id_type: typing.Literal['ACTION','ARMATURE','BRUSH','CACHEFILE','CAMERA','COLLECTION','CURVE','CURVES','FONT','GREASEPENCIL','GREASEPENCIL_V3','IMAGE','KEY','LATTICE','LIBRARY','LIGHT','LIGHT_PROBE','LINESTYLE','MASK','MATERIAL','MESH','META','MOVIECLIP','NODETREE','OBJECT','PAINTCURVE','PALETTE','PARTICLE','POINTCLOUD','SCENE','SCREEN','SOUND','SPEAKER','TEXT','TEXTURE','VOLUME','WINDOWMANAGER','WORKSPACE','WORLD'] | None
3724
3893
  :param eval_string: Value, Python value for unsupported custom property types
3725
3894
  :type eval_string: str
3726
3895
  """
@@ -3967,7 +4136,10 @@ def recover_auto_save(
3967
4136
  filter_folder: bool | None = False,
3968
4137
  filter_blenlib: bool | None = False,
3969
4138
  filemode: int | None = 8,
3970
- display_type: str | None = "LIST_VERTICAL",
4139
+ display_type: typing.Literal[
4140
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
4141
+ ]
4142
+ | None = "LIST_VERTICAL",
3971
4143
  sort_method: str | None = "",
3972
4144
  use_scripts: bool | None = True,
3973
4145
  ):
@@ -4031,7 +4203,7 @@ def recover_auto_save(
4031
4203
 
4032
4204
  THUMBNAIL
4033
4205
  Thumbnails -- Display files as thumbnails.
4034
- :type display_type: str | None
4206
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
4035
4207
  :param sort_method: File sorting mode
4036
4208
  :type sort_method: str | None
4037
4209
  :param use_scripts: Trusted Source, Allow .blend file to execute scripts automatically, default available from system preferences
@@ -4063,7 +4235,16 @@ def redraw_timer(
4063
4235
  execution_context: int | str | None = None,
4064
4236
  undo: bool | None = None,
4065
4237
  *,
4066
- type: str | None = "DRAW",
4238
+ type: typing.Literal[
4239
+ "DRAW",
4240
+ "DRAW_SWAP",
4241
+ "DRAW_WIN",
4242
+ "DRAW_WIN_SWAP",
4243
+ "ANIM_STEP",
4244
+ "ANIM_PLAY",
4245
+ "UNDO",
4246
+ ]
4247
+ | None = "DRAW",
4067
4248
  iterations: int | None = 10,
4068
4249
  time_limit: float | None = 0.0,
4069
4250
  ):
@@ -4094,7 +4275,7 @@ def redraw_timer(
4094
4275
 
4095
4276
  UNDO
4096
4277
  Undo/Redo -- Undo and redo.
4097
- :type type: str | None
4278
+ :type type: typing.Literal['DRAW','DRAW_SWAP','DRAW_WIN','DRAW_WIN_SWAP','ANIM_STEP','ANIM_PLAY','UNDO'] | None
4098
4279
  :param iterations: Iterations, Number of times to redraw
4099
4280
  :type iterations: int | None
4100
4281
  :param time_limit: Time Limit, Seconds to run the test for (override iterations)
@@ -4147,7 +4328,10 @@ def save_as_mainfile(
4147
4328
  filter_folder: bool | None = True,
4148
4329
  filter_blenlib: bool | None = False,
4149
4330
  filemode: int | None = 8,
4150
- display_type: str | None = "DEFAULT",
4331
+ display_type: typing.Literal[
4332
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
4333
+ ]
4334
+ | None = "DEFAULT",
4151
4335
  sort_method: str | None = "",
4152
4336
  compress: bool | None = False,
4153
4337
  relative_remap: bool | None = True,
@@ -4213,7 +4397,7 @@ def save_as_mainfile(
4213
4397
 
4214
4398
  THUMBNAIL
4215
4399
  Thumbnails -- Display files as thumbnails.
4216
- :type display_type: str | None
4400
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
4217
4401
  :param sort_method: File sorting mode
4218
4402
  :type sort_method: str | None
4219
4403
  :param compress: Compress, Write compressed .blend file
@@ -4266,7 +4450,10 @@ def save_mainfile(
4266
4450
  filter_folder: bool | None = True,
4267
4451
  filter_blenlib: bool | None = False,
4268
4452
  filemode: int | None = 8,
4269
- display_type: str | None = "DEFAULT",
4453
+ display_type: typing.Literal[
4454
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
4455
+ ]
4456
+ | None = "DEFAULT",
4270
4457
  sort_method: str | None = "",
4271
4458
  compress: bool | None = False,
4272
4459
  relative_remap: bool | None = False,
@@ -4333,7 +4520,7 @@ def save_mainfile(
4333
4520
 
4334
4521
  THUMBNAIL
4335
4522
  Thumbnails -- Display files as thumbnails.
4336
- :type display_type: str | None
4523
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
4337
4524
  :param sort_method: File sorting mode
4338
4525
  :type sort_method: str | None
4339
4526
  :param compress: Compress, Write compressed .blend file
@@ -4416,9 +4603,16 @@ def set_stereo_3d(
4416
4603
  execution_context: int | str | None = None,
4417
4604
  undo: bool | None = None,
4418
4605
  *,
4419
- display_mode: str | None = "ANAGLYPH",
4420
- anaglyph_type: str | None = "RED_CYAN",
4421
- interlace_type: str | None = "ROW_INTERLEAVED",
4606
+ display_mode: typing.Literal[
4607
+ "ANAGLYPH", "INTERLACE", "TIMESEQUENTIAL", "SIDEBYSIDE", "TOPBOTTOM"
4608
+ ]
4609
+ | None = "ANAGLYPH",
4610
+ anaglyph_type: typing.Literal["RED_CYAN", "GREEN_MAGENTA", "YELLOW_BLUE"]
4611
+ | None = "RED_CYAN",
4612
+ interlace_type: typing.Literal[
4613
+ "ROW_INTERLEAVED", "COLUMN_INTERLEAVED", "CHECKERBOARD_INTERLEAVED"
4614
+ ]
4615
+ | None = "ROW_INTERLEAVED",
4422
4616
  use_interlace_swap: bool | None = False,
4423
4617
  use_sidebyside_crosseyed: bool | None = False,
4424
4618
  ):
@@ -4428,11 +4622,11 @@ def set_stereo_3d(
4428
4622
  :type execution_context: int | str | None
4429
4623
  :type undo: bool | None
4430
4624
  :param display_mode: Display Mode
4431
- :type display_mode: str | None
4625
+ :type display_mode: typing.Literal['ANAGLYPH', 'INTERLACE', 'TIMESEQUENTIAL', 'SIDEBYSIDE', 'TOPBOTTOM'] | None
4432
4626
  :param anaglyph_type: Anaglyph Type
4433
- :type anaglyph_type: str | None
4627
+ :type anaglyph_type: typing.Literal['RED_CYAN', 'GREEN_MAGENTA', 'YELLOW_BLUE'] | None
4434
4628
  :param interlace_type: Interlace Type
4435
- :type interlace_type: str | None
4629
+ :type interlace_type: typing.Literal['ROW_INTERLEAVED', 'COLUMN_INTERLEAVED', 'CHECKERBOARD_INTERLEAVED'] | None
4436
4630
  :param use_interlace_swap: Swap Left/Right, Swap left and right stereo channels
4437
4631
  :type use_interlace_swap: bool | None
4438
4632
  :param use_sidebyside_crosseyed: Cross-Eyed, Right eye should see left image and vice versa
@@ -4494,7 +4688,10 @@ def stl_export(
4494
4688
  filter_folder: bool | None = True,
4495
4689
  filter_blenlib: bool | None = False,
4496
4690
  filemode: int | None = 8,
4497
- display_type: str | None = "DEFAULT",
4691
+ display_type: typing.Literal[
4692
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
4693
+ ]
4694
+ | None = "DEFAULT",
4498
4695
  sort_method: str | None = "",
4499
4696
  ascii_format: bool | None = False,
4500
4697
  use_batch: bool | None = False,
@@ -4502,8 +4699,12 @@ def stl_export(
4502
4699
  collection: str = "",
4503
4700
  global_scale: float | None = 1.0,
4504
4701
  use_scene_unit: bool | None = False,
4505
- forward_axis: str | None = "Y",
4506
- up_axis: str | None = "Z",
4702
+ forward_axis: typing.Literal[
4703
+ "X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"
4704
+ ]
4705
+ | None = "Y",
4706
+ up_axis: typing.Literal["X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"]
4707
+ | None = "Z",
4507
4708
  apply_modifiers: bool | None = True,
4508
4709
  filter_glob: str = "*.stl",
4509
4710
  ):
@@ -4565,7 +4766,7 @@ def stl_export(
4565
4766
 
4566
4767
  THUMBNAIL
4567
4768
  Thumbnails -- Display files as thumbnails.
4568
- :type display_type: str | None
4769
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
4569
4770
  :param sort_method: File sorting mode
4570
4771
  :type sort_method: str | None
4571
4772
  :param ascii_format: ASCII Format, Export file in ASCII format, export as binary otherwise
@@ -4599,7 +4800,7 @@ def stl_export(
4599
4800
 
4600
4801
  NEGATIVE_Z
4601
4802
  -Z -- Negative Z axis.
4602
- :type forward_axis: str | None
4803
+ :type forward_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
4603
4804
  :param up_axis: Up Axis
4604
4805
 
4605
4806
  X
@@ -4619,7 +4820,7 @@ def stl_export(
4619
4820
 
4620
4821
  NEGATIVE_Z
4621
4822
  -Z -- Negative Z axis.
4622
- :type up_axis: str | None
4823
+ :type up_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
4623
4824
  :param apply_modifiers: Apply Modifiers, Apply modifiers to exported meshes
4624
4825
  :type apply_modifiers: bool | None
4625
4826
  :param filter_glob: Extension Filter
@@ -4656,13 +4857,20 @@ def stl_import(
4656
4857
  filter_folder: bool | None = True,
4657
4858
  filter_blenlib: bool | None = False,
4658
4859
  filemode: int | None = 8,
4659
- display_type: str | None = "DEFAULT",
4860
+ display_type: typing.Literal[
4861
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
4862
+ ]
4863
+ | None = "DEFAULT",
4660
4864
  sort_method: str | None = "",
4661
4865
  global_scale: float | None = 1.0,
4662
4866
  use_scene_unit: bool | None = False,
4663
4867
  use_facet_normal: bool | None = False,
4664
- forward_axis: str | None = "Y",
4665
- up_axis: str | None = "Z",
4868
+ forward_axis: typing.Literal[
4869
+ "X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"
4870
+ ]
4871
+ | None = "Y",
4872
+ up_axis: typing.Literal["X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"]
4873
+ | None = "Z",
4666
4874
  use_mesh_validate: bool | None = True,
4667
4875
  filter_glob: str = "*.stl",
4668
4876
  ):
@@ -4728,7 +4936,7 @@ def stl_import(
4728
4936
 
4729
4937
  THUMBNAIL
4730
4938
  Thumbnails -- Display files as thumbnails.
4731
- :type display_type: str | None
4939
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
4732
4940
  :param sort_method: File sorting mode
4733
4941
  :type sort_method: str | None
4734
4942
  :param global_scale: Scale
@@ -4756,7 +4964,7 @@ def stl_import(
4756
4964
 
4757
4965
  NEGATIVE_Z
4758
4966
  -Z -- Negative Z axis.
4759
- :type forward_axis: str | None
4967
+ :type forward_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
4760
4968
  :param up_axis: Up Axis
4761
4969
 
4762
4970
  X
@@ -4776,7 +4984,7 @@ def stl_import(
4776
4984
 
4777
4985
  NEGATIVE_Z
4778
4986
  -Z -- Negative Z axis.
4779
- :type up_axis: str | None
4987
+ :type up_axis: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
4780
4988
  :param use_mesh_validate: Validate Mesh, Ensure the data is valid (when disabled, data may be imported which causes crashes displaying or editing)
4781
4989
  :type use_mesh_validate: bool | None
4782
4990
  :param filter_glob: Extension Filter
@@ -4811,7 +5019,28 @@ def tool_set_by_id(
4811
5019
  name: str = "",
4812
5020
  cycle: bool | None = False,
4813
5021
  as_fallback: bool | None = False,
4814
- space_type: str | None = "EMPTY",
5022
+ space_type: typing.Literal[
5023
+ "EMPTY",
5024
+ "VIEW_3D",
5025
+ "IMAGE_EDITOR",
5026
+ "NODE_EDITOR",
5027
+ "SEQUENCE_EDITOR",
5028
+ "CLIP_EDITOR",
5029
+ "DOPESHEET_EDITOR",
5030
+ "GRAPH_EDITOR",
5031
+ "NLA_EDITOR",
5032
+ "TEXT_EDITOR",
5033
+ "CONSOLE",
5034
+ "INFO",
5035
+ "TOPBAR",
5036
+ "STATUSBAR",
5037
+ "OUTLINER",
5038
+ "PROPERTIES",
5039
+ "FILE_BROWSER",
5040
+ "SPREADSHEET",
5041
+ "PREFERENCES",
5042
+ ]
5043
+ | None = "EMPTY",
4815
5044
  ):
4816
5045
  """Set the tool by name (for key-maps)
4817
5046
 
@@ -4825,7 +5054,7 @@ def tool_set_by_id(
4825
5054
  :param as_fallback: Set Fallback, Set the fallback tool instead of the primary tool
4826
5055
  :type as_fallback: bool | None
4827
5056
  :param space_type: Type
4828
- :type space_type: str | None
5057
+ :type space_type: typing.Literal['EMPTY','VIEW_3D','IMAGE_EDITOR','NODE_EDITOR','SEQUENCE_EDITOR','CLIP_EDITOR','DOPESHEET_EDITOR','GRAPH_EDITOR','NLA_EDITOR','TEXT_EDITOR','CONSOLE','INFO','TOPBAR','STATUSBAR','OUTLINER','PROPERTIES','FILE_BROWSER','SPREADSHEET','PREFERENCES'] | None
4829
5058
  """
4830
5059
 
4831
5060
  ...
@@ -4839,7 +5068,28 @@ def tool_set_by_index(
4839
5068
  cycle: bool | None = False,
4840
5069
  expand: bool | None = True,
4841
5070
  as_fallback: bool | None = False,
4842
- space_type: str | None = "EMPTY",
5071
+ space_type: typing.Literal[
5072
+ "EMPTY",
5073
+ "VIEW_3D",
5074
+ "IMAGE_EDITOR",
5075
+ "NODE_EDITOR",
5076
+ "SEQUENCE_EDITOR",
5077
+ "CLIP_EDITOR",
5078
+ "DOPESHEET_EDITOR",
5079
+ "GRAPH_EDITOR",
5080
+ "NLA_EDITOR",
5081
+ "TEXT_EDITOR",
5082
+ "CONSOLE",
5083
+ "INFO",
5084
+ "TOPBAR",
5085
+ "STATUSBAR",
5086
+ "OUTLINER",
5087
+ "PROPERTIES",
5088
+ "FILE_BROWSER",
5089
+ "SPREADSHEET",
5090
+ "PREFERENCES",
5091
+ ]
5092
+ | None = "EMPTY",
4843
5093
  ):
4844
5094
  """Set the tool by index (for key-maps)
4845
5095
 
@@ -4855,7 +5105,7 @@ def tool_set_by_index(
4855
5105
  :param as_fallback: Set Fallback, Set the fallback tool instead of the primary
4856
5106
  :type as_fallback: bool | None
4857
5107
  :param space_type: Type
4858
- :type space_type: str | None
5108
+ :type space_type: typing.Literal['EMPTY','VIEW_3D','IMAGE_EDITOR','NODE_EDITOR','SEQUENCE_EDITOR','CLIP_EDITOR','DOPESHEET_EDITOR','GRAPH_EDITOR','NLA_EDITOR','TEXT_EDITOR','CONSOLE','INFO','TOPBAR','STATUSBAR','OUTLINER','PROPERTIES','FILE_BROWSER','SPREADSHEET','PREFERENCES'] | None
4859
5109
  """
4860
5110
 
4861
5111
  ...
@@ -4963,7 +5213,10 @@ def usd_export(
4963
5213
  filter_folder: bool | None = True,
4964
5214
  filter_blenlib: bool | None = False,
4965
5215
  filemode: int | None = 8,
4966
- display_type: str | None = "DEFAULT",
5216
+ display_type: typing.Literal[
5217
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
5218
+ ]
5219
+ | None = "DEFAULT",
4967
5220
  sort_method: str | None = "",
4968
5221
  filter_glob: str = "*.usd",
4969
5222
  selected_objects_only: bool | None = False,
@@ -4976,22 +5229,29 @@ def usd_export(
4976
5229
  export_mesh_colors: bool | None = True,
4977
5230
  export_normals: bool | None = True,
4978
5231
  export_materials: bool | None = True,
4979
- export_subdivision: str | None = "BEST_MATCH",
5232
+ export_subdivision: typing.Literal["IGNORE", "TESSELLATE", "BEST_MATCH"]
5233
+ | None = "BEST_MATCH",
4980
5234
  export_armatures: bool | None = True,
4981
5235
  only_deform_bones: bool | None = False,
4982
5236
  export_shapekeys: bool | None = True,
4983
5237
  use_instancing: bool | None = False,
4984
- evaluation_mode: str | None = "RENDER",
5238
+ evaluation_mode: typing.Literal["RENDER", "VIEWPORT"] | None = "RENDER",
4985
5239
  generate_preview_surface: bool | None = True,
4986
5240
  generate_materialx_network: bool | None = False,
4987
5241
  convert_orientation: bool | None = False,
4988
- export_global_forward_selection: str | None = "NEGATIVE_Z",
4989
- export_global_up_selection: str | None = "Y",
5242
+ export_global_forward_selection: typing.Literal[
5243
+ "X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"
5244
+ ]
5245
+ | None = "NEGATIVE_Z",
5246
+ export_global_up_selection: typing.Literal[
5247
+ "X", "Y", "Z", "NEGATIVE_X", "NEGATIVE_Y", "NEGATIVE_Z"
5248
+ ]
5249
+ | None = "Y",
4990
5250
  export_textures: bool | None = False,
4991
- export_textures_mode: str | None = "NEW",
5251
+ export_textures_mode: typing.Literal["KEEP", "PRESERVE", "NEW"] | None = "NEW",
4992
5252
  overwrite_textures: bool | None = False,
4993
5253
  relative_paths: bool | None = True,
4994
- xform_op_mode: str | None = "TRS",
5254
+ xform_op_mode: typing.Literal["TRS", "TOS", "MAT"] | None = "TRS",
4995
5255
  root_prim_path: str = "/root",
4996
5256
  export_custom_properties: bool | None = True,
4997
5257
  custom_properties_namespace: str = "userProperties",
@@ -5004,9 +5264,15 @@ def usd_export(
5004
5264
  export_curves: bool | None = True,
5005
5265
  export_volumes: bool | None = True,
5006
5266
  triangulate_meshes: bool | None = False,
5007
- quad_method: str | None = "SHORTEST_DIAGONAL",
5008
- ngon_method: str | None = "BEAUTY",
5009
- usdz_downscale_size: str | None = "KEEP",
5267
+ quad_method: typing.Literal[
5268
+ "BEAUTY", "FIXED", "FIXED_ALTERNATE", "SHORTEST_DIAGONAL", "LONGEST_DIAGONAL"
5269
+ ]
5270
+ | None = "SHORTEST_DIAGONAL",
5271
+ ngon_method: typing.Literal["BEAUTY", "CLIP"] | None = "BEAUTY",
5272
+ usdz_downscale_size: typing.Literal[
5273
+ "KEEP", "256", "512", "1024", "2048", "4096", "CUSTOM"
5274
+ ]
5275
+ | None = "KEEP",
5010
5276
  usdz_downscale_custom_size: int | None = 128,
5011
5277
  ):
5012
5278
  """Export current scene in a USD archive
@@ -5067,7 +5333,7 @@ def usd_export(
5067
5333
 
5068
5334
  THUMBNAIL
5069
5335
  Thumbnails -- Display files as thumbnails.
5070
- :type display_type: str | None
5336
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
5071
5337
  :param sort_method: File sorting mode
5072
5338
  :type sort_method: str | None
5073
5339
  :type filter_glob: str
@@ -5101,7 +5367,7 @@ def usd_export(
5101
5367
 
5102
5368
  BEST_MATCH
5103
5369
  Best Match -- Scheme = Catmull-Clark, when possible. Reverts to exporting the subdivided mesh for the Simple subdivision type.
5104
- :type export_subdivision: str | None
5370
+ :type export_subdivision: typing.Literal['IGNORE','TESSELLATE','BEST_MATCH'] | None
5105
5371
  :param export_armatures: Armatures, Export armatures and meshes with armature modifiers as USD skeletons and skinned meshes
5106
5372
  :type export_armatures: bool | None
5107
5373
  :param only_deform_bones: Only Deform Bones, Only export deform bones and their parents
@@ -5117,7 +5383,7 @@ def usd_export(
5117
5383
 
5118
5384
  VIEWPORT
5119
5385
  Viewport -- Use Viewport settings for object visibility, modifier settings, etc.
5120
- :type evaluation_mode: str | None
5386
+ :type evaluation_mode: typing.Literal['RENDER','VIEWPORT'] | None
5121
5387
  :param generate_preview_surface: USD Preview Surface Network, Generate an approximate USD Preview Surface shader representation of a Principled BSDF node network
5122
5388
  :type generate_preview_surface: bool | None
5123
5389
  :param generate_materialx_network: MaterialX Network, Generate a MaterialX network representation of the materials
@@ -5143,7 +5409,7 @@ def usd_export(
5143
5409
 
5144
5410
  NEGATIVE_Z
5145
5411
  -Z -- Negative Z axis.
5146
- :type export_global_forward_selection: str | None
5412
+ :type export_global_forward_selection: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
5147
5413
  :param export_global_up_selection: Up Axis
5148
5414
 
5149
5415
  X
@@ -5163,7 +5429,7 @@ def usd_export(
5163
5429
 
5164
5430
  NEGATIVE_Z
5165
5431
  -Z -- Negative Z axis.
5166
- :type export_global_up_selection: str | None
5432
+ :type export_global_up_selection: typing.Literal['X','Y','Z','NEGATIVE_X','NEGATIVE_Y','NEGATIVE_Z'] | None
5167
5433
  :param export_textures: Export Textures, If exporting materials, export textures referenced by material nodes to a 'textures' directory in the same directory as the USD file
5168
5434
  :type export_textures: bool | None
5169
5435
  :param export_textures_mode: Export Textures, Texture export method
@@ -5176,7 +5442,7 @@ def usd_export(
5176
5442
 
5177
5443
  NEW
5178
5444
  New Path -- Export textures to a 'textures' folder next to the USD file.
5179
- :type export_textures_mode: str | None
5445
+ :type export_textures_mode: typing.Literal['KEEP','PRESERVE','NEW'] | None
5180
5446
  :param overwrite_textures: Overwrite Textures, Overwrite existing files when exporting textures
5181
5447
  :type overwrite_textures: bool | None
5182
5448
  :param relative_paths: Relative Paths, Use relative paths to reference external files (i.e. textures, volumes) in USD, otherwise use absolute paths
@@ -5191,7 +5457,7 @@ def usd_export(
5191
5457
 
5192
5458
  MAT
5193
5459
  Matrix -- Export matrix operator.
5194
- :type xform_op_mode: str | None
5460
+ :type xform_op_mode: typing.Literal['TRS','TOS','MAT'] | None
5195
5461
  :param root_prim_path: Root Prim, If set, add a transform primitive with the given path to the stage as the parent of all exported data
5196
5462
  :type root_prim_path: str
5197
5463
  :param export_custom_properties: Custom Properties, Export custom properties as USD attributes
@@ -5217,9 +5483,9 @@ def usd_export(
5217
5483
  :param triangulate_meshes: Triangulate Meshes, Triangulate meshes during export
5218
5484
  :type triangulate_meshes: bool | None
5219
5485
  :param quad_method: Quad Method, Method for splitting the quads into triangles
5220
- :type quad_method: str | None
5486
+ :type quad_method: typing.Literal['BEAUTY', 'FIXED', 'FIXED_ALTERNATE', 'SHORTEST_DIAGONAL', 'LONGEST_DIAGONAL'] | None
5221
5487
  :param ngon_method: N-gon Method, Method for splitting the n-gons into triangles
5222
- :type ngon_method: str | None
5488
+ :type ngon_method: typing.Literal['BEAUTY', 'CLIP'] | None
5223
5489
  :param usdz_downscale_size: USDZ Texture Downsampling, Choose a maximum size for all exported textures
5224
5490
 
5225
5491
  KEEP
@@ -5242,7 +5508,7 @@ def usd_export(
5242
5508
 
5243
5509
  CUSTOM
5244
5510
  Custom -- Specify a custom size.
5245
- :type usdz_downscale_size: str | None
5511
+ :type usdz_downscale_size: typing.Literal['KEEP','256','512','1024','2048','4096','CUSTOM'] | None
5246
5512
  :param usdz_downscale_custom_size: USDZ Custom Downscale Size, Custom size for downscaling exported textures
5247
5513
  :type usdz_downscale_custom_size: int | None
5248
5514
  """
@@ -5275,7 +5541,10 @@ def usd_import(
5275
5541
  filter_blenlib: bool | None = False,
5276
5542
  filemode: int | None = 8,
5277
5543
  relative_path: bool | None = True,
5278
- display_type: str | None = "DEFAULT",
5544
+ display_type: typing.Literal[
5545
+ "DEFAULT", "LIST_VERTICAL", "LIST_HORIZONTAL", "THUMBNAIL"
5546
+ ]
5547
+ | None = "DEFAULT",
5279
5548
  sort_method: str | None = "",
5280
5549
  filter_glob: str = "*.usd",
5281
5550
  scale: float | None = 1.0,
@@ -5305,11 +5574,14 @@ def usd_import(
5305
5574
  import_usd_preview: bool | None = True,
5306
5575
  set_material_blend: bool | None = True,
5307
5576
  light_intensity_scale: float | None = 1.0,
5308
- mtl_name_collision_mode: str | None = "MAKE_UNIQUE",
5309
- import_textures_mode: str | None = "IMPORT_PACK",
5577
+ mtl_name_collision_mode: typing.Literal["MAKE_UNIQUE", "REFERENCE_EXISTING"]
5578
+ | None = "MAKE_UNIQUE",
5579
+ import_textures_mode: typing.Literal["IMPORT_NONE", "IMPORT_PACK", "IMPORT_COPY"]
5580
+ | None = "IMPORT_PACK",
5310
5581
  import_textures_dir: str = "//textures/",
5311
- tex_name_collision_mode: str | None = "USE_EXISTING",
5312
- attr_import_mode: str | None = "ALL",
5582
+ tex_name_collision_mode: typing.Literal["USE_EXISTING", "OVERWRITE"]
5583
+ | None = "USE_EXISTING",
5584
+ attr_import_mode: typing.Literal["NONE", "USER", "ALL"] | None = "ALL",
5313
5585
  validate_meshes: bool | None = False,
5314
5586
  create_world_material: bool | None = True,
5315
5587
  import_defined_only: bool | None = True,
@@ -5374,7 +5646,7 @@ def usd_import(
5374
5646
 
5375
5647
  THUMBNAIL
5376
5648
  Thumbnails -- Display files as thumbnails.
5377
- :type display_type: str | None
5649
+ :type display_type: typing.Literal['DEFAULT','LIST_VERTICAL','LIST_HORIZONTAL','THUMBNAIL'] | None
5378
5650
  :param sort_method: File sorting mode
5379
5651
  :type sort_method: str | None
5380
5652
  :type filter_glob: str
@@ -5439,7 +5711,7 @@ def usd_import(
5439
5711
 
5440
5712
  REFERENCE_EXISTING
5441
5713
  Reference Existing -- If a material with the same name already exists, reference that instead of importing.
5442
- :type mtl_name_collision_mode: str | None
5714
+ :type mtl_name_collision_mode: typing.Literal['MAKE_UNIQUE','REFERENCE_EXISTING'] | None
5443
5715
  :param import_textures_mode: Import Textures, Behavior when importing textures from a USDZ archive
5444
5716
 
5445
5717
  IMPORT_NONE
@@ -5450,7 +5722,7 @@ def usd_import(
5450
5722
 
5451
5723
  IMPORT_COPY
5452
5724
  Copy -- Copy files to textures directory.
5453
- :type import_textures_mode: str | None
5725
+ :type import_textures_mode: typing.Literal['IMPORT_NONE','IMPORT_PACK','IMPORT_COPY'] | None
5454
5726
  :param import_textures_dir: Textures Directory, Path to the directory where imported textures will be copied
5455
5727
  :type import_textures_dir: str
5456
5728
  :param tex_name_collision_mode: File Name Collision, Behavior when the name of an imported texture file conflicts with an existing file
@@ -5460,7 +5732,7 @@ def usd_import(
5460
5732
 
5461
5733
  OVERWRITE
5462
5734
  Overwrite -- Overwrite existing files.
5463
- :type tex_name_collision_mode: str | None
5735
+ :type tex_name_collision_mode: typing.Literal['USE_EXISTING','OVERWRITE'] | None
5464
5736
  :param attr_import_mode: Custom Properties, Behavior when importing USD attributes as Blender custom properties
5465
5737
 
5466
5738
  NONE
@@ -5471,7 +5743,7 @@ def usd_import(
5471
5743
 
5472
5744
  ALL
5473
5745
  All Custom -- Import all USD custom attributes as Blender custom properties. Namespaces will be retained in the property names.
5474
- :type attr_import_mode: str | None
5746
+ :type attr_import_mode: typing.Literal['NONE','USER','ALL'] | None
5475
5747
  :param validate_meshes: Validate Meshes, Ensure the data is valid (when disabled, data may be imported which causes crashes displaying or editing)
5476
5748
  :type validate_meshes: bool | None
5477
5749
  :param create_world_material: Create World Material, Convert the first discovered USD dome light to a world background shader
@@ -5543,7 +5815,22 @@ def xr_navigation_fly(
5543
5815
  execution_context: int | str | None = None,
5544
5816
  undo: bool | None = None,
5545
5817
  *,
5546
- mode: str | None = "VIEWER_FORWARD",
5818
+ mode: typing.Literal[
5819
+ "FORWARD",
5820
+ "BACK",
5821
+ "LEFT",
5822
+ "RIGHT",
5823
+ "UP",
5824
+ "DOWN",
5825
+ "TURNLEFT",
5826
+ "TURNRIGHT",
5827
+ "VIEWER_FORWARD",
5828
+ "VIEWER_BACK",
5829
+ "VIEWER_LEFT",
5830
+ "VIEWER_RIGHT",
5831
+ "CONTROLLER_FORWARD",
5832
+ ]
5833
+ | None = "VIEWER_FORWARD",
5547
5834
  lock_location_z: bool | None = False,
5548
5835
  lock_direction: bool | None = False,
5549
5836
  speed_frame_based: bool | None = True,
@@ -5603,7 +5890,7 @@ def xr_navigation_fly(
5603
5890
 
5604
5891
  CONTROLLER_FORWARD
5605
5892
  Controller Forward -- Move along controller's forward axis.
5606
- :type mode: str | None
5893
+ :type mode: typing.Literal['FORWARD','BACK','LEFT','RIGHT','UP','DOWN','TURNLEFT','TURNRIGHT','VIEWER_FORWARD','VIEWER_BACK','VIEWER_LEFT','VIEWER_RIGHT','CONTROLLER_FORWARD'] | None
5607
5894
  :param lock_location_z: Lock Elevation, Prevent changes to viewer elevation
5608
5895
  :type lock_location_z: bool | None
5609
5896
  :param lock_direction: Lock Direction, Limit movement to viewer's initial direction