Objeto SceneDrawingOpBitmap¶
Objeto SceneDrawingOpBitmap¶
O Objeto SceneDrawingOpBitmap representa uma operação gráfica de um Bitmap/Imagem em um SceneCanvas .
Herança¶
O o**bjeto SceneDrawingOpBitmap** herda de SceneDrawingOp e possui também TODAS todas as suas características.
Veja também:
Características¶
Além das características herdadas, o objeto SceneDrawingOpBitmap também possui as seguintes características:
Propriedades e atributos¶
| Propriedade | Tipo | Descrição |
|---|---|---|
| objectType | String "opBitmap" | (Somente Leitura) Contém um texto que identifica o tipo da operação gráfica - "opBitmap". |
| url | String | Contém a URL da imagem/bitmap que será renderizada. Este valor: Pode ser um endereço de internet (exemplo: “http://xxxx.com.br/a.png”) Pode ser o caminho de um arquivo contido no pacote do plugin. Pode ser um arquivo que se encontra no HD Virtual do plugin instalado. |
| flipHorz | Boolean | Determina se a imagem deve ser desenhada de forma espelhada horizontalmente. |
| flipVert | Boolean | Determina se a imagem deve ser desenhada de forma espelhada verticalmente. |
| grayscale | Boolean | Determina se imagem deve ser desenhada usando um filtro de cores que transforma a imagem em uma imagem de escala cinzenta. |
| colorBlend | String de Cor | Determina se a imagem deve ser desenhada utilizando um filtro que misturando as cores originais com uma cor definida pela propriedade "colorBlend". O valor padrão é "#00000000" e significa não realizar misturar de cores. Exemplo: "Blue" fará com que a imagem seja desenhada misturada com a cor azul. |
| colorMask | String de Cor | Determina se a imagem deve ser desenhada utilizando um filtro que seleciona as cores da imagem realizando uma multiplicação das cores da imagem pela cor definida em "colorMask". O valor padrão é "#FFFFFFFF" e significa que todas as coras originais da imagem deve ser desenhadas sem alteração. Exemplo: "Blue" fará com que a imagem seja desenhada selecionando apenas os tons azuis pois os componentes da cor azul são R = 0, G = 0 e B = 255, o que transformando em notação de ponto flutuante fica R = 0.0, G = 0.0, B = 1.0... Para cada pixel da imagem, o Red será multiplicado por 0, o Green será multiplicado por 0 e o Blue será multiplicado por 1.0. |
| filterEx | Enumerado: "none" (Padrão) "glow" "innerGlow" "blur" "sepia" | Determina se a imagem deve ser desenhada com mais algum filtro de imagem especial. "none" - Nenhum filtro especial. "glow" - Um filtro que adiciona uma incandescência à imagem. Não esqueça de preencher a propriedade "filterExColor" ao utilizar este filtro. "innerGlow" - Um filtro que adiciona um brilho interno à imagem. Não esqueça de preencher a propriedade "filterExColor" ao utilizar este filtro. "blur" - Um filtro que aplica um "borrão" na imagem. "sepia" - Um filtro que aplica um tom marrom na imagem. |
| filterExColor | String de Cor | Alguns filtros permitem escolher uma cor como parâmetro. Se a propriedade filterEx for: "glow" - Esta propriedade contém a cor da incandescência que será criada na imagem. "innerGlow" - Esta propriedade contém a cor do brilho interno que será criado na imagem. A cor padrão é "Red" |
| frame | Enumerado: "none" (Padrão) "boton" | Determina se a imagem deve ser desenhada com alguma borda. "none" - A imagem será desenhada sem bordas. "boton" - A imagem será desenhada com borda de um bóton arredondado. |
| sourceRect | Estrutura SceneRect | Determina, utilizando uma Estrutura SceneRect, qual porção da imagem original deve ser desenhada. Os valores de left, top, right e bottom vão de 0.0 a 1.0, onde 0.0 = representa o inicio e 1.0 o final do eixo. O valor padrão é: {left=0.0, top=0.0, right=1.0, bottom=1.0} ... isto é, desenhar todo contéudo da imagem original. Exemplo: {left=0.5, top=0, right=1.0, bottom=0.5} - Desenhar apenas o quadrante superior-direita da imagem. |
Métodos¶
| Método | Descrição |
|---|---|
Eventos¶
| Nome do evento | Descrição |
|---|---|
Exemplos¶
Exemplo 1 - Um plug-in que adiciona/remove uma marca personalizada quando o usuário clica nos itens do scene.¶
| require("scene.lua"); SceneLib.registerPlugin( function (scene, attachment) -- Manipular o evento OnMouseDown do Viewport scene.viewport.onMouseDown = function(event) -- Usuário clicou no Scene -- Transformar as coordenadas de tela em métrica de mundo local worldX, worldY = scene.viewport:screenToWorld(event.x, event.y); -- Localizar o item que o usuário clicou local item = scene.items:itemAtPoint(worldX, worldY); if item ~= nil then -- Encontrou um item na posição clicada. * **local* NOME_MINHA_MARCA = "MarcaExemplo"; -- Localizar uma operação gráfica neste item com o nosso nome local opGrafica = item.canvas:findByName(NOME_MINHA_MARCA); if opGrafica == nil then --[[ A operação gráfica da minha marca ainda não existe neste token/item. Vamos criar ]] opGrafica = item.canvas:addBitmap(); opGrafica.name = NOME_MINHA_MARCA; -- Abaixo, URL da imagem da nossa marca. opGrafica.url = "https://wiki.teamfortress.com/w/images/d/dd/Bleed_drop.png?t=20110425044341"; opGrafica.x = 0.25; opGrafica.width = 0.3; opGrafica.y = -0.1; opGrafica.height = 0.3; opGrafica.z = 10; else -- Vamos apagar nossa operação gráfica previamente criada opGrafica:delete(); end; end; end; end); |
|---|
Item sem a marca |
Item com a marca |
|---|---|
Exemplo 2 - ¶
Created with the Personal Edition of HelpNDoc: Transform Your Word Document into a Professional eBook with HelpNDoc
Item sem a marca
Item com a marca