Português:Gerenciamento de Depth

Introdução ao Gerenciamento de Depth do Gaia
O Gaia usa um sistema simples de Gerenciamento de Profundidade (depth) para o z-indexing das páginas e assets visuais. Seu sistema de 3 camadas fornece uma maneira simples de gerenciar depths para praticamente todas as finalidades, e pode ser facilmente customizado e/ou desviado para um gerenciamento de depth preciso.



Containers do Depth Primário
OS três depths primários são top, middle e bottom.

Por padrão, todas as páginas e assets são carregados dentro do depth middle, exceto o index, que é carregado no depth bottom por padrão. Assets automaticamente herdam o depth de suas páginas a não ser que você especifique de outra maneira.

Se página e assets estão definidos para carregar no mesmo container de profundidade, eles estarão empilhados na ordem em que forem carregados no branch do site.xml.

Top
O depth top é o container mais alto na pilha de exibição (display stack).

Middle
O depth middle está abaixo de top e acima de bottom.

Bottom
O depth bottom é o container mais baixo na pilha de exibição.



Container de Depth Especial
O depth preloader é usado para preloaders e pode ser definido no site.xml. Em AS3, há um depth especial nested.

Preloader
O depth preloader é um atributo definível dinamicamente no node em site.xml. Sua z-position é um level acima de qualquer coisa para a qual o preloaderDepth container esteja definido. Por padrão, é definido como top então está acima do container top. Se você usar preloaderDepth como middle, ele estará abaixo de top e acima de middle. Se você definir o preloaderDepth como bottom, estará abaixo de middle e acima de bottom.

Aninhado (Nested) (somente AS3)
Nested é um depth especial. Se você usar o depth nested a página ou asset será colocado dentro da página de seu parent no site.xml. Isto significa que suas páginas e assets aninhados terão movimento, escala, máscara e tudo mais afetados pelas propriedades de sua página parent, incluindo visible, alpha, etc.

Por padrão, assets automaticamente herdam o depth de sua página container, então se uma página de asset tem seu depth="nested", o asset também terá, o que quer dizer que irá carregar dentro do clip de conteúdo da página. Se você quer que um asset de uma página aninhada carregue dentro de um dos containers de depth do gaia, precisa definir explicitamente seu depth para um dos quatro containers.



Gerenciamento de Depth Customizado
Você pode gerenciar os depths manualmente com Actionscript dentro dos limites dos containers de depth do Gaia, ou não. O sistema de depth management do Gaia forece uma base simples, da qual você pode expandir.

Se você quer ignorar o depth management do Gaia totalmente, não declare o depth de nenhuma página ou asset, e todos eles irão carregar dentro do container middle, dando a você total liberdade.