# Information for Developers and Advanced Users of &k3b;

&k3b; features, like many other &kde; applications as well, a &DCOP; interface which makes it possible to control a part of it's functionality from &eg; a shellscript.

To use these &DCOP; functions you can either use the `dcop` commandline program or the more convenient Kdcop application. Both provide the same functionality so it's mostly a matter of taste and context of usage when deciding which way to choose.

This chapter assumes that you're using the `dcop` commandline program. To access &k3b;'s &DCOP; functions, make sure that &k3b; is started and then enter something like this at a console:

        % dcop k3b-X K3bInterface [function]

If an error message appears telling you that `dcop` couldn't be found or executed, please ensure that the `dcop` binary is in `$`KDEDIR`/bin` and that that directory is in your $`PATH`. Also, make sure the permissions for that file are appropriately set (that your user can execute that file).

In that command line, just replace X with the actual number of the &k3b; process and [function] with the respective name of the function you'd like to call.

## &DCOP; Interface Reference

Besides the generic &DCOP; functions available to all &kde; programs, &k3b; features the following functions which are specific to it.

`DCOPRefcreateAudioCDProject`

  Example:

                  % echo `k3b-31754 K3bInterface DCOPRefcreateAudioCDProject`

`DCOPRefcreateDataCDProject`

  Example:

                  % echo `k3b-31754 K3bInterface DCOPRefcreateDataCDProject`

`DCOPRefcreateDataDVDProject`

  Example:

                  % echo `k3b-31754 K3bInterface DCOPRefcreateDataDVDProject`

`DCOPRefcreateMixedCDProject`

  Example:

                  % echo `k3b-31754 K3bInterface DCOPRefcreateMixedCDProject`

`DCOPRefcreateMovixCDProject`

  Example:

                  % echo `k3b-31754 K3bInterface DCOPRefcreateMovixCDProject`

`DCOPRefcreateVideoCDProject`

  Example:

                  % echo `k3b-31754 DCOPRefcreateVideoCDProject DCOPRefcreateVideoCDProject`

`DCOPRefopenDocument(KURL url)`

`QCStringList interfaces`

`QValueList<DCOPRef> projects`