OnscreenImage - Panda3D Manual

Panda3D Manual: OnscreenImage

Just like OnscreenText, you can use OnscreenImage as a quick way to put an image onscreen. Use an OnscreenImage whenever you want a quick way to display an ordinary image without a lot of fancy requirements.

from direct.gui.OnscreenImage import OnscreenImage
imageObject = OnscreenImage(image = 'myImage.jpg', pos = (-0.5, 0, 0.02))

If you want, you can change the image into another one using setImage():

imageObject.setImage('myImage2.jpg')

When you want to take the image away, use:

imageObject.destroy()

The following keyword parameters may be specified to the constructor:

image	the actual geometry to display or a file name. This may be omitted and specified later via setImage() if you don't have it available.
pos	the x, y, z position of the geometry on the screen. This maybe a 3-tuple of floats or a vector. y should be zero
scale	the size of the geometry. This may either be a single float, a 3-tuple of floats, or a vector, specifying a different x, y, z scale. y should be 1
hpr	the h, p, r of the geometry on the screen. This maybe a 3-tuple of floats or a vector.
color	the (r, g, b, a) color of the geometry. This is normally a 4-tuple of floats or ints.
parent	the NodePath to parent the text to initially; the default is aspect2d.

NOTE: To enable transparency in images, you must first set the TransparencyAttrib, otherwise the transparent parts of the image will be shown black:

from pandac.PandaModules import TransparencyAttrib
self.myImage=OnscreenImage(image = 'myImage.png', pos = (0, 0, 0))
self.myImage.setTransparency(TransparencyAttrib.MAlpha)

Since GIF's are not supported you should use PNG or TGA if you need transparency.

Top