QGIS API Documentation  2.10.1-Pisa
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
qgsrasterlayer.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgsrasterlayer.cpp - description
3  -------------------
4 begin : Sat Jun 22 2002
5 copyright : (C) 2003 by Tim Sutton, Steve Halasz and Gary E.Sherman
6 email : tim at linfiniti.com
7  ***************************************************************************/
8 
9 /***************************************************************************
10  * *
11  * This program is free software; you can redistribute it and/or modify *
12  * it under the terms of the GNU General Public License as published by *
13  * the Free Software Foundation; either version 2 of the License, or *
14  * (at your option) any later version. *
15  * *
16  ***************************************************************************/
17 #include "qgsapplication.h"
18 #include "qgscolorrampshader.h"
20 #include "qgscoordinatetransform.h"
21 #include "qgsdatasourceuri.h"
22 #include "qgslogger.h"
23 #include "qgsmaplayerlegend.h"
24 #include "qgsmaplayerregistry.h"
25 #include "qgsmaptopixel.h"
26 #include "qgsmessagelog.h"
30 #include "qgsproviderregistry.h"
31 #include "qgspseudocolorshader.h"
32 #include "qgsrasterdrawer.h"
33 #include "qgsrasteriterator.h"
34 #include "qgsrasterlayer.h"
35 #include "qgsrasterlayerrenderer.h"
36 #include "qgsrasterprojector.h"
37 #include "qgsrasterrange.h"
39 #include "qgsrectangle.h"
40 #include "qgsrendercontext.h"
44 
45 #include <cmath>
46 #include <cstdio>
47 #include <limits>
48 #include <typeinfo>
49 
50 #include <QApplication>
51 #include <QCursor>
52 #include <QDomElement>
53 #include <QDomNode>
54 #include <QFile>
55 #include <QFileInfo>
56 #include <QFont>
57 #include <QFontMetrics>
58 #include <QFrame>
59 #include <QImage>
60 #include <QLabel>
61 #include <QLibrary>
62 #include <QList>
63 #include <QMatrix>
64 #include <QMessageBox>
65 #include <QPainter>
66 #include <QPixmap>
67 #include <QRegExp>
68 #include <QSettings>
69 #include <QSlider>
70 #include <QTime>
71 
72 // typedefs for provider plugin functions of interest
73 typedef bool isvalidrasterfilename_t( QString const & theFileNameQString, QString & retErrMsg );
74 
75 #define ERR(message) QGS_ERROR_MESSAGE(message,"Raster layer")
76 
77 const double QgsRasterLayer::CUMULATIVE_CUT_LOWER = 0.02;
78 const double QgsRasterLayer::CUMULATIVE_CUT_UPPER = 0.98;
79 const double QgsRasterLayer::SAMPLE_SIZE = 250000;
80 
82  : QgsMapLayer( RasterLayer )
83  , QSTRING_NOT_SET( "Not Set" )
84  , TRSTRING_NOT_SET( tr( "Not Set" ) )
85  , mDataProvider( 0 )
86 {
87  init();
88  mValid = false;
89 }
90 
92  QString const & path,
93  QString const & baseName,
94  bool loadDefaultStyleFlag )
95  : QgsMapLayer( RasterLayer, baseName, path )
96  , QSTRING_NOT_SET( "Not Set" )
97  , TRSTRING_NOT_SET( tr( "Not Set" ) )
98  , mDataProvider( 0 )
99 {
100  QgsDebugMsg( "Entered" );
101 
102  // TODO, call constructor with provider key
103  init();
104  setDataProvider( "gdal" );
105  if ( !mValid ) return;
106 
107  bool defaultLoadedFlag = false;
108  if ( mValid && loadDefaultStyleFlag )
109  {
110  loadDefaultStyle( defaultLoadedFlag );
111  }
112  if ( !defaultLoadedFlag )
113  {
115  }
116  return;
117 } // QgsRasterLayer ctor
118 
124  const QString & baseName,
125  const QString & providerKey,
126  bool loadDefaultStyleFlag )
127  : QgsMapLayer( RasterLayer, baseName, uri )
128  // Constant that signals property not used.
129  , QSTRING_NOT_SET( "Not Set" )
130  , TRSTRING_NOT_SET( tr( "Not Set" ) )
131  , mDataProvider( 0 )
132  , mProviderKey( providerKey )
133 {
134  QgsDebugMsg( "Entered" );
135  init();
136  setDataProvider( providerKey );
137  if ( !mValid ) return;
138 
139  // load default style
140  bool defaultLoadedFlag = false;
141  if ( mValid && loadDefaultStyleFlag )
142  {
143  loadDefaultStyle( defaultLoadedFlag );
144  }
145  if ( !defaultLoadedFlag )
146  {
148  }
149 
150  // TODO: Connect signals from the dataprovider to the qgisapp
151 
152  emit statusChanged( tr( "QgsRasterLayer created" ) );
153 } // QgsRasterLayer ctor
154 
156 {
157  mValid = false;
158  // Note: provider and other interfaces are owned and deleted by pipe
159 }
160 
162 //
163 // Static Methods and members
164 //
166 
170 bool QgsRasterLayer::isValidRasterFileName( QString const & theFileNameQString, QString & retErrMsg )
171 {
172  isvalidrasterfilename_t *pValid = ( isvalidrasterfilename_t * ) cast_to_fptr( QgsProviderRegistry::instance()->function( "gdal", "isValidRasterFileName" ) );
173  if ( ! pValid )
174  {
175  QgsDebugMsg( "Could not resolve isValidRasterFileName in gdal provider library" );
176  return false;
177  }
178 
179  bool myIsValid = pValid( theFileNameQString, retErrMsg );
180  return myIsValid;
181 }
182 
183 bool QgsRasterLayer::isValidRasterFileName( QString const & theFileNameQString )
184 {
185  QString retErrMsg;
186  return isValidRasterFileName( theFileNameQString, retErrMsg );
187 }
188 
190 {
191  QgsDebugMsg( "name=" + name );
192  QDateTime t;
193 
194  QFileInfo fi( name );
195 
196  // Is it file?
197  if ( !fi.exists() )
198  return t;
199 
200  t = fi.lastModified();
201 
202  QgsDebugMsg( "last modified = " + t.toString() );
203 
204  return t;
205 }
206 
207 // typedef for the QgsDataProvider class factory
209 
211 //
212 // Non Static Public methods
213 //
215 
217 {
218  if ( !mDataProvider ) return 0;
219  return mDataProvider->bandCount();
220 }
221 
222 const QString QgsRasterLayer::bandName( int theBandNo )
223 {
224  return dataProvider()->generateBandName( theBandNo );
225 }
226 
227 void QgsRasterLayer::setRendererForDrawingStyle( const QgsRaster::DrawingStyle & theDrawingStyle )
228 {
229  setRenderer( QgsRasterRendererRegistry::instance()->defaultRendererForDrawingStyle( theDrawingStyle, mDataProvider ) );
230 }
231 
236 {
237  return mDataProvider;
238 }
239 
244 {
245  return mDataProvider;
246 }
247 
249 {
250  if ( mDataProvider )
251  {
252  mDataProvider->reloadData();
253  }
254 }
255 
257 {
258  return new QgsRasterLayerRenderer( this, rendererContext );
259 }
260 
261 bool QgsRasterLayer::draw( QgsRenderContext& rendererContext )
262 {
263  QgsDebugMsg( "entered. (renderContext)" );
264 
265  QgsDebugMsg( "checking timestamp." );
266 
267  // Check timestamp
268  if ( !update() )
269  {
270  return false;
271  }
272 
273  QgsRasterLayerRenderer renderer( this, rendererContext );
274  return renderer.render();
275 }
276 
277 void QgsRasterLayer::draw( QPainter * theQPainter,
278  QgsRasterViewPort * theRasterViewPort,
279  const QgsMapToPixel* theQgsMapToPixel )
280 {
281  QgsDebugMsg( " 3 arguments" );
282  QTime time;
283  time.start();
284  //
285  //
286  // The goal here is to make as many decisions as possible early on (outside of the rendering loop)
287  // so that we can maximise performance of the rendering process. So now we check which drawing
288  // procedure to use :
289  //
290 
291  QgsRasterProjector *projector = mPipe.projector();
292 
293  // TODO add a method to interface to get provider and get provider
294  // params in QgsRasterProjector
295  if ( projector )
296  {
297  projector->setCRS( theRasterViewPort->mSrcCRS, theRasterViewPort->mDestCRS, theRasterViewPort->mSrcDatumTransform, theRasterViewPort->mDestDatumTransform );
298  }
299 
300  // Drawer to pipe?
301  QgsRasterIterator iterator( mPipe.last() );
302  QgsRasterDrawer drawer( &iterator );
303  drawer.draw( theQPainter, theRasterViewPort, theQgsMapToPixel );
304 
305  QgsDebugMsg( QString( "total raster draw time (ms): %1" ).arg( time.elapsed(), 5 ) );
306 } //end of draw method
307 
309 {
310  QList< QPair< QString, QColor > > symbolList;
312  if ( renderer )
313  {
314  renderer->legendSymbologyItems( symbolList );
315  }
316  return symbolList;
317 }
318 
320 {
321  QString myMetadata;
322  myMetadata += "<p class=\"glossy\">" + tr( "Driver" ) + "</p>\n";
323  myMetadata += "<p>";
324  myMetadata += mDataProvider->description();
325  myMetadata += "</p>\n";
326 
327  // Insert provider-specific (e.g. WMS-specific) metadata
328  // crashing
329  myMetadata += mDataProvider->metadata();
330 
331  myMetadata += "<p class=\"glossy\">";
332  myMetadata += tr( "No Data Value" );
333  myMetadata += "</p>\n";
334  myMetadata += "<p>";
335  // TODO: all bands
336  if ( mDataProvider->srcHasNoDataValue( 1 ) )
337  {
338  myMetadata += QString::number( mDataProvider->srcNoDataValue( 1 ) );
339  }
340  else
341  {
342  myMetadata += "*" + tr( "NoDataValue not set" ) + "*";
343  }
344  myMetadata += "</p>\n";
345 
346  myMetadata += "</p>\n";
347  myMetadata += "<p class=\"glossy\">";
348  myMetadata += tr( "Data Type" );
349  myMetadata += "</p>\n";
350  myMetadata += "<p>";
351  //just use the first band
352  switch ( mDataProvider->srcDataType( 1 ) )
353  {
354  case QGis::Byte:
355  myMetadata += tr( "Byte - Eight bit unsigned integer" );
356  break;
357  case QGis::UInt16:
358  myMetadata += tr( "UInt16 - Sixteen bit unsigned integer " );
359  break;
360  case QGis::Int16:
361  myMetadata += tr( "Int16 - Sixteen bit signed integer " );
362  break;
363  case QGis::UInt32:
364  myMetadata += tr( "UInt32 - Thirty two bit unsigned integer " );
365  break;
366  case QGis::Int32:
367  myMetadata += tr( "Int32 - Thirty two bit signed integer " );
368  break;
369  case QGis::Float32:
370  myMetadata += tr( "Float32 - Thirty two bit floating point " );
371  break;
372  case QGis::Float64:
373  myMetadata += tr( "Float64 - Sixty four bit floating point " );
374  break;
375  case QGis::CInt16:
376  myMetadata += tr( "CInt16 - Complex Int16 " );
377  break;
378  case QGis::CInt32:
379  myMetadata += tr( "CInt32 - Complex Int32 " );
380  break;
381  case QGis::CFloat32:
382  myMetadata += tr( "CFloat32 - Complex Float32 " );
383  break;
384  case QGis::CFloat64:
385  myMetadata += tr( "CFloat64 - Complex Float64 " );
386  break;
387  default:
388  myMetadata += tr( "Could not determine raster data type." );
389  }
390  myMetadata += "</p>\n";
391 
392  myMetadata += "<p class=\"glossy\">";
393  myMetadata += tr( "Pyramid overviews" );
394  myMetadata += "</p>\n";
395  myMetadata += "<p>";
396 
397  myMetadata += "<p class=\"glossy\">";
398  myMetadata += tr( "Layer Spatial Reference System" );
399  myMetadata += "</p>\n";
400  myMetadata += "<p>";
401  myMetadata += crs().toProj4();
402  myMetadata += "</p>\n";
403 
404  myMetadata += "<p class=\"glossy\">";
405  myMetadata += tr( "Layer Extent (layer original source projection)" );
406  myMetadata += "</p>\n";
407  myMetadata += "<p>";
408  myMetadata += mDataProvider->extent().toString();
409  myMetadata += "</p>\n";
410 
411  // output coordinate system
412  // TODO: this is not related to layer, to be removed? [MD]
413 #if 0
414  myMetadata += "<tr><td class=\"glossy\">";
415  myMetadata += tr( "Project Spatial Reference System" );
416  myMetadata += "</p>\n";
417  myMetadata += "<p>";
418  myMetadata += mCoordinateTransform->destCRS().toProj4();
419  myMetadata += "</p>\n";
420 #endif
421 
422  //
423  // Add the stats for each band to the output table
424  //
425  int myBandCountInt = bandCount();
426  for ( int myIteratorInt = 1; myIteratorInt <= myBandCountInt; ++myIteratorInt )
427  {
428  QgsDebugMsg( "Raster properties : checking if band " + QString::number( myIteratorInt ) + " has stats? " );
429  //band name
430  myMetadata += "<p class=\"glossy\">\n";
431  myMetadata += tr( "Band" );
432  myMetadata += "</p>\n";
433  myMetadata += "<p>";
434  myMetadata += bandName( myIteratorInt );
435  myMetadata += "</p>\n";
436  //band number
437  myMetadata += "<p>";
438  myMetadata += tr( "Band No" );
439  myMetadata += "</p>\n";
440  myMetadata += "<p>\n";
441  myMetadata += QString::number( myIteratorInt );
442  myMetadata += "</p>\n";
443 
444  //check if full stats for this layer have already been collected
445  if ( !dataProvider()->hasStatistics( myIteratorInt ) ) //not collected
446  {
447  QgsDebugMsg( ".....no" );
448 
449  myMetadata += "<p>";
450  myMetadata += tr( "No Stats" );
451  myMetadata += "</p>\n";
452  myMetadata += "<p>\n";
453  myMetadata += tr( "No stats collected yet" );
454  myMetadata += "</p>\n";
455  }
456  else // collected - show full detail
457  {
458  QgsDebugMsg( ".....yes" );
459 
460  QgsRasterBandStats myRasterBandStats = dataProvider()->bandStatistics( myIteratorInt );
461  //Min Val
462  myMetadata += "<p>";
463  myMetadata += tr( "Min Val" );
464  myMetadata += "</p>\n";
465  myMetadata += "<p>\n";
466  myMetadata += QString::number( myRasterBandStats.minimumValue, 'f', 10 );
467  myMetadata += "</p>\n";
468 
469  // Max Val
470  myMetadata += "<p>";
471  myMetadata += tr( "Max Val" );
472  myMetadata += "</p>\n";
473  myMetadata += "<p>\n";
474  myMetadata += QString::number( myRasterBandStats.maximumValue, 'f', 10 );
475  myMetadata += "</p>\n";
476 
477  // Range
478  myMetadata += "<p>";
479  myMetadata += tr( "Range" );
480  myMetadata += "</p>\n";
481  myMetadata += "<p>\n";
482  myMetadata += QString::number( myRasterBandStats.range, 'f', 10 );
483  myMetadata += "</p>\n";
484 
485  // Mean
486  myMetadata += "<p>";
487  myMetadata += tr( "Mean" );
488  myMetadata += "</p>\n";
489  myMetadata += "<p>\n";
490  myMetadata += QString::number( myRasterBandStats.mean, 'f', 10 );
491  myMetadata += "</p>\n";
492 
493  //sum of squares
494  myMetadata += "<p>";
495  myMetadata += tr( "Sum of squares" );
496  myMetadata += "</p>\n";
497  myMetadata += "<p>\n";
498  myMetadata += QString::number( myRasterBandStats.sumOfSquares, 'f', 10 );
499  myMetadata += "</p>\n";
500 
501  //standard deviation
502  myMetadata += "<p>";
503  myMetadata += tr( "Standard Deviation" );
504  myMetadata += "</p>\n";
505  myMetadata += "<p>\n";
506  myMetadata += QString::number( myRasterBandStats.stdDev, 'f', 10 );
507  myMetadata += "</p>\n";
508 
509  //sum of all cells
510  myMetadata += "<p>";
511  myMetadata += tr( "Sum of all cells" );
512  myMetadata += "</p>\n";
513  myMetadata += "<p>\n";
514  myMetadata += QString::number( myRasterBandStats.sum, 'f', 10 );
515  myMetadata += "</p>\n";
516 
517  //number of cells
518  myMetadata += "<p>";
519  myMetadata += tr( "Cell Count" );
520  myMetadata += "</p>\n";
521  myMetadata += "<p>\n";
522  myMetadata += QString::number( myRasterBandStats.elementCount );
523  myMetadata += "</p>\n";
524  }
525  }
526 
527  QgsDebugMsg( myMetadata );
528  return myMetadata;
529 }
530 
536 {
537  //TODO: This function should take dimensions
538  QgsDebugMsg( "entered." );
539 
540  // Only do this for the GDAL provider?
541  // Maybe WMS can do this differently using QImage::numColors and QImage::color()
542  if ( mDataProvider->colorInterpretation( theBandNumber ) == QgsRaster::PaletteIndex )
543  {
544  QgsDebugMsg( "....found paletted image" );
545  QgsColorRampShader myShader;
546  QList<QgsColorRampShader::ColorRampItem> myColorRampItemList = mDataProvider->colorTable( theBandNumber );
547  if ( myColorRampItemList.size() > 0 )
548  {
549  QgsDebugMsg( "....got color ramp item list" );
550  myShader.setColorRampItemList( myColorRampItemList );
552  // Draw image
553  int mySize = 100;
554  QPixmap myPalettePixmap( mySize, mySize );
555  QPainter myQPainter( &myPalettePixmap );
556 
557  QImage myQImage = QImage( mySize, mySize, QImage::Format_RGB32 );
558  myQImage.fill( 0 );
559  myPalettePixmap.fill();
560 
561  double myStep = (( double )myColorRampItemList.size() - 1 ) / ( double )( mySize * mySize );
562  double myValue = 0.0;
563  for ( int myRow = 0; myRow < mySize; myRow++ )
564  {
565  QRgb* myLineBuffer = ( QRgb* )myQImage.scanLine( myRow );
566  for ( int myCol = 0; myCol < mySize; myCol++ )
567  {
568  myValue = myStep * ( double )( myCol + myRow * mySize );
569  int c1, c2, c3, c4;
570  myShader.shade( myValue, &c1, &c2, &c3, &c4 );
571  myLineBuffer[ myCol ] = qRgba( c1, c2, c3, c4 );
572  }
573  }
574 
575  myQPainter.drawImage( 0, 0, myQImage );
576  return myPalettePixmap;
577  }
578  QPixmap myNullPixmap;
579  return myNullPixmap;
580  }
581  else
582  {
583  //invalid layer was requested
584  QPixmap myNullPixmap;
585  return myNullPixmap;
586  }
587 }
588 
590 {
591  return mProviderKey;
592 }
593 
598 {
599 // We return one raster pixel per map unit pixel
600 // One raster pixel can have several raster units...
601 
602 // We can only use one of the mGeoTransform[], so go with the
603 // horisontal one.
604 
605  if ( mDataProvider->capabilities() & QgsRasterDataProvider::Size && mDataProvider->xSize() > 0 )
606  {
607  return mDataProvider->extent().width() / mDataProvider->xSize();
608  }
609  return 1;
610 }
611 
613 {
614  if ( mDataProvider->capabilities() & QgsRasterDataProvider::Size && mDataProvider->xSize() > 0 )
615  {
616  return mDataProvider->extent().height() / mDataProvider->ySize();
617  }
618  return 1;
619 }
620 
621 void QgsRasterLayer::init()
622 {
623  mRasterType = QgsRasterLayer::GrayOrUndefined;
624 
626 
627  setRendererForDrawingStyle( QgsRaster::UndefinedDrawingStyle );
628 
629  //Initialize the last view port structure, should really be a class
630  mLastViewPort.mWidth = 0;
631  mLastViewPort.mHeight = 0;
632 }
633 
634 void QgsRasterLayer::setDataProvider( QString const & provider )
635 {
636  QgsDebugMsg( "Entered" );
637  mValid = false; // assume the layer is invalid until we determine otherwise
638 
639  mPipe.remove( mDataProvider ); // deletes if exists
640  mDataProvider = 0;
641 
642  // XXX should I check for and possibly delete any pre-existing providers?
643  // XXX How often will that scenario occur?
644 
645  mProviderKey = provider;
646  // set the layer name (uppercase first character)
647  if ( ! mLayerName.isEmpty() ) // XXX shouldn't this happen in parent?
648  {
650  }
651 
652  //mBandCount = 0;
653 
654  mDataProvider = ( QgsRasterDataProvider* )QgsProviderRegistry::instance()->provider( mProviderKey, mDataSource );
655  if ( !mDataProvider )
656  {
657  //QgsMessageLog::logMessage( tr( "Cannot instantiate the data provider" ), tr( "Raster" ) );
658  appendError( ERR( tr( "Cannot instantiate the '%1' data provider" ).arg( mProviderKey ) ) );
659  return;
660  }
661  QgsDebugMsg( "Data provider created" );
662 
663  // Set data provider into pipe even if not valid so that it is deleted with pipe (with layer)
664  mPipe.set( mDataProvider );
665  if ( !mDataProvider->isValid() )
666  {
667  setError( mDataProvider->error() );
668  appendError( ERR( tr( "Provider is not valid (provider: %1, URI: %2" ).arg( mProviderKey ).arg( mDataSource ) ) );
669  return;
670  }
671 
672  if ( provider == "gdal" )
673  {
674  // make sure that the /vsigzip or /vsizip is added to uri, if applicable
675  mDataSource = mDataProvider->dataSourceUri();
676  }
677 
678  // get the extent
679  QgsRectangle mbr = mDataProvider->extent();
680 
681  // show the extent
682  QString s = mbr.toString();
683  QgsDebugMsg( "Extent of layer: " + s );
684  // store the extent
685  setExtent( mbr );
686 
687  // upper case the first letter of the layer name
688  QgsDebugMsg( "mLayerName: " + name() );
689 
690  // set up the raster drawing style
691  // Do not set any 'sensible' style here, the style is set later
692 
693  // Setup source CRS
694  setCrs( QgsCoordinateReferenceSystem( mDataProvider->crs() ) );
695 
696  QString mySourceWkt = crs().toWkt();
697 
698  QgsDebugMsg( "using wkt:\n" + mySourceWkt );
699 
700  //defaults - Needs to be set after the Contrast list has been build
701  //Try to read the default contrast enhancement from the config file
702 
703  QSettings myQSettings;
704 
705  //decide what type of layer this is...
706  //TODO Change this to look at the color interp and palette interp to decide which type of layer it is
707  QgsDebugMsg( "bandCount = " + QString::number( mDataProvider->bandCount() ) );
708  QgsDebugMsg( "dataType = " + QString::number( mDataProvider->dataType( 1 ) ) );
709  if (( mDataProvider->bandCount() > 1 ) )
710  {
711  // handle singleband gray with alpha
712  if ( mDataProvider->bandCount() == 2
713  && (( mDataProvider->colorInterpretation( 1 ) == QgsRaster::GrayIndex
714  && mDataProvider->colorInterpretation( 2 ) == QgsRaster::AlphaBand )
715  || ( mDataProvider->colorInterpretation( 1 ) == QgsRaster::AlphaBand
716  && mDataProvider->colorInterpretation( 2 ) == QgsRaster::GrayIndex ) ) )
717  {
718  mRasterType = GrayOrUndefined;
719  }
720  else
721  {
722  mRasterType = Multiband;
723  }
724  }
725  else if ( mDataProvider->dataType( 1 ) == QGis::ARGB32
726  || mDataProvider->dataType( 1 ) == QGis::ARGB32_Premultiplied )
727  {
728  mRasterType = ColorLayer;
729  }
730  else if ( mDataProvider->colorInterpretation( 1 ) == QgsRaster::PaletteIndex )
731  {
732  mRasterType = Palette;
733  }
734  else if ( mDataProvider->colorInterpretation( 1 ) == QgsRaster::ContinuousPalette )
735  {
736  mRasterType = Palette;
737  }
738  else
739  {
740  mRasterType = GrayOrUndefined;
741  }
742 
743  QgsDebugMsg( "mRasterType = " + QString::number( mRasterType ) );
744  if ( mRasterType == ColorLayer )
745  {
746  QgsDebugMsg( "Setting drawing style to SingleBandColorDataStyle " + QString::number( QgsRaster::SingleBandColorDataStyle ) );
747  setRendererForDrawingStyle( QgsRaster::SingleBandColorDataStyle );
748  }
749  else if ( mRasterType == Palette && mDataProvider->colorInterpretation( 1 ) == QgsRaster::PaletteIndex )
750  {
751  setRendererForDrawingStyle( QgsRaster::PalettedColor ); //sensible default
752  }
753  else if ( mRasterType == Palette && mDataProvider->colorInterpretation( 1 ) == QgsRaster::ContinuousPalette )
754  {
755  setRendererForDrawingStyle( QgsRaster::SingleBandPseudoColor );
756  // Load color table
757  QList<QgsColorRampShader::ColorRampItem> colorTable = mDataProvider->colorTable( 1 );
759  if ( r )
760  {
761  // TODO: this should go somewhere else
762  QgsRasterShader* shader = new QgsRasterShader();
763  QgsColorRampShader* colorRampShader = new QgsColorRampShader();
765  colorRampShader->setColorRampItemList( colorTable );
766  shader->setRasterShaderFunction( colorRampShader );
767  r->setShader( shader );
768  }
769  }
770  else if ( mRasterType == Multiband )
771  {
772  setRendererForDrawingStyle( QgsRaster::MultiBandColor ); //sensible default
773  }
774  else //GrayOrUndefined
775  {
776  setRendererForDrawingStyle( QgsRaster::SingleBandGray ); //sensible default
777  }
778 
779  // Auto set alpha band
780  for ( int bandNo = 1; bandNo <= mDataProvider->bandCount(); bandNo++ )
781  {
782  if ( mDataProvider->colorInterpretation( bandNo ) == QgsRaster::AlphaBand )
783  {
784  if ( mPipe.renderer() )
785  {
786  mPipe.renderer()->setAlphaBand( bandNo );
787  }
788  break;
789  }
790  }
791 
792  // brightness filter
794  mPipe.set( brightnessFilter );
795 
796  // hue/saturation filter
798  mPipe.set( hueSaturationFilter );
799 
800  //resampler (must be after renderer)
802  mPipe.set( resampleFilter );
803 
804  // projector (may be anywhere in pipe)
805  QgsRasterProjector * projector = new QgsRasterProjector;
806  mPipe.set( projector );
807 
808  // Set default identify format - use the richest format available
809  int capabilities = mDataProvider->capabilities();
811  if ( capabilities & QgsRasterInterface::IdentifyHtml )
812  {
813  // HTML is usually richest
814  identifyFormat = QgsRaster::IdentifyFormatHtml;
815  }
816  else if ( capabilities & QgsRasterInterface::IdentifyFeature )
817  {
818  identifyFormat = QgsRaster::IdentifyFormatFeature;
819  }
820  else if ( capabilities & QgsRasterInterface::IdentifyText )
821  {
822  identifyFormat = QgsRaster::IdentifyFormatText;
823  }
824  else if ( capabilities & QgsRasterInterface::IdentifyValue )
825  {
826  identifyFormat = QgsRaster::IdentifyFormatValue;
827  }
828  setCustomProperty( "identify/format", QgsRasterDataProvider::identifyFormatName( identifyFormat ) );
829 
830  // Store timestamp
831  // TODO move to provider
832  mLastModified = lastModified( mDataSource );
833 
834  // Connect provider signals
835  connect(
836  mDataProvider, SIGNAL( progress( int, double, QString ) ),
837  this, SLOT( onProgress( int, double, QString ) )
838  );
839 
840  // Do a passthrough for the status bar text
841  connect(
842  mDataProvider, SIGNAL( statusChanged( QString ) ),
843  this, SIGNAL( statusChanged( QString ) )
844  );
845 
846  //mark the layer as valid
847  mValid = true;
848 
849  QgsDebugMsg( "exiting." );
850 } // QgsRasterLayer::setDataProvider
851 
852 void QgsRasterLayer::closeDataProvider()
853 {
854  mValid = false;
855  mPipe.remove( mDataProvider );
856  mDataProvider = 0;
857 }
858 
859 void QgsRasterLayer::setContrastEnhancement( QgsContrastEnhancement::ContrastEnhancementAlgorithm theAlgorithm, QgsRaster::ContrastEnhancementLimits theLimits, QgsRectangle theExtent, int theSampleSize, bool theGenerateLookupTableFlag )
860 {
861  QgsDebugMsg( QString( "theAlgorithm = %1 theLimits = %2 theExtent.isEmpty() = %3" ).arg( theAlgorithm ).arg( theLimits ).arg( theExtent.isEmpty() ) );
862  if ( !mPipe.renderer() || !mDataProvider )
863  {
864  return;
865  }
866 
867  QList<int> myBands;
868  QList<QgsContrastEnhancement*> myEnhancements;
869  QgsSingleBandGrayRenderer* myGrayRenderer = 0;
870  QgsMultiBandColorRenderer* myMultiBandRenderer = 0;
871  QString rendererType = mPipe.renderer()->type();
872  if ( rendererType == "singlebandgray" )
873  {
874  myGrayRenderer = dynamic_cast<QgsSingleBandGrayRenderer*>( mPipe.renderer() );
875  if ( !myGrayRenderer ) return;
876  myBands << myGrayRenderer->grayBand();
877  }
878  else if ( rendererType == "multibandcolor" )
879  {
880  myMultiBandRenderer = dynamic_cast<QgsMultiBandColorRenderer*>( mPipe.renderer() );
881  if ( !myMultiBandRenderer ) return;
882  myBands << myMultiBandRenderer->redBand() << myMultiBandRenderer->greenBand() << myMultiBandRenderer->blueBand();
883  }
884 
885  foreach ( int myBand, myBands )
886  {
887  if ( myBand != -1 )
888  {
889  QGis::DataType myType = ( QGis::DataType )mDataProvider->dataType( myBand );
890  QgsContrastEnhancement* myEnhancement = new QgsContrastEnhancement(( QGis::DataType )myType );
891  myEnhancement->setContrastEnhancementAlgorithm( theAlgorithm, theGenerateLookupTableFlag );
892 
893  double myMin = std::numeric_limits<double>::quiet_NaN();
894  double myMax = std::numeric_limits<double>::quiet_NaN();
895 
896  if ( theLimits == QgsRaster::ContrastEnhancementMinMax )
897  {
898  QgsRasterBandStats myRasterBandStats = mDataProvider->bandStatistics( myBand, QgsRasterBandStats::Min | QgsRasterBandStats::Max, theExtent, theSampleSize );
899  myMin = myRasterBandStats.minimumValue;
900  myMax = myRasterBandStats.maximumValue;
901  }
902  else if ( theLimits == QgsRaster::ContrastEnhancementStdDev )
903  {
904  double myStdDev = 1; // make optional?
905  QgsRasterBandStats myRasterBandStats = mDataProvider->bandStatistics( myBand, QgsRasterBandStats::Mean | QgsRasterBandStats::StdDev, theExtent, theSampleSize );
906  myMin = myRasterBandStats.mean - ( myStdDev * myRasterBandStats.stdDev );
907  myMax = myRasterBandStats.mean + ( myStdDev * myRasterBandStats.stdDev );
908  }
909  else if ( theLimits == QgsRaster::ContrastEnhancementCumulativeCut )
910  {
911  QSettings mySettings;
912  double myLower = mySettings.value( "/Raster/cumulativeCutLower", QString::number( CUMULATIVE_CUT_LOWER ) ).toDouble();
913  double myUpper = mySettings.value( "/Raster/cumulativeCutUpper", QString::number( CUMULATIVE_CUT_UPPER ) ).toDouble();
914  QgsDebugMsg( QString( "myLower = %1 myUpper = %2" ).arg( myLower ).arg( myUpper ) );
915  mDataProvider->cumulativeCut( myBand, myLower, myUpper, myMin, myMax, theExtent, theSampleSize );
916  }
917 
918  QgsDebugMsg( QString( "myBand = %1 myMin = %2 myMax = %3" ).arg( myBand ).arg( myMin ).arg( myMax ) );
919  myEnhancement->setMinimumValue( myMin );
920  myEnhancement->setMaximumValue( myMax );
921  myEnhancements.append( myEnhancement );
922  }
923  else
924  {
925  myEnhancements.append( 0 );
926  }
927  }
928 
929  if ( rendererType == "singlebandgray" )
930  {
931  if ( myEnhancements.value( 0 ) ) myGrayRenderer->setContrastEnhancement( myEnhancements.value( 0 ) );
932  }
933  else if ( rendererType == "multibandcolor" )
934  {
935  if ( myEnhancements.value( 0 ) ) myMultiBandRenderer->setRedContrastEnhancement( myEnhancements.value( 0 ) );
936  if ( myEnhancements.value( 1 ) ) myMultiBandRenderer->setGreenContrastEnhancement( myEnhancements.value( 1 ) );
937  if ( myEnhancements.value( 2 ) ) myMultiBandRenderer->setBlueContrastEnhancement( myEnhancements.value( 2 ) );
938  }
939 
940  emit repaintRequested();
941 }
942 
944 {
945  QgsDebugMsg( "Entered" );
946 
947  QSettings mySettings;
948 
949  QString myKey;
950  QString myDefault;
951 
952  // TODO: we should not test renderer class here, move it somehow to renderers
953  if ( dynamic_cast<QgsSingleBandGrayRenderer*>( renderer() ) )
954  {
955  myKey = "singleBand";
956  myDefault = "StretchToMinimumMaximum";
957  }
958  else if ( dynamic_cast<QgsMultiBandColorRenderer*>( renderer() ) )
959  {
960  if ( QgsRasterBlock::typeSize( dataProvider()->srcDataType( 1 ) ) == 1 )
961  {
962  myKey = "multiBandSingleByte";
963  myDefault = "NoEnhancement";
964  }
965  else
966  {
967  myKey = "multiBandMultiByte";
968  myDefault = "StretchToMinimumMaximum";
969  }
970  }
971 
972  if ( myKey.isEmpty() )
973  {
974  QgsDebugMsg( "No default contrast enhancement for this drawing style" );
975  }
976  QgsDebugMsg( "myKey = " + myKey );
977 
978  QString myAlgorithmString = mySettings.value( "/Raster/defaultContrastEnhancementAlgorithm/" + myKey, myDefault ).toString();
979  QgsDebugMsg( "myAlgorithmString = " + myAlgorithmString );
980 
982 
983  if ( myAlgorithm == QgsContrastEnhancement::NoEnhancement )
984  {
985  return;
986  }
987 
988  QString myLimitsString = mySettings.value( "/Raster/defaultContrastEnhancementLimits", "CumulativeCut" ).toString();
990 
991  setContrastEnhancement( myAlgorithm, myLimits );
992 }
993 
999 void QgsRasterLayer::setDrawingStyle( QString const & theDrawingStyleQString )
1000 {
1001  QgsDebugMsg( "DrawingStyle = " + theDrawingStyleQString );
1002  QgsRaster::DrawingStyle drawingStyle;
1003  if ( theDrawingStyleQString == "SingleBandGray" )//no need to tr() this its not shown in ui
1004  {
1005  drawingStyle = QgsRaster::SingleBandGray;
1006  }
1007  else if ( theDrawingStyleQString == "SingleBandPseudoColor" )//no need to tr() this its not shown in ui
1008  {
1009  drawingStyle = QgsRaster::SingleBandPseudoColor;
1010  }
1011  else if ( theDrawingStyleQString == "PalettedColor" )//no need to tr() this its not shown in ui
1012  {
1013  drawingStyle = QgsRaster::PalettedColor;
1014  }
1015  else if ( theDrawingStyleQString == "PalettedSingleBandGray" )//no need to tr() this its not shown in ui
1016  {
1017  drawingStyle = QgsRaster::PalettedSingleBandGray;
1018  }
1019  else if ( theDrawingStyleQString == "PalettedSingleBandPseudoColor" )//no need to tr() this its not shown in ui
1020  {
1022  }
1023  else if ( theDrawingStyleQString == "PalettedMultiBandColor" )//no need to tr() this its not shown in ui
1024  {
1025  drawingStyle = QgsRaster::PalettedMultiBandColor;
1026  }
1027  else if ( theDrawingStyleQString == "MultiBandSingleBandGray" )//no need to tr() this its not shown in ui
1028  {
1029  drawingStyle = QgsRaster::MultiBandSingleBandGray;
1030  }
1031  else if ( theDrawingStyleQString == "MultiBandSingleBandPseudoColor" )//no need to tr() this its not shown in ui
1032  {
1034  }
1035  else if ( theDrawingStyleQString == "MultiBandColor" )//no need to tr() this its not shown in ui
1036  {
1037  drawingStyle = QgsRaster::MultiBandColor;
1038  }
1039  else if ( theDrawingStyleQString == "SingleBandColorDataStyle" )//no need to tr() this its not shown in ui
1040  {
1041  QgsDebugMsg( "Setting drawingStyle to SingleBandColorDataStyle " + QString::number( QgsRaster::SingleBandColorDataStyle ) );
1042  drawingStyle = QgsRaster::SingleBandColorDataStyle;
1043  QgsDebugMsg( "Setted drawingStyle to " + QString::number( drawingStyle ) );
1044  }
1045  else
1046  {
1047  drawingStyle = QgsRaster::UndefinedDrawingStyle;
1048  }
1049  setRendererForDrawingStyle( drawingStyle );
1050 }
1051 
1053 {
1054  QgsDebugMsg( "entered." );
1055 
1056  if ( mDataProvider )
1057  {
1058  QgsDebugMsg( "About to mDataProvider->setLayerOrder(layers)." );
1059  mDataProvider->setLayerOrder( layers );
1060  }
1061 
1062 }
1063 
1065 {
1066 
1067  if ( mDataProvider )
1068  {
1069  QgsDebugMsg( "About to mDataProvider->setSubLayerVisibility(name, vis)." );
1070  mDataProvider->setSubLayerVisibility( name, vis );
1071  }
1072 
1073 }
1074 
1076 {
1077  QgsDebugMsg( "Entered" );
1078  if ( !theRenderer ) { return; }
1079  mPipe.set( theRenderer );
1080  emit rendererChanged();
1081 }
1082 
1083 void QgsRasterLayer::showProgress( int theValue )
1084 {
1085  emit progressUpdate( theValue );
1086 }
1087 
1088 
1089 void QgsRasterLayer::showStatusMessage( QString const & theMessage )
1090 {
1091  // QgsDebugMsg(QString("entered with '%1'.").arg(theMessage));
1092 
1093  // Pass-through
1094  // TODO: See if we can connect signal-to-signal. This is a kludge according to the Qt doc.
1095  emit statusChanged( theMessage );
1096 }
1097 
1099 {
1100  return mDataProvider->subLayers();
1101 }
1102 
1104 {
1105  QPixmap myQPixmap( size );
1106 
1107  myQPixmap.fill( bgColor ); //defaults to white, set to transparent for rendering on a map
1108 
1109  QgsRasterViewPort *myRasterViewPort = new QgsRasterViewPort();
1110 
1111  double myMapUnitsPerPixel;
1112  double myX = 0.0;
1113  double myY = 0.0;
1114  QgsRectangle myExtent = mDataProvider->extent();
1115  if ( myExtent.width() / myExtent.height() >= ( double )myQPixmap.width() / myQPixmap.height() )
1116  {
1117  myMapUnitsPerPixel = myExtent.width() / myQPixmap.width();
1118  myY = ( myQPixmap.height() - myExtent.height() / myMapUnitsPerPixel ) / 2;
1119  }
1120  else
1121  {
1122  myMapUnitsPerPixel = myExtent.height() / myQPixmap.height();
1123  myX = ( myQPixmap.width() - myExtent.width() / myMapUnitsPerPixel ) / 2;
1124  }
1125 
1126  double myPixelWidth = myExtent.width() / myMapUnitsPerPixel;
1127  double myPixelHeight = myExtent.height() / myMapUnitsPerPixel;
1128 
1129  myRasterViewPort->mTopLeftPoint = QgsPoint( myX, myY );
1130  myRasterViewPort->mBottomRightPoint = QgsPoint( myPixelWidth, myPixelHeight );
1131  myRasterViewPort->mWidth = myQPixmap.width();
1132  myRasterViewPort->mHeight = myQPixmap.height();
1133 
1134  myRasterViewPort->mDrawnExtent = myExtent;
1135  myRasterViewPort->mSrcCRS = QgsCoordinateReferenceSystem(); // will be invalid
1136  myRasterViewPort->mDestCRS = QgsCoordinateReferenceSystem(); // will be invalid
1137  myRasterViewPort->mSrcDatumTransform = -1;
1138  myRasterViewPort->mDestDatumTransform = -1;
1139 
1140  QgsMapToPixel *myMapToPixel = new QgsMapToPixel( myMapUnitsPerPixel );
1141 
1142  QPainter * myQPainter = new QPainter( &myQPixmap );
1143  draw( myQPainter, myRasterViewPort, myMapToPixel );
1144  delete myRasterViewPort;
1145  delete myMapToPixel;
1146  myQPainter->end();
1147  delete myQPainter;
1148 
1149  return myQPixmap;
1150 }
1151 
1152 // this function should be used when rendering with the MTR engine introduced in 2.3, as QPixmap is not thread safe (see bug #9626)
1153 // note: previewAsImage and previewAsPixmap should use a common low-level fct QgsRasterLayer::previewOnPaintDevice( QSize size, QColor bgColor, QPaintDevice &device )
1154 QImage QgsRasterLayer::previewAsImage( QSize size, QColor bgColor, QImage::Format format )
1155 {
1156  QImage myQImage( size, format );
1157 
1158  myQImage.setColor( 0, bgColor.rgba() );
1159  myQImage.fill( 0 ); //defaults to white, set to transparent for rendering on a map
1160 
1161  QgsRasterViewPort *myRasterViewPort = new QgsRasterViewPort();
1162 
1163  double myMapUnitsPerPixel;
1164  double myX = 0.0;
1165  double myY = 0.0;
1166  QgsRectangle myExtent = mDataProvider->extent();
1167  if ( myExtent.width() / myExtent.height() >= ( double )myQImage.width() / myQImage.height() )
1168  {
1169  myMapUnitsPerPixel = myExtent.width() / myQImage.width();
1170  myY = ( myQImage.height() - myExtent.height() / myMapUnitsPerPixel ) / 2;
1171  }
1172  else
1173  {
1174  myMapUnitsPerPixel = myExtent.height() / myQImage.height();
1175  myX = ( myQImage.width() - myExtent.width() / myMapUnitsPerPixel ) / 2;
1176  }
1177 
1178  double myPixelWidth = myExtent.width() / myMapUnitsPerPixel;
1179  double myPixelHeight = myExtent.height() / myMapUnitsPerPixel;
1180 
1181  myRasterViewPort->mTopLeftPoint = QgsPoint( myX, myY );
1182  myRasterViewPort->mBottomRightPoint = QgsPoint( myPixelWidth, myPixelHeight );
1183  myRasterViewPort->mWidth = myQImage.width();
1184  myRasterViewPort->mHeight = myQImage.height();
1185 
1186  myRasterViewPort->mDrawnExtent = myExtent;
1187  myRasterViewPort->mSrcCRS = QgsCoordinateReferenceSystem(); // will be invalid
1188  myRasterViewPort->mDestCRS = QgsCoordinateReferenceSystem(); // will be invalid
1189  myRasterViewPort->mSrcDatumTransform = -1;
1190  myRasterViewPort->mDestDatumTransform = -1;
1191 
1192  QgsMapToPixel *myMapToPixel = new QgsMapToPixel( myMapUnitsPerPixel );
1193 
1194  QPainter * myQPainter = new QPainter( &myQImage );
1195  draw( myQPainter, myRasterViewPort, myMapToPixel );
1196  delete myRasterViewPort;
1197  delete myMapToPixel;
1198  myQPainter->end();
1199  delete myQPainter;
1200 
1201  return myQImage;
1202 }
1203 
1204 void QgsRasterLayer::updateProgress( int theProgress, int theMax )
1205 {
1206  Q_UNUSED( theProgress );
1207  Q_UNUSED( theMax );
1208 }
1209 
1210 void QgsRasterLayer::onProgress( int theType, double theProgress, QString theMessage )
1211 {
1212  Q_UNUSED( theType );
1213  Q_UNUSED( theMessage );
1214  QgsDebugMsg( QString( "theProgress = %1" ).arg( theProgress ) );
1215  emit progressUpdate(( int )theProgress );
1216 }
1217 
1219 //
1220 // Protected methods
1221 //
1223 /*
1224  * @param QDomNode node that will contain the symbology definition for this layer.
1225  * @param errorMessage reference to string that will be updated with any error messages
1226  * @return true in case of success.
1227  */
1228 bool QgsRasterLayer::readSymbology( const QDomNode& layer_node, QString& errorMessage )
1229 {
1230  Q_UNUSED( errorMessage );
1231  QDomElement rasterRendererElem;
1232 
1233  // pipe element was introduced in the end of 1.9 development when there were
1234  // already many project files in use so we support 1.9 backward compatibility
1235  // even it was never officialy released -> use pipe element if present, otherwise
1236  // use layer node
1237  QDomNode pipeNode = layer_node.firstChildElement( "pipe" );
1238  if ( pipeNode.isNull() ) // old project
1239  {
1240  pipeNode = layer_node;
1241  }
1242 
1243  //rasterlayerproperties element there -> old format (1.8 and early 1.9)
1244  if ( !layer_node.firstChildElement( "rasterproperties" ).isNull() )
1245  {
1246  //copy node because layer_node is const
1247  QDomNode layerNodeCopy = layer_node.cloneNode();
1248  QDomDocument doc = layerNodeCopy.ownerDocument();
1249  QDomElement rasterPropertiesElem = layerNodeCopy.firstChildElement( "rasterproperties" );
1250  QgsProjectFileTransform::convertRasterProperties( doc, layerNodeCopy, rasterPropertiesElem,
1251  this );
1252  rasterRendererElem = layerNodeCopy.firstChildElement( "rasterrenderer" );
1253  QgsDebugMsg( doc.toString() );
1254  }
1255  else
1256  {
1257  rasterRendererElem = pipeNode.firstChildElement( "rasterrenderer" );
1258  }
1259 
1260  if ( !rasterRendererElem.isNull() )
1261  {
1262  QString rendererType = rasterRendererElem.attribute( "type" );
1263  QgsRasterRendererRegistryEntry rendererEntry;
1264  if ( QgsRasterRendererRegistry::instance()->rendererData( rendererType, rendererEntry ) )
1265  {
1266  QgsRasterRenderer *renderer = rendererEntry.rendererCreateFunction( rasterRendererElem, dataProvider() );
1267  mPipe.set( renderer );
1268  }
1269  }
1270 
1271  //brightness
1273  mPipe.set( brightnessFilter );
1274 
1275  //brightness coefficient
1276  QDomElement brightnessElem = pipeNode.firstChildElement( "brightnesscontrast" );
1277  if ( !brightnessElem.isNull() )
1278  {
1279  brightnessFilter->readXML( brightnessElem );
1280  }
1281 
1282  //hue/saturation
1284  mPipe.set( hueSaturationFilter );
1285 
1286  //saturation coefficient
1287  QDomElement hueSaturationElem = pipeNode.firstChildElement( "huesaturation" );
1288  if ( !hueSaturationElem.isNull() )
1289  {
1290  hueSaturationFilter->readXML( hueSaturationElem );
1291  }
1292 
1293  //resampler
1295  mPipe.set( resampleFilter );
1296 
1297  //max oversampling
1298  QDomElement resampleElem = pipeNode.firstChildElement( "rasterresampler" );
1299  if ( !resampleElem.isNull() )
1300  {
1301  resampleFilter->readXML( resampleElem );
1302  }
1303 
1304  // get and set the blend mode if it exists
1305  QDomNode blendModeNode = layer_node.namedItem( "blendMode" );
1306  if ( !blendModeNode.isNull() )
1307  {
1308  QDomElement e = blendModeNode.toElement();
1310  }
1311 
1312  return true;
1313 } //readSymbology
1314 
1321 bool QgsRasterLayer::readXml( const QDomNode& layer_node )
1322 {
1323  QgsDebugMsg( "Entered" );
1325 
1326  //process provider key
1327  QDomNode pkeyNode = layer_node.namedItem( "provider" );
1328 
1329  if ( pkeyNode.isNull() )
1330  {
1331  mProviderKey = "gdal";
1332  }
1333  else
1334  {
1335  QDomElement pkeyElt = pkeyNode.toElement();
1336  mProviderKey = pkeyElt.text();
1337  if ( mProviderKey.isEmpty() )
1338  {
1339  mProviderKey = "gdal";
1340  }
1341  }
1342 
1343  // Open the raster source based on provider and datasource
1344 
1345  // Go down the raster-data-provider paradigm
1346 
1347  // Collect provider-specific information
1348 
1349  QDomNode rpNode = layer_node.namedItem( "rasterproperties" );
1350 
1351  if ( mProviderKey == "wms" )
1352  {
1353  // >>> BACKWARD COMPATIBILITY < 1.9
1354  // The old WMS URI format does not contain all the information, we add them here.
1355  if ( !mDataSource.contains( "crs=" ) && !mDataSource.contains( "format=" ) )
1356  {
1357  QgsDebugMsg( "Old WMS URI format detected -> adding params" );
1358  QgsDataSourceURI uri;
1359  uri.setEncodedUri( mDataSource );
1360  QDomElement layerElement = rpNode.firstChildElement( "wmsSublayer" );
1361  while ( !layerElement.isNull() )
1362  {
1363  // TODO: sublayer visibility - post-0.8 release timeframe
1364 
1365  // collect name for the sublayer
1366  uri.setParam( "layers", layerElement.namedItem( "name" ).toElement().text() );
1367 
1368  // collect style for the sublayer
1369  uri.setParam( "styles", layerElement.namedItem( "style" ).toElement().text() );
1370 
1371  layerElement = layerElement.nextSiblingElement( "wmsSublayer" );
1372  }
1373 
1374  // Collect format
1375  QDomNode formatNode = rpNode.namedItem( "wmsFormat" );
1376  uri.setParam( "format", rpNode.namedItem( "wmsFormat" ).toElement().text() );
1377 
1378  // WMS CRS URL param should not be mixed with that assigned to the layer.
1379  // In the old WMS URI version there was no CRS and layer crs().authid() was used.
1380  uri.setParam( "crs", crs().authid() );
1381  mDataSource = uri.encodedUri();
1382  }
1383  // <<< BACKWARD COMPATIBILITY < 1.9
1384  }
1385 
1386  setDataProvider( mProviderKey );
1387  if ( !mValid ) return false;
1388 
1389  QString theError;
1390  bool res = readSymbology( layer_node, theError );
1391 
1392  // old wms settings we need to correct
1393  if ( res && mProviderKey == "wms" && ( !renderer() || renderer()->type() != "singlebandcolordata" ) )
1394  {
1395  setRendererForDrawingStyle( QgsRaster::SingleBandColorDataStyle );
1396  }
1397 
1398  // Check timestamp
1399  // This was probably introduced to reload completely raster if data changed and
1400  // reset completly symbology to reflect new data type etc. It creates however
1401  // problems, because user defined symbology is complete lost if data file time
1402  // changed (the content may be the same). See also 6900.
1403 #if 0
1404  QDomNode stampNode = layer_node.namedItem( "timestamp" );
1405  if ( !stampNode.isNull() )
1406  {
1407  QDateTime stamp = QDateTime::fromString( stampNode.toElement().text(), Qt::ISODate );
1408  // TODO: very bad, we have to load twice!!! Make QgsDataProvider::timestamp() static?
1409  if ( stamp < mDataProvider->dataTimestamp() )
1410  {
1411  QgsDebugMsg( "data changed, reload provider" );
1412  closeDataProvider();
1413  init();
1414  setDataProvider( mProviderKey );
1415  if ( !mValid ) return false;
1416  }
1417  }
1418 #endif
1419 
1420  // Load user no data value
1421  QDomElement noDataElement = layer_node.firstChildElement( "noData" );
1422 
1423  QDomNodeList noDataBandList = noDataElement.elementsByTagName( "noDataList" );
1424 
1425  for ( int i = 0; i < noDataBandList.size(); ++i )
1426  {
1427  QDomElement bandElement = noDataBandList.at( i ).toElement();
1428  bool ok;
1429  int bandNo = bandElement.attribute( "bandNo" ).toInt( &ok );
1430  QgsDebugMsg( QString( "bandNo = %1" ).arg( bandNo ) );
1431  if ( ok && ( bandNo > 0 ) && ( bandNo <= mDataProvider->bandCount() ) )
1432  {
1433  mDataProvider->setUseSrcNoDataValue( bandNo, bandElement.attribute( "useSrcNoData" ).toInt() );
1434  QgsRasterRangeList myNoDataRangeList;
1435 
1436  QDomNodeList rangeList = bandElement.elementsByTagName( "noDataRange" );
1437 
1438  for ( int j = 0; j < rangeList.size(); ++j )
1439  {
1440  QDomElement rangeElement = rangeList.at( j ).toElement();
1441  QgsRasterRange myNoDataRange( rangeElement.attribute( "min" ).toDouble(),
1442  rangeElement.attribute( "max" ).toDouble() );
1443  QgsDebugMsg( QString( "min = %1 %2" ).arg( rangeElement.attribute( "min" ) ).arg( myNoDataRange.min() ) );
1444  myNoDataRangeList << myNoDataRange;
1445  }
1446  mDataProvider->setUserNoDataValue( bandNo, myNoDataRangeList );
1447  }
1448  }
1449 
1450  readStyleManager( layer_node );
1451 
1452  return res;
1453 } // QgsRasterLayer::readXml( QDomNode & layer_node )
1454 
1455 /*
1456  * @param QDomNode the node that will have the style element added to it.
1457  * @param QDomDocument the document that will have the QDomNode added.
1458  * @param errorMessage reference to string that will be updated with any error messages
1459  * @return true in case of success.
1460  */
1461 bool QgsRasterLayer::writeSymbology( QDomNode & layer_node, QDomDocument & document, QString& errorMessage ) const
1462 {
1463  Q_UNUSED( errorMessage );
1464  QDomElement layerElem = layer_node.toElement();
1465 
1466  // Store pipe members (except provider) into pipe element, in future, it will be
1467  // possible to add custom filters into the pipe
1468  QDomElement pipeElement = document.createElement( "pipe" );
1469 
1470  for ( int i = 1; i < mPipe.size(); i++ )
1471  {
1472  QgsRasterInterface * interface = mPipe.at( i );
1473  if ( !interface ) continue;
1474  interface->writeXML( document, pipeElement );
1475  }
1476 
1477  layer_node.appendChild( pipeElement );
1478 
1479  // add blend mode node
1480  QDomElement blendModeElement = document.createElement( "blendMode" );
1482  blendModeElement.appendChild( blendModeText );
1483  layer_node.appendChild( blendModeElement );
1484 
1485  return true;
1486 } // bool QgsRasterLayer::writeSymbology
1487 
1488 /*
1489  * virtual
1490  * @note Called by QgsMapLayer::writeXML().
1491  */
1493  QDomDocument & document )
1494 {
1495  // first get the layer element so that we can append the type attribute
1496 
1497  QDomElement mapLayerNode = layer_node.toElement();
1498 
1499  if ( mapLayerNode.isNull() || "maplayer" != mapLayerNode.nodeName() )
1500  {
1501  QgsMessageLog::logMessage( tr( "<maplayer> not found." ), tr( "Raster" ) );
1502  return false;
1503  }
1504 
1505  mapLayerNode.setAttribute( "type", "raster" );
1506 
1507  // add provider node
1508 
1509  QDomElement provider = document.createElement( "provider" );
1510  QDomText providerText = document.createTextNode( mProviderKey );
1511  provider.appendChild( providerText );
1512  layer_node.appendChild( provider );
1513 
1514  // User no data
1515  QDomElement noData = document.createElement( "noData" );
1516 
1517  for ( int bandNo = 1; bandNo <= mDataProvider->bandCount(); bandNo++ )
1518  {
1519  QDomElement noDataRangeList = document.createElement( "noDataList" );
1520  noDataRangeList.setAttribute( "bandNo", bandNo );
1521  noDataRangeList.setAttribute( "useSrcNoData", mDataProvider->useSrcNoDataValue( bandNo ) );
1522 
1523  foreach ( QgsRasterRange range, mDataProvider->userNoDataValues( bandNo ) )
1524  {
1525  QDomElement noDataRange = document.createElement( "noDataRange" );
1526 
1527  noDataRange.setAttribute( "min", range.min() );
1528  noDataRange.setAttribute( "max", range.max() );
1529  noDataRangeList.appendChild( noDataRange );
1530  }
1531 
1532  noData.appendChild( noDataRangeList );
1533 
1534  }
1535  if ( noData.hasChildNodes() )
1536  {
1537  layer_node.appendChild( noData );
1538  }
1539 
1540  writeStyleManager( layer_node, document );
1541 
1542  //write out the symbology
1543  QString errorMsg;
1544  return writeSymbology( layer_node, document, errorMsg );
1545 }
1546 
1548 {
1549  if ( !mDataProvider ) return 0;
1550  return mDataProvider->xSize();
1551 }
1552 
1554 {
1555  if ( !mDataProvider ) return 0;
1556  return mDataProvider->ySize();
1557 }
1558 
1560 //
1561 // Private methods
1562 //
1564 bool QgsRasterLayer::update()
1565 {
1566  QgsDebugMsg( "entered." );
1567  // Check if data changed
1568  if ( mDataProvider->dataTimestamp() > mDataProvider->timestamp() )
1569  {
1570  QgsDebugMsg( "reload data" );
1571  closeDataProvider();
1572  init();
1573  setDataProvider( mProviderKey );
1574  emit dataChanged();
1575  }
1576  return mValid;
1577 }
uchar * scanLine(int i)
bool draw(QgsRenderContext &rendererContext) override
This is called when the view on the raster layer needs to be redrawn.
QgsDataProvider * classFactoryFunction_t(const QString *)
static void convertRasterProperties(QDomDocument &doc, QDomNode &parentNode, QDomElement &rasterPropertiesElem, QgsRasterLayer *rlayer)
bool readSymbology(const QDomNode &node, QString &errorMessage) override
Read the symbology for the current layer from the Dom node supplied.
virtual int bandCount() const =0
Get number of bands.
virtual void setSubLayerVisibility(const QString &name, bool vis)
Set the visibility of the given sublayer name.
void setRenderer(QgsRasterRenderer *theRenderer)
Set raster renderer.
#define ERR(message)
QDomNodeList elementsByTagName(const QString &tagname) const
QString toString(Qt::DateFormat format) const
void setContrastEnhancementAlgorithm(ContrastEnhancementAlgorithm, bool generateTable=true)
Set the contrast enhancement algorithm.
IdentifyFormat
Definition: qgsraster.h:54
A rectangle specified with double values.
Definition: qgsrectangle.h:35
Base class for all map layer types.
Definition: qgsmaplayer.h:49
Interface for all raster shaders.
virtual QDateTime timestamp() const override
Time stamp of data source in the moment when data/metadata were loaded by provider.
bool isEmpty() const
test if rectangle is empty.
virtual QStringList subLayers() const override
Returns the sublayers of this layer - Useful for providers that manage their own layers, such as WMS.
double rasterUnitsPerPixelY()
QgsMapLayer::LayerType type() const
Get the type of the layer.
Definition: qgsmaplayer.cpp:93
int width() const
double sum
The sum of all cells in the band.
void setCRS(const QgsCoordinateReferenceSystem &theSrcCRS, const QgsCoordinateReferenceSystem &theDestCRS, int srcDatumTransform=-1, int destDatumTransform=-1)
set source and destination CRS
bool end()
Iterator for sequentially processing raster cells.
QDomNode appendChild(const QDomNode &newChild)
void fill(const QColor &color)
DrawingStyle
This enumerator describes the different kinds of drawing we can do.
Definition: qgsraster.h:95
A ramp shader will color a raster pixel based on a list of values ranges in a ramp.
QString attribute(const QString &name, const QString &defValue) const
static QgsProviderRegistry * instance(QString pluginPath=QString::null)
means of accessing canonical single instance
void setEncodedUri(const QByteArray &uri)
set complete encoded uri (generic mode)
#define QgsDebugMsg(str)
Definition: qgslogger.h:33
virtual QgsCoordinateReferenceSystem crs()=0
QString toString(int indent) const
virtual void setLayerOrder(const QStringList &layers) override
Reorders the previously selected sublayers of this layer from bottom to top.
static ContrastEnhancementLimits contrastEnhancementLimitsFromString(QString theLimits)
Definition: qgsraster.cpp:39
void setDefaultContrastEnhancement()
Set default contrast enhancement.
virtual void setUseSrcNoDataValue(int bandNo, bool use)
Set source nodata value usage.
virtual double srcNoDataValue(int bandNo) const
Value representing no data value.
void setCustomProperty(const QString &key, const QVariant &value)
Set a custom property for layer.
double maximumValue
The maximum cell value in the raster band.
int mWidth
Width, number of columns to be rendered.
QDomElement nextSiblingElement(const QString &tagName) const
QgsRasterInterface * last() const
Definition: qgsrasterpipe.h:86
virtual QgsRasterRangeList userNoDataValues(int bandNo) const
Get list of user no data value ranges.
static QDateTime lastModified(const QString &name)
Return time stamp for given file name.
Raster values range container.
static bool isValidRasterFileName(const QString &theFileNameQString, QString &retError)
This helper checks to see whether the file name appears to be a valid raster file name...
Resample filter pipe for rasters.
Abstract base class for spatial data provider implementations.
void setColorRampItemList(const QList< QgsColorRampShader::ColorRampItem > &theList)
Set custom colormap.
void readXML(const QDomElement &filterElem) override
Sets base class members from xml.
static const double SAMPLE_SIZE
Default sample size (number of pixels) for estimated statistics/histogram calculation.
Q_DECL_DEPRECATED void updateProgress(int, int)
bool readXml(const QDomNode &layer_node) override
Reads layer specific state from project file Dom node.
Implementation of threaded rendering for raster layers.
double toDouble(bool *ok) const
QString tr(const char *sourceText, const char *disambiguation, int n)
void setBlendMode(const QPainter::CompositionMode &blendMode)
Set the blending mode used for rendering a layer.
QString mLayerName
Name of the layer - used for display.
Definition: qgsmaplayer.h:578
virtual bool render() override
Do the rendering (based on data stored in the class)
void setShader(QgsRasterShader *shader)
Takes ownership of the shader.
BlendMode
Blending modes enum defining the available composition modes that can be used when rendering a layer...
void setColor(int index, QRgb colorValue)
double rasterUnitsPerPixelX()
Returns the number of raster units per each raster pixel.
virtual int ySize() const
void setGreenContrastEnhancement(QgsContrastEnhancement *ce)
Takes ownership.
static QString identifyFormatName(QgsRaster::IdentifyFormat format)
int size() const
static void logMessage(QString message, QString tag=QString::null, MessageLevel level=WARNING)
add a message to the instance (and create it if necessary)
int size() const
Definition: qgsrasterpipe.h:84
QgsCoordinateReferenceSystem mDestCRS
Target coordinate system.
Q_DECL_DEPRECATED void setDrawingStyle(const QString &theDrawingStyleQString)
Overloaded version of the above function for convenience when restoring from xml. ...
T value(int i) const
virtual bool useSrcNoDataValue(int bandNo) const
Get source nodata value usage.
QDomElement toElement() const
const QString & name() const
Get the display name of the layer.
void onProgress(int, double, QString)
receive progress signal from provider
Perform transforms between map coordinates and device coordinates.
Definition: qgsmaptopixel.h:34
bool writeSymbology(QDomNode &, QDomDocument &doc, QString &errorMessage) const override
Write the symbology for the layer into the docment provided.
virtual QgsRasterBandStats bandStatistics(int theBandNo, int theStats=QgsRasterBandStats::All, const QgsRectangle &theExtent=QgsRectangle(), int theSampleSize=0)
Get band statistics.
The drawing pipe for raster layers.
double stdDev
The standard deviation of the cell values.
virtual void setSubLayerVisibility(QString name, bool vis) override
Set the visibility of the given sublayer name.
int elapsed() const
QString number(int n, int base)
The RasterBandStats struct is a container for statistics about a single raster band.
static QgsRasterRendererRegistry * instance()
void setError(const QgsError &theError)
Set error message.
Definition: qgsmaplayer.h:566
double mean
The mean cell value for the band.
int height() const
Accessor that returns the height of the (unclipped) raster.
QPainter::CompositionMode blendMode() const
Returns the current blending mode for a layer.
void append(const T &value)
void readStyleManager(const QDomNode &layerNode)
Read style manager's configuration (if any).
QDomDocument ownerDocument() const
void setRedContrastEnhancement(QgsContrastEnhancement *ce)
Takes ownership.
QString text() const
QgsRasterRenderer * renderer() const
void fill(uint pixelValue)
virtual void setUserNoDataValue(int bandNo, QgsRasterRangeList noData)
int bandCount() const
Get the number of bands in this layer.
QgsDataProvider * provider(const QString &providerKey, const QString &dataSource)
Create an instance of the provider.
virtual QGis::DataType srcDataType(int bandNo) const override=0
Returns source data type for the band specified by number, source data type may be shorter than dataT...
void setParam(const QString &key, const QString &value)
Set generic param (generic mode)
void setCrs(const QgsCoordinateReferenceSystem &srs, bool emitSignal=true)
Sets layer's spatial reference system.
int width() const
virtual QStringList subLayers() const override
Returns the sublayers of this layer - useful for providers that manage their own layers, such as WMS.
void setAttribute(const QString &name, const QString &value)
void writeStyleManager(QDomNode &layerNode, QDomDocument &doc) const
Write style manager's configuration (if exists).
int toInt(bool *ok, int base) const
void statusChanged(QString theStatus)
Emit a signal with status (e.g.
virtual void setExtent(const QgsRectangle &rect)
Set the extent.
QString metadata() override
Obtain GDAL Metadata for this layer.
bool shade(double, int *, int *, int *, int *) override
Generates and new RGB value based on one input value.
static const double CUMULATIVE_CUT_UPPER
Default cumulative cut upper limit.
QString nodeName() const
~QgsRasterLayer()
The destructor.
ContrastEnhancementLimits
Contrast enhancement limits.
Definition: qgsraster.h:86
bool isEmpty() const
qgssize elementCount
The number of not no data cells in the band.
void setMinimumValue(double, bool generateTable=true)
Return the minimum value for the contrast enhancement range.
Raster renderer pipe for single band pseudocolor.
QImage previewAsImage(QSize size, QColor bgColor=Qt::white, QImage::Format format=QImage::Format_ARGB32_Premultiplied)
Draws a preview of the rasterlayer into a QImage.
const QString bandName(int theBandNoInt)
Get the name of a band given its number.
bool isvalidrasterfilename_t(QString const &theFileNameQString, QString &retErrMsg)
double min() const
Raster renderer pipe for single band gray.
virtual QString generateBandName(int theBandNumber) const
helper function to create zero padded band names
QgsRasterResampleFilter * resampleFilter() const
Set raster resample filter.
static int typeSize(int dataType)
virtual QgsMapLayerRenderer * createMapRenderer(QgsRenderContext &rendererContext) override
Return new instance of QgsMapLayerRenderer that will be used for rendering of given context...
virtual void setLayerOrder(const QStringList &layers)
Reorder the list of layer names to be rendered by this provider (in order from bottom to top) ...
QgsRasterProjector * projector() const
QDateTime lastModified() const
void rendererChanged()
Signal emitted when renderer is changed.
void setAlphaBand(int band)
bool mValid
Indicates if the layer is valid and can be drawn.
Definition: qgsmaplayer.h:572
void setContrastEnhancement(QgsContrastEnhancement::ContrastEnhancementAlgorithm theAlgorithm, QgsRaster::ContrastEnhancementLimits theLimits=QgsRaster::ContrastEnhancementMinMax, QgsRectangle theExtent=QgsRectangle(), int theSampleSize=SAMPLE_SIZE, bool theGenerateLookupTableFlag=true)
Set contrast enhancement algorithm.
void setDataProvider(const QString &provider)
[ data provider interface ] Set the data provider
void setRasterShaderFunction(QgsRasterShaderFunction *)
A public method that allows the user to set their own shader function.
Base class for processing filters like renderers, reprojector, resampler etc.
A class to represent a point.
Definition: qgspoint.h:63
bool hasChildNodes() const
void setColorRampType(QgsColorRampShader::ColorRamp_TYPE theColorRampType)
Set the color ramp type.
Q_DECL_DEPRECATED QPixmap previewAsPixmap(QSize size, QColor bgColor=Qt::white)
Draws a preview of the rasterlayer into a pixmap.
QDomText createTextNode(const QString &value)
bool exists() const
Class for storing the component parts of a PostgreSQL/RDBMS datasource URI.
QPixmap paletteAsPixmap(int theBandNumber=1)
Get an 100x100 pixmap of the color palette.
QDomNode namedItem(const QString &name) const
bool contains(QChar ch, Qt::CaseSensitivity cs) const
static ContrastEnhancementAlgorithm contrastEnhancementAlgorithmFromString(const QString &contrastEnhancementString)
virtual int capabilities() const
Returns a bitmask containing the supported capabilities.
int height() const
virtual int colorInterpretation(int theBandNo) const
Returns data type for the band specified by number.
QDateTime fromString(const QString &string, Qt::DateFormat format)
QgsCoordinateReferenceSystem mSrcCRS
Source coordinate system.
bool isNull() const
void progressUpdate(int theValue)
Signal for notifying listeners of long running processes.
static QPainter::CompositionMode getCompositionMode(const QgsMapRenderer::BlendMode &blendMode)
Returns a QPainter::CompositionMode corresponding to a BlendMode.
void showProgress(int theValue)
[ data provider interface ] A wrapper function to emit a progress update signal
virtual QgsRectangle extent() override=0
Get the extent of the data source.
Registry for raster renderer entries.
virtual QGis::DataType dataType(int bandNo) const override=0
Returns data type for the band specified by number.
QgsPoint mBottomRightPoint
Coordinate (in output device coordinate system) of bottom right corner of the part of the raster that...
void setContrastEnhancement(QgsContrastEnhancement *ce)
Takes ownership.
ContrastEnhancementAlgorithm
This enumerator describes the types of contrast enhancement algorithms that can be used...
QVariant value(const QString &key, const QVariant &defaultValue) const
Contains information about the context of a rendering operation.
virtual void legendSymbologyItems(QList< QPair< QString, QColor > > &symbolItems) const
Get symbology items if provided by renderer.
static QgsMapLayerLegend * defaultRasterLegend(QgsRasterLayer *rl)
Create new legend implementation for raster layer.
void drawImage(const QRectF &target, const QImage &image, const QRectF &source, QFlags< Qt::ImageConversionFlag > flags)
bool remove(int idx)
Remove and delete interface at given index if possible.
virtual int xSize() const
Get raster size.
QString mDataSource
data source description string, varies by layer type
Definition: qgsmaplayer.h:575
virtual QString loadDefaultStyle(bool &theResultFlag)
Retrieve the default style for this layer if one exists (either as a .qml file on disk or as a record...
bool writeXml(QDomNode &layer_node, QDomDocument &doc) override
Write layer specific state to project file Dom node.
QDomNode cloneNode(bool deep) const
virtual QString type() const
virtual QString metadata()=0
Get metadata in a format suitable for feeding directly into a subset of the GUI raster properties "Me...
void readXML(const QDomElement &filterElem) override
Sets base class members from xml.
virtual void reloadData()
Reloads the data from the source.
virtual bool isValid()=0
Returns true if this is a valid layer.
void repaintRequested()
By emitting this signal the layer tells that either appearance or content have been changed and any v...
QDomElement firstChildElement(const QString &tagName) const
int mHeight
Distance in map units from bottom edge to top edge for the part of the raster that is to be rendered...
Brightness/contrast filter pipe for rasters.
Class for storing a coordinate reference system (CRS)
Color and saturation filter pipe for rasters.
static const double CUMULATIVE_CUT_LOWER
Default cumulative cut lower limit.
DataType
Raster data types.
Definition: qgis.h:204
virtual QString description() const =0
return description
double range
The range is the distance between min & max.
void setBlueContrastEnhancement(QgsContrastEnhancement *ce)
Takes ownership.
QgsHueSaturationFilter * hueSaturationFilter() const
double minimumValue
The minimum cell value in the raster band.
Renderer for multiband images with the color components.
void dataChanged()
data of layer changed
Base class for utility classes that encapsulate information necessary for rendering of map layers...
void setLayerName(const QString &name)
Set the display name of the layer.
const QgsCoordinateReferenceSystem & crs() const
Returns layer's spatial reference system.
void * function(const QString &providerKey, const QString &functionName)
Get pointer to provider function.
void appendError(const QgsErrorMessage &theMessage)
Add error message.
Definition: qgsmaplayer.h:564
Manipulates raster pixel values so that they enhanceContrast or clip into a specified numerical range...
double max() const
void start()
int height() const
QByteArray encodedUri() const
return complete encoded uri (generic mode)
double toDouble(bool *ok) const
void(*)() cast_to_fptr(void *p)
Definition: qgis.h:323
QgsRasterDataProvider * dataProvider()
Returns the data provider.
static QgsMapRenderer::BlendMode getBlendModeEnum(const QPainter::CompositionMode &blendMode)
Returns a BlendMode corresponding to a QPainter::CompositionMode.
QString providerType() const
[ data provider interface ] Which provider is being used for this Raster Layer?
QgsPoint mTopLeftPoint
Coordinate (in output device coordinate system) of top left corner of the part of the raster that is ...
virtual bool srcHasNoDataValue(int bandNo) const
Return true if source band has no data value.
This class provides details of the viewable area that a raster will be rendered into.
int size() const
QDomElement createElement(const QString &tagName)
virtual void reload() override
Synchronises with changes in the datasource.
void readXML(const QDomElement &filterElem) override
Sets base class members from xml.
void setLegend(QgsMapLayerLegend *legend)
Assign a legend controller to the map layer.
double width() const
Width of the rectangle.
Definition: qgsrectangle.h:202
virtual void cumulativeCut(int theBandNo, double theLowerCount, double theUpperCount, double &theLowerValue, double &theUpperValue, const QgsRectangle &theExtent=QgsRectangle(), int theSampleSize=0)
Find values for cumulative pixel count cut.
bool connect(const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
virtual QList< QgsColorRampShader::ColorRampItem > colorTable(int bandNo) const
QgsLegendColorList legendSymbologyItems() const
Returns a list with classification items (Text and color)
QString toString(bool automaticPrecision=false) const
returns string representation of form xmin,ymin xmax,ymax
QgsRasterRenderer * renderer() const
bool set(QgsRasterInterface *theInterface)
Insert a new known interface in default place or replace interface of the same role if it already exi...
QString toString() const
virtual QgsError error() const
Get current status error.
Raster renderer pipe that applies colors to a raster.
QgsRasterRendererCreateFunc rendererCreateFunction
virtual QString dataSourceUri() const
Get the data source specification.
void setMaximumValue(double, bool generateTable=true)
Set the maximum value for the contrast enhancement range.
void showStatusMessage(const QString &theMessage)
virtual QDateTime dataTimestamp() const override
Current time stamp of data source.
QRgb rgba() const
double height() const
Height of the rectangle.
Definition: qgsrectangle.h:207
QgsBrightnessContrastFilter * brightnessFilter() const
QDomNode at(int index) const
QgsRectangle mDrawnExtent
Intersection of current map extent and layer extent.
QString toProj4() const
Get the Proj Proj4 string representation of this srs.
Base class for raster data providers.
int width() const
Accessor that returns the width of the (unclipped) raster.
double sumOfSquares
The sum of the squares.
#define tr(sourceText)
QgsRasterLayer()
Constructor.