Apêndice C. Interface em QML

Os programas em QML podem ser invocados através do menu de contexto da lista de ficheiros e podem ser configurados na página Acções do Utilizador da janela de configuração. Os programas que são aqui configurados podem ser usados como exemplos para programas personalizados. O QML usa o JavaScript, sendo que aqui está o obrigatório "Olá Mundo":

import Kid3 1.0

Kid3Script {
  onRun: {
    console.log("Olá mundo, a pasta é", app.dirName)
    Qt.quit()
  }
}

Se este programa for gravado em /local/do/Exemplo.qml, o comando do utilizador poderá ser definido como @qml /local/do/Exemplo.qml com o nome Teste de QML e o Resultado assinalado. Poderá então ser iniciado com o item Teste de QML no menu de contexto da lista de ficheiros, ficando o resultado visível na janela.

Infelizmente, o arranque de programas em QML com o qml (p.ex. qml -apptype widget -I /usr/lib/kid3/plugins/imports /localização/do/Exemplo.qml) está com problemas nas versões recentes do Qt. Mas o kid3-cli oferece uma forma alternativa de executar um programa em QML a partir da linha de comandos, usando o seu comando execute.

kid3-cli -c "execute @qml /localização/do/Exemplo.qml"

Para enumerar os títulos nas marcas 2 de todos os ficheiros na pasta actual, poderia ser usado o seguinte programa:

import Kid3 1.0

Kid3Script {
  onRun: {
    app.firstFile()
    do {
      if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {
        console.log(app.getFrame(tagv2, "title"))
      }
    } while (app.nextFile())
  }
}

Se a pasta tiver vários ficheiros, um destes programas poderá bloquear a interface do utilizador durante algum tempo. Para as operações mais demoradas, deverá então pausar de tempos a tempos. A implementação alternativa em baixo tem o trabalho feito para um único ficheiro transferido para uma função. Essa função invoca-se a si própria com um tempo-limite de 1 ms no fim, desde que existam mais ficheiros para serem processados. Isto irá garantir que a GUI continua a reagir enquanto o programa está em execução.

import Kid3 1.0

Kid3Script {
  onRun: {
    function trabalhar() {
      if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {
        console.log(app.getFrame(tagv2, "title"))
      }
      if (!app.nextFile()) {
        Qt.quit()
      } else {
        setTimeout(trabalhar, 1)
      }
    }

    app.firstFile()
    trabalhar()
  }
}

Ao usar o app.firstFile() com o app.nextFile(), serão processados todos os ficheiros na pasta actual. Se só é suposto processar os ficheiros seleccionados, use o firstFile() e o nextFile() em alternativa; estas são funções de conveniência do componente Kid3Script. O seguinte exemplo é um programa que copia apenas os pacotes do número do disco e dos direitos de cópia do ficheiro seleccionado.

import Kid3 1.1

Kid3Script {
  onRun: {
    function trabalhar() {
      if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {
        app.setFrame(tagv2, "*.selected", false)
        app.setFrame(tagv2, "discnumber.selected", true)
        app.setFrame(tagv2, "copyright.selected", true)
        app.copyTags(tagv2)
      }
      if (!nextFile()) {
        Qt.quit()
      } else {
        setTimeout(trabalhar, 1)
      }
    }

    firstFile()
    trabalhar()
  }
}

Mais programas vêm disponíveis com o Kid3 e estão já registados como comandos do utilizador.