# A interface &DCOP; do &k3b;

O &k3b; possui, tal como muitas outras aplicações do &kde;, uma interface &DCOP; que torna possível controlar parte das suas funcionalidades a partir, por exemplo, de um 'shellscript'.

Para utilizar estas funções &DCOP; você pode usar o programa de linha de comando `dcop` ou a aplicação Kdcop. Ambos fornecem a mesma funcionalidade por isso é uma questão de gosto e de contexto de utilização para escolher qual utilizar.

Este capítulo assume que você está usando o programa de linha de comando `dcop`. Para acessar às funções &DCOP; do &k3b;'s &DCOP;, verifique se o &k3b; está rodando e depois escreva algo deste gênero no console:

    #dcop k3b K3bInterface [função]

Além das funções &DCOP; genéricas disponíveis em todos os programas do &kde;, a interface DCOP do &k3b; consiste em duas partes principais, como descrito abaixo.

## A interface padrão do K3b

A interface de DCOP padrão do K3b oferece funcionalidades do tipo 'copyCD', 'formatDVD', bem como métodos para criar projetos novos.

    DCOPRef createDataCDProject()
    DCOPRef createAudioCDProject()
    DCOPRef createMixedCDProject()
    DCOPRef createVideoCDProject()
    DCOPRef createMovixCDProject()
    DCOPRef createDataDVDProject()
    DCOPRef createVideoDVDProject()
    DCOPRef createMovixDVDProject()
    DCOPRef openProject(KURL url)
    QValueList<DCOPRef> projects()
    DCOPRef currentProject()
    void copyCd()
    void copyDvd()
    void eraseCdrw()
    void formatDvd()
    void burnCdImage(KURL url)
    void burnDvdImage(KURL url)

Como resultado de um dos métodos 'createXXXProject', obtém-se uma referência de DCOP ao projeto recém-criado:

    DCOPRef(k3b,K3bProject-0)

Em alternativa, você poderá criar um projeto com a linha de comando:

    # k3b --audiocd

e então obter uma referência para este projeto com

    # dcop k3b K3bInterface currentProject

Se usar esta referência, é possível manipular o projeto com a K3bProjectInterface.

## K3bProjectInterface

    void addUrls(KURL::List urls)
    void addUrl(KURL url)
    void burn()

O K3b oferece a K3bProjectInterface listada acima, ou então a K3bDataProjectInterface, mais poderosa, que só se aplica aos projetos de dados (CD e DVD):

    void createFolder(QString nome)
    void createFolder(QString nome,QString pai)
    void addUrl(KURL url,QString pai)
    void addUrls(KURL::List urls,QString pai)
    void removeItem(QString localização)
    void renameItem(QString localização,QString novoNome)
    void setVolumeID(QString id)

Se você usar estes métodos, é possível preencher um projeto de dados com os arquivos e pastas de um programa. O exemplo a seguir cria um novo projeto de dados, adiciona várias pastas ao projeto e adiciona arquivos às pastas recém criadas:

    #!/bin/bash
    PROJECT=$(dcop k3b K3bInterface createDataCDProject)
    dcop $PROJECT createFolder teste
    dcop $PROJECT createFolder xpto
    dcop $PROJECT createFolder xpto2 /xpto
    dcop $PROJECT addUrl /home/jose/umArquivo.txt /xpto/xpto2