I have a raster layer loaded in QGIS and I'd like to be able to set its transparency via the Python console. I'm new to the API and have not been able to find out how to do this. Any help would be greatly appreciated!


Here's what I see from the console:

>>> l = qgis.utils.iface.activeLayer()
>>> l
<qgis.core.QgsRasterLayer object at 0x07144DF8>
>>> rt = l.rasterTransparency()
Traceback (most recent call last):
  File "<input>", line 1, in <module>
AttributeError: 'QgsRasterLayer' object has no attribute 'rasterTransparency'

I'm just loading a single band raster in GeoTiff format with a palleted color scheme... nothing too fancy. Am I getting the layer incorrectly?


I found a plugin called rasparenza today that got me going on the transparency issue.

For QGIS 2.x it looks like we want the setOpacity() method:

rlayer = qgis.utils.iface.activeLayer()

# Set opacity

# Trigger a repaint
if hasattr(rlayer, "setCacheImage"):

For some reason, I thought I should be able to use iface.mapCanvas().refresh() but it didn't seem to do the refresh.


This way you can access current list of transparency values:

lst = rt.transparentSingleValuePixelList()
for item in lst: print item.pixelValue, item.percentTransparent


-9999.0 100.0

0.0 50.0

To set a list with just one value:

x = QgsRasterTransparency.TransparentSingleValuePixel()
x.pixelValue = 123
x.transparencyPercent = 50
rt.setTransparentSingleValuePixelList( [ x ] )

The above examples suppose that you use single band raster. In case of RGB image the steps are similar, just instead of "SingleValue" methods you would use "ThreeValue" methods and instead of "pixelValue" attribute there are "red", "green", "blue" attributes.

  • Thanks! I have a problem though, rasterTransparency() isn't working for me somehow. I've updated my question to show what I'm seeing in the console window. Am I pulling the active layer incorrectly? – TxAG98 Nov 14 '13 at 22:42
  • This what I got, it seems it doesn't have rasterTransparency atttribue ``` rt=l.rasterTransparency() Traceback (most recent call last): File "<input>", line 1, in <module> AttributeError: 'QgsRasterLayer' object has no attribute 'rasterTransparency' ``` – ismailsunni Jan 15 '16 at 1:33

Perhaps more updated answer from Rob Lodge

from qgis.core import QgsRasterTransparency

print 'Start'
active_layer = l = qgis.utils.iface.mapCanvas().currentLayer()
raster_transpareny  = active_layer.renderer().rasterTransparency()
ltr = QgsRasterTransparency.TransparentSingleValuePixel()
tr_list = []
ltr.min = 0  # Or another value
ltr.max = 0  # Or another value
ltr.percentTransparent = 100  # Or another value
tr_list.append(ltr)  # You can add more item in this list.

active_layer.triggerRepaint()  # Tried with iface.mapCanvas().refresh(), but it didn't work
print 'Finish'

You can try this in QGIS Python Console. I tried with QGIS 2.8.3

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.