BackgroundImage(bpy_struct)

base class — bpy_struct

class bpy.types.BackgroundImage(bpy_struct)

Image and settings for display in the 3d View background

clip

Movie clip displayed and edited in this space

Type :MovieClip
clip_user

Parameters defining which frame of the movie clip is displayed

Type :MovieClipUser, (readonly, never None)
image

Image displayed and edited in this space

Type :Image
image_user

Parameters defining which layer, pass and frame of the image is displayed

Type :ImageUser, (readonly, never None)
offset_x

Offset image horizontally from the world origin

Type :float in [-inf, inf], default 0.0
offset_y

Offset image vertically from the world origin

Type :float in [-inf, inf], default 0.0
opacity

Image opacity to blend the image against the background color

Type :float in [0, 1], default 0.0
show_background_image

Show this image as background

Type :boolean, default False
show_expanded

Show the expanded in the user interface

Type :boolean, default False
show_on_foreground

Show this image in front of objects in viewport

Type :boolean, default False
size

Scaling factor for the background image

Type :float in [0, inf], default 0.0
source

Data source used for background

Type :enum in [‘IMAGE’, ‘MOVIE_CLIP’], default ‘IMAGE’
use_camera_clip

Use movie clip from active scene camera

Type :boolean, default False
view_axis

The axis to display the image on

  • LEFT Left, Show background image while looking to the left.
  • RIGHT Right, Show background image while looking to the right.
  • BACK Back, Show background image in back view.
  • FRONT Front, Show background image in front view.
  • BOTTOM Bottom, Show background image in bottom view.
  • TOP Top, Show background image in top view.
  • ALL All Views, Show background image in all views.
  • CAMERA Camera, Show background image in camera view.
Type :enum in [‘LEFT’, ‘RIGHT’, ‘BACK’, ‘FRONT’, ‘BOTTOM’, ‘TOP’, ‘ALL’, ‘CAMERA’], default ‘ALL’

Inherited Properties

Inherited Functions

References

Previous topic

Available(KeyingSetInfo)

Next topic

BackgroundImages(bpy_struct)