# Gráfico de pizza

> Referência do componente de dashboard Gráfico de pizza, como um todo se divide entre pontos ao vivo, com todas as propriedades do editor.

O **Gráfico de pizza** mostra como um todo se divide: uma fatia por endereço, lida neste
momento, como pizza, rosca ou meia rosca. Como o [Gráfico de barras](component-bar-chart), ele
é um gráfico categórico: sem eixo de tempo, sem janela, sem cadência, sem retenção. Os dois
compartilham as seções de conteúdo, de pontos e de formato; só o desenho abaixo difere.

Um ponto que não está lendo é deixado de fora da comparação em vez de ser desenhado em zero, e
o gráfico diz isso sob o desenho. Uma tela que acabou de abrir ainda não diz nada.

## Conteúdo e pontos {#content-and-points}

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Título do gráfico | Cabeçalho opcional desenhado dentro do subgráfico. Este é o cabeçalho do próprio gráfico, não o título de canto do componente (aquele mora na seção Aparência compartilhada). | texto | vazio |
| Pontos | As categorias comparadas, um cartão por fatia, na ordem declarada. **Adicionar ponto** junta um. | lista | vazio |
| · Endereço | Endereço com raiz, na Logic, que a fatia lê. O campo sugere a partir da lista de pontos ao vivo, filtrada por pontos numéricos, e mostra a leitura atual do ponto assim que ele é nomeado. | endereço | vazio |
| · Nome | Como os rótulos e a legenda chamam a fatia. | texto | em branco recai no endereço |
| · Cor | A tinta da fatia como `#RRGGBB`. | cor hex | em branco toma a vez da paleta |
| Ordem | A ordem em que as fatias são desenhadas. | como declarado · do menor para o maior · do maior para o menor | como declarado |

## Formato {#format}

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Unidade | Unidade de engenharia opcional escrita depois de cada leitura. | texto | vazio |
| Decimais | Casas decimais fixas para as leituras. | de 0 a 15 | em branco usa a preferência da estação |
| Lê-se como | Como cada leitura é escrita por extenso, tanto nos rótulos quanto nas dicas de valor. | Número · Porcentagem · Duração | Número |
| O valor conta | O que uma unidade do valor significa enquanto o formato é uma duração. | Segundos · Milissegundos · Minutos | Segundos |

## Fatias {#slices}

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Forma | O corpo de que as fatias são tiradas. As três respondem à mesma pergunta e diferem no que o meio serve: um disco cheio dá a cada fatia a maior área, um anel libera o centro, e meio anel cabe na célula larga e baixa que uma fileira de cartões deixa. | Pizza · Rosca · Meia rosca | Pizza |
| Rótulos | O que é escrito ao lado de cada fatia. O nome sempre faz parte de um rótulo desenhado, porque um número flutuando ao lado de uma cunha sem nome não diz nada, e a escolha é o que o acompanha. Escolher nada deixa a legenda nomear as fatias, que é o que uma célula pequena quer. | Só o nome · Nome e leitura · Nome e proporção · Nome, leitura e proporção · Nada | Nome e proporção |
| Os rótulos ficam | Onde a escrita fica. Fora custa diâmetro do anel e linhas-guia: cada rótulo é escrito entre o fim da sua linha-guia e a borda da célula, um rótulo mais longo que esse espaço termina em reticências e a dica de valor o mostra inteiro. O nome ocupa uma linha só dele e a leitura e a proporção a linha de baixo, então o espaço corta o nome e nunca a proporção. Uma célula estreita demais para escrever ao lado do anel tira os rótulos e lista as fatias na legenda, uma por linha (sob o subgráfico quando a legenda está em nenhuma): um nome mais longo que a sua linha termina em reticências e a dica de valor sobre a linha o mostra inteiro. A lista ocupa no máximo cinco linhas, e menos numa célula baixa demais para guardar também um terço da sua altura para o anel: com mais fatias que linhas, ela as mostra uma página por vez, com as setas e o contador de páginas (como 1/3) na última linha. Os rótulos voltam assim que a célula fica larga o bastante. Dentro não gasta nada da célula com os rótulos e precisa de uma fatia larga o bastante para segurar um. Pedido só enquanto há rótulos desenhados. | fora do anel · dentro da fatia | fora do anel |
| Legenda | Onde a legenda fica. Sem rótulo ao lado do anel (Rótulos em Nada, ou dentro da fatia), só a legenda nomeia as fatias: uma célula estreita demais para escrever todos os nomes na sua única linha lista as fatias uma por linha, a mesma lista que uma célula estreita desenha no lugar dos rótulos de fora (veja Os rótulos ficam). A linha volta assim que a célula fica larga o bastante. | sobre o subgráfico · sob o subgráfico · nenhuma | sobre o subgráfico |

## Faixas da escala {#scale-bands}

A seção **Escala** declara trechos da extensão de valores pelo editor de faixas compartilhado.
Numa pizza as faixas são uma paleta: elas tingem cada fatia conforme onde a leitura dela cai, e
nada mais; fatias de um mesmo todo não têm um trecho único em que o desenho *está*, então
nenhum campo de redação e nenhuma referência são oferecidos. Uma leitura além do último limite
mantém a tinta escrita da fatia.

## Caixa de ferramentas {#toolbox}

| Ferramenta | O que ela faz | No conjunto padrão |
|---|---|---|
| Salvar PNG | Baixa o desenho como um PNG. | sim |
| Copiar PNG | Põe o desenho na área de transferência como um PNG. | sim |
| Tela cheia | Preenche a janela com este gráfico. | sim |