5. Substituições

5.1. Utilização

Para facilitar o uso de ícones nos manuais do QGIS, são definidas substituições para cada ícone no arquivo /source/substitutions.txt no` repositório de documentação do QGIS <https://github.com/qgis/QGIS-Documentation>`_ e algumas dessas substituições estão listadas abaixo. Portanto, quando você deseja usar um ícone do aplicativo QGIS na documentação, há uma grande chance de que já exista uma substituição que possa/deva ser usada.

Se não existir substituição:

  1. check the documentation repository whether the icon is available in /static/common folder. If no image, then you need to find and copy the icon image file from QGIS repository (often under default themes folder) and paste (in .png format) under /static/common folder. For convenience and update, it’s advised to keep filename when possible.

  2. create the reference to the substitution in the /substitutions.txt file following the example below. The replacement text should be derived from file name and in camelCase:

    .. |dataSourceManager| image:: /static/common/mActionDataSourceManager.png
       :width: 1.5em
    .. |splitLayer| image:: /static/common/split_layer.png
       :width: 1.5em
    
  3. Update the target section(s) of the docs, using your new substitution.

  4. (optional but highly desirable) add the substitution to the list below.

  5. Add the new substitution reference in the substitutions list at the end of the file(s) it is used in, or run the convenient scripts/find_set_subst.py script.

    # from the repository main folder
    python3 scripts/find_set_subst.py
    

5.2. Substituições comuns

Abaixo são dados alguns ícones e sua substituição para utilização durante a escrita da documentação. Podem ser usados/encontrados em muitos locais em manuais.

5.2.1. Ícones da plataforma

Ícone

Substituição

Ícone

Substituição

logo

|logo|

kde

|kde|

nix

|nix|

osx

|osx|

win

|win|

5.3. Ícones de botões da barra de ferramentas

5.3.1. Gerenciar camadas e visão global

Ícone

Substituição

Ícone

Substituição

dataSourceManager

|dataSourceManager|

addOgrLayer

|addOgrLayer|

addRasterLayer

|addRasterLayer|

addMssqlLayer

|addMssqlLayer|

addDelimitedTextLayer

|addDelimitedTextLayer|

addSpatiaLiteLayer

|addSpatiaLiteLayer|

addPostgisLayer

|addPostgisLayer|

addOracleLayer

|addOracleLayer|

addAfsLayer

|addAfsLayer|

addMeshLayer

|addMeshLayer|

addVectorTileLayer

|addVectorTileLayer|

addXyzLayer

|addXyzLayer|

addVirtualLayer

|addVirtualLayer|

addWmsLayer

|addWmsLayer|

addWcsLayer

|addWcsLayer|

addWfsLayer

|addWfsLayer|

addPointCloudLayer

|addPointCloudLayer|

addGpsLayer

|addGpsLayer|

newVectorLayer

|newVectorLayer|

newSpatiaLiteLayer

|newSpatiaLiteLayer|

newGeoPackageLayer

|newGeoPackageLayer|

createMemory

|createMemory|

newVirtualLayer

|newVirtualLayer|

newMeshLayer

|newMeshLayer|

dbManager

|dbManager|

gdal

|gdal|

geoPackage

|geoPackage|

spatialite

|spatialite|

virtualLayer

|virtualLayer|

wms

|wms|

wcs

|wcs|

wfs

|wfs|

pointCloudLayer

|pointCloudLayer|

gps

|gps|

dbSchema

|dbSchema|

inOverview

|inOverview|

addAllToOverview

|addAllToOverview|

removeAllFromOverview

|removeAllFromOverview|

removeLayer

|removeLayer|

showAllLayers

|showAllLayers|

hideAllLayers

|hideAllLayers|

showPresets

|showPresets|

showSelectedLayers

|showSelectedLayers|

hideSelectedLayers

|hideSelectedLayers|

hideDeselectedLayers

|hideDeselectedLayers|

toggleAllLayers

|toggleAllLayers|

toggleSelectedLayers

|toggleSelectedLayers|

addLayer

|addLayer|

indicatorTemporal

|indicatorTemporal|

indicatorNonRemovable

|indicatorNonRemovable|

indicatorEmbedded

|indicatorEmbedded|

indicatorFilter

|indicatorFilter|

indicatorMemory

|indicatorMemory|

indicatorNoCRS

|indicatorNoCRS|

indicatorBadLayer

|indicatorBadLayer|

favourites

|favourites|

indicatorLayerError

|indicatorLayerError|

indicatorNotes

|indicatorNotes|

indicatorLowAccuracy

|indicatorLowAccuracy|

indicatorOffline

|indicatorOffline|

5.3.2. Projeto

Ícone

Substituição

Ícone

Substituição

fileNew

|fileNew|

fileOpen

|fileOpen|

fileSave

|fileSave|

fileSaveAs

|fileSaveAs|

fileExit

|fileExit|

5.3.3. Editar

Ícone

Substituição

Ícone

Substituição

undo

|undo|

redo

|redo|

editCopy

|editCopy|

editPaste

|editPaste|

editCut

|editCut|

saveEdits

|saveEdits|

editableEdits

|editableEdits|

circle2Points

|circle2Points|

circle2TangentsPoint

|circle2TangentsPoint|

circle3Points

|circle3Points|

circle3Tangents

|circle3Tangents|

circleCenterPoint

|circleCenterPoint|

ellipseCenter2Points

|ellipseCenter2Points|

ellipseCenterPoint

|ellipseCenterPoint|

ellipseExtent

|ellipseExtent|

ellipseFoci

|ellipseFoci|

rectangle3PointsDistance

|rectangle3PointsDistance|

rectangle3PointsProjected

|rectangle3PointsProjected|

rectangleCenter

|rectangleCenter|

rectangleExtent

|rectangleExtent|

regularPolygon2Points

|regularPolygon2Points|

regularPolygonCenterCorner

|regularPolygonCenterCorner|

regularPolygonCenterPoint

|regularPolygonCenterPoint|

5.3.4. Identificar resultado

Ícone

Substituição

Ícone

Substituição

expandTree

|expandTree|

collapseTree

|collapseTree|

expandNewTree

|expandNewTree|

formView

|formView|

deselectAll

|deselectAll|

editCopy

|editCopy|

filePrint

|filePrint|

identifyByRectangle

|identifyByRectangle|

identifyByPolygon

|identifyByPolygon|

identifyByFreehand

|identifyByFreehand|

identifyByRadius

|identifyByRadius|

5.3.5. Digitalização e digitalização avançada

Ícone

Substituição

Ícone

Substituição

cad

|cad|

cadConstruction

|cadConstruction|

cadParallel

|cadParallel|

cadPerpendicular

|cadPerpendicular|

floater

|floater|

toggleEditing

|toggleEditing|

allEdits

|allEdits|

tracing

|tracing|

snapping

|snapping|

capturePoint

|capturePoint|

capturePolygon

|capturePolygon|

captureLine

|captureLine|

captureCurveFromFeature

|captureCurveFromFeature|

deleteSelectedFeatures

|deleteSelectedFeatures|

circularStringCurvePoint

|circularStringCurvePoint|

circularStringRadius

|circularStringRadius|

vertexTool

|vertexTool|

vertexToolActiveLayer

|vertexToolActiveLayer|

digitizeWithSegment

|digitizeWithSegment|

digitizeShape

|digitizeShape|

streamingDigitize

|streamingDigitize|

digitizeWithCurve

|digitizeWithCurve|

moveFeature

|moveFeature|

moveFeatureCopy

|moveFeatureCopy|

moveFeatureLine

|moveFeatureLine|

moveFeatureCopyLine

|moveFeatureCopyLine|

moveFeaturePoint

|moveFeaturePoint|

moveFeatureCopyPoint

|moveFeatureCopyPoint|

rotateFeature

|rotateFeature|

rotatePointSymbols

|rotatePointSymbols|

scaleFeature

|scaleFeature|

offsetCurve

|offsetCurve|

offsetPointSymbols

|offsetPointSymbols|

simplify

|simplify|

reshape

|reshape|

addRing

|addRing|

addPart

|addPart|

fillRing

|fillRing|

deleteRing

|deleteRing|

deletePart

|deletePart|

mergeFeatures

|mergeFeatures|

mergeFeatureAttributes

|mergeFeatureAttributes|

splitFeatures

|splitFeatures|

splitParts

|splitParts|

reverseLine

|reverseLine|

allowIntersections

|allowIntersections|

avoidIntersectionsCurrentLayer

|avoidIntersectionsCurrentLayer|

avoidIntersectionsLayers

|avoidIntersectionsLayers|

snappingSelf

|snappingSelf|

5.3.6. Malha

Ícone

Substituição

Ícone

Substituição

meshDigitizing

|meshDigitizing|

meshReindex

|meshReindex|

meshSelectExpression

|meshSelectExpression|

meshSelectPolygon

|meshSelectPolygon|

meshTransformByExpression

|meshTransformByExpression|

meshEditForceByVectorLines

|meshEditForceByVectorLines|

vertexCoordinates

|vertexCoordinates|

5.3.7. Navegação no mapa e atributos

Ícone

Substituição

Ícone

Substituição

pan

|pan|

panToSelected

|panToSelected|

zoomIn

|zoomIn|

zoomOut

|zoomOut|

zoomActual

|zoomActual|

zoomFullExtent

|zoomFullExtent|

zoomToLayer

|zoomToLayer|

zoomToSelected

|zoomToSelected|

zoomLast

|zoomLast|

zoomNext

|zoomNext|

zoomInXAxis

|zoomInXAxis|

refresh

|refresh|

identify

|identify|

mapTips

|mapTips|

showBookmarks

|showBookmarks|

newBookmark

|newBookmark|

measure

|measure|

measureArea

|measureArea|

measureBearing

|measureBearing|

measureAngle

|measureAngle|

newMap

|newMap|

new3DMap

|new3DMap|

tiltUp

|tiltUp|

tiltDown

|tiltDown|

3dNavigation

|3dNavigation|

play

|play|

temporal

|temporal

temporalNavigationOff

|temporalNavigationOff|

temporalNavigationFixedRange

|temporalNavigationFixedRange|

temporalNavigationAnimated

|temporalNavigationAnimated|

5.3.8. Seleção e Expressões

Ícone

Substituição

Ícone

Substituição

selectRectangle

|selectRectangle|

selectPolygon

|selectPolygon|

selectFreehand

|selectFreehand|

selectRadius

|selectRadius|

selectAll

|selectAll|

deselectAll

|deselectAll|

invertSelection

|invertSelection|

expressionSelect

|expressionSelect|

deselectActiveLayer

|deselectActiveLayer|

selectLocation

|selectLocation|

selectAllTree

|selectAllTree|

select

|select|

selectAdd

|selectAdd|

selectRemove

|selectRemove|

formSelect

|formSelect|

dataDefine

|dataDefine|

expression

|expression|

dataDefineOn

|dataDefineOn|

dataDefineExpressionOn

|dataDefineExpressionOn|

dataDefineError

|dataDefineError|

dataDefineExpressionError

|dataDefineExpressionError|

addExpression

|addExpression|

expressionFilter

|expressionFilter|

filterMap

|filterMap|

5.3.9. Rótulos e Diagramas

Ícone

Substituição

Ícone

Substituição

labelingSingle

|labelingSingle|

labelingNone

|labelingNone|

labelingRuleBased

|labelingRuleBased|

labelingObstacle

|labelingObstacle|

piechart

|piechart|

diagramNone

|diagramNone|

text

|text|

histogram

|histogram|

stackedBar

|stackedBar|

createAnnotationLayer

|createAnnotationLayer|

annotationLayer

|annotationLayer|

annotation

|annotation|

textAnnotation

|textAnnotation|

formAnnotation

|formAnnotation|

htmlAnnotation

|htmlAnnotation|

svgAnnotation

|svgAnnotation|

actionText

|actionText|

labelbackground

|labelbackground|

labelbuffer

|labelbuffer|

labelformatting

|labelformatting|

labelplacement

|labelplacement|

labelshadow

|labelshadow|

render

|render|

labelcallout

|labelcallout|

labelAnchorCenter

|labelAnchorCenter|

labelAnchorCustom

|labelAnchorCustom|

labelAnchorEnd

|labelAnchorEnd|

labelAnchorStart

|labelAnchorStart|

pinLabels

|pinLabels|

showHideLabels

|showHideLabels|

moveLabel

|moveLabel|

rotateLabel

|rotateLabel|

showPinnedLabels

|showPinnedLabels|

showUnplacedLabel

|showUnplacedLabel|

changeLabelProperties

|changeLabelProperties|

autoPlacementSettings

|autoPlacementSettings|

5.3.10. Decorações

Ícone

Substituição

Ícone

Substituição

copyrightLabel

|copyrightLabel|

addGrid

|addGrid|

titleLabel

|titleLabel|

northArrow

|northArrow|

scaleBar

|scaleBar|

addMap

|addMap|

addImage

|addImage|

5.3.11. Ajuda

Ícone

Substituição

Ícone

Substituição

helpContents

|helpContents|

qgisHomePage

|qgisHomePage|

success

|success|

helpSponsors

|helpSponsors|

contextHelp

|contextHelp|

5.3.12. Cores

Ícone

Substituição

Ícone

Substituição

colorBox

|colorBox|

colorPicker

|colorPicker|

colorSwatches

|colorSwatches|

colorWheel

|colorWheel|

5.4. Outros ícones básicos

Ícone

Substituição

Ícone

Substituição

arrowLeft

|arrowLeft|

arrowRight

|arrowRight|

arrowDown

|arrowDown|

arrowUp

|arrowUp|

symbologyAdd

|symbologyAdd|

symbologyRemove

|symbologyRemove|

projectProperties

|projectProperties|

options

|options|

interfaceCustomization

|interfaceCustomization|

keyboardShortcuts

|keyboardShortcuts|

copyrightLabel

|copyrightLabel|

northArrow

|northArrow|

scaleBar

|scaleBar|

tracking

|tracking|

gpsImporter

|gpsImporter|

gpsTrackBarChart

|gpsTrackBarChart|

folder

|folder|

extents

|extents|

settings

|settings|

start

|start|

properties

|properties|

deleteSelected

|deleteSelected|

browserExpand

|browserExpand|

browserCollapse

|browserCollapse|

codeEditor

|codeEditor|

add

|add|

relations

|relations|

layoutItem3DMap

|layoutItem3DMap|

stopwatch

|stopwatch|

5.5. Tabela de Atributos

Ícone

Substituição

Ícone

Substituição

openTable

|openTable|

openTableSelected

|openTableSelected|

openTableVisible

|openTableVisible|

openTableEdited

|openTableEdited|

selectedToTop

|selectedToTop|

selectAll

|selectAll|

invertSelection

|invertSelection|

panToSelected

|panToSelected|

zoomToSelected

|zoomToSelected|

copySelected

|copySelected|

editPaste

|editPaste|

expressionSelect

|expressionSelect|

deleteSelectedFeatures

|deleteSelectedFeatures|

newAttribute

|newAttribute|

deleteAttribute

|deleteAttribute|

editTable

|editTable|

newTableRow

|newTableRow|

calculateField

|calculateField|

refresh

|refresh|

formView

|formView|

conditionalFormatting

|conditionalFormatting|

multiEdit

|multiEdit|

dock

|dock|

actionRun

|actionRun|

duplicateFeature

|duplicateFeature|

zoomTo

|zoomTo|

panTo

|panTo|

highlightFeature

|highlightFeature|

handleStoreFilterExpressionChecked

|handleStoreFilterExpressionChecked|

handleStoreFilterExpressionUnchecked

|handleStoreFilterExpressionUnchecked|

5.6. Projeções e Georreferenciamento

Ícone

Substituição

Ícone

Substituição

geographic

|geographic|

crs

|crs|

customProjection

|customProjection|

setProjection

|setProjection|

projectionDisabled

|projectionDisabled|

projectionEnabled

|projectionEnabled|

transformation

|transformation|

gdalScript

|gdalScript|

georefRun

|georefRun|

pencil

|pencil|

linkQGisToGeoref

|linkQGisToGeoref|

linkGeorefToQGis

|linkGeorefToQGis|

fullHistogramStretch

|fullHistogramStretch|

5.8. Propriedades da Camada

Ícone

Substituição

Ícone

Substituição

symbology

|symbology|

labelingSingle

|labelingSingle|

sourceFields

|sourceFields|

general

|general|

metadata

|metadata|

action

|action|

display

|display|

rendering

|rendering|

join

|join|

diagram

|diagram|

labelmask

|labelmask|

temporal

|temporal|

legend

|legend|

dependencies

|dependencies|

3d

|3d|

system

|system|

elevationscale

|elevationscale|

layerTree

|layerTree|

editMetadata

|editMetadata|

overlay

|overlay|

digitizing

|digitizing|

auxiliaryStorage

|auxiliaryStorage|

history

|history|

stylePreset

|stylePreset|

search

|search|

pyramids

|pyramids|

transparency

|transparency|

rasterHistogram

|rasterHistogram|

singleSymbol

|singleSymbol|

nullSymbol

|nullSymbol|

graduatedSymbol

|graduatedSymbol|

categorizedSymbol

|categorizedSymbol|

25dSymbol

|25dSymbol|

ruleBasedSymbol

|ruleBasedSymbol|

invertedSymbol

|invertedSymbol|

heatmapSymbol

|heatmapSymbol|

pointDisplacementSymbol

|pointDisplacementSymbol|

pointClusterSymbol

|pointClusterSymbol|

mergedFeatures

|mergedFeatures|

meshcontours

|meshcontours|

meshcontoursoff

|meshcontoursoff|

meshvectors

|meshvectors|

meshvectorsoff

|meshvectorsoff|

meshframe

|meshframe|

meshaveraging

|meshaveraging|

singleColor

|singleColor|

paletted

|paletted|

singlebandPseudocolor

|singlebandPseudocolor|

multibandColor

|multibandColor|

pointCloudExtent

|pointCloudExtent|

sum

|sum|

sort

|sort|

paintEffects

|paintEffects|

mapIdentification

|mapIdentification|

styleManager

|styleManager|

iconView

|iconView|

joinNotEditable

|joinNotEditable|

joinedLayerNotEditable

|joinedLayerNotEditable|

joinHasNotUpsertOnEdit

|joinHasNotUpsertOnEdit|

filterTableFields

|filterTableFields|

symbologyEdit

|symbologyEdit|

sharingImport

|sharingImport|

sharingExport

|sharingExport|

5.9. Plugins

5.9.1. Processamento

Ícone

Substituição

Ícone

Substituição

processingAlgorithm

|processingAlgorithm|

processingModel

|processingModel|

processingHistory

|processingHistory|

processingResult

|processingResult|

menu

|menu|

processSelected

|processSelected|

editHelpContent

|editHelpContent|

saveAsPython

|saveAsPython|

modelOutput

|modelOutput|

qgsProjectFile

|qgsProjectFile|

addToProject

|addToProject|

fieldInteger

|fieldInteger|

meanCoordinates

|meanCoordinates|

extractLayerExtent

|extractLayerExtent|

selectRandom

|selectRandom|

vectorGrid

|vectorGrid|

convexHull

|convexHull|

buffer

|buffer|

intersect

|intersect|

union

|union|

symmetricalDifference

|symmetricalDifference|

clip

|clip|

difference

|difference|

dissolve

|dissolve|

checkGeometry

|checkGeometry|

exportGeometry

|exportGeometry|

delaunay

|delaunay|

centroids

|centroids|

polygonToLine

|polygonToLine|

extractVertices

|extractVertices|

lineToPolygon

|lineToPolygon|

nearestNeighbour

|nearestNeighbour|

splitLayer

|splitLayer|

heatmap

|heatmap|

showRasterCalculator

|showRasterCalculator|

showMeshCalculator

|showMeshCalculator|

regularPoints

|regularPoints|

addGeometryAttributes

|addGeometryAttributes|

basicStatistics

|basicStatistics|

uniqueValues

|uniqueValues|

collect

|collect|

simplify_2

|simplify_2|

createGrid

|createGrid|

distanceMatrix

|distanceMatrix|

lineIntersections

|lineIntersections|

mergeLayers

|mergeLayers|

sumPoints

|sumPoints|

sumLengthLines

|sumLengthLines|

randomPointsInPolygons

|randomPointsInPolygons|

randomPointsWithinPolygon

|randomPointsWithinPolygon|

randomPointsOnLines

|randomPointsOnLines|

randomPointsWithinExtent

|randomPointsWithinExtent|

multiToSingle

|multiToSingle|

grid

|grid|

tiles

|tiles|

merge

|merge|

rasterClip

|rasterClip|

contour

|contour|

proximity

|proximity|

polygonize

|polygonize|

rasterize

|rasterize|

sieve

|sieve|

nearblack

|nearblack|

projectionAdd

|projectionAdd|

projectionExport

|projectionExport

8To24Bits

|8To24Bits|

24To8Bits

|24To8Bits|

rasterInfo

|rasterInfo|

rasterOverview

|rasterOverview|

vrt

|vrt|

voronoi

|voronoi|

translate

|translate|

warp

|warp|

iterate

|iterate|

terminal

|terminal|

5.9.2. Vários Complementos Principais

São fornecidos padrões com a instalação básica, mas não são carregados com a instalação inicial

Ícone

Substituição

Ícone

Substituição

showPluginManager

|showPluginManager|

installPluginFromZip

|installPluginFromZip|

pythonFile

|pythonFile|

runConsole

|runConsole|

showEditorConsole

|showEditorConsole|

clearConsole

|clearConsole|

offlineEditingCopy

|offlineEditingCopy|

offlineEditingSync

|offlineEditingSync|

plugin

|plugin|

metasearch

|metasearch|

geometryChecker

|geometryChecker|

topologyChecker

|topologyChecker|

fromSelectedFeature

|fromSelectedFeature|

sqlQueryBuilder

|sqlQueryBuilder|

5.9.3. Integração do Grass

Ícone

Substituição

Ícone

Substituição

grassLogo

|grassLogo|

grassRegion

|grassRegion|

grassTools

|grassTools|

grassNewMapset

|grassNewMapset|

grassOpenMapset

|grassOpenMapset|

grassCloseMapset

|grassCloseMapset|