<chapter id="configuration">
<title
>Configurar o &kplayer;</title>

<para
>Como vários outros programas do &kde;, o &kplayer; é altamente configurável. Quando você <link linkend="howto-installation"
>instalar o &kplayer;</link
> e a sua infra-estrutura de reprodução multimédia que é o <link linkend="howto-installation-mplayer"
>&mplayer;</link
>, as opções predefinidas deverão permitir ao seu sistema ler conteúdos multimédia sem mais configurações adicionais. Este capítulo descreve as formas de tornar a interface de utilizador do &kplayer; mais adequada aos seus gostos e configurar a reprodução multimédia para uma qualidade e performance óptimas.</para>

<sect1 id="configuration-bars">
<title
>Barras de Ferramentas</title>

<para
>Quando o &kplayer; é instalado pela primeira vez, a sua janela contém uma <link linkend="parts-menu-bar"
>barra de menu</link
>, uma <link linkend="parts-toolbar-main"
>barra principal</link
>, uma <link linkend="parts-toolbar-playlist"
>barra da lista de reprodução</link
> e uma <link linkend="parts-status-bar"
>barra de estado</link
>. Para além disso, uma <link linkend="parts-toolbar-slider"
>barra de progresso</link
> irá aparecer normalmente quando você começar a ler um ficheiro.</para>

<para
>No menu <link linkend="menu-settings"
><guimenu
>Configuração</guimenu
> menu</link
>, irá encontrar as opções para esconder as barras de ferramentas que não necessita e para mostrar as <link linkend="parts-toolbar-slider"
>outras barras de ferramentas disponíveis</link
>. Algumas delas só estão disponíveis para os ficheiros de vídeo, enquanto a barra de progresso está disponível quando o &kplayer; conseguir detectar a duração total do ficheiro actual.</para>

<para
>O próprio menu poderá ser activado ou desactivado com a combinação de teclas <keycombo action="simul"
>&Ctrl;<keycap
>M</keycap
></keycombo
>. Poderá também esconder a barra de estado se não necessitar da informação que esta mostra ou mostrar o registo de mensagens que detalha a operação interna da infra-estrutura do &mplayer;, assim como os <acronym
>I/O</acronym
> Slaves do &kde;.</para>

<para
>Cada barra de ferramentas tem uma pequena área de um dos lados onde poderá carregar e manter pressionado o &LMB; para arrastar a barra de ferramentas para uma posição nova. Poderá colocar a maioria das barras de ferramentas horizontalmente na parte superior ou na inferior da janela do &kplayer; ou verticalmente à esquerda ou à direita da mesma, enquanto a barra da lista de reprodução só poderá ser colocada na horizontal.</para>

<para
>Se carregar com o botão <mousebutton
>direito</mousebutton
> numa barra de ferramentas, irá obter um <link linkend="popup-toolbar"
>menu</link
> para a configurar. Poderá escolher a orientação da barra de ferramentas, a posição do texto e o tamanho dos ícones.</para>

<para
>O &kplayer; irá obviamente recordar todas as opções que escolher e as posições em que colocar as suas barras de ferramentas. Irá recordar as opções de visibilidade para o <link linkend="howto-full-screen"
>modo de ecrã completo</link
> e para o modo normal em separado.</para>

</sect1>

<sect1 id="configuration-playlist">
<title
>Lista de Reprodução</title>

<para
>A lista de reprodução do &kplayer; guarda os itens que foram reproduzidos e permite lê-los de novo, organizá-los e atribuir individualmente a eles <link linkend="howto-properties"
>propriedades</link
>. Para una lista completa dos comandos e opções, veja as secções sobre o <link linkend="menu-playlist"
>menu Lista de Reprodução</link
> e o <link linkend="popup-playlist"
>menu de contexto da Lista de Reprodução</link
> na Referências de Comandos, a <link linkend="settings-playlist"
>secção da Lista de Reprodução</link
> no capítulo da Janela de Configuração. O <link linkend="howto-playlist"
>micro-HOWTO da lista de reprodução</link
> dar-lhe-á detalhes sobre o suporte de listas de reprodução no &kplayer;. Segue-se uma descrição das opções que afectam o comportamento da lista de reprodução.</para>

<itemizedlist>

<listitem
><para
>A opção <guimenuitem
>Mostrar a Lista de Reprodução</guimenuitem
> está disponível no menu <link linkend="menu-playlist"
><guimenu
>Lista de Reprodução</guimenu
></link
> e no <link linkend="popup-main"
>menu de contexto geral</link
>. Ele mostra ou esconde a <link linkend="parts-toolbar-playlist"
>barra da lista de reprodução</link
> que contém a lista de reprodução propriamente dita numa lista, assim como os comandos <guimenuitem
>Anterior</guimenuitem
> e <guimenuitem
>Seguinte</guimenuitem
> e as opções <guimenuitem
>Ciclo</guimenuitem
> e <guimenuitem
>Baralhar</guimenuitem
>.</para
></listitem>

<listitem
><para
>A opção <guimenuitem
>Mostrar o Editor</guimenuitem
> está disponível no menu <link linkend="menu-playlist"
><guimenu
>Lista de Reprodução</guimenu
></link
> e no <link linkend="popup-main"
>menu de contexto geral</link
>. Ele mostra ou esconde o <link linkend="parts-playlist-editor"
>editor da lista de reprodução</link
> que poderá usar para subir ou descer os itens na lista, removê-los ou mudar as suas <link linkend="howto-properties"
>propriedades</link
>.</para
></listitem>

<listitem
><para
>A opção <guimenuitem
>Mostrar a Barra de Ferramentas</guimenuitem
> está disponível no menu <link linkend="menu-playlist"
><guimenu
>Lista de Reprodução</guimenu
></link
>. Ela mostra ou esconde a <link linkend="parts-toolbar-editor"
>barra de edição da lista de reprodução</link
> que contém comandos que funcionam sobre os itens no editor, assim como a opção para bloquear a lista principal.</para
></listitem>

<listitem
><para
>A opção <guimenuitem
>Ciclo</guimenuitem
> está disponível no menu <link linkend="menu-playlist"
><guimenu
>Lista de Reprodução</guimenu
></link
> e na <link linkend="toolbar-playlist"
>barra da lista de reprodução</link
>. Quando está activa, faz com que o &kplayer; comece a reproduzir os itens do início da lista quando acabar de reproduzir o último item da mesma.</para
></listitem>

<listitem
><para
>A opção <guimenuitem
>Baralhar</guimenuitem
> está disponível no menu <link linkend="menu-playlist"
><guimenu
>Lista de Reprodução</guimenu
></link
> e na <link linkend="toolbar-playlist"
>barra da lista de reprodução</link
>. Quando está activa, faz com que o &kplayer; reproduza os itens por uma ordem aleatória. Quando a opção <guimenuitem
>Ciclo</guimenuitem
> está também activa, os itens serão baralhados de novo de cada vez que o &kplayer; reinicia a reprodução desde o topo da lista. Para voltar a baralhar imediatamente, desactive a opção <guimenuitem
>Baralhar</guimenuitem
> e active-a de novo.</para
></listitem>

<listitem
><para
>A opção <guimenuitem
>Lista Temporária para os Itens Novos</guimenuitem
> está disponível no menu <link linkend="menu-playlist"
><guimenu
>Lista de Reprodução</guimenu
></link
>, no <link linkend="popup-main"
>menu de contexto da lista de reprodução</link
> e na <link linkend="toolbar-playlist"
>barra de ferramentas da edição da lista de reprodução</link
>. Quando está activa, ela bloqueia a lista de reprodução actual, de modo que ao carregar os itens novos com a opção <menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Abrir</guimenuitem
></menuchoice
> ou <menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Abrir um URL</guimenuitem
></menuchoice
>, ao arrastar e largar ficheiros na janela do &kplayer; ou ao iniciar o &kplayer; com argumentos de ficheiros, ela criará um lista de reprodução temporária, colocará os itens novos nela e iniciará a sua reprodução. Para começar a ler os itens da lista de reprodução principal de novo, escolha a opção <menuchoice
><guimenu
>Lista de Reprodução</guimenu
><guimenuitem
>Reproduzir da Lista</guimenuitem
></menuchoice
>.</para
></listitem>

<listitem
><para
>A opção <guimenuitem
>Reproduzir Apenas a Selecção</guimenuitem
> está disponível no menu <link linkend="menu-playlist"
><guimenu
>Lista de Reprodução</guimenu
></link
> e no <link linkend="popup-main"
>menu de contexto da lista de reprodução</link
>. Quando está activa, faz com que o &kplayer; leia apenas os itens seleccionados no <link linkend="parts-playlist-editor"
>editor da lista de reprodução</link
>.</para
></listitem>

<listitem
><para
>O comando <guimenuitem
>Limpar Antes de Adicionar Itens</guimenuitem
> está disponível no menu <link linkend="menu-playlist"
><guimenu
>Lista de Reprodução</guimenu
></link
>. Quando a opção está activa, todos os itens são removidos da lista actual antes de adicionar novos itens a ela. A lista actual poderá tanto ser a lista de reprodução principal como a temporária, quando a opção <guimenuitem
>Lista Temporária para os Novos Itens</guimenuitem
> está activa.</para
></listitem>

<listitem
><para
>As opções da lista de reprodução mais avançadas estão disponíveis na <link linkend="settings-playlist"
>secção da Lista de Reprodução</link
> da <guilabel
>Configuração do &kplayer;</guilabel
>.</para
></listitem>

</itemizedlist>

</sect1>

<sect1 id="configuration-shortcuts">
<title
>Atalhos</title>

<para
>Para alterar as combinações de teclas de atalho usadas pelo &kplayer;, seleccione a opção <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar os Atalhos...</guimenuitem
></menuchoice
>. Isto irá abrir uma janela como a que está apresentada em baixo.</para>

<mediaobject>
<imageobject>
<imagedata fileref="shortcuts-configure.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Janela de configuração de atalhos de teclado</phrase>
</textobject>
</mediaobject>

<para
>Se alterar as combinações de teclas, garanta que não duplica um atalho existente e que também não usa a tecla &Shift; para os seus atalhos novos, dado que a tecla &Shift; tem uma <link linkend="howto-properties"
>função especial</link
> no &kplayer;.</para>

<para
>Procure na lista para encontrar a acção da qual deseja adicionar ou alterar as teclas de atalho e seleccione-a, carregando com o botão <mousebutton
>esquerdo</mousebutton
> no seu nome. Poderá então alterar o atalho, seleccionando a opção <guilabel
>Nenhum</guilabel
>, <guilabel
>Predefinido</guilabel
> ou <guilabel
>Personalizado</guilabel
> ou carregando no botão grande na área do <guilabel
>Atalho para a Acção Seleccionada</guilabel
>. A janela para <guilabel
>Definir o Atalho</guilabel
> será então aberta.</para>

<mediaobject>
<imageobject>
<imagedata fileref="shortcuts-define.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Janela de Definição do Atalho</phrase>
</textobject>
</mediaobject>

<para
>Escolha se deseja alterar o atalho <guilabel
>Primário</guilabel
> ou o <guilabel
>Alternativo</guilabel
>, carregando depois na tecla ou combinação de teclas que deseja atribuir como atalho. Se a opção <guilabel
>Auto-Fechar</guilabel
> estiver assinalada, a janela desaparecerá logo que introduza a combinação de teclas, caso contrário irá permanecer até que carregue em <guibutton
>OK</guibutton
> ou <guibutton
>Cancelar</guibutton
>. Se carregar no pequeno ícone preto com uma cruz branca nela irá remover o atalho.</para>

<sect2 id="configuration-userdefmenus">
<title
>Menus definidos pelo utilizador</title>

<para
>Poderá também adicionar o seu próprio menu de contexto ao &kplayer;, para que ao carregar numa combinação de teclas faça aparecer o menu e ao carregar numa segunda tecla ou usando os cursores para <keysym
>Cima</keysym
> ou <keysym
>Baixo</keysym
> e carregando em <keycap
>Enter</keycap
>, seleccione um item dela.</para>

<para
>Para fazer isso, adicione um atalho <guilabel
>Personalizado</guilabel
> para cada uma das acções que queira que apareça no menu e, na janela para <guilabel
>Definir um Atalho</guilabel
>, assinale a opção <guilabel
>Multi-Tecla</guilabel
>, carregue na combinação de teclas que deseja que apareça no seu menu novo e então, separadamente, carregue na tecla que irá escolher esse item do menu.</para>

</sect2>

</sect1>

<sect1 id="configuration-dialog">
<title
>Outras configurações</title>

<para
>O &kde; é conhecido como o ambiente de trabalho gráfico mais flexível e configurável, e o &kplayer; não é excepção. Para além das opções de configuração descritas nas secções anteriores, existem muitas mais opções, sendo a maior parte delas acessíveis a partir da <link linkend="settings"
>janela de configuração do &kplayer;</link
>. Seleccione a opção <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
> Configurar o &kplayer;...</guimenuitem
></menuchoice
> para a abrir.</para>

<para
>A janela está dividida em várias secções. Algumas delas afectam o comportamento do &kplayer;, incluindo as opções <link linkend="settings-general"
>gerais</link
> e as opções que afectam a <link linkend="settings-playlist"
>lista de reprodução</link
> e o <link linkend="settings-messages"
>registo de mensagens</link
> especificamente. A <link linkend="settings-controls"
>secção de Controlos</link
> diz ao &kplayer; que alterações este deverá recordar a nível global e quais deverá guardar nas <link linkend="howto-properties"
>propriedades do ficheiro</link
> individuais, e as suas sub-secções permitem-lhe afinar os controlos individuais do &kplayer;, incluindo o <link linkend="settings-progress"
>progresso</link
>, o <link linkend="settings-volume"
>volume</link
>, o <link linkend="settings-contrast"
>contraste</link
>, o <link linkend="settings-brightness"
>brilho</link
>, a <link linkend="settings-hue"
>matiz</link
>, a <link linkend="settings-saturation"
>saturação</link
> e as <link linkend="settings-sliders"
>barras deslizantes</link
> de um modo geral. As outras secções afectam a opção que o &kplayer; usa para interagir com o <link linkend="howto-installation-mplayer"
>&mplayer;</link
> e controlam vários aspectos da reprodução multimédia, incluindo o <link linkend="settings-video"
>vídeo</link
>, o <link linkend="settings-audio"
>áudio</link
>, as <link linkend="settings-subtitles"
>legendas</link
> e as opções <link linkend="settings-advanced"
>avançadas</link
>.</para>

<para
>O <link linkend="settings"
>capítulo da janela de configuração</link
> dá-lhe os detalhes completos de cada secção e de todas as opções disponíveis. Também o <link linkend="howto-settings"
>micro-HOWTO de configuração avançada</link
> descreve algumas das opções mais avançadas com maior detalhe.</para>

<para
>Algumas opções adicionais que se aplicam à janela principal do &kplayer; estão disponíveis no <link linkend="popup-title-bar"
>menu de contexto da barra de título</link
> que poderá obter se carregar com o botão <mousebutton
>direito</mousebutton
> na <link linkend="parts-title-bar"
>barra de título</link
> ou com o botão <mousebutton
>esquerdo</mousebutton
> no pequeno botão do canto superior esquerdo da janela do &kplayer; ou carregando em <keycombo action="simul"
>&Alt;<keycap
>F3</keycap
></keycombo
>.</para>

</sect1>

<sect1 id="configuration-properties">
<title
>Propriedades do ficheiro</title>

<para
>O &kplayer; tem uma funcionalidade única que lhe permite escolher várias opções diferentes para cada ficheiro individual. Estas opções são chamadas de Propriedades do Ficheiro e são gravadas em conjunto com o <acronym
>URL</acronym
> de cada ficheiro ou localização na rede individual.</para>

<para
>Existem duas formas de definir uma propriedade de um ficheiro. A mais simples é manter a tecla &Shift; carregada enquanto altera uma opção como o tamanho do vídeo ou as proporções de dimensões, o volume, o contraste ou o brilho do vídeo, etc. O &kplayer; irá aplicar a alteração ao ficheiro carregado de momento e recordá-la-á na propriedade do ficheiro correspondente. Quando carregar outro ficheiro, deverá repor essa configuração no valor que estava definido antes da alteração (a menos que o outro ficheiro também tenha a mesma propriedade configurada). Quando carregar e ler esse ficheiro anterior de novo, o &kplayer; irá aplicar de novo a alteração que fez à configuração e mantê-la-á até que carregue outro ficheiro ou <acronym
>URL</acronym
>.</para>

<para
>A outra forma de definir uma propriedade do ficheiro é através da <link linkend="properties"
>janela de Propriedades do Ficheiro</link
>. As propriedades da janela estão organizadas de acordo com a sua função. As propriedades gerais como o <guilabel
>Nome</guilabel
>, o <guilabel
>Tamanho</guilabel
>, entre outras, incluindo as propriedades que controlam o tamanho do vídeo estão na secção <link linkend="properties-general"
>Geral</link
>. As outras secções contêm propriedades que afectam a interacção do &kplayer; com o <link linkend="howto-installation-mplayer"
>&mplayer;</link
> e controlam a reprodução multimédia, incluindo o <link linkend="properties-video"
>vídeo</link
>, o <link linkend="properties-audio"
>áudio</link
>, as <link linkend="properties-subtitles"
>legendas</link
> e as propriedades <link linkend="properties-advanced"
>avançadas</link
>.</para>

<para
>Seleccione a opção <menuchoice
><guimenu
>Ficheiro</guimenu
> <guimenuitem
>Propriedades...</guimenuitem
></menuchoice
> para abrir as propriedades do ficheiro ou <acronym
>URL</acronym
> actual. Poderá também carregar com o botão <mousebutton
>direito</mousebutton
> num item do <guilabel
>Editor da Lista de Reprodução</guilabel
> e seleccionar o comando <guimenuitem
>Propriedades...</guimenuitem
> para abrir a janela de <guilabel
>Propriedades do Ficheiro</guilabel
> para esse item.</para>

<para
>O <link linkend="properties"
>capítulo da janela de Propriedades do Ficheiro</link
> dá-lhe os detalhes completos sobre cada secção e todas as propriedades disponíveis. Também o <link linkend="howto-properties"
>micro-HOWTO de propriedades do ficheiro</link
> descreve esta funcionalidade com mais detalhes e dá alguns exemplos.</para>

</sect1>

</chapter>