Import Scene Operators

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

Import from 3DS file format (.3ds)

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

addons/io_scene_3ds/__init__.py:90

bpy.ops.import_scene.fbx(filepath="", axis_up='Y', axis_forward='-Z', directory="", filter_glob="*.fbx", use_manual_orientation=False, global_scale=1.0, bake_space_transform=False, use_image_search=True, use_alpha_decals=False, decal_offset=0.0, use_custom_props=True, use_custom_props_enum_as_string=True, ignore_leaf_bones=False, automatic_bone_orientation=False, primary_bone_axis='Y', secondary_bone_axis='X', use_prepost_rot=True)

Load a FBX file

Parameters:
  • filepath (string, (optional, never None)) – File Path, Filepath used for importing the file
  • axis_up (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Up
  • axis_forward (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Forward
  • 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
  • global_scale (float in [0.001, 1000], (optional)) – Scale
  • bake_space_transform (boolean, (optional)) – Apply Transform, Bake space transform into object data, avoids getting unwanted rotations to objects when target space is not aligned with Blender’s space (WARNING! experimental option, might give odd/wrong results)
  • 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
  • use_custom_props (boolean, (optional)) – Import User Properties, Import user properties as custom properties
  • use_custom_props_enum_as_string (boolean, (optional)) – Import Enums As Strings, Store enumeration values as strings
  • ignore_leaf_bones (boolean, (optional)) – Ignore Leaf Bones, Ignore the last bone at the end of each chain (used to mark the length of the previous bone)
  • automatic_bone_orientation (boolean, (optional)) – Automatic Bone Orientation, Try to align the major bone axis with the bone children
  • primary_bone_axis (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Primary Bone Axis
  • secondary_bone_axis (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Secondary Bone Axis
  • use_prepost_rot (boolean, (optional)) – Use Pre/Post Rotation, Use pre/post rotation from FBX transform (you may have to disable that in some cases)
File:

addons/io_scene_fbx/__init__.py:199

bpy.ops.import_scene.obj(filepath="", axis_up='Y', axis_forward='-Z', filter_glob="*.obj;*.mtl", 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)

Load a Wavefront OBJ File

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

addons/io_scene_obj/__init__.py:124

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

Import an X3D or VRML2 file

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

addons/io_scene_x3d/__init__.py:68