qgis · Jan 6, 2017
diff --git a/‎doc/api_break.dox
Lines changed: 1 addition & 0 deletions b/‎doc/api_break.dox
Lines changed: 1 addition & 0 deletions
diff --git a/‎python/core/composer/qgscomposition.sip
Lines changed: 9 additions & 1 deletion b/‎python/core/composer/qgscomposition.sip
Lines changed: 9 additions & 1 deletion
@@ -615,6 +615,7 @@ QgsComposerTableV2        {#qgis_api_break_3_0_QgsComposerTableV2}
 QgsComposition        {#qgis_api_break_3_0_QgsComposition}
 --------------
 
+- constructor requires QgsProject instance as the second argument
 - addItemsFromXML() has been renamed to addItemsFromXml()
 - Constructor with QgsMapRenderer parameter has been removed. Use the variant with QgsMapSettings parameter.
 - mapRenderer() has been removed. Use mapSettings() instead.
 
@@ -40,7 +40,7 @@ class QgsComposition : QGraphicsScene, QgsExpressionContextGenerator
       Landscape
     };
 
-    explicit QgsComposition( const QgsMapSettings& mapSettings );
+    explicit QgsComposition( const QgsMapSettings& mapSettings, QgsProject* project );
 
     /** Composition atlas modes*/
     enum AtlasMode
@@ -52,6 +52,14 @@ class QgsComposition : QGraphicsScene, QgsExpressionContextGenerator
 
     ~QgsComposition();
 
+    /**
+     * The project associated with the composition. Used to get access to layers, map themes,
+     * relations and various other bits. It is never null.
+     *
+     * \note Added in QGIS 3.0
+     */
+    QgsProject* project() const;
+
     /** Changes size of paper item.
      * @param width page width in mm
      * @param height page height in mm