<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&krec;">
  <!ENTITY package "kdemultimedia">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Danish "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
<title
>&krec;-håndbogen</title>

<authorgroup>
<author
><firstname
>Arnold</firstname
> <surname
>Krille</surname
> <affiliation
> <address
><email
>arnold@arnoldarts.de</email
></address>
</affiliation>
</author>
</authorgroup>

&erik.kjaer.pedersen.role; 

<copyright>
<year
>2002</year>
<holder
>Arnold Krille</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-08-20</date>
<releaseinfo
>0.01.00</releaseinfo>

<abstract>
<para
>&krec; er en grænseflade for &arts; til optagelse. Den kan bruges til at optage enkelte filer eller hele indspilningssessioner. Visse dynamiske effekter er implementerede, samt muligheden for samtidigt at afspille det som optages (hvis du ikke optager det du lytter til). </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>Krec</keyword>
<keyword
>aRts</keyword>
<keyword
>indspilning</keyword>
<keyword
>grænseflade</keyword>
</keywordset>

</bookinfo>
 
<chapter id="introduction">
<title
>Indledning</title>

<sect1 id="why-krec">
<title
>Hvorfor skrev jeg &krec;</title>

<para
>Efter at have arbejdet en del med &arts;, indså jeg at der ikke fandtes nogen grænseflade til at optage lyd, bortset fra kommandolinjeværktøjet <command
>artsrec</command
>. Jeg skulle optage et radiospil som nogen af mine venner ville at jeg skulle mikse, og jeg ville bruge &Linux; til indspilningen. Altså begyndte jeg at skrive &krec;. </para>
</sect1>

<sect1 id="what-krec-does">
<title
>Hvad &krec; gør</title>

<para
>&krec;'s funktion er meget enkel. Det forbinder til &arts;-serveren og optager det som sendes til den til en fil. </para>
<para
>For øjeblikket skriver den kun raw-filer, som er det samme som normale wav-filer men uden wav-hovedet (<application
>sox</application
> kan tilføje til det for dig). </para>
</sect1>

</chapter>

<chapter id="using-krec">
<title
>Brug af &krec;</title>

<para
>Dette kapitel beskriver hvordan &krec; bruges. Der er flere måder at bruge &krec;, så jeg lavede nogle afsnit med <quote
>Gør sådan her</quote
>, som beskriver de forskellige anvendelsesmuligheder. Læs blot den første paragraf i hvert afsnit, og bestem dig for hvad du behøver at læse. Eller læs altsammen, og lær dig alle de fantastiske muligheder i &krec;.</para>

<screenshot>
<screeninfo
>Her er et skærmaftryk af &krec;.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="krec-hicolor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Her er et skærmaftryk af &krec; lige efter den er startet.</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect1 id="simple-usage">
<title
>Optager en simpel fil</title>

<para
>Hvis du hører noget i radioen som du vil optage (og radioen er sluttet til lydkortet) er der en (relativt) hurtigt måde at optage. </para>

<orderedlist>
<listitem>
<para
>Først skal du vælge indspilningskilden for lydkortet. Du behøver din favoritmikser (&kmix;), hvor du vælger kilden du vil bruge til indspilningen. Du skal også indstille &arts;-serveren til fuld dupleks (lydkortet og driverne skal også også understøtte dette). Hvis du behøver at genstarte &arts;, skal du også genstarte &krec;. </para>
</listitem>
<listitem>
<para
>Derefter skal du åbne &arts;-kontrolværktøj, og lydhåndteringen. Den viser to nye linjer: &krec;::In og &krec;::Out, hvor den sidste bruges for afspilning og spil samtidig, og ikke er irrelevant her. Den første skal du give din opmærksomhed: Den skal tilsluttes til bussen <emphasis
>in_soundcard</emphasis
>. Hvis du ikke kan vælge den, er noget formodentlig fejlinstalleret (ingen fuld dupleks eller noget sådant).</para>
</listitem>
<listitem>
<para
>Hvis alting fungerede, skulle du nu se noget som bevæger sig inde i &krec; - lydmåleren som viser hvor stærk indspilningen er. For gode indspilninger uden klipning, skal den være gul eller orange, men ikke rød. Glideren til højre for lydmåleren indstiller lydstyrken.</para>
</listitem>
<listitem>
<para
>Nu har du brug for en fil at optage til. Brug <menuchoice
><guimenu
>Fil</guimenu
> <guimenuitem
>Ny fil</guimenuitem
></menuchoice
> eller værktøjslinjens ikon for at oprette den. Derefter skal du fortælle &krec; at den skal optage til denne fil. Det gøres med filens sammenhængsafhængige menu.</para>
</listitem>
<listitem>
<para
>Nu kan du begynde at optage. Brug den store røde knap i værktøjslinjen, <guimenu
>Spil</guimenu
> <guimenuitem
>Optag</guimenuitem
>, eller tryk helt enkelt på <keycap
>R</keycap
>. For at stoppe, bruges stopknappen, eller indgangen i <guimenu
>Spil</guimenu
>-menuen (eller tasten <keycap
>S</keycap
>).</para>
</listitem>
</orderedlist>

<para
>O.k., det går ikke lige så hurtigt som at trykke på optage-knappen på båndoptageren, men &krec; har nogle flere funktioner som ikke findes på en båndoptager, tro mig.</para>

<tip>
<para
>Du vil måske også optage andre ting. For at prøve kan du bruge uddata-signalet fra &noatun;. Ændr &krec;::In til <emphasis
>out_soundcard</emphasis
> (eller en anden bus, som du lader &noatun; spille til). Dette virker også selvom du ikke har aktiveret fuld dupleks i &arts;.</para>
</tip>
</sect1>

<sect1 id="advanced-usage">
<title
>Optagelse af flere filer</title>

<para
>I dette afsnit antages at du vil optage flere små eller større stykker i flere filer. Hvis du for eksempel vil optage scener i et radiostykke, eller noget lignende. (Det var grunden til at jeg skrev &krec;.) </para>

<para
>Jeg antager at du har arbejdet med &arts; tidligere, og ved en smule om emnet <quote
>lydindspilning</quote
>. Mikrofonen, eller hvad du endnu indspiller fra, skal være tilsluttet maskinen og du skal vide hvad der skal indstilles (foruden &krec;) for at få inddata-signalet optaget. </para>

<para
>Denne <quote
>gennemgang</quote
> bruger et radiostykke som eksempel. Vi skal afgøre om alle optagelser skal have forskellige navne, eller om visse eller alle optagelser skal have samme navn, og kun skal adskilles af et nummer. Det første tilfælde dækkes af instruktionerne i <xref linkend="simple-usage"/>, og husk at man kan lave flere filer på en gang og derefter vælge hvilken som optagre til. Det andet tilfælde beskrives her ... </para>

<orderedlist>
<listitem
><para
>Før vi starter, skal vi sørge for at alt er rigtigt indstillet, især om du virkelig optager det du vil. Du kan bekræfte at alt virker hvis lydmåleren i &krec; bevæger sig. Hvis man ikke indspiller fra <emphasis
>out_soundcard</emphasis
>, kan man vælge <guimenu
>Spil</guimenu
> <guimenuitem
>Spil samtidigt</guimenuitem
> for at høre det  indspillede signal via lydkortets udgang, hvilket er bedre, eftersom det høres om lyden er for stærk eller for svag.</para
></listitem>
<listitem
><para
>I tilfældet med flere filer som har samme navn, behøves en session. <guimenu
>Fil</guimenu
> <guimenuitem
>Ny session</guimenuitem
> giver en sådan. Vælg søgestien, og indtast et filnavn som udvides med nummer og filendelse for indspilningen.</para
></listitem>
<listitem
><para
>Man behøver stadigvæk filer at optage til, men nu laves de ved at vælge punktet <guimenuitem
>Ny fil</guimenuitem
> i den sammenhængsafhængige menu. Man kan oprette så mange filer som behøves.</para
></listitem>
<listitem
><para
>Resten er enkelt: Vælg filen du vil optage til og optag så...</para
></listitem>
</orderedlist>

<note
><para
>En session er ikke en ny MIME-type, ikke engang en fil. Det er kun et internt navn for at organisere nummerering. Du kan altså ikke åbne en session senere, og fortsætte med at optage til nye filer ... </para
></note>
</sect1>

<sect1 id="more-usage">
<title
>Flere tip og kommentarer om brugen</title>

<para
>Der er en del yderligere at sige, og nogle flere komponenter at forklare.</para>

<sect2 id="usage-play-through">
<title
>Brug afspilning samtidig</title>

<para
>For de som vil høre det som indspilles, er der det meget nyttige punkt <quote
>Afspil samtidigt</quote
>. Det er i menuen <guimenu
>Spil</guimenu
>. Jeg råder dig til at bruge det så meget som muligt, især hvis komprimering eller andre effekter også bruges. Se <xref linkend="internals"/> for detaljeinformation om tilslutningerne.</para>

<caution>
<para
>Undgå at oprette en løkke ved indspilning fra <emphasis
>out_soundcard</emphasis
> når <quote
>afspil samtidigt</quote
> aktiveres. En sådan løkke er for meget for den stakkels &arts;, og gør din maskine enormt meget langsommere! Du kan få brug for at dræbe &arts; ...</para>
</caution>

</sect2>

<sect2 id="using-compressor">
<title
>Brug komprimering</title>

<para
>Hvis du optager med en mikrofon, bemærker du måske at niveauet ind imellem næsten klippes, og sommetider er meget lavt, især ved indspilning af tale. For at kompensere for dette, kan du bruge komprimering. Den reducerer helt enkelt alle lyde som er over en vis tærskelværdi med faktoren som angives af ratio. Eftersom dette reducerer lydstyrken, er der et udgangspotentiometer til at ekspandere (eller reducere) lyden. Attack og release bruges for at styre tiden inden komprimeringen reagerer (tiden som går efter indgangen først overskrider tærskelværdien) og tiden som komprimeringen stadigvæk reagerer efter lyden er under tærskelværdien. </para>
<tip
><para
>Prøv det mens du taler i mikrofonen med <quote
>afspil samtidigt</quote
> aktiveret, så hører du forskellen.</para
></tip>
</sect2>

<sect2 id="usage-switching-file">
<title
>Skift mellem flere filer</title>

<para
>På samme måde som du kan åbne flere filer til indspilning, kan du skifte mellem dem. Dette kan ikke kun gøres efter indspilningen er stoppet, men mens den står på. Bemærk at visse inddata kan gå tabt når dette gøres. Hvor meget lydinformation det er, afhænger af størrelsen af lydbufferen som indstilles i kontrolcentret for &arts;. Det skal ikke være alt for meget, men hvis du spiller filerne direkte efter hinanden (for eksempel med <command
>artscat fil*.raw</command
>) kan du høre nogle små <quote
>hop</quote
>.</para>
</sect2>

</sect1>
 
<sect1 id="internals">
<title
>Interne funktioner</title>

<para
>Lad mig sige noget om lydforbindelsen i &krec;. </para>
<para
>Der er nogle ting som behøves for at indspille med &arts;: et indspilningsmodul (synth_AMAN_RECORD), en konvertering af lyd til datastrøm og en modtager af datastrømmen. De to første er indbyggede i &arts;, mens den sidste er en del af programmet. Men dette er kun det basale. Hvis du vil lytte til filerne, behøves noget som sender en datastrøm fra programmet, og en konvertering af lydstrømmen til lyd samt afspilning (synth_AMAN_PLAY) i serveren. </para>
<para
>Hvad med effekterne? Jeg puttede stereoeffekter ind mellem indspillingen med AMAN_RECORD og forvandlingen af lyd til datastrøm, hvor jeg placerede komprimeringen (synth_STEREO_COMPRESSOR) og lydstyrkekontrollen (StereoVolumeControl). </para>
<para
>Hvis du aktiverer <quote
>Afspil samtidigt</quote
>, så tilsluttes også effekterne til afspilningen med AMAN_PLAY. Alt dette sker altså inde i &arts;-serveren. </para>
</sect1>

</chapter>

<chapter id="commands">
<title
>Kommandoreference</title>

<sect1 id="krec-mainwindow">
<title
>Hovedvinduet i &krec;</title>

<sect2>
<title
><guimenu
>Fil</guimenu
>-menuen</title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Ny fil</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Opretter en ny enkelt fil til at optage til en fil.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Ny session</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Opretter en ny session for flere indspilninger.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Afslut</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Afslutter</action
> &krec;</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2>
<title
><guimenu
>Spil</guimenu
>-menuen</title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Spil</guimenu
> <guimenuitem
>Spil</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Spiller filen som blev valgt til afspilning.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Spil</guimenu
> <guimenuitem
>Optag</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Starter indspilningen til den valgte fil.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Spil</guimenu
> <guimenuitem
>Stop</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Stopper optagelsen.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Spil</guimenu
> <guimenuitem
>Afspil samtidig</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Tilslutter indgangen til udgangen, og gør at du kan høre det som indspilles.</action
> (&krec;::In og &krec;::Out i lydhåndteringen i &arts;-kontrollen).</para>
<caution
><para
>Brug aldrig dette under indspilning af det som høres (fra out_soundcard). Det giver feedback som &arts; ikke kan klare. (Det virker ikke fordi &arts; er hurtigere end feedback fra maskinen til mikrofonen.)</para
></caution>
</listitem>
</varlistentry>

</variablelist>
</para>
</sect2>

<sect2>
<title
><guimenu
>Opsætnings</guimenu
>menuen</title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Vis startskærm</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Vælger om startskærmen med hurtigvejledningen vises eller ej.</action
></para
></listitem>
</varlistentry>

</variablelist>
</para>
</sect2>

<sect2>
<title
><guimenu
>Hjælpe</guimenu
>menuen</title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="startupwindow">
<title
>Opstartskærmen</title>

<para
>Opstartskærmen ligner dialogen i Dagens vink. </para>
</sect1>

</chapter>

<chapter id="faq">
<title
>Spørgsmål og svar</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist"
> <qandaentry>
<question>
<para
>Jeg har indspillet nogle filer med &krec;, men jeg kan ikke afspille dem i min foretrukne afspiller?</para>
</question>
<answer>
<para
>&krec; optager kun til raw-filer (for øjeblikket), ikke rigtige wav-filer. For at konvertere kan du bruge sox. For eksempel:</para>
<example id="converting-with-sox">
<title
>Konverterer raw-filer til rigtige Wav-filer med sox</title>
<para
>For at konvertere en raw-fil som blev optaget med &krec;, bruges følgende kommandolinje i en terminal (&konsole;), under forudsætning af at <command
>sox</command
> er installeret. I eksemplet hedder filen test.raw, og skal konverteres til test.wav. Brug egne filnavne i stedet. </para>
<para
><screen
><prompt
>&percnt;</prompt
><command
>sox -r 44100 -c 2 -s -w test.raw 
test.wav</command
>
</screen
></para>
<para
>Flagene <option
>-r 44100 -c 2 -s -w</option
> fortæller <command
>sox</command
> at du indspillede med 44100 kHz samplingsrate, to kanaler (stereo), kodet med lineær kodning med fortegn og 16-bit ord. Du vil måske skulle bruge flere flag din indstilling: Kig på <command
>sox</command
>-manualside. </para>
</example>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">
<title
>Medvirkende og licens</title>

<para
>&krec; </para>
<para
>Program ophavsret 2002 Arnold Krille<email
>arnold@arnoldarts.de</email
> </para>


<para
>Dokumentation ophavsret 2002 Arnold Krille <email
>arnold@arnoldarts.de</email
> </para>

&erik.kjaer.pedersen.credit; 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installation</title>

<sect1 id="getting-krec">
<title
>Hvordan får man fat på &krec;</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Krav</title>

<para
>For at bruge &krec; med heldigt resultat, har du brug for &kde; 3.1. </para>

<para
>&krec; skulle være i kdemultimedia-pakken. Eftersom pakken kræver at &kde; og &arts; kører, skulle alting være i orden. </para>


</sect1>

<sect1 id="compilation">
<title
>Kompilering og installation</title>
&install.compile.documentation; </sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
End:
-->
