/usr/include/qgis/qgsmaplayerrenderer.h is in libqgis-dev 2.8.6+dfsg-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 | /***************************************************************************
qgsmaplayerrenderer.h
--------------------------------------
Date : December 2013
Copyright : (C) 2013 by Martin Dobias
Email : wonder dot sk at gmail dot com
***************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
***************************************************************************/
#ifndef QGSMAPLAYERRENDERER_H
#define QGSMAPLAYERRENDERER_H
#include <QStringList>
/**
* Base class for utility classes that encapsulate information necessary
* for rendering of map layers. The rendering is typically done in a background
* thread, so it is necessary to keep all structures required for rendering away
* from the original map layer because it may change any time.
*
* Because the data needs to be copied (to avoid the need for locking),
* is is highly desirable to use copy-on-write where possible. This way,
* the overhead of copying (both memory and CPU) will be kept low.
* Qt containers and various Qt classes use implicit sharing.
*
* The scenario will be:
* 1. renderer job (doing preparation in the GUI thread) calls
* QgsMapLayer::createMapRenderer() and gets instance of this class.
* The instance is initialized at that point and should not need
* additional calls to QgsVectorLayer.
* 2. renderer job (still in GUI thread) stores the renderer for later use.
* 3. renderer job (in worker thread) calls QgsMapLayerRenderer::render()
* 4. renderer job (again in GUI thread) will check errors() and report them
*
* @note added in 2.4
*/
class CORE_EXPORT QgsMapLayerRenderer
{
public:
QgsMapLayerRenderer( const QString& layerID ) : mLayerID( layerID ) {}
virtual ~QgsMapLayerRenderer() {}
//! Do the rendering (based on data stored in the class)
virtual bool render() = 0;
//! Return list of errors (problems) that happened during the rendering
QStringList errors() const { return mErrors; }
//! Get access to the ID of the layer rendered by this class
QString layerID() const { return mLayerID; }
protected:
QStringList mErrors;
QString mLayerID;
};
#endif // QGSMAPLAYERRENDERER_H
|