Import Scene Operators

bpy.ops.import_scene.autodesk_3ds(filepath="", filter_glob="*.3ds", constrain_size=10.0, use_image_search=True, use_apply_transform=True, axis_forward='Y', axis_up='Z')

Import from 3DS file format (.3ds)

Parameters:
  • filepath (string, (optional, never None)) – File Path, Filepath used for importing the file
  • filter_glob (string, (optional, never None)) – filter_glob
  • constrain_size (float in [0, 1000], (optional)) – Size Constraint, Scale the model by 10 until it reaches the size constraint (0 to disable)
  • use_image_search (boolean, (optional)) – Image Search, Search subdirectories for any associated images (Warning, may be slow)
  • use_apply_transform (boolean, (optional)) – Apply Transform, Workaround for object transformations importing incorrectly
  • axis_forward (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Forward
  • axis_up (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Up
File:

addons/io_scene_3ds/__init__.py:105

bpy.ops.import_scene.fbx(filepath="", directory="", filter_glob="*.fbx", use_manual_orientation=False, axis_forward='-Z', axis_up='Y', global_scale=1.0, use_image_search=True, use_alpha_decals=False, decal_offset=0.0)

Load a FBX geometry file

Parameters:
  • filepath (string, (optional, never None)) – File Path, Filepath used for importing the file
  • directory (string, (optional, never None)) – directory
  • filter_glob (string, (optional, never None)) – filter_glob
  • use_manual_orientation (boolean, (optional)) – Manual Orientation, Specify orientation and scale, instead of using embedded data in FBX file
  • axis_forward (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Forward
  • axis_up (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Up
  • global_scale (float in [0.001, 1000], (optional)) – Scale
  • use_image_search (boolean, (optional)) – Image Search, Search subdirs for any associated images (Warning, may be slow)
  • use_alpha_decals (boolean, (optional)) – Alpha Decals, Treat materials with alpha as decals (no shadow casting)
  • decal_offset (float in [0, 1], (optional)) – Decal Offset, Displace geometry of alpha meshes
File:

addons/io_scene_fbx/__init__.py:138

bpy.ops.import_scene.obj(filepath="", filter_glob="*.obj;*.mtl", use_ngons=True, use_edges=True, use_smooth_groups=True, use_split_objects=True, use_split_groups=True, use_groups_as_vgroups=False, use_image_search=True, split_mode='ON', global_clamp_size=0.0, axis_forward='-Z', axis_up='Y')

Load a Wavefront OBJ File

Parameters:
  • filepath (string, (optional, never None)) – File Path, Filepath used for importing the file
  • filter_glob (string, (optional, never None)) – filter_glob
  • use_ngons (boolean, (optional)) – NGons, Import faces with more than 4 verts as ngons
  • use_edges (boolean, (optional)) – Lines, Import lines and faces with 2 verts as edge
  • use_smooth_groups (boolean, (optional)) – Smooth Groups, Surround smooth groups by sharp edges
  • use_split_objects (boolean, (optional)) – Object, Import OBJ Objects into Blender Objects
  • use_split_groups (boolean, (optional)) – Group, Import OBJ Groups into Blender Objects
  • use_groups_as_vgroups (boolean, (optional)) – Poly Groups, Import OBJ groups as vertex groups
  • use_image_search (boolean, (optional)) – Image Search, Search subdirs for any associated images (Warning, may be slow)
  • split_mode (enum in [‘ON’, ‘OFF’], (optional)) –

    Split

    • ON Split, Split geometry, omits unused verts.
    • OFF Keep Vert Order, Keep vertex order from file.
  • global_clamp_size (float in [0, 1000], (optional)) – Clamp Size, Clamp bounds under this value (zero to disable)
  • axis_forward (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Forward
  • axis_up (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Up
File:

addons/io_scene_obj/__init__.py:146

bpy.ops.import_scene.x3d(filepath="", filter_glob="*.x3d;*.wrl", axis_forward='Z', axis_up='Y')

Import an X3D or VRML2 file

Parameters:
  • filepath (string, (optional, never None)) – File Path, Filepath used for importing the file
  • filter_glob (string, (optional, never None)) – filter_glob
  • axis_forward (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Forward
  • axis_up (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Up
File:

addons/io_scene_x3d/__init__.py:82

Previous topic

Import Mesh Operators

Next topic

Info Operators