Import Scene Operators

bpy.ops.import_scene.autodesk_3ds(filepath="", axis_forward='-Z', axis_up='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_forward (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Forward
• axis_up (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Up
• 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:82

bpy.ops.import_scene.fbx(filepath="", axis_forward='-Z', axis_up='Y', 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_forward (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Forward
• axis_up (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Up
• 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:195

bpy.ops.import_scene.obj(filepath="", axis_forward='-Z', axis_up='Y', 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_forward (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Forward
• axis_up (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Up
• 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:119

bpy.ops.import_scene.x3d(filepath="", axis_forward='-Z', axis_up='Y', 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_forward (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Forward
• axis_up (enum in [‘X’, ‘Y’, ‘Z’, ‘-X’, ‘-Y’, ‘-Z’], (optional)) – Up
• filter_glob (string, (optional, never None)) – filter_glob

File:

addons/io_scene_x3d/__init__.py:59