From 0b8ca6637be94f7814cafa7d01ad4699672ff336 Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Tue, 21 Jan 2014 22:06:48 -0600 Subject: Beautify docbook files --- .../docs/tdemultimedia/artsbuilder/tools.docbook | 839 +++++---------------- 1 file changed, 169 insertions(+), 670 deletions(-) (limited to 'tde-i18n-sv/docs/tdemultimedia/artsbuilder/tools.docbook') diff --git a/tde-i18n-sv/docs/tdemultimedia/artsbuilder/tools.docbook b/tde-i18n-sv/docs/tdemultimedia/artsbuilder/tools.docbook index 9ce4c2ed33c..5bc9baa3caa 100644 --- a/tde-i18n-sv/docs/tdemultimedia/artsbuilder/tools.docbook +++ b/tde-i18n-sv/docs/tdemultimedia/artsbuilder/tools.docbook @@ -6,533 +6,245 @@ To validate or process this file as a standalone document, uncomment this prolog. Be sure to comment it out again when you are done --> -&arts;-verktyg +&arts;-verktyg -Ett antal verktyg levereras tillsammans med &arts; för att styra och anpassa dess beteende. Du behöver känna till de flesta av de här verktygen lite grand för att kunna använda &arts; på ett effektivt sätt. Det här avsnittet beskriver vart och en av verktygen och deras kommandoväljare. +Ett antal verktyg levereras tillsammans med &arts; för att styra och anpassa dess beteende. Du behöver känna till de flesta av de här verktygen lite grand för att kunna använda &arts; på ett effektivt sätt. Det här avsnittet beskriver vart och en av verktygen och deras kommandoväljare. -Inställningscentralen - -När man kör &arts; med &kde;, tillhandahåller inställningscentralen en grupp med inställningar i kategorin Ljud. Vissa av de här används av &arts;. Man kan också binda ljud till olika fönsterhanterings- och &kde;-händelser med dialogrutan LjudSystemunderrättelser. Se handboken för inställningscentralen för mer information om hur dialogrutans inställningar används. +Inställningscentralen + +När man kör &arts; med &kde;, tillhandahåller inställningscentralen en grupp med inställningar i kategorin Ljud. Vissa av de här används av &arts;. Man kan också binda ljud till olika fönsterhanterings- och &kde;-händelser med dialogrutan LjudSystemunderrättelser. Se handboken för inställningscentralen för mer information om hur dialogrutans inställningar används. -&artsd; +&artsd; -Tillgången till ljudhårdvaran kontrolleras av &artsd;, ljudservern för &arts;. Det här tillåter att flera program samtidigt skickar en begäran till servern, där de kan blandas och spelas upp. Utan en central ljudserver skulle ett enstaka program som använder en ljudenhet förhindra andra program från att använda den. +Tillgången till ljudhårdvaran kontrolleras av &artsd;, ljudservern för &arts;. Det här tillåter att flera program samtidigt skickar en begäran till servern, där de kan blandas och spelas upp. Utan en central ljudserver skulle ett enstaka program som använder en ljudenhet förhindra andra program från att använda den. -För att använda &arts; ska det finnas en och endast en kopia av &artsd; som kör. Den startas typiskt när &kde; startas om detta är aktiverat i inställningscentralens Ljudserver modul. +För att använda &arts; ska det finnas en och endast en kopia av &artsd; som kör. Den startas typiskt när &kde; startas om detta är aktiverat i inställningscentralens Ljudserver modul. -Programmet accepterar följande väljare: +Programmet accepterar följande väljare: -artsd - - - - -Ställ in samplingsfrekvens som ska användas. - - - - - - -Visa kommandoanvändning. - - - - - - -Aktivera nätverkstransparens. - - - - - +artsd + + + + +Ställ in samplingsfrekvens som ska användas. + + + + + + +Visa kommandoanvändning. + + + + + + +Aktivera nätverkstransparens. + + + + + -Ange TCP-port som ska användas (förutsätter ). +Ange TCP-port som ska användas (förutsätter ). - + -Öppen, ingen identifiering (farligt). +Öppen, ingen identifiering (farligt). - + -Aktivera full duplex. +Aktivera full duplex. - + -Ange ljudenhet (vanligtvis /dev/dsp). +Ange ljudenhet (vanligtvis /dev/dsp). - + -Ange antal fragment. +Ange antal fragment. - + -Ange fragmentstorlek i byte. +Ange fragmentstorlek i byte. - + -Ställ in fördröjningen innan vänteläget aktiveras i sekunder. Värdet noll stänger av vänteläget. +Ställ in fördröjningen innan vänteläget aktiveras i sekunder. Värdet noll stänger av vänteläget. - + -Ange namnet på ett program som används för att visa fel, varningar och informationsmeddelanden. Om du kör KDE kan du använda verktyget artsmessage för det här. +Ange namnet på ett program som används för att visa fel, varningar och informationsmeddelanden. Om du kör KDE kan du använda verktyget artsmessage för det här. - + -Öka storleken av nätverksbuffrarna till ett värde som är lämpligt för att köra med ett 10 Mbps lokalt nätverk. Det här är samma som att använda väljaren -w 5 (se nedan). +Öka storleken av nätverksbuffrarna till ett värde som är lämpligt för att köra med ett 10 Mbps lokalt nätverk. Det här är samma som att använda väljaren -w 5 (se nedan). - + -När artsd körs via en nätverksanslutning till en annan värddator vill man ofta använda en stor buffer för att undvika pauser. aRts föreslår en minimal bufferstorlek för program. Utan det här alternativet baseras den förvalda storleken på fragmentstorleken * antalet fragment. Med det här alternativet kan man öka storleken från den förvalda med en faktor n. +När artsd körs via en nätverksanslutning till en annan värddator vill man ofta använda en stor buffer för att undvika pauser. aRts föreslår en minimal bufferstorlek för program. Utan det här alternativet baseras den förvalda storleken på fragmentstorleken * antalet fragment. Med det här alternativet kan man öka storleken från den förvalda med en faktor n. - + -Ställ in informationsnivå: 3 (tyst), 2 (varningar), 1 (info), 0 (avlusning). +Ställ in informationsnivå: 3 (tyst), 2 (varningar), 1 (info), 0 (avlusning). - + -Visa versionsnivå. +Visa versionsnivå. -I de flesta fall är det nog att bara köra &artsd;. +I de flesta fall är det nog att bara köra &artsd;. -&artswrapper; - -För att ge bra realtidsegenskaper körs &artsd; oftast som en realtidsprocess (på plattformar där realtidsprioriteter stöds). Det här kräver root-behörighet, så för att minimera säkerhetspåverkan, kan &artsd; startas med det lilla omgärdande programmet &artswrapper; som helt enkelt byter till realtidsprioritet (medan det kör som root) och sedan startar &artsd; som en annan användare än root. - -Om du gör &artswrapper; SUID root, kommer det troligen förbättra kvaliteten på ljudåtergivningen genom att reducera uppehåll i musiken. Dock ökar det också risken att ett fel i koden, eller en användare med uppsåt att skada kan krascha eller skada datorn på något sätt. Dessutom, att prioritera hög ljudkvalitet på fleranvändardatorer kan orsaka försämrad prestanda för användare som försöker använda datorn på ett produktivt sätt. +&artswrapper; + +För att ge bra realtidsegenskaper körs &artsd; oftast som en realtidsprocess (på plattformar där realtidsprioriteter stöds). Det här kräver root-behörighet, så för att minimera säkerhetspåverkan, kan &artsd; startas med det lilla omgärdande programmet &artswrapper; som helt enkelt byter till realtidsprioritet (medan det kör som root) och sedan startar &artsd; som en annan användare än root. + +Om du gör &artswrapper; SUID root, kommer det troligen förbättra kvaliteten på ljudåtergivningen genom att reducera uppehåll i musiken. Dock ökar det också risken att ett fel i koden, eller en användare med uppsåt att skada kan krascha eller skada datorn på något sätt. Dessutom, att prioritera hög ljudkvalitet på fleranvändardatorer kan orsaka försämrad prestanda för användare som försöker använda datorn på ett produktivt sätt. -&artsshell; +&artsshell; -Kommandot &artsshell; är avsett som ett verktyg för att utföra diverse funktioner som hör ihop med ljudservern. Förmodligen kommer verktyget att utökas med nya kommandon i framtiden (se kommentarerna i källkoden för några idéer). +Kommandot &artsshell; är avsett som ett verktyg för att utföra diverse funktioner som hör ihop med ljudservern. Förmodligen kommer verktyget att utökas med nya kommandon i framtiden (se kommentarerna i källkoden för några idéer). -Kommandot accepterar följande format: +Kommandot accepterar följande format: -artsshell suspendstatus terminate autosuspend secs networkbuffers n volume [volume] stereoeffect options - -artsshell [väljare] kommando [kommandoalternativ] - -Följande väljare stöds: +artsshell suspendstatus terminate autosuspend secs networkbuffers n volume [volume] stereoeffect options + +artsshell [väljare] kommando [kommandoalternativ] + +Följande väljare stöds: - + -Undertryck all utmatning. +Undertryck all utmatning. - + -Visa kommandoanvändning. +Visa kommandoanvändning. -Följande kommandon stöds: +Följande kommandon stöds: - + -Ange att ljudservern ska gå till vänteläget. +Ange att ljudservern ska gå till vänteläget. - + -Visa statusinformation för ljudservern. +Visa statusinformation för ljudservern. - + -Avsluta ljudservern. Det här kan förvirra och/eller krascha alla program som för närvarande använder den. +Avsluta ljudservern. Det här kan förvirra och/eller krascha alla program som för närvarande använder den. - secs + secs -Ställ in fördröjningen för aktivering av vänteläget till det angivna antalet sekunder. Ljudservern går till vänteläget om den är inaktiv så länge. Värdet noll stänger av vänteläget. +Ställ in fördröjningen för aktivering av vänteläget till det angivna antalet sekunder. Ljudservern går till vänteläget om den är inaktiv så länge. Värdet noll stänger av vänteläget. - n + n -Ställer in storleken på nätverksbuffrarna till en faktor n gånger den förvalda storleken. +Ställer in storleken på nätverksbuffrarna till en faktor n gånger den förvalda storleken. - [volume] + [volume] -Ställer in volymskalning för ljudserverns utmatning av ljud. Parametern volume är ett flyttal. Utan parameter visas nuvarande volym. +Ställer in volymskalning för ljudserverns utmatning av ljud. Parametern volume är ett flyttal. Utan parameter visas nuvarande volym. - + -Visa alla tillgängliga stereoeffektmodulerna. +Visa alla tillgängliga stereoeffektmodulerna. - namn + namn -Infoga en stereoeffekt i stereoeffektstacken. Returnerar en identifierare som senare kan användas för att ta bort den. Effekten kan installeras längst upp eller längs ner (normalvärdet). +Infoga en stereoeffekt i stereoeffektstacken. Returnerar en identifierare som senare kan användas för att ta bort den. Effekten kan installeras längst upp eller längs ner (normalvärdet). - id + id -Tar bort stereoeffekten med identifieraren id från effektstacken. +Tar bort stereoeffekten med identifieraren id från effektstacken. @@ -541,208 +253,105 @@ this prolog. Be sure to comment it out again when you are done --> -<application ->artsplay</application -> - -Programmet artsplay är ett enkelt verktyg för att spela en ljudfil. Det accepterar en enda parameter som motsvarar namnet på ljudfilen som skickas till ljudservern för att spelas. Ljudfilen kan vara vilken vanlig ljudfiltyp som helst, såsom wav eller au. Det här verktyget är bra för att prova om ljudservern fungerar. Genom att köra två kommandon parallellt eller i snabb följd kan man demonstrera hur ljudservern blandar mer än en ljudkälla. +<application>artsplay</application> + +Programmet artsplay är ett enkelt verktyg för att spela en ljudfil. Det accepterar en enda parameter som motsvarar namnet på ljudfilen som skickas till ljudservern för att spelas. Ljudfilen kan vara vilken vanlig ljudfiltyp som helst, såsom wav eller au. Det här verktyget är bra för att prova om ljudservern fungerar. Genom att köra två kommandon parallellt eller i snabb följd kan man demonstrera hur ljudservern blandar mer än en ljudkälla. -<application ->artsdsp</application -> +<application>artsdsp</application> -Ljudservern hanterar bara program som stöder &arts;. Många gamla program vill komma åt ljudenheten direkt. Kommandot &artsdsp; tillhandahåller en interimlösning som låter de flesta av dessa program köra oförändrade. +Ljudservern hanterar bara program som stöder &arts;. Många gamla program vill komma åt ljudenheten direkt. Kommandot &artsdsp; tillhandahåller en interimlösning som låter de flesta av dessa program köra oförändrade. -När ett program körs med &artsdsp; fångas alla försök att komma åt ljudenheten /dev/dsp och omvandlas till anrop till &arts; programmeringsgränssnitt. Även om enhetsemuleringen inte är perfekt, så fungerar de flesta program på det här sättet, fastän med en viss försämring i prestanda och latenstid. +När ett program körs med &artsdsp; fångas alla försök att komma åt ljudenheten /dev/dsp och omvandlas till anrop till &arts; programmeringsgränssnitt. Även om enhetsemuleringen inte är perfekt, så fungerar de flesta program på det här sättet, fastän med en viss försämring i prestanda och latenstid. -Kommandot &artsdsp; följer formatet: +Kommandot &artsdsp; följer formatet: -artsdsp [väljare] program väljare +artsdsp [väljare] program väljare -Följande väljare känns igen: +Följande väljare känns igen: -, +, -Visa kortfattad hjälp. +Visa kortfattad hjälp. - = namn + = namn -Använd namn för att identifiera en spelare för artsd. +Använd namn för att identifiera en spelare för artsd. - + -Emulera minnesmappning (t.ex för Quake). +Emulera minnesmappning (t.ex för Quake). - + -Visa väljare. +Visa väljare. -Ett typiskt anrop är: +Ett typiskt anrop är: -artsdsp realplay song.mp3 +artsdsp realplay song.mp3 -Vissa program fungerar bättre med väljaren . Ljudenhetens alla funktioner är inte fullständigt emulerade, men de flesta program bör fungera. Om du hittar ett som inte gör det, skicka in en detaljerad felrapport så kan utvecklarna fixa det. Återigen, kom ihåg att det här är en intermediär lösning och något av en ful snabbfix. Den bästa lösningen är att lägga till inbyggt stöd för &arts; i programmen. Om ditt favoritljudprogram inte har stöd för &arts;, be utvecklaren att tillhandahålla det. +Vissa program fungerar bättre med väljaren . Ljudenhetens alla funktioner är inte fullständigt emulerade, men de flesta program bör fungera. Om du hittar ett som inte gör det, skicka in en detaljerad felrapport så kan utvecklarna fixa det. Återigen, kom ihåg att det här är en intermediär lösning och något av en ful snabbfix. Den bästa lösningen är att lägga till inbyggt stöd för &arts; i programmen. Om ditt favoritljudprogram inte har stöd för &arts;, be utvecklaren att tillhandahålla det. -<application ->artscat</application -> +<application>artscat</application> -Det här är ett enkelt verktyg för att skicka råljuddata till ljudservern. Man måste ange dataformatet (samplingsfrekvens, samplingsstorlek och antal kanaler). Det här är troligen inte ett verktyg som man behöver använda ofta, men det kan vara bekvämt för provändamål. Kommandosyntaxen är: +Det här är ett enkelt verktyg för att skicka råljuddata till ljudservern. Man måste ange dataformatet (samplingsfrekvens, samplingsstorlek och antal kanaler). Det här är troligen inte ett verktyg som man behöver använda ofta, men det kan vara bekvämt för provändamål. Kommandosyntaxen är: -artscat [ väljare ] [ filnamn ] +artscat [ väljare ] [ filnamn ] -Om inget filnamn anges läser programmet från standardinmatningen. Följande väljare stöds: +Om inget filnamn anges läser programmet från standardinmatningen. Följande väljare stöds: - samplingsfrekvens + samplingsfrekvens -Ställ in samplingsfrekvens som används. +Ställ in samplingsfrekvens som används. - bitar + bitar -Ställ in samplingsstorlek som används (8 eller 16). +Ställ in samplingsstorlek som används (8 eller 16). - kanaler + kanaler -Välj antal kanaler (1 eller 2). +Välj antal kanaler (1 eller 2). - + -Visa kommandoanvändning och avsluta. +Visa kommandoanvändning och avsluta. @@ -750,79 +359,51 @@ this prolog. Be sure to comment it out again when you are done --> -&artscontrol; +&artscontrol; -Det här är ett grafiskt verktyg för att utföra ett antal uppgifter som hör ihop med ljudservern. Det förvalda fönstret visar två volymnivåvisare och ett skjutreglage för att ställa in den generella uppspelningsvolymen. Från menyn Visa kan du välja andra funktioner: +Det här är ett grafiskt verktyg för att utföra ett antal uppgifter som hör ihop med ljudservern. Det förvalda fönstret visar två volymnivåvisare och ett skjutreglage för att ställa in den generella uppspelningsvolymen. Från menyn Visa kan du välja andra funktioner: -FFT-mätare +FFT-mätare -Öppnar ett fönster som visar en skärm med en realtidsspektrumanalysator. +Öppnar ett fönster som visar en skärm med en realtidsspektrumanalysator. -Ljudhanterare +Ljudhanterare -Visar aktiva ljudkällor och låter dig ansluta dem till alla tillgängliga bussar. +Visar aktiva ljudkällor och låter dig ansluta dem till alla tillgängliga bussar. -aRts status +aRts status -Visar om ljudservern kör och om realtidsschemaläggning används. Anger när servern kommer att gå till vänteläget och låter dig gå till vänteläget omedelbart. +Visar om ljudservern kör och om realtidsschemaläggning används. Anger när servern kommer att gå till vänteläget och låter dig gå till vänteläget omedelbart. -Midihanterare +Midihanterare -Visar aktiva &MIDI; in- och utgångar och låter dig göra förbindelser [ATT GÖRA: fungerar det här ännu? Behöver mera detaljer]. +Visar aktiva &MIDI; in- och utgångar och låter dig göra förbindelser [ATT GÖRA: fungerar det här ännu? Behöver mera detaljer]. -FreeVerb +FreeVerb -Ansluter en FreeVerb efterklangseffekt till stacken av &arts; utmatningseffekter och låter dig kontrollera ljudeffektinställningarna grafiskt. +Ansluter en FreeVerb efterklangseffekt till stacken av &arts; utmatningseffekter och låter dig kontrollera ljudeffektinställningarna grafiskt. -Leds liknande volymvisning +Leds liknande volymvisning -Ändrar volymindikeringen i huvudfönstret att använda ett visningsformat med färgade lysdioder istället för staplar. +Ändrar volymindikeringen i huvudfönstret att använda ett visningsformat med färgade lysdioder istället för staplar. @@ -831,166 +412,84 @@ this prolog. Be sure to comment it out again when you are done --> -<application ->artsc-config</application -> +<application>artsc-config</application> -Det här verktyget är till för att hjälpa utvecklare som använder C-programmeringsgränssnittet i &arts;. Det matar ut de riktiga kompilator- och länkarväljare som behövs när man kompilerar och länkar med &arts;. Det är tänkt att användas i make-filer för att hjälpa till med flyttbarhet. Kommandot accepterar tre väljare: +Det här verktyget är till för att hjälpa utvecklare som använder C-programmeringsgränssnittet i &arts;. Det matar ut de riktiga kompilator- och länkarväljare som behövs när man kompilerar och länkar med &arts;. Det är tänkt att användas i make-filer för att hjälpa till med flyttbarhet. Kommandot accepterar tre väljare: - + -Visar kompilatorväljare som behövs när man kompilerar med &arts; C-programmeringsgränssnitt. +Visar kompilatorväljare som behövs när man kompilerar med &arts; C-programmeringsgränssnitt. - + -Visar länkarväljare som behövs när man länkar med &arts; C-programmeringsgränssnitt. +Visar länkarväljare som behövs när man länkar med &arts; C-programmeringsgränssnitt. ----version +---version -Visar versionen av kommandot artsc-config. +Visar versionen av kommandot artsc-config. -Typisk utmatning från kommandot visas nedan: - -% artsc-config --I/usr/local/kde2/include/artsc -% artsc-config --L/usr/local/kde2/lib -ldl -lartsc -DPIC -fPIC -lpthread -% artsc-config -0.9.5 +Typisk utmatning från kommandot visas nedan: + +% artsc-config +-I/usr/local/kde2/include/artsc +% artsc-config +-L/usr/local/kde2/lib -ldl -lartsc -DPIC -fPIC -lpthread +% artsc-config +0.9.5 -Man ska kunna använda det här verktyget i en make-fil med en regel som: +Man ska kunna använda det här verktyget i en make-fil med en regel som: -artsc: artsc.c +artsc: artsc.c gcc `artsc-config --cflags` -o artsc artsc.c `artsc-config --libs` -&mcopidl; +&mcopidl; -Kommandot &mcopidl; är &IDL;-fil kompilatorn för &MCOP;, multimedia-kommunikationsprotokollet som används av &arts;. Gränssnitt i &arts; definieras med &IDL;, ett språkoberoende gränssnittsdefinitionsspråk. Verktyget &mcopidl; accepterar en &IDL;-fil som indata och skapar C++ deklarations- och källkodsfiler för en klass som implementerar gränssnittet. Kommandot accepterar följande syntax: +Kommandot &mcopidl; är &IDL;-fil kompilatorn för &MCOP;, multimedia-kommunikationsprotokollet som används av &arts;. Gränssnitt i &arts; definieras med &IDL;, ett språkoberoende gränssnittsdefinitionsspråk. Verktyget &mcopidl; accepterar en &IDL;-fil som indata och skapar C++ deklarations- och källkodsfiler för en klass som implementerar gränssnittet. Kommandot accepterar följande syntax: -mcopidl [ väljare ] filnamn +mcopidl [ väljare ] filnamn -Giltiga väljare är: +Giltiga väljare är: - katalog + katalog -Sök i katalog efter deklarationsfiler. +Sök i katalog efter deklarationsfiler. - namn + namn -Hoppa över en struct, gränssnitt eller uppräkningstyp namn vid kodgenerering. +Hoppa över en struct, gränssnitt eller uppräkningstyp namn vid kodgenerering. - + -Skapa också .mcoptype/.mcopclass filer som innehåller typinformation för &IDL;-filen. +Skapa också .mcoptype/.mcopclass filer som innehåller typinformation för &IDL;-filen. -Mer information om &MCOP; och &IDL; finns i avsnittet Gränssnitt och &IDL;. +Mer information om &MCOP; och &IDL; finns i avsnittet Gränssnitt och &IDL;. -- cgit v1.2.1