Esta página foi traduzida pela API Cloud Translation.

Dimensionar e posicionar os elementos da página

Este guia descreve como dimensionar e posicionar elementos de página usando transformações afins. Para uma introdução conceitual às transformações afins, consulte o guia do conceito Transformações.

Transformando elementos

A Slides API permite reposicionar e dimensionar elementos em uma página. Para isso, primeiro determine que tipo de transformação precisa ser aplicada. Em seguida, aplique essa transformação usando o método presentations.batchUpdate que contém um ou mais elementos UpdatePageElementTransformRequest.

As transformações podem ser feitas em um destes dois applyModes:

As transformações ABSOLUTE substituem a matriz de transformação atual do elemento. Todos os parâmetros omitidos da solicitação de atualização de transformação são definidos como zero.
As transformações RELATIVE são multiplicadas pela matriz de transformação atual do elemento. A ordem de multiplicação é importante:

$$A' = BA$$

As transformações relativas movem ou dimensionam o elemento de página de onde ele está no momento. Por exemplo, mover uma forma 100 pontos para a esquerda ou girá-la 40 graus. As transformações absolutas descartam informações atuais de posição e escala. Por exemplo, mover uma forma para o centro da página ou dimensioná-la para uma largura específica.

Transformações complexas podem ser expressas como uma sequência de outras mais simples. Muitas vezes, calcular previamente uma transformação (combinar várias transformações usando a multiplicação de matrizes) pode reduzir a sobrecarga.

Para algumas operações, você precisa saber quais são os parâmetros de transformação existentes de um elemento. Se você não tem esses valores, pode recuperá-los com uma solicitação presentations.pages.get.

Tradução

Translação é o processo de mover um elemento para uma nova posição na mesma página. Movimentações absolutas movem o elemento a um ponto específico, enquanto as conversões relativas movem o elemento a uma distância específica.

Uma matriz de transformação de conversão básica tem a seguinte forma:

$$T=\begin{bmatrix} 1 & 0 & translate\_x\\ 0 & 1 & translate\_y\\ 0 & 0 & 1 \end{bmatrix}$$

Ao usar uma UpdatePageElementTransformRequest para traduzir um elemento (sem alterar o tamanho, a distorção ou a orientação), é possível usar uma das seguintes estruturas AffineTransform:

// Absolute translation:
{
  'transform': {
    'scaleX':  current scaleX value,
    'scaleY':  current scaleY value,
    'shearX':  current shearX value,
    'shearY':  current shearY value,
    'translateX': X coordinate to move to,
    'translateY': Y coordinate to move to,
    'unit': 'EMU' // or 'PT'
  }
}

// Relative translation (scaling must also be provided to avoid a matrix multiplication error):
{
  'transform': {
    'scaleX':  1,
    'scaleY':  1,
    'translateX': X coordinate to move by,
    'translateY': Y coordinate to move by,
    'unit': 'EMU' // or 'PT'
  }
}

Escalonamento

Dimensionamento é a ação de alongar ou espremer um elemento ao longo da dimensão X e/ou Y para mudar o tamanho dele. Uma matriz de transformação de escalonamento básica tem a seguinte forma:

$$S=\begin{bmatrix} scale\_x & 0 & 0\\ 0 & scale\_y & 0\\ 0 & 0 & 1 \end{bmatrix}$$

É possível usar esse formato de matriz diretamente como uma transformação RELATIVE para redimensionar um elemento, mas isso também pode afetar a distorção e a translação renderizadas do elemento. Para dimensionar o elemento sem afetar a distorção ou a translação, mude para o frame de referência.

Rotation

As transformações de rotação giram um elemento de página em torno de um ponto usando os parâmetros de dimensionamento e distanciamento. A matriz de transformação de rotação básica tem a seguinte forma, em que o ângulo de rotação (em radianos) é medido a partir do eixo X, movendo-se no sentido anti-horário:

$$R=\begin{bmatrix} cos(\theta) & sin(\theta) & 0\\ -sin(\theta) & cos(\theta) & 0\\ 0 & 0 & 1 \end{bmatrix}$$

Assim como no dimensionamento, é possível usar a forma da matriz diretamente como uma transformação RELATIVE para girar um elemento, mas isso faz com que ele seja girado em torno da origem da página. Para girar o elemento em torno do centro ou de um ponto diferente, mude para esse frame de referência.

Reflexão

O reflexo espelha um elemento em uma linha ou eixo específico. A matriz de transformação básica de reflexo nos eixos x e y tem as seguintes formas:

$$F_x=\begin{bmatrix} 1 & 0 & 0\\ 0 & -1 & 0\\ 0 & 0 & 1\\ \end{bmatrix}\qquad\qquad F_y=\begin{bmatrix} -1 & 0 & 0\\ 0 & 1 & 0\\ 0 & 0 & 1\\ \end{bmatrix}$$

Assim como no escalonamento, é possível usar a forma da matriz diretamente como uma transformação RELATIVE para refletir um elemento, mas isso também faz com que o elemento seja convertido. Para refletir o elemento sem nenhuma translação, mude para o frame de referência.

Frames de referência de elementos

Aplicar uma transformação básica de escala, reflexão ou rotação diretamente a um elemento de página produz uma transformação no frame de referência da página. Por exemplo, uma rotação básica gira o elemento em torno da origem da página (o canto superior esquerdo). No entanto, é possível operar no frame de referência do próprio elemento, por exemplo, para girar um elemento em torno do seu ponto central.

Para transformar um elemento dentro do próprio frame de referência, coloque-o entre duas outras traduções: uma T1 de tradução anterior, que move o centro do elemento para a origem da página, e uma T2 de translação seguinte, que move o elemento de volta à posição original. A operação completa pode ser expressa como um produto de matriz:

$$A' = T2 \times B \times T1 \times A$$

Também é possível alternar para outros frames de referência, traduzindo diferentes pontos para a origem. Esses pontos se tornam o centro do novo frame de referência.

É possível executar cada uma dessas transformações individualmente como solicitações de transformação RELATIVE sequenciais. O ideal é pré-computar A' acima com multiplicações de matrizes e aplicar o resultado como uma única transformação ABSOLUTE. Como alternativa, pré-compute o produto T2 * B * T1 e aplique-o como uma única transformação RELATIVE. Ambos são mais eficientes, em termos de operações de API, do que enviar as solicitações de transformação individualmente.

Limitações

Alguns campos de dimensionamento e posicionamento são incompatíveis com alguns tipos de elementos de página. A tabela abaixo resume a compatibilidade de certos elementos de página com os campos de dimensionamento e posicionamento.

Field	Formato	Vídeo	Tabela
Tradução	✔	✔	✔
Escala	✔	✔	Não**
Treia	✔	Não	Não

** Para atualizar as dimensões de linha e coluna da tabela, use UpdateTableRowPropertiesRequest e UpdateTableColumnPropertiesRequest.

Todos os campos de dimensionamento e posicionamento poderão gerar resultados inesperados se o elemento de página tiver distorção. Todas as limitações estão sujeitas a alterações. Veja informações atualizadas na API Google Slides.

A API Slides pode refatorar seus valores

Ao criar um elemento de página, é possível especificar um tamanho e uma transformação que forneçam um determinado resultado visual. No entanto, a API pode substituir os valores fornecidos por outros que produzam a mesma aparência. Em geral, se você gravar um tamanho usando a API, não há garantia de que ele vai receber o mesmo tamanho. No entanto, você deve ter os mesmos resultados se levar a transformação em consideração.