From 474149035f171b4f9a478dce62f5e8deae7898d8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sl=C3=A1vek=20Banko?= Date: Sun, 16 Sep 2012 19:31:58 +0200 Subject: Rebranding of Krita as Chalk --- .../koffice/chalk/developers-scripting.docbook | 1132 ++++++++++++++++++++ 1 file changed, 1132 insertions(+) create mode 100644 koffice-i18n-pt_BR/docs/koffice/chalk/developers-scripting.docbook (limited to 'koffice-i18n-pt_BR/docs/koffice/chalk/developers-scripting.docbook') diff --git a/koffice-i18n-pt_BR/docs/koffice/chalk/developers-scripting.docbook b/koffice-i18n-pt_BR/docs/koffice/chalk/developers-scripting.docbook new file mode 100644 index 00000000..5c45e0aa --- /dev/null +++ b/koffice-i18n-pt_BR/docs/koffice/chalk/developers-scripting.docbook @@ -0,0 +1,1132 @@ + +Programação + +No &chalk;, você poderá criar programas em Ruby ou Python (a disponibilidade dos interpretadores poderá depender da sua distribuição ou se o administrador da sua máquina os instalou). Aqui você poderá encontrar uma descrição da API de programação. Alguns dos exemplos são distribuídos com o &chalk; e você poderá encontrá-los em /usr/share/apps/chalk/scripts (ou /opt/kde/share/apps/chalk/scripts). + + +Variáveis do módulo <classname +>Krosschalkcore</classname +> + + +O ChalkDocument retorna um objeto Document +O ChalkScript retorna um objeto ScriptProgress + + +Você poderá obter um objeto com a função get do módulo Krosschalkcore; no Ruby, você terá que escrever algo como: doc = Krosschalkcore::get("ChalkDocument") +programa = Krosschalkcore::get("ChalkScript") + + + + + + +Funções no módulo <classname +>Krosschalkcore</classname +> + + +Função: getBrushEsta função retorna um Brush obtido da lista de recursos do &chalk;. Recebe um argumento: o nome do pincel. Por exemplo (em Ruby): Krosschalkcore::getBrush("Circle (05)") + + +Função: getFilterEsta função retorna um Filter obtido da lista de recursos do &chalk;. Recebe um argumento: o nome do filtro. Por exemplo (em Ruby): Krosschalkcore::getFilter("invert") + + +Função: getPatternEsta função retorna um Pattern obtido da lista de recursos do &chalk;. Recebe um argumento: o nome do padrão. Por exemplo (em Ruby): Krosschalkcore::getPattern("Bricks") + + +Função: loadBrushEsta função carrega um Brush e retorna-o em seguida. Ela recebe um argumento: o nome do arquivo do pincel. + +Função: loadPatternEsta função carrega um Pattern e retorna-o em seguida. Ela recebe um argumento: o nome do arquivo do padrão. + +Função: newCircleBrushEsta função retorna um Brush com uma forma circular. Recebe pelo menos dois argumentos: a largura e a altura. Poderá receber outros dois argumentos: a largura e a altura do sombreado. Se não for indicado qualquer sombreado, ele não será usado. Por exemplo (em Ruby): Krosschalkcore::newCircleBrush(10,20) # cria um círculo simples +Krosschalkcore::newCircleBrush(10,20,5,10) # cria um gradiente + + +Função: newHSVColorEsta função retorna uma nova Color com a tripla HSV fornecido. Recebe três argumentos: a componente do matiz (0 a 255), da saturação (0 a 255) e do valor (0 to 255). Por exemplo (em Ruby): Krosschalkcore::newHSVColor(255,125,0) + + +Função: newImageEsta função retorna uma nova Image. Recebe quatro argumentos: largura, altura, ID do espaço de cores, nome da imagem. Como resultado, irá obter um objeto Image. Por exemplo (em Ruby): Krosschalkcore::newImage(10,20, "RGBA", "kikoo") + + +Função: newRectBrushEsta função retorna um Brush com uma forma retangular. Recebe pelo menos dois argumentos: a largura e a altura. Poderá receber outros dois argumentos: a largura e a altura do sombreado. Se não for indicado qualquer sombreado, ele não será usado. Por exemplo (em Ruby): Krosschalkcore::newRectBrush(10,20) # criar um retângulo simples + Krosschalkcore::newRectBrush(10,20,5,10) # criar um gradiente + + +Função: newRGBColorEsta função retorna uma nova Color com a tripla RGB fornecida. Recebe três argumentos: a componente do vermelho (0 a 255), do verde (0 a 255) e do azul (0 to 255). Por exemplo (em Ruby): Krosschalkcore::newRGBColor(255,0,0) # criar uma cor vermelha +Krosschalkcore::newRGBColor(255,255,255) # criar uma cor branca + + + + + +Descrições e listas de funções dos vários objetos no <classname +>Krosschalkcore</classname +> + + +Objeto: PaintLayer + + +Função: beginPainting + +Função: convertToColorspaceConverte a imagem para um espaço de cores. Esta função recebe um argumento: o nome do espaço de cores de destino. Por exemplo (em Ruby): image.convertToColorspace("CMYK") + + +Função: createHistogramEsta função cria um histograma para esta camada. Recebe dois argumentos: o tipo do histograma ("RGB8HISTO") e 0 se o histograma for linear ou 1 se for logarítmico. + +Função: createHLineIteratorCria um iterador sobre uma camada, que irá percorrer uma linha. Esta função recebe três argumentos: x (início na linha), y (posição vertical da linha), largura da linha. + +Função: createPainterEsta função cria um Painter que lhe permitirá pintar na camada. + +Função: createRectIteratorCria um iterador sobre uma camada, que irá funcionar sobre uma área retangular. Esta função recebe quatro argumentos: x, y, largura do retângulo, altura do retângulo. + +Função: createVLineIteratorCria um iterador sobre uma camada, que irá percorrer uma coluna. Esta função recebe três argumentos: x (posição horizontal da coluna), y (início da coluna), altura da coluna. + +Função: endPaintingEsta função fecha o ítem a desfazer atual e adiciona-o ao histórico. + +Função: fastWaveletTransformationRetorna a transformação por ondulação da camada. + +Função: fastWaveletUntransformationAnula uma ondulação desta camada. Recebe um argumento: um objeto de ondulação. Por exemplo (em Ruby): wavelet = camada.fastWaveletTransformation() +camada.fastWaveletUntransformation(wavelet) + + +Função: getHeightRetorna a altura da camada. + +Função: getWidthRetorna a largura da camada. + + + +Objeto: Filter + + +Função: getFilterConfigurationEsta função retorna a FilterConfiguration associada com este filtro. + +Função: processEsta função irá aplicar o filtro. Recebe pelo menos um argumento: a camada de origem. Você poderá também usar estes quatro argumentos: x, y, largura, altura. O (x,y,largura,altura) define a área retangular na qual será calculado o filtro. Se o retângulo não for definido, então o filtro será aplicado na camada de origem inteira. Por exemplo (em Ruby) doc = Krosschalkcore::get("ChalkDocument") +imagem = doc.getImage() +camada = imagem.getActivePaintLayer() +largura = camada.getWidth() +altura = camada.getHeight() +filtro = Krosschalkcore::getFilter("invert") +filtro.process(camada, camada) +filtro.process(camada, camada, 10, 10, 20, 20 ) + + + +Objeto: FilterConfiguration + + +Função: getPropertyEsta função retorna o valor de um parâmetro do Filter associado. Ele recebe um argumento: o nome do parâmetro. + +Função: setPropertyEsta função define um parâmetro do Filter associado. Ela recebe dois argumentos: o nome do parâmetro e o valor, cujo tipo depende do Filter. + + + +Objeto: Histogram + +Esta classe permite-lhe acessar o histograma de um PaintLayer. Exemplo (em Ruby): doc = krosschalkcore::get("ChalkDocument") + imagm = doc.getImage() + camada = imagem.getActiveLayer() + histo = camada.createHistogram("RGB8HISTO",0) + min = camada.getMin() * 255 + max = camada.getMax() * 255 + for i in min..max + print camada.getValue(i) + print "\n" + end + + + + +Função: getChannelRetorna o canal selecionado. + +Função: getCountEsta função retorna o número de pixels usados pelo histograma. + +Função: getHighestEsta função retorna o valor mais elevado do histograma. + +Função: getLowestEsta função retorna o valor mínimo do histograma. + +Função: getMaxEsta função retorna o limite máximo do histograma (os valores com maior posição onde os máximos são nulos). O valor está no intervalo 0.0 – 1.0. + +Função: getMeanEsta função retorna a média do histograma. + +Função: getMinEsta função retorna o limite mínimo do histograma (os valores com menor posição onde os máximos são nulos). O valor está no intervalo 0.0 – 1.0. + +Função: getNumberOfBinsRetorna o número de abcissas deste histograma. + +Função: getTotalEsta função retorna o somatório de todos os valores do histograma. + +Função: getValueRetorna o valor de uma abcissa do histograma. Esta função recebe um argumento: índice, no intervalo [0..255]. + +Função: setChannelSeleciona o canal da camada para o qual irá obter o resultado do histograma. Esta função recebe um argumento: o número do canal. + + + +Objeto: ScriptProgress +O ScriptProgress é usado para gerenciar a barra de progresso da barra de estado do &chalk;. Por exemplo (em Ruby): programa = Krosschalkcore::get("ChalkScript") +programa.setProgressTotalSteps(1000) +programa.setProgressStage("progressive", 0) +for i in 1..900 + programa.incProgress() +end +programa.setProgressStage("brutal", 1000) + + + +Função: incProgressEsta função avança um passo no progresso. + +Função: setProgressEsta função altera o valor do progresso. Recebe um argumento: o valor do progresso. + +Função: setProgressStageEsta função altera o valor do progresso e mostra o texto. + +Função: setProgressTotalStepsEsta função define o número de passos que o programa irá necessitar. Recebe um argumento: o valor máximo do progresso + + + +Objeto: WaveletEste objeto contém os coeficientes de uma transformação por ondulação de um PaintLayer. + + +Função: getDepthRetorna a profundidade da camada. + +Função: getNCoeffRetorna o valor do N-ésimo coeficiente. A função recebe um argumento: o índice do coeficiente. + +Função: getNumCoeffsRetorna o número de coeficientes nesta ondulação (= tamanho * tamanho * profundidade). + +Função: getSizeRetorna o tamanho da ondulação (tamanho = largura = altura). + +Função: getXYCoeffRetorna o valor de um coeficiente. A função recebe dois argumentos: x e y. + +Função: setNCoeffAltera o valor do N-ésimo coeficiente. A função recebe dois argumentos: o índice do coeficiente e o novo valor do coeficiente. + +Função: setXYCoeffAltera o valor de um coeficiente. A função recebe três argumentos: x, y e o novo valor do coeficiente. + + + +Objeto: Painter + + +Função: convolveEsta função aplica um módulo de convolução a uma imagem. Recebe pelo menos três argumentos: uma lista de módulos (todas as listas deverão ter o mesmo tamanho), o fator e o deslocamento. O valor de um pixel será fornecido pela seguinte função: K * P / factor + deslocamento, onde o K é o módulo e o P a vizinhança. Poderá receber os seguintes argumentos opcionais: opContorno (controla como fazer a convolução dos pixels no extremo de uma imagem: 0 = usar a cor padrão, 1 = usa o pixel do lado oposto da imagem, 2 = usar o pixel do contorno, 3 = evitar os pixels do contorno), canal (1 para a cor, 2 para o alfa, 3 para ambos), x, y, largura, altura. + +Função: setFillThresholdDefine o limiar de preenchimento. Recebe um argumento: o limite. + +Função: fillColorComeça a preencher com uma cor. Recebe dois argumentos: x e y. + +Função: fillPatternComeça a preencher com um padrão. Recebe dois argumentos: x e y. + +Função: paintPolylineEsta função irá pintar uma linha poligonal. Recebe dois argumentos: uma lista de posições em X e uma lista de posições em Y. + +Função: paintLineEsta função irá pintar uma linha. Ele recebe cinco argumentos: x1, y1, x2, y2 e pressão. + +Função: paintBezierCurveEsta função irá pintar uma curva Bezier. Recebe dez argumentos: x1, y1, p1, cx1, cy1, cx2, cx2, x2, y2, p2, onde o (x1,y1) é a posição inicial, o p1 é a pressão inicial, (x2,y2) é a posição final, p2 é a pressão no fim. O (cx1,cy1) e o (cx2,cy2) são as posições dos pontos de controle. + +Função: paintEllipseEsta função irá pintar uma elipse. Recebe cinco argumentos: x1, y1, x2, y2, pressão, onde o (x1,y1) e o (x2,y2) são as posições dos dois centros. + +Função: paintPolygonEsta função irá pintar um polígono. Recebe dois argumentos: uma lista de posições em X e uma lista de posições em Y. + +Função: paintRectEsta função irá pintar um retângulo. Recebe cinco argumentos: x, y, largura altura, pressão. + +Função: paintAtEsta função irá pintar numa posição fornecida. Recebe três argumentos: x, y, pressão. + +Função: setPaintColorEsta função define a cor de pintura (também chamada de cor principal). Recebe um argumento: um Color. + +Função: setBackgroundColorEsta função altera a cor de fundo. Recebe um argumento: uma Color. + +Função: setPatternEsta função altera o padrão usado no preenchimento. Recebe um argumento: um objeto Pattern. + +Função: setBrushEsta função altera o pincel usado na pintura. Recebe um argumento: um objeto Brush. + +Função: setPaintOpEsta função define a operação de pintura. Recebe um argumento: o nome da operação de pintura. + +Função: setDuplicateOffsetEsta função define o deslocamento da duplicata. Recebe dois argumentos: o deslocamento horizontal e o vertical. + +Função: setOpacityEsta função altera a opacidade da pintura. Recebe um argumento: a opacidade, no intervalo de 0 a 255. + +Função: setStrokeStyleEsta função define o estilo do traço. Recebe um argumento: 0 para nenhum e 1 para pincel. + +Função: setFillStyleEsta função altera o estilo de preenchimento do Painter. Recebe um argumento: 0 para nada, 1 para o preenchimento com a cor principal, 2 para o preenchimento com a cor de fundo e 3 para o preenchimento com um padrão. + + + +Objeto: IteratorEste objeto permite-lhe alterar os valores dos pixels um a um. O nome de algumas funções depende do espaço de cores; por exemplo, se o espaço de cores da camada for o RGB, terá o setR, setG e o setB e, no caso do CMYK: setC, setM, setY e setK. Na documentação abaixo, nós consideraremos que o espaço de cores se chamada ABC, com três canais: A, B e C. + + +Funções: setA, setB, setCEstas funções recebem um argumento: o novo valor de um dos canais deste pixel. + +Função: setABCAltera o valor de todos os canais. Esta função recebe um argumento: uma lista com os valores novos de todos os canais. + +Funções: getA, getB, getCRetorna o valor de um dos canais deste pixel. + +Função: getABCRetorna uma lista com os valores de todos os canais. + +Função: darkenTorna um pixel mais escuro. Esta função recebe pelo menos um argumento: sombra (quantidade usada para escurecer todos os canais de cores). Esta função poderá receber o seguinte argumento opcional: compensação (para limitar o escurecimento). + +Função: invertColorInverte a cor de um pixel. + +Função: nextIncrementa a posição, indo para o pixel seguinte. + +Função: isDoneDevolve 'true' (verdadeiro) se o iterador estiver no fim (não existirem mais pixels). + + + + + + + +Recursos + +Aqui estão sugestões ou listas parciais de recursos do &chalk;. Para o Brush e o Pattern: Você poderá obter o nome e o pincel ou padrão associado do seletor da barra de ferramentas do &chalk;. Uma lista de identificadores de espaços de cores no &chalk;: LABA, RGBA, RGBA16, RGBAF32, RGBAF16HALF, LMSAF32, GRAYA, GRAYA16, CMYK, CMYKA16. + + + + -- cgit v1.2.1