Разработка простого расширения для QGIS на Python - История изменений

Gornak: /* Разработка */

2018-11-05T20:10:14Z

Разработка

← Предыдущая версия		Версия от 22:10, 5 ноября 2018
Строка 83:		Строка 83:
	=== Разработка ===		=== Разработка ===

	Разработка начинается с файла <tt>__init__.py</tt>. Главным фрагментом кода является импорт исполняемой части расширения, содержащейся в файле <tt>~~plugin~~.py</tt> (поэтому <tt>from testplugin</tt>) и содержащей всю содержательную часть кода.		Разработка начинается с файла <tt>__init__.py</tt>. Главным фрагментом кода является импорт исполняемой части расширения, содержащейся в файле <tt>testplugin.py</tt> (поэтому <tt>from testplugin</tt>) и содержащей всю содержательную часть кода.

	<syntaxhighlight lang="python">		<syntaxhighlight lang="python">

Elf: Уточнение ОС для раздела "Интернационализация"

2017-03-21T11:12:06Z

Уточнение ОС для раздела "Интернационализация"

← Предыдущая версия		Версия от 13:12, 21 марта 2017
Строка 179:		Строка 179:
	=== Интернационализация ===		=== Интернационализация ===
	Интернационализация позволяет сделать ваш плагин доступным на разных языках. [https://ru.wikipedia.org/wiki/Интернационализация Об интернационализации на wiki]		Интернационализация позволяет сделать ваш плагин доступным на разных языках. [https://ru.wikipedia.org/wiki/Интернационализация Об интернационализации на wiki]
	В качестве примера рассмотрим добавление перевода на русский язык.		В качестве примера рассмотрим добавление перевода на русский язык. Команды в данном разделе указаны для систем Ubuntu/Debian.
	Для начала нам потребуется внести изменения в код файла <tt>testplugin.py</tt>.		Для начала нам потребуется внести изменения в код файла <tt>testplugin.py</tt>.
	Добавим импорт нового модуля <tt>os</tt>, который позволит нам обращаться к файловой системе. Добавьте перед существующими "импортами":		Добавим импорт нового модуля <tt>os</tt>, который позволит нам обращаться к файловой системе. Добавьте перед существующими "импортами":
Строка 238:		Строка 238:
	<pre>sudo apt-get install pyqt4-dev-tools</pre>		<pre>sudo apt-get install pyqt4-dev-tools</pre>

	Данная команда подходит для систем Ubuntu/Debian. Если у вас Windows и команды <tt>pylupdate4</tt> и <tt>linguist</tt> недоступны, то установите [http://pyqt.sourceforge.net/Docs/PyQt4/installation.html PyQt4]. В терминале выполняем команды:		В терминале выполняем команды:

	<pre>cd i18n		<pre>cd i18n

Elf: Добавлен раздел об интернационализации. На гитхабе сделан pull request c изменениями кода.

2017-03-13T23:10:57Z

Добавлен раздел об интернационализации. На гитхабе сделан pull request c изменениями кода.

@@ Строка 17: / Строка 17: @@
 * добавит новую кнопку на панель инструментов
 * добавит подменю в меню расширений
-* выполнит простое действие.
+* выполнит простое действие
 Это расширение можно будет использовать как каркас для других будущих, более функциональных расширений. Далее мы более подробно разберем процесс создания по шагам.
@@ Строка 175: / Строка 176: @@
      QMessageBox.information(self.iface.mainWindow(),"About",infoString)
 </syntaxhighlight>
 === Какие функции из API доступны через Python ===

KolesovDmitry: /* Разработка */

2015-06-06T14:17:12Z

Разработка

← Предыдущая версия		Версия от 16:17, 6 июня 2015
Строка 127:		Строка 127:

	<syntaxhighlight lang="python">		<syntaxhighlight lang="python">
	import resources def initGui(self):		import resources
			def initGui(self):
	"""Инициализируем графический интерфейс пользователя"""		"""Инициализируем графический интерфейс пользователя"""
	#проверим, не пытаются ли запустить плагин из QGIS версии ниже 2.0//check if the plugin is ran below 2.0		#проверим, не пытаются ли запустить плагин из QGIS версии ниже 2.0//check if the plugin is ran below 2.0

Максим Дубинин: /* Заключение */

2013-11-16T11:50:33Z

Заключение

← Предыдущая версия		Версия от 13:50, 16 ноября 2013
Строка 227:		Строка 227:
	=== Заключение ===		=== Заключение ===

	Разработка каркаса нашего расширения завершена. Если она велась в ~~нужной~~ папке, то после запуска QGIS ~~оно~~ должно автоматически в списке расширений и можно начать его тестирование, отладку и, конечно, наполнение нужными полезными функциями.		Разработка каркаса нашего расширения завершена. Если она велась в папке расширений, то после запуска QGIS расширение должно автоматически появиться в списке расширений и можно начать его тестирование, отладку и, конечно, наполнение нужными полезными функциями.

	Помните, что лучшим пособием по разработке для QGIS являются расширения созданные другими авторами.		Помните, что лучшим пособием по разработке для QGIS являются расширения созданные другими авторами.

	О том как организовать репозиторий расширений на своем сайте, для удобного их широкого распространения мы расскажем в следующих статьях.

	=== Ссылки по теме ===		=== Ссылки по теме ===

Максим Дубинин: /* Подготовка */

2013-11-16T11:49:14Z

Подготовка

← Предыдущая версия		Версия от 13:49, 16 ноября 2013
Строка 33:		Строка 33:
	* Любой текстовый редактор		* Любой текстовый редактор
	* Python, лучше версии 2.5-2.7.х (3.x не подойдет)		* Python, лучше версии 2.5-2.7.х (3.x не подойдет)
	* PyQt
	* Qt Opensource
	* QGIS версии 2.0 и выше, для проверки работоспособности расширения.		* QGIS версии 2.0 и выше, для проверки работоспособности расширения.

			Если вы установили QGIS с помощью установщика [http://gis-lab.info/qa/qgis-osgeo4w.html osgeo4w] или [http://nextgis.ru/nextgis-qgis NextGIS QGIS], то у вас уже есть все необходимое для разработки. Ничего дополнительно устанавливать не нужно.

	Разработку можно вести прямо в папке, где хранятся расширения или переместить его в нее после разработки, в QGIS эта папка либо <tt>QGIS\python\plugins</tt> либо </tt>C:\Documents and Settings\username\.qgis2\python\plugins\</tt>.		Разработку можно вести прямо в папке, где хранятся расширения или переместить его в нее после разработки, в QGIS эта папка либо <tt>QGIS\python\plugins</tt> либо </tt>C:\Documents and Settings\username\.qgis2\python\plugins\</tt>.

Максим Дубинин: /* Ресурсы */

2013-11-16T11:43:58Z

Ресурсы

← Предыдущая версия		Версия от 13:43, 16 ноября 2013
Строка 223:		Строка 223:
	</pre>		</pre>

	И как уже упоминалось выше, импортировать получившиеся ресурсы в основном коде <tt>~~plugin~~.py</tt>.		И как уже упоминалось выше, импортировать получившиеся ресурсы в основном коде <tt>testplugin.py</tt>.

	=== Заключение ===		=== Заключение ===

Максим Дубинин: /* Ресурсы */

2013-11-16T11:43:43Z

Ресурсы

← Предыдущая версия		Версия от 13:43, 16 ноября 2013
Строка 209:		Строка 209:
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<RCC>		<RCC>
	<qresource prefix="~~/plugins/testplugin~~" >		<qresource prefix="" >
	<file>icon.png</file>		<file>icons/icon.png</file>
	</qresource>		</qresource>
	</RCC>		</RCC>

Максим Дубинин: /* Какие функции из API доступны через Python */

2013-11-16T11:42:53Z

Какие функции из API доступны через Python

← Предыдущая версия		Версия от 13:42, 16 ноября 2013
Строка 200:		Строка 200:

	<pre>		<pre>
	['__class__', '__delattr__', '__doc__', '__getattribute__', '__hash__', '__init__', '__module__',		['__class__', '__delattr__', '__delitem__', '__dict__', '__doc__', '__format__', '__getattribute__', '__getitem__', '__hash__', '__init__', '__iter__', '__module__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__setitem__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__', 'attribute', 'attributes', 'deleteAttribute', 'fieldNameIndex', 'fields', 'geometry', 'geometryAndOwnership', 'id', 'initAttributes', 'isValid', 'setAttribute', 'setAttributes', 'setFeatureId', 'setFields', 'setGeometry', 'setGeometryAndOwnership', 'setValid']
	'__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__str__', '__weakref__', '~~addAttribute~~',
	'~~attributeMap~~', '~~changeAttribute~~', '~~clean~~', '~~deleteAttribute~~', 'geometry', 'geometryAndOwnership', 'id',
	'~~isDirty~~', 'isValid', '~~setAttributeMap~~', '~~setFeatureId~~', '~~setGeometry~~', '~~setGeometryAndOwnership~~', '~~setTypeName~~',
	'~~setValid~~', '~~typeName~~']
	</pre>		</pre>

Максим Дубинин: /* Какие функции из API доступны через Python */

2013-11-16T11:42:13Z

Какие функции из API доступны через Python

← Предыдущая версия		Версия от 13:42, 16 ноября 2013
Строка 177:		Строка 177:
	=== Какие функции из API доступны через Python ===		=== Какие функции из API доступны через Python ===

	К сожалению, не все функции API QGIS доступны через Python (через C++ доступны все). Чтобы определить, доступны ли конкретные классы и функции, необходимо сначала найти их в документации к API GIS [http://doc.qgis.org/ http://doc.qgis.org]. А затем в консоли Python определить с помощью команды <tt>dir</tt> видны ли эти классы и функции из Python.		К сожалению, не все функции API QGIS доступны через Python (через C++ доступны все). Чтобы определить, доступны ли конкретные классы и функции, необходимо сначала найти их в документации к API GIS [http://doc.qgis.org/ http://doc.qgis.org]. А затем в консоли Python (Модули\Консоль Python) определить с помощью команды <tt>dir</tt> видны ли эти классы и функции из Python.

	Например, определим доступные классы:		Например, определим доступные классы:
Строка 188:		Строка 188:
	Результат:		Результат:
	<pre>		<pre>
	['DEFAULT_LINE_WIDTH', 'DEFAULT_POINT_SIZE', 'ELLPS_PREFIX_LEN', 'GEOCRS_ID', 'GEOPROJ4', 'GEOSRID', '~~GEOWkt~~',		['DEFAULT_LINE_WIDTH', 'DEFAULT_POINT_SIZE', 'DEFAULT_SEGMENT_EPSILON', 'ELLPS_PREFIX_LEN', 'GEOCRS_ID', 'GEOPROJ4', 'GEOSRID', 'GEOWKT', 'GEO_EPSG_CRS_AUTHID', 'GEO_EPSG_CRS_ID', 'GEO_NONE', 'LAT_PREFIX_LEN', 'MINIMUM_POINT_SIZE', 'NULL', 'PROJECT_SCALES', 'PROJ_PREFIX_LEN', 'QGis', 'QgsAbstractCacheIndex', 'QgsAbstractFeatureIterator', 'QgsAction', 'QgsAddRemoveItemCommand', 'QgsAddRemoveMultiFrameCommand', 'QgsApplication', 'QgsAtlasComposition', 'QgsAttributeAction', 'QgsAttributeEditorContainer', 'QgsAttributeEditorElement', 'QgsAttributeEditorField', 'QgsBilinearRasterResampler', 'QgsBrightnessContrastFilter', 'QgsBrowserModel', 'QgsCRSCache', 'QgsCacheIndexFeatureId', 'QgsCachedFeatureIterator', 'QgsCachedFeatureWriterIterator', 'QgsCategorizedSymbolRendererV2', 'QgsCentroidFillSymbolLayerV2', 'QgsClipToMinMaxEnhancement', 'QgsClipper', 'QgsColorBrewerPalette', 'QgsColorRampShader', 'QgsComposerArrow', 'QgsComposerAttributeTable', 'QgsComposerAttributeTableCompare', 'QgsComposerEffect', 'QgsComposerFrame', 'QgsComposerGroupItem', 'QgsComposerHtml', 'QgsComposerItem', 'QgsComposerItemCommand', 'QgsComposerItemGroup', 'QgsComposerLabel', 'QgsComposerLayerItem', 'QgsComposerLegend', 'QgsComposerLegendItem', 'QgsComposerLegendStyle', 'QgsComposerMap', 'QgsComposerMergeCommand', 'QgsComposerMultiFrame', 'QgsComposerMultiFrameCommand', 'QgsComposerPicture', 'QgsComposerRasterSymbolItem', 'QgsComposerScaleBar', 'QgsComposerShape', 'QgsComposerSymbolV2Item', 'QgsComposerTable', 'QgsComposerTextTable', 'QgsComposition', 'QgsContextHelp', 'QgsContrastEnhancement', 'QgsContrastEnhancementFunction', 'QgsCoordinateReferenceSystem', 'QgsCoordinateTransform', 'QgsCoordinateTransformCache', 'QgsCptCityArchive', 'QgsCptCityBrowserModel', 'QgsCptCityCollectionItem', 'QgsCptCityColorRampItem', 'QgsCptCityColorRampV2', 'QgsCptCityDataItem', 'QgsCptCityDirectoryItem', 'QgsCptCitySelectionItem', 'QgsCredentials', 'QgsCredentialsConsole', 'QgsCsException', 'QgsCubicRasterResampler', 'QgsDataCollectionItem', 'QgsDataDefined', 'QgsDataItem', 'QgsDataProvider', 'QgsDataSourceURI', 'QgsDbFilterProxyModel', 'QgsDiagram', 'QgsDiagramInterpolationSettings', 'QgsDiagramLayerSettings', 'QgsDiagramRendererV2', 'QgsDiagramSettings', 'QgsDirectoryItem', 'QgsDirectoryParamWidget', 'QgsDistanceArea', 'QgsDoubleBoxScaleBarStyle', 'QgsEllipseSymbolLayerV2', 'QgsError', 'QgsErrorItem', 'QgsErrorMessage', 'QgsException', 'QgsExpression', 'QgsFavouritesItem', 'QgsFeature', 'QgsFeatureIterator', 'QgsFeatureRendererV2', 'QgsFeatureRequest', 'QgsFeatureStore', 'QgsField', 'QgsFields', 'QgsFillSymbolLayerV2', 'QgsFillSymbolV2', 'QgsFontMarkerSymbolLayerV2', 'QgsFontUtils', 'QgsGPSConnection', 'QgsGPSConnectionRegistry', 'QgsGPSDetector', 'QgsGPSInformation', 'QgsGeometry', 'QgsGeometryCache', 'QgsGeometryValidator', 'QgsGml', 'QgsGmlFeatureClass', 'QgsGmlSchema', 'QgsGpsdConnection', 'QgsGradientStop', 'QgsGraduatedSymbolRendererV2', 'QgsHistogramDiagram', 'QgsHttpTransaction', 'QgsHueSaturationFilter', 'QgsImageFillSymbolLayer', 'QgsLabel', 'QgsLabelAttributes', 'QgsLabelCandidate', 'QgsLabelComponent', 'QgsLabelPosition', 'QgsLabelSearchTree', 'QgsLabelingEngineInterface', 'QgsLayerItem', 'QgsLegendModel', 'QgsLinePatternFillSymbolLayer', 'QgsLineSymbolLayerV2', 'QgsLineSymbolV2', 'QgsLinearMinMaxEnhancement', 'QgsLinearMinMaxEnhancementWithClip', 'QgsLinearlyInterpolatedDiagramRenderer', 'QgsLogger', 'QgsMapLayer', 'QgsMapLayerRegistry', 'QgsMapRenderer', 'QgsMapToPixel', 'QgsMarkerLineSymbolLayerV2', 'QgsMarkerSymbolLayerV2', 'QgsMarkerSymbolV2', 'QgsMessageLog', 'QgsMessageLogConsole', 'QgsMessageOutput', 'QgsMessageOutputConsole', 'QgsMimeDataUtils', 'QgsMultiBandColorRenderer', 'QgsNMEAConnection', 'QgsNetworkAccessManager', 'QgsNumericScaleBarStyle', 'QgsOWSConnection', 'QgsOfflineEditing', 'QgsOgcUtils', 'QgsPaintEngineHack', 'QgsPalLabeling', 'QgsPalLayerSettings', 'QgsPalettedRasterRenderer', 'QgsPaperItem', 'QgsPieDiagram', 'QgsPluginLayer', 'QgsPluginLayerRegistry', 'QgsPluginLayerType', 'QgsPoint', 'QgsPointDisplacementRenderer', 'QgsPointPatternFillSymbolLayer', 'QgsProject', 'QgsProjectBadLayerDefaultHandler', 'QgsProjectBadLayerHandler', 'QgsProjectFileTransform', 'QgsProjectVersion', 'QgsProperty', 'QgsPropertyKey', 'QgsPropertyValue', 'QgsProviderCountCalcEvent', 'QgsProviderExtentCalcEvent', 'QgsProviderMetadata', 'QgsProviderRegistry', 'QgsPseudoColorShader', 'QgsPythonRunner', 'QgsRaster', 'QgsRasterBandStats', 'QgsRasterBlock', 'QgsRasterChecker', 'QgsRasterDataProvider', 'QgsRasterDrawer', 'QgsRasterFileWriter', 'QgsRasterHistogram', 'QgsRasterIdentifyResult', 'QgsRasterInterface', 'QgsRasterIterator', 'QgsRasterLayer', 'QgsRasterNuller', 'QgsRasterPipe', 'QgsRasterProjector', 'QgsRasterPyramid', 'QgsRasterRange', 'QgsRasterRenderer', 'QgsRasterResampleFilter', 'QgsRasterResampler', 'QgsRasterShader', 'QgsRasterShaderFunction', 'QgsRasterTransparency', 'QgsRasterViewPort', 'QgsRectangle', 'QgsRenderChecker', 'QgsRenderContext', 'QgsRendererCategoryV2', 'QgsRendererRangeV2', 'QgsRendererV2AbstractMetadata', 'QgsRendererV2Metadata', 'QgsRendererV2Registry', 'QgsRuleBasedRendererV2', 'QgsRunProcess', 'QgsSVGFillSymbolLayer', 'QgsSatelliteInfo', 'QgsScaleBarStyle', 'QgsScaleCalculator', 'QgsScaleUtils', 'QgsSimpleFillSymbolLayerV2', 'QgsSimpleLineSymbolLayerV2', 'QgsSimpleMarkerSymbolLayerV2', 'QgsSingleBandColorDataRenderer', 'QgsSingleBandGrayRenderer', 'QgsSingleBandPseudoColorRenderer', 'QgsSingleBoxScaleBarStyle', 'QgsSingleCategoryDiagramRenderer', 'QgsSingleSymbolRendererV2', 'QgsSnapper', 'QgsSnappingResult', 'QgsSpatialIndex', 'QgsStyleV2', 'QgsSvgCache', 'QgsSvgCacheEntry', 'QgsSvgMarkerSymbolLayerV2', 'QgsSymbolLayerV2', 'QgsSymbolLayerV2AbstractMetadata', 'QgsSymbolLayerV2Metadata', 'QgsSymbolLayerV2Registry', 'QgsSymbolLayerV2Utils', 'QgsSymbolV2', 'QgsSymbolV2LevelItem', 'QgsSymbolV2RenderContext', 'QgsSymbologyV2Conversion', 'QgsTextDiagram', 'QgsTicksScaleBarStyle', 'QgsTolerance', 'QgsVectorColorBrewerColorRampV2', 'QgsVectorColorRampV2', 'QgsVectorDataProvider', 'QgsVectorFieldSymbolLayer', 'QgsVectorFileWriter', 'QgsVectorGradientColorRampV2', 'QgsVectorJoinInfo', 'QgsVectorLayer', 'QgsVectorLayerCache', 'QgsVectorLayerEditBuffer', 'QgsVectorLayerEditUtils', 'QgsVectorLayerFeatureIterator', 'QgsVectorLayerImport', 'QgsVectorLayerJoinBuffer', 'QgsVectorRandomColorRampV2', 'QgsZipItem', 'USER_CRS_START_ID', '__doc__', '__file__', '__name__', '__package__']
	'GEO_EPSG_CRS_ID', 'LAT_PREFIX_LEN', 'MINIMUM_POINT_SIZE', 'PROJ_PREFIX_LEN', 'QGis', 'QgsApplication', '~~QgsContextHelp~~',
	'~~QgsContinuousColorRenderer~~', 'QgsContrastEnhancement', 'QgsContrastEnhancementFunction', 'QgsCoordinateReferenceSystem',
	'QgsCoordinateTransform', 'QgsDataProvider', 'QgsDataSourceURI', 'QgsDistanceArea', 'QgsFeature', 'QgsField', 'QgsGeometry',
	'~~QgsGraduatedSymbolRenderer~~', 'QgsLabel', 'QgsLabelAttributes', 'QgsLogger', 'QgsMapLayer', 'QgsMapLayerRegistry',
	'QgsMapRenderer', 'QgsMapToPixel', '~~QgsMarkerCatalogue~~', 'QgsMessageOutput', 'QgsMessageOutputConsole', 'QgsPoint',
	'QgsProject', 'QgsProviderMetadata', 'QgsProviderRegistry', 'QgsRasterBandStats', 'QgsRasterDataProvider', 'QgsRasterLayer',
	'QgsRasterPyramid', 'QgsRasterShader', 'QgsRasterShaderFunction', 'QgsRasterTransparency', 'QgsRasterViewPort', 'QgsRectangle',
	'QgsRenderContext', '~~QgsRenderer~~', 'QgsScaleCalculator', '~~QgsSingleSymbolRenderer~~', 'QgsSnapper', 'QgsSnappingResult',
	'QgsSpatialIndex', '~~QgsSymbol~~', '~~QgsSymbologyUtils~~', '~~QgsUniqueValueRenderer~~', 'QgsVectorDataProvider',
	'QgsVectorFileWriter', 'QgsVectorLayer', 'USER_CRS_START_ID', '__doc__', '__file__', '~~__name_~~]
	</pre>		</pre>