<chapter id="advanced-features"><title>Recursos Avan?ados do amaroK</title><sect1 id="keybd-shortcuts"><title>Atalhos de Teclado</title><para>O &amarok; usa os atalhos de teclado, como a maioria dos outros aplicativos; abaixo, encontra-se uma listagem desses atalhos e das suas a??es respectivas. Os atalhos globais podem ser configurados clicando com o &RMB; na janela do Leitor e selecionando a op??o <guimenuitem>Configurar os Atalhos Globais...</guimenuitem>. Os atalhos do &amarok; podem ser configurados clicando com o &RMB; na janela do Leitor e selecionando a op??o <guimenuitem>Configurar Atalhos...</guimenuitem></para><tip><para>Você poderá atribuir teclas multimídia para funcionarem como atalhos do &amarok;, tornando o seu teclado um centro de controle do &amarok;.</para></tip><para>Os atalhos globais s?o:</para><informaltable><tgroup cols="2"><thead><row><entry>Combina??o de Teclas</entry><entry>A??o</entry></row></thead><tbody><row><entry><keycombo><keycap>Win</keycap><keycap>X</keycap></keycombo></entry><entry>Tocar</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>C</keycap></keycombo></entry><entry>Pausa</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>V</keycap></keycombo></entry><entry>Parar</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>B</keycap></keycombo></entry><entry>Próxima Faixa</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>Z</keycap></keycombo></entry><entry>Faixa Anterior</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>KP_Add</keycap></keycombo></entry><entry>Aumentar o Volume</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>KP_Subtract</keycap></keycombo></entry><entry>Diminuir o Volume</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>A</keycap></keycombo></entry><entry>Adicionar Mídia</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>P</keycap></keycombo></entry><entry>Alternar Lista</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>O</keycap></keycombo></entry><entry>Mostrar o OSD</entry></row></tbody></tgroup></informaltable><para>Os atalhos do &amarok; s?o:</para><informaltable><tgroup cols="2"><thead><row><entry>Combina??o de Teclas</entry><entry>A??o</entry></row></thead><tbody><row><entry><keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo></entry><entry>Copiar</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>KP_Enter</keycap></keycombo></entry><entry>Ir para a Atual</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo></entry><entry>Sair</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>Z</keycap></keycombo></entry><entry>Refazer</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo></entry><entry>Salvar a Lista de Reprodu??o</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>A</keycap></keycombo></entry><entry>Selecionar Tudo</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo></entry><entry>Embaralhar</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo></entry><entry>Desfazer</entry></row></tbody></tgroup></informaltable><para>Os atalhos do Navegador na Lista de Reprodu??o s?o:</para><informaltable><tgroup cols="2"><thead><row><entry>Combina??o de Teclas</entry><entry>A??o</entry></row></thead><tbody><row><entry><keycap>Espa?o</keycap></entry><entry>Carregar Lista</entry></row><row><entry><keycap>F2</keycap></entry><entry>Renomear Lista</entry></row><row><entry><keycap>Backspace</keycap></entry><entry>Remover Lista</entry></row></tbody></tgroup></informaltable></sect1><sect1 id="the-dcop-interface"><title>A Interface DCOP</title><para>A interface de DCOP do amaroK oferece-lhe uma forma simples de controlar o amaroK com os seus próprios programas personalizados.</para><para>A interface de DCOP do amaroK tem várias fun??es genéricas que poder?o ser encontradas noutros aplicativos do KDE. Esta se??o pretende descrever as fun??es do DCOP para o leitor. Um exemplo da fun??o de DCOP <quote>pause</quote> seria semelhante ao seguinte:</para><para><prompt>&percnt;</prompt>dcop amarok player pause</para><informaltable><tgroup cols="2"><thead><row><entry>Fun??o de DCOP</entry><entry>A??o</entry></row></thead><tbody><row><entry>album</entry><entry>A fun??o <quote>album</quote> retorna o álbum da música que está tocando atualmente.</entry></row><row><entry>artist</entry><entry>A fun??o <quote>artist</quote> retorna o artista da música que está tocando atualmente.</entry></row><row><entry>bitrate</entry><entry>A fun??o <quote>bitrate</quote> retorna a taxa de amostragem em bits da música que está tocando atualmente.</entry></row><row><entry>comment</entry><entry>A fun??o <quote>comment</quote> retorna o comentário da música que está tocando atualmente.</entry></row><row><entry>coverImage</entry><entry>A fun??o <quote>coverImage</quote> retorna o URL da imagem de capa da faixa atual.</entry></row><row><entry>currentTime</entry><entry>A fun??o <quote>currentTime</quote> retorna a posi??o (mm:ss) da música que está tocando atualmente.</entry></row><row><entry>encodedURL</entry><entry>A fun??o <quote>encodedURL</quote> retorna o URL da faixa atual com os espa?os codificados.</entry></row><row><entry>genre</entry><entry>A fun??o <quote>genre</quote> retorna o gênero da música que está tocando atualmente.</entry></row><row><entry>nowPlaying</entry><entry>A fun??o <quote>nowPlaying</quote> retorna o texto "Artista - Título" da faixa que está tocando atualmente. Se uma das marcas ID3 estiver em branco, só o "Artista" ou o "Título" s?o mostrados (sem o "-").</entry></row><row><entry>title</entry><entry>A fun??o <quote>title</quote> retorna o título da música que está tocando atualmente.</entry></row><row><entry>totalTime</entry><entry>A fun??o <quote>totalTime</quote> retorna o tempo total (mm:ss) da música que está tocando atualmente.</entry></row><row><entry>track</entry><entry>A fun??o <quote>track</quote> retorna o número da faixa atual.</entry></row><row><entry>year</entry><entry>A fun??o <quote>year</quote> retorna o ano da música que está tocando atualmente.</entry></row><row><entry>isPlaying</entry><entry>A fun??o <quote>isPlaying</quote> retorna um valor 'true' (verdadeiro) ou 'false' (falso) para indicar se o leitor está tocando ou n?o.</entry></row><row><entry>randomModeStatus</entry><entry>A fun??o <quote>randomModeStatus</quote> retorna o estado do Modo Aleatório com um valor verdadeiro ('true') ou falso ('false').</entry></row><row><entry>repeatPlaylistStatus</entry><entry>A fun??o <quote>repeatPlaylistStatus</quote> retorna o estado da Repeti??o da Lista de Músicas com um valor verdadeiro ('true') ou falso ('false').</entry></row><row><entry>repeatTrackStatus</entry><entry>A fun??o <quote>repeatTrackStatus</quote> retorna o valor da Repeti??o da Faixa com um valor verdadeiro ('true') ou falso ('false').</entry></row><row><entry>getVolume</entry><entry>A fun??o <quote>getVolume</quote> retorna o nível do volume, com um valor entre 0-100.</entry></row><row><entry>sampleRate</entry><entry>A fun??o <quote>sampleRate</quote> retorna a taxa de amostragem da faixa atual.</entry></row><row><entry>score</entry><entry>A fun??o <quote>score</quote> retorna a pontua??o da faixa atual.</entry></row><row><entry>status</entry><entry>A fun??o <quote>status</quote> retorna um valor para o estado do motor, sendo 2 para o estado de reprodu??o, 1 para pausa e 0 para inativo.</entry></row><row><entry>trackCurrentTime</entry><entry>A fun??o <quote>trackCurrentTime</quote> retorna um valor com o tempo decorrido na faixa em segundos.</entry></row><row><entry>trackTotalTime</entry><entry>A fun??o <quote>trackTotalTime</quote> retorna o valor do tempo total da faixa em segundos.</entry></row><row><entry>addMedia</entry><entry>A fun??o <quote>addMedia</quote> é usada para adicionar arquivos únicos à lista de músicas.</entry></row><row><entry>addMediaList</entry><entry>A fun??o <quote>addMediaList</quote> é usada para adicionar vários arquivos à lista de músicas.</entry></row><row><entry>clearPlaylist</entry><entry>A fun??o <quote>clearPlaylist</quote> é usada para limpar a lista por completo.</entry></row><row><entry>configEqualizer</entry><entry>A fun??o <quote>configEqualizer</quote> apresenta a janela de configura??o do equalizador.</entry></row><row><entry>enableOSD</entry><entry>A fun??o <quote>enableOSD</quote> permite-lhe ativar ou desativar a Visualiza??o na Tela ou OSD com um valor 'true' (verdadeiro) ou 'false' (falso)</entry></row><row><entry>enableRandomMode</entry><entry>A fun??o <quote>enableRandomMode</quote> permite-lhe ativar ou desativar o modo aleatório com um valor 0 (desativado) ou 1 (ativo).</entry></row><row><entry>mute</entry><entry>A fun??o <quote>mute</quote> permite-lhe emudecer ou ativar o som da faixa que está sendo tocada.</entry></row><row><entry>next</entry><entry>A fun??o <quote>next</quote> avan?a uma faixa no leitor.</entry></row><row><entry>pause</entry><entry>A fun??o <quote>pause</quote> coloca em pausa a faixa atual.</entry></row><row><entry>play</entry><entry>A fun??o <quote>play</quote> inicia o leitor no ponto em que foi parado da última vez.</entry></row><row><entry>playMedia</entry><entry>A fun??o <quote>playMEDIA</quote> inicia a reprodu??o de uma faixa indicada peloa seu KURL.</entry></row><row><entry>playPause</entry><entry>A fun??o <quote>playPause</quote> inicia o leitor se já está parado ou em pausa. Esta fun??o também coloca o leitor em pausa se já estava tocando uma faixa.</entry></row><row><entry>prev</entry><entry>A fun??o <quote>prev</quote> recua uma faixa no leitor.</entry></row><row><entry>saveCurrentPlaylist</entry><entry>A fun??o <quote>saveCurrentPlaylist</quote> salva a lista de reprodu??o atual como ~/.kde/share/apps/amarok/current.xml.</entry></row><row><entry>scanCollection</entry><entry>A fun??o <quote>scanCollection</quote> efetua uma pesquisa manual sobre a sua cole??o.</entry></row><row><entry>seek</entry><entry>A fun??o <quote>seek</quote> é usada para se posicionar numa faixa com base num valor indicado em segundos.</entry></row><row><entry>seekRelative</entry><entry>A fun??o <quote>seekRelative</quote> é usada para se posicionar de forma relativa numa faixa com base num valor indicado em segundos.</entry></row><row><entry>setEqualizerEnabled</entry><entry>A fun??o <quote>setEqualizerEnabled</quote> é usada para ativar o equalizador com um valor booleano verdadeiro ou falso.</entry></row><row><entry>setVolume</entry><entry>A fun??o <quote>setVolume</quote> ajusta o volume para um nível indicado com um valor entre 0-100.</entry></row><row><entry>showOSD</entry><entry>A fun??o <quote>showOSD</quote> apresenta o OSD para mostrar informa??es da faixa atual.</entry></row><row><entry>stop</entry><entry>A fun??o <quote>stop</quote> irá parar o leitor se ele já estiver tocando.</entry></row><row><entry>togglePlaylist</entry><entry>A fun??o <quote>togglePlaylist</quote> ativa ou desativa a utiliza??o da janela da lista de músicas.</entry></row><row><entry>volumeDown</entry><entry>A fun??o <quote>volumeDown</quote> abaixa o volume uma posi??o.</entry></row><row><entry>volumeUp</entry><entry>A fun??o <quote>volumeUp</quote> sobe o volume uma posi??o.</entry></row></tbody></tgroup></informaltable></sect1><sect1 id="cmd-line-options"><title>Op??es da Linha de Comando</title><para>O amaroK suporta a utiliza??o das op??es padr?o da linha de comando para o Qt e o &kde;. O amaroK tem também as suas op??es específicas do aplicativo.</para><para>As op??es do Qt e do kde:</para><informaltable><tgroup cols="2"><thead><row><entry>Op??o</entry><entry>A??o</entry></row></thead><tbody><row><entry>--help</entry><entry>Mostra a ajuda sobre as op??es.</entry></row><row><entry>--help-qt</entry><entry>Mostra as op??es específicas do Qt.</entry></row><row><entry>--help-kde</entry><entry>Mostra op??es específicas do KDE.</entry></row><row><entry>--help-all</entry><entry>Mostra todas as op??es.</entry></row><row><entry>--author</entry><entry>Mostra informa??es sobre o autor.</entry></row><row><entry>-v, --version</entry><entry>Mostra a vers?o.</entry></row><row><entry>--license</entry><entry>Mostra informa??es sobre a licen?a.</entry></row></tbody></tgroup></informaltable><para>As op??es do amaroK:</para><note><para>As op??es do &amarok; foram concebidas para serem utilizadas enquanto o &amarok; está rodando.</para></note><informaltable><tgroup cols="2"><thead><row><entry>Op??o</entry><entry>A??o</entry></row></thead><tbody><row><entry>-r, --previous</entry><entry>Passa à faixa anterior na lista de reprodu??o.</entry></row><row><entry>-p, --play</entry><entry>Inicia a reprodu??o da lista de músicas atual.</entry></row><row><entry>-s, --stop</entry><entry>Para a reprodu??o.</entry></row><row><entry>--pause</entry><entry>Pausa a reprodu??o.</entry></row><row><entry>-f, --next</entry><entry>Passa para a próxima faixa na lista de reprodu??o.</entry></row><row><entry>-a, --append</entry><entry>Adiciona arquivos/URLs à lista de reprodu??o.</entry></row><row><entry>-e, --enqueue</entry><entry>Veja 'append', disponível por raz?es de compatibilidade.</entry></row><row><entry>--queue</entry><entry>Coloca arquivos/URLs na lista após a faixa atual.</entry></row> <row><entry>-m, --toggle-playlist-window</entry><entry>Ativa ou desativa a janela da lista de músicas.</entry></row><row><entry>--wizard</entry><entry>Lan?a o assistente da Primeira Execu??o.</entry></row><row><entry>--engine "nome"</entry><entry>Inicia o &amarok; como o motor "name".</entry></row></tbody></tgroup></informaltable></sect1></chapter>