BackgroundImage(bpy_struct)

base class — bpy_struct

class bpy.types.BackgroundImage(bpy_struct)

Image and settings for display in the 3d View background

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

Offsets image horizontally from the world origin

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

Offsets 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_expanded

Show the expanded in the user interface

Type :boolean, default False
size

Scaling factor for the background image

Type :float in [0, inf], default 0.0
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

ArrayModifier(Modifier)

Next topic

BevelModifier(Modifier)