El manual del Kwave

# El manual del Kwave

Eschenbacher, Thomas `<thomas.eschenbacher@gmx.de>`

Traductor: Antoni Bella
revisió 24.12.0 (9 de novembre de 2024)

Dret de reproducció © 1998-2000 Martin Wilz

Dret de reproducció © 2020 Thomas Eschenbacher

Dret de reproducció © 2024 Mark Penner

Avís legal

El Kwave és un editor de so senzill construït amb els Frameworks del KDE.

Llistat de taules

4.1. Taula de traducció de la codificació de l'URL
A.1. Llista d'identificadors d'informació del fitxer

Llistat d'exemples

3.1. Contingut d'un fitxer ASCII amb una única ona sinusoidal

Capítol 1. Introducció
Introducció

# Capítol 1. Introducció

Aquest és el Kwave, un editor de so senzill construït amb els Frameworks del KDE. Les seves característiques inclouen:

- una interfície d'usuari que es pot canviar als modes SDI -finestres separades-, MDI -la mateixa finestra- o Tab -pestanyes-

- funcions senzilles de retallar, copiar i enganxar

- desfer/refer multinivell

- etiquetatge dels senyals

- funcionalitat d'enregistrament, inclòs el preenregistrament

- Reproducció mitjançant ALSA, PulseAudio, Qt i OSS

- Enregistrament mitjançant ALSA, PulseAudio, Qt i OSS

- importació/exportació d'MP3

- importació/exportació d'Ogg/Vorbis i Opus

- importació/exportació de FLAC

- algunes funcions d'anàlisi com Sonagram

- internament utilitza una precisió fixa de 24 bits per a les dades de mostra

- freqüències de mostreig lliurement seleccionables

- admet l'edició de fitxers amb múltiples canals

- reproducció de fitxers d'àudio multicanal (si cal, la sortida de l'àudio serà reduïda a mono o estèreo)

- extensible a través d'una interfície de connectors fàcil d'emprar

- importació/exportació d'altres formats d'àudio mitjançant audiofile

Si esteu interessat en què s'ha fet i en el que encara s'ha de fer, consulteu els fitxers `CHANGES` i `TODO` inclosos al paquet font. L'ajuda i crítiques constructives sempre són benvingudes.

## Recursos del Kwave

Per tant, si voleu posar-vos en contacte amb els desenvolupadors, necessiteu més ajuda per a utilitzar el Kwave, enviar pedaços, informes d'error o altres coses, els recursos següents poden ser d'interès per a vosaltres:

- Pàgina web del projecte

  Per a informació sobre llançaments nous d'actualització, vegeu la pàgina del Kwave a apps.kde.org. Per a altres informacions, doneu un cop d'ull a la pàgina web del Kwave.

- Repositori Git

  El repositori Git està allotjat a la instància del Gitlab de KDE aquí, i també hi ha un repositori mirall a SourceForge.

Historial de revisions del Kwave
Historial de revisions del Kwave

## Historial de revisions del Kwave

Aquest projecte el va iniciar en Martin Wilz a l'estiu de 1998 i ha estat desenvolupat i millorat per ell i per altres persones. El novembre de 1999, en Thomas Eschenbacher va començar a esmenar alguns petits errors aquí i allà, i es va submergir en el codi font del programa més i més. Fins avui, que ha ampliat, reescrit o revisat gairebé tots els components del programa i ha dedicat molt de temps a millorar-lo.

Des del Kwave versió 0.8.0, el registre de canvis ja no s'inclou en aquest manual. Per tant, si esteu interessat en una llista completa dels canvis, trobareu tot l'historial aquí: https://invent.kde.org/multimedia/kwave/-/blob/master/CHANGES o navegueu pel codi font emprant la interfície web del Git.

El Kwave versió 0.9.0 fou la primera versió allotjada als servidors del KDE (kdereview) i SourceForge, seguida per la versió 0.9.1, la primera versió per als Frameworks 5 del KDE.

Capítol 2. Conceptes bàsics sobre l'àudio digital
Conceptes bàsics sobre l'àudio digital

# Capítol 2. Conceptes bàsics sobre l'àudio digital

Aquest capítol hauria de donar una breu introducció sobre els conceptes bàsics del processament de l'àudio digital, sense entrar massa en detalls.

## El món analògic

En primer lloc, cal saber què és el món analògic, però els ordinadors treballen en forma digital. D'aquesta manera, hi ha diverses maneres de convertir àudio analògic a àudio digital i viceversa. Com que el pas de digital a analògic normalment és la reversió de la via des d'analògic a digital, només descriurem el camí des d'analògic a digital.

Convertir el so a bits

Abans de continuar, l'àudio analògic s'haurà de transformar en senyals electrònics per a trobar el seu camí cap a un ordinador. Una manera comuna de fer-ho és mitjançant un micròfon i un amplificador. Aquesta combinació emet sons (canvis en la pressió de l'aire) a l'entrada i una tensió a la sortida. L'amplitud més alta dels canvis de pressió es representarà mitjançant voltatges alts a la sortida de l'amplificador. Aquesta sortida també s'anomena «senyal». A més d'un micròfon, per descomptat, també podeu imaginar altres fonts d'àudio. I l'«amplificador» pot ser el que hi ha integrat a la targeta de so, on normalment no es pot veure.

Convertir a senyal electrònic

En aquesta etapa, el senyal elèctric té tres limitacions que cal tenir en compte:

1. L'amplitud (volum) es limita a algun nivell màxim. Això és conseqüència de l'electrònica (amplificadors), els quals només són capaços de manejar els voltatges dins d'algun interval específic. Això no serà un problema sempre que els sons no siguin massa forts. En aquest cas es retallarà el senyal, el qual vol dir que el senyal elèctric s'executarà contra els seus marges i el resultat quedarà alterat.

2. L'interval de freqüències també està limitat. A causa de les restriccions mecàniques dels micròfons i l'interval de freqüències limitat dels amplificadors, l'interval de freqüència d'un senyal és limitat. No hi ha marges durs en els quals el so desapareix abruptament, sinó que per sota i per sobre de certes freqüències l'amplitud del senyal comença a disminuir cada vegada més. L'existència d'una freqüència màxima es pot entendre fàcilment com una velocitat limitada del senyal elèctric quant a la pujada i caiguda. Emprant amplificadors i micròfons d'alta qualitat, els límits poden anar més enllà dels intervals en els quals l'oïda humana ja no pot escoltar els resultats i, per tant, no tenen gens d'interès. L'oïda humana normalment no és capaç de sentir el so per sobre dels 20 kHz.

3. El senyal conté soroll. El soroll és l'enemic més gran per algú que ha de manejar els senyals d'àudio. El soroll és un efecte analògic típic, «pertorba» el senyal d'àudio i és molest, sempre està present i no es pot evitar. Només es pot intentar utilitzar components d'alta qualitat que produeixin el mínim soroll possible, de manera que no es pugui escoltar. Normalment, el soroll té un cert volum, de manera que el so interessant hauria de ser molt més fort en comparació amb el soroll. Això s'anomena relació senyal/soroll (SNR), com més alt sigui, millor serà la qualitat del so. Els sons que tenen un volum més baix que el soroll no es poden escoltar.

Digitalització
Digitalització

## Digitalització

Quan volem emmagatzemar i reproduir àudio en un ordinador, primer hem de convertir el so analògic en dades digitals. Aquest procés s'anomena digitalització. Converteix un senyal electrònic en una seqüència de valors digitals.

Digitalització del senyal electrònic

La conversió es pot entendre com una mesura repetitiva del valor del senyal electrònic en un determinat moment, prenent així una mostra del senyal. El resultat es codificarà com a un valor digital.

El mostreig es podria fer en distàncies arbitràries o en intervals constants. L'últim mètode és molt més fàcil de manejar i, per tant, és el que s'utilitza normalment, amb una freqüència constant -l'anomenada freqüència de mostreig-. Les freqüències de mostreig habituals són de 8000, 11025, 22050 i 44100 mostres per segon. A la pràctica, les freqüències de mostreig també es donen com a freqüències, en Hz o kHz.

La freqüència de mostreig limita la freqüència més alta que un senyal digitalitzat pot representar. A causa del teorema de Shannon, la freqüència d'ús màxima és la meitat de la freqüència de mostreig, de manera que amb una freqüència de mostreig de 44,1 kHz no es poden mostrar senyals amb més de 22 kHz. Per a evitar una infracció d'aquesta regla de la meitat de la freqüència de mostreig, la vostra targeta de so ja té filtres integrats que filtren les freqüències que superen la meitat de la freqüència de mostreig emprada.

Senyal de mostratge

Codificar la mostra
Codificar la mostra

## Codificar la mostra

El resultat del procés de mostreig digital és una seqüència de mostres individuals. Una mostra és una representació digital del valor del senyal en un moment determinat.

El valor d'una mostra es pot interpretar i codificar de diverses maneres. La més senzilla és la codificació lineal. Això significa que el valor de cada mostra representa directament el valor del senyal analògic multiplicat per un factor constant. Això és fàcil d'implementar, però té el desavantatge que el soroll serà audible sobretot en amplituds baixes, on més molesta, i menys audible en amplituds altes, on és menys audible.

Una forma de reduir la influència del soroll és la codificació no lineal. Això significa que les amplituds baixes s'amplifiquen abans del processament. A mesura que s'amplifiquen les amplituds baixes, la seva distància del soroll augmenta i la qualitat millora. Els mètodes més comuns per a això són la codificació Llei A i Llei U -algunes corbes d'amplificació logarítmica estandarditzades, utilitzades en la telefonia digital (estàndard ITU G.711)-.

Codificació no lineal

Formats per a la mostra
Formats per a la mostra

## Formats per a la mostra

Les mostres es poden emmagatzemar en diferents formats i precisions. Els més comuns són formats enters (coma fixa), els quals emmagatzemen valors amb quantificació fixa. Segons on es defineixi la línia zero, s'ha de distingir entre formats enters sense signar (només valors positius, la «línia zero» és a la meitat de l'interval numèric) i signats (valors positius i negatius).

Format signat

Format sense signar

A mesura que la quantificació perd certa precisió, produeix soroll, l'anomenat soroll de quantificació. Aquest tipus de soroll té més efecte en les amplituds baixes, de manera que aquest mètode d'emmagatzematge de les mostres no és òptim, sinó que és molt senzill i molt ràpid de manejar (els ordinadors són ràpids calculant amb nombres de coma fixa).

La segona manera de codificar mostres és amb números de coma flotant. Amb nombres de coma flotant, el soroll es distribueix gairebé igual en tots els intervals de l'amplitud i té avantatges especialment en amplituds baixes. Tanmateix, aquest format és molt més lent quan s'utilitza per a processar (els ordinadors són molt més lents calculant amb valors de coma flotant en comparació amb els nombres de coma fixa).

### Nota

El Kwave utilitza internament un format enter signat amb precisió de 24 bits, emmagatzemat en enters de 32 bits. Això té el desavantatge d'un consum més gran de memòria quan es processen fitxers amb menys precisió (p. ex., 8 bits), però el processament dels nombres de 32 bits és molt ràpid i també deixa algunes reserves per a càlculs interns, ja que només s'utilitzen 24 bits.

Capítol 3. Usar el Kwave
Usar el Kwave

# Capítol 3. Usar el Kwave

Aquí teniu una petita captura de pantalla de la finestra principal del Kwave, perquè pugueu tenir una impressió sobre l'aspecte del Kwave...

## Mode de la interfície d'usuari

Segons les preferències personals o casos d'ús, podeu configurar com manejarà el Kwave els diversos fitxers oberts. Podreu canviar aquesta opció sobre la marxa mitjançant el menú Arranjament → Mostra els fitxers en....

Les tres opcions possibles són:

- Finestres separades (SDI): quan s'utilitza la interfície de document únic (SDI), cada fitxer es mostrarà en una finestra principal separada.

- La mateixa finestra (MDI): quan s'utilitza la interfície de múltiples documents (MDI), només hi haurà una finestra principal del Kwave, però dins d'aquesta tindreu una àrea que mostra les subfinestres, les quals es poden canviar de mida, moure, disposar en mosaic o en cascada, o minimitzar.

  Podeu seleccionar una finestra des del menú Finestra o aneu a través de les subfinestres amb Ctrl+Tab.

- Pestanyes: aquesta és una variant de la interfície MDI, on els fitxers es mostren en pestanyes separades. És possible que conegueu aquest mode d'alguns navegadors populars d'Internet.

  Podeu activar una pestanya mitjançant el menú Finestra o aneu a través de les pestanyes amb Ctrl+Tab.

Línia d'ordres
Línia d'ordres

## Línia d'ordres

### Llista de fitxers o ordres

Si inicieu el Kwave des de la línia d'ordres, podeu especificar una llista dels fitxers que s'han d'obrir. El primer fitxer especificat s'obrirà primer i després els altres. Cada fitxer s'obrirà en una finestra nova o subfinestra de la mateixa instància del Kwave. Si especifiqueu algun comodí, podreu obrir una gran quantitat de fitxers alhora.

Per exemple, l'ordre següent inicia un Kwave i obre tots els sons proporcionats pel tema de so XDG de freedesktop, cadascun d'ells en una finestra o subfinestra nova:

    % kwave /usr/share/sounds/freedesktop/stereo/*.ogg

També és possible passar ordres de text al Kwave, codificades com un URI[1] especial, això es descriu en una secció posterior.

### Tipus d'IGU

El paràmetre `--gui=`SDI`|`MDI`|`Pestanyes`` permet que el Kwave sigui iniciat en un dels tres modes d'IGU possibles: SDI, MDI o Pestanyes.

### Opcions del conjunt d'eines de les Qt

A més d'una llista de fitxers, podeu especificar una llista d'opcions del Qt toolkit com `-qwindowgeometry` per a especificar la mida i/o la posició de la primera finestra oberta del Kwave i/o `-display` per a iniciar el Kwave en una pantalla diferent.

Per exemple, l'ordre següent inicia una finestra del Kwave amb una amplada inicial de 600 píxels i una alçada de 400 píxels, amb la vora dreta ubicada a 30 píxels de la dreta i 0 píxels de la part superior de la pantalla.

    % kwave --disable-splashscreen -qwindowgeometry 600x400-30+0

### Opcions d'inici

Amb l'opció `--disable-splashscreen` podreu inhabilitar la pantalla de presentació que apareix en iniciar el Kwave. Això pot ser útil quan inicieu el Kwave des d'un script.

L'opció `--iconic` de la línia d'ordres permet que el Kwave sigui iniciat en el mode minimitzat (com una icona). Això pot ser útil quan vulgueu iniciar el Kwave sense interacció amb la interfície gràfica d'usuari, p. ex., quan s'executa des d'un script. Aquesta opció també inhabilita implícitament la pantalla de presentació!

En utilitzar l'opció `--logfile=`kwave.log`` de la línia d'ordres podreu registrar la seqüència d'accions d'una sessió del Kwave en un fitxer. Això és útil per a la depuració, es podria donar el cas que se us demani un fitxer de registre d'aquest tipus quan informeu d'un error.

[1] Identificador de recurs universal

Obrir i desar fitxers
Obrir i desar fitxers

## Obrir i desar fitxers

L'obertura de fitxers amb el Kwave funciona com a la majoria de les altres aplicacions, podeu

- especificar una llista de fitxers sobre la línia d'ordres quan s'inicia el Kwave,

- obrir una finestra buida del Kwave (per exemple, amb Fitxer → Nou... (Ctrl+W)) i posar-hi un fitxer fent arrossegar i deixar anar, o podeu

- obrir un fitxer mitjançant el menú amb Fitxer → Obre (Ctrl+O)

- o un dels últims fitxers oberts recentment que estan llistats sota Fitxer → Obre un de recent

- desar el fitxer actual amb Fitxer → Desa (Ctrl+S),

- desar-lo amb un altre nom amb Fitxer → Desa → Com a... (Maj+Ctrl+S)

- desar totes les àrees que estiguin separades per marcadors, cadascuna d'elles en un fitxer propi, amb Fitxer → Desa → Blocs...

- o només la selecció actual amb Fitxer → Desa → Selecció...

### Formats de fitxer admesos

El Kwave admet els formats de fitxer següents:

- El format de fitxer preferit del Kwave és (com es pot endevinar pel nom) el `.wav`. Aquest format és molt comú a altres «sistemes operatius» i també s'utilitza habitualment a l'entorn Plasma.

- El segon format que suporta el Kwave és «ASCII». També podeu exportar i importar. Tingueu en compte que l'emmagatzematge en aquest format pot produir fitxers molt grans! El format de fitxer es descriu a continuació.

- La importació de `.mp3` i `.mp2` està disponible a través de la libmad per a la descodificació d'MP3 en combinació amb la id3lib per a la descodificació de les etiquetes ID3 i el lame per a la codificació.

- Importació i exportació d'Ogg/Vorbis (`*.ogg`). Vegeu https://www.xiph.org per als detalls.

- Importació i exportació de FLAC (`*.flac`). Vegeu https://xiph.org/flac/ per als detalls.

- A més, podeu importar formats de fitxer com `*.8svx` (format de fitxer de so Amiga IFF / 8SVX), `*.au` (NeXT, àudio de Sun), `*.aiff` (format d'intercanvi d'àudio), `*.avr` (format de fitxer per a la recerca audiovisual), `*.caf` (nucli del format de so), `*.nist` (format de fitxer d'àudio de NIST SPHERE), `*.sf` (Berkeley, IRCAM, format de so Carl), `*.smp` (format per a la visió de la mostra), `*.snd` (NeXT, àudio de Sun), `*.voc` (veu de Creative) i altres a través del connector audiofile.

### Convertir des de i cap a .wav

La millor manera de treballar amb formats que no siguin els admesos pel Kwave és utilitzar un programa de conversió extern. Un bon conjunt d'eines per a això es troben al paquet SoX, també disposa d'una bona documentació.

Els plans per al futur, inclouen la implementació per a la importació i també filtres d'exportació per a més formats i potser un filtre que utilitzi un script adaptable a l'usuari amb una crida a un filtre extern, de manera que fins i tot els formats no admesos per `SoX` es puguin llegir o escriure.

### Format dels fitxers ASCII

El format ASCII és molt útil per a finalitats científiques i educatives. A causa del seu format senzill, podeu escriure els fitxers amb un editor de text o utilitzar la sortida d'alguna altra aplicació i convertir-lo en ASCII. Com que el format és realment senzill, no hauríeu de tenir gaires problemes per a escriure un convertidor i la majoria de les aplicacions científiques utilitzen algun tipus del seu propi format ASCII per a l'exportació.

El format d'un fitxer ASCII és força senzill i té les regles següents:

1. Al començament del fitxer ve un bloc de propietats, amb una propietat per línia.

2. Cada línia de propietat comença amb `##`.

3. Després de les propietats apareix una llista de mostres, amb una mostra per línia. Quan s'utilitzen múltiples canals, les mostres se separen amb comes.

4. Les línies poden finalitzar amb un retorn de carro i/o un caràcter de salt de línia (de manera que també s'admeten els fitxers DOS). Però en desar, els fitxers es desaran sempre amb el caràcter de salt de línia com a final de la línia.

5. Les línies buides i el que hi hagi després d'un caràcter `#` es tractaran com a comentaris i s'ignoraran.

6. Els valors s'han de donar en format enter signat amb un interval de 24 bits, el qual és el format d'emmagatzematge intern del Kwave.

7. Tot el que hi hagi després d'un `#` (excepte les línies de propietats, vegeu a dalt) es tractarà com a comentari i s'ignorarà. Les línies buides també seran ignorades.

Aquí teniu un exemple d'un fitxer ASCII senzill que representa una ona sinusoidal amb onze mostres:

Exemple 3.1. Contingut d'un fitxer ASCII amb una única ona sinusoidal

    ## 'rate'=44100
    ## 'tracks'=2
    ## 'bits'=16
    ## 'length'=11
    ## 'Date'='2013-11-09'
    ## 'Software'='Kwave-0.8.11 for KDE 4.11.3'
      5930496,   5930496 #            0
            0,   8388352 #            1
     -5930752,   5930496 #            2
     -8388608,         0 #            3
     -5930752,  -5930752 #            4
            0,  -8388608 #            5
      5930496,  -5930752 #            6
      8388352,         0 #            7
      5930496,   5930496 #            8
            0,   8388352 #            9
     -5930752,   5930496 #           10
    # EOF

Crear un fitxer nou
Crear un fitxer nou

## Crear un fitxer nou

Podeu crear un fitxer nou i buit sota Fitxer → Nou....

Podeu seleccionar la freqüència de mostreig, la resolució en bits per mostra i el nombre de pistes. Per omissió, el format del fitxer serà «.wav», però encara es podrà canviar en el moment de desar el fitxer.

La longitud del senyal nou es pot establir per temps (hores, minuts, segons) o pel nombre de mostres. A més, podeu seleccionar-lo relatiu a la longitud més alta possible, la qual està limitada per la memòria disponible i el límit intern del Kwave (2 GB).

Enregistrament
Enregistrament

## Enregistrament

El Kwave és capaç d'enregistrar dades d'àudio des de diverses fonts, amb totes les freqüències de mostreig, formats de la mostra i altres modes que admeti el maquinari de so. El Kwave pot enregistrar amb els dorsals d'ALSA, PulseAudio, Qt i OSS.

Es pot accedir a l'enregistrament des del menú sota Fitxer → Enregistra.

Aquí teniu una captura de pantalla del diàleg d'enregistrament del Kwave, mostrant la primera pàgina amb els controls de l'enregistrament durant una sessió d'enregistrament en execució. Com en la majoria de diàlegs del Kwave, podeu obtenir alguna ajuda o veure els consells d'eina sobre els controls.

Aquí teniu els controls següents:

- Preenregistrament: Si està habilitada la característica de preenregistrament del Kwave i s'inicia l'enregistrament, el Kwave enregistrarà en una memòria intermèdia interna alguns segons més. Si premeu el botó Enregistra ( ) una altra vegada, l'enregistrament començarà realment i també es mantindran les dades ja preenregistrades. Això és útil, per exemple, si voleu enregistrar la vostra cançó preferida de la ràdio, però reconeixeu massa tard que la cançó ha començat. En aquest cas, encara podeu prémer el botó d'enregistrar i obtenir el començament de la cançó que el Kwave ja haurà preenregistrat, de manera que ja no perdreu un començament.

- Temps a enregistrar: Si la durada de l'enregistrament s'ha de limitar a algun temps, podeu activar aquesta opció i seleccionar un temps en hores, minuts i segons per al vostre enregistrament. Si aquesta opció no està habilitada, l'enregistrament s'executarà fins que premeu el botó Atura ().

- Comença a: Si s'ha activat aquesta opció, podreu establir una data i hora de quan s'iniciarà l'enregistrament. Tingueu en compte que si el temps configurat es troba en el passat, l'enregistrament començarà immediatament.

- Detecta l'enregistrament: Si està habilitada, l'enregistrament només començarà si el volum de l'entrada supera un cert límit, el qual es pot definir de 0 al 100% del volum d'entrada més alt possible. Això és útil si no voleu enregistrar el silenci del començament. (Consell: combineu-ho amb la característica de preenregistrament mencionada anteriorment per a capturar també alguns segons abans d'arribar a la detecció, de manera que no us perdeu cap esvaïment silenciós).

- El botó Nou () estarà activat quan l'enregistrament no estigui en execució o hagi finalitzat, per a descartar el contingut del fitxer actual i tornar a començar.

- El botó Atura () estarà activat quan l'enregistrament o preenregistrament s'està executant o el Kwave resta a l'espera de la detecció. Si es prem, s'aturarà el progrés actual.

- El botó de Pausa () estarà activat quan l'enregistrament o preenregistrament s'està executant. La primera vegada que el premeu, l'enregistrament s'aturarà i el botó començarà a parpellejar. Quan el premeu de nou, el botó deixarà de parpellejar i l'enregistrament continuarà immediatament, sense esperar una detecció.

- El botó Enregistra () començarà l'enregistrament i/o preenregistrament, depenent de les característiques habilitades anteriorment:

  1. Si no s'utilitza cap nivell de detecció per al preenregistrament, l'enregistrament començarà tan bon punt es premi el botó enregistra.

  2. Si no s'utilitza el preenregistrament i s'estableix un nivell de detecció, la primera vegada que el premeu permetrà al Kwave esperar fins a arribar al nivell de detecció. Mentre s'espera una detecció, podeu forçar l'enregistrament perquè comenci immediatament després de prémer el botó d'enregistrament de nou, altrament, l'enregistrament s'iniciarà automàticament quan s'hagi assolit el nivell de detecció.

  3. Si el preenregistrament està habilitat, la primera acció de prémer només iniciarà el preenregistrament i la segona realment l'enregistrament.

Reproducció
Reproducció

## Reproducció

Segons les opcions de compilació, el Kwave pot reproduir sons mitjançant d'un dels mètodes de reproducció següents:

- ALSA (arquitectura avançada de so a Linux): Substitueix a OSS, admet més característiques i més maquinari. Podria interferir amb altres aplicacions de so com fa l'OSS, però té un connector anomenat «dmix» com a sortida. Les versions més noves d'ALSA utilitzen un dmix com a connector per omissió, de manera que aquesta hauria de ser la millor opció.

- PulseAudio: Servidor de so de propòsit general habitual al Linux. El PulseAudio podria no ser capaç d'una latència tan baixa com l'ALSA.

- Qt Multimèdia: No està dissenyat per a àudio de baixa latència, però funciona amb mides grans de memòria intermèdia.

- OSS (sistema de so obert): La implementació de Linux més antiga, capaç de sortides mono i estèreo. Obsolet des del nucli Linux 2.6. Pot interferir amb altres aplicacions de so, la reproducció amb OSS només pot utilitzar una aplicació a la vegada!

Abans d'intentar reproduir sons, haureu de donar un cop d'ull al diàleg de configuració de la reproducció:

Si el vostre fitxer de so utilitza més o menys canals que els permesos per la reproducció, durant la reproducció es barrejaran tots els canals. Per exemple, si teniu un fitxer amb tres canals i utilitzeu la reproducció estèreo, el canal esquerre reproduirà el canal 0 (superior) i la meitat del canal 1 (mig), el canal dret reproduirà la meitat del canal 1 (mig) i el canal 2 (inferior).

Per a obtenir una reproducció suau sense interrupcions, també hauríeu d'establir la mida de la memòria intermèdia a un valor adequat. Si teniu problemes amb interrupcions de la reproducció, augmenteu aquí la mida de la memòria intermèdia. Però com més gran sigui, més gran serà la latència entre el so audible i la visualització de la posició de reproducció a la presentació del senyal.

El diàleg de configuració de la reproducció també proporciona un botó per a reproduir un senzill so de prova. Escoltareu un to de 440 Hz que anirà per tots els altaveus, des d'un a l'altre.

Una vegada que hàgiu configurat la reproducció, podreu utilitzar els controls de la reproducció de la finestra principal del Kwave, a través del menú Reprodueix o amb les dreceres de teclat:

- Reprodueix → Inicia (P): Comença la reproducció de la selecció actual des del començament o tot el fitxer des de la posició actual del cursor si no s'ha seleccionat res. Només reprodueix una vegada.

- Reprodueix → Repeteix: Com abans, però repeteix en un bucle.

- Reprodueix → Pausa (Espai): Atura la reproducció a la posició actual. Només disponible quan s'està executant la reproducció.

- Reprodueix → Continua (Espai): Continua la reproducció des de la posició on s'ha fet la pausa. Només disponible si la reproducció està en pausa.

- Reprodueix → Atura (Esc): Atura la reproducció, torna al començament de la selecció.

Propietats del fitxer
Propietats del fitxer

## Propietats del fitxer

El Kwave és capaç de manejar diversa meta-informació que s'emmagatzemarà dins d'un fitxer d'àudio. Intenta importar i exportar tanta part d'aquesta informació com sigui possible. Per exemple, si importeu un fitxer MP3 amb etiquetes ID3, podeu mantenir aquesta informació quan s'exporta a un fitxer Wave. Si el Kwave veu que perdrà aquesta meta-informació durant el desament, mostrarà un avís.

Podeu visualitzar i modificar la meta-informació sota Edita → Propietats del fitxer.... També podeu canviar coses com ara el format, resolució i compressió de la mostra.

Zoom i navegar
Zoom i navegar

## Zoom i navegar

El Kwave proporciona diverses maneres de fer zoom i navegar, utilitzant les dreceres de teclat, ordres de menú, botons de la barra d'eines i fent servir el ratolí. Les seccions següents haurien de donar una visió general sobre com utilitzar totes aquestes funcions.

### Apropar i allunyar

- Apropa: apropa per a veure més detalls, augmenta en un factor de 3.

  - entrada del menú / drecera de teclat: Visualitza → Apropa (Ctrl++)

- Allunya: allunya per a veure menys detalls, es redueix en un factor de 3.

  - entrada del menú / drecera del teclat: Visualitza → Allunya (Ctrl+-)

- Zoom a la selecció: apropa ​​a un factor on la selecció actual és completament visible a la vista actual.

  - entrada del menú / drecera del teclat: Visualitza → Zoom a la selecció (Ctrl+Espai)

- Apropa a tot el senyal: selecciona un factor d'apropament el qual farà que tot el senyal sigui visible a la finestra actual.

  - entrada del menú: Visualitza → Apropa a tot el senyal

- Zoom al 100%: augmenta fins a una escala on la representació de la mostra està representada per un píxel a la pantalla.

  - entrada del menú: Visualitza → Zoom al 100%

- Selecciona un zoom predefinit: seleccioneu un factor d'apropament des del quadre combinat de zoom a la barra d'eines.

### Desplaçar cap a l'esquerra i a la dreta

- Ves a la posició... obre un diàleg per a introduir la posició on voleu desplaçar la vista actual.

  entrada del menú / drecera de teclat: Visualitza → Ves a la posició... (Ctrl+G)

- Començament: desplaça la vista actual perquè comenci al començament del senyal.

  entrada del menú / drecera del teclat: Visualitza → Començament (Ctrl+Inici)

- Final: desplaça la vista actual perquè finalitzi al final del senyal.

  entrada del menú / drecera del teclat: Visualitza → Final (Ctrl+Fi)

- Pàgina anterior: desplaça cap a la posició just abans de la vista actual (a l'esquerra).

  entrada del menú / drecera del teclat: Visualitza → Pàgina anterior (Re Pàg)

- Pàgina següent: desplaça cap a la posició just després de la vista actual (a la dreta).

  entrada del menú / drecera del teclat: Visualitza → Pàgina següent (Av Pàg)

- Desplaça a la dreta: desplaça fins al final del senyal en 1/3 de la vista actual.

  entrada del menú / drecera del teclat: Visualitza → Desplaça a la dreta (Fletxa dreta)

- Desplaça a l'esquerra: desplaça fins al començament del senyal en 1/3 de la vista actual.

  entrada del menú / drecera del teclat: Visualitza → Desplaça a l'esquerra (Fletxa esquerra)

### Usar el resum

La pantalla principal del Kwave mostra un petit resum de tot el senyal que hi ha a sobre de la barra de desplaçament horitzontal de la finestra principal. Aquest resum també proporciona algunes característiques per a navegar:

- fer clic amb el botó esquerre del ratolí: mou directament la vista actual a la posició on s'ha fet clic.

- fer doble clic amb el botó esquerre del ratolí: mou directament la vista actual a la posició on s'ha fet clic i a més apropa la vista.

- fer doble clic amb el botó esquerre del ratolí, amb la tecla Maj premuda: mou directament la vista actual a la posició on s'ha fet clic i a més allunya la vista.

### Zoom vertical

Podeu fer zoom verticalment de la vista actual prement la tecla Alt i desplaçant amb la roda del ratolí.

Com seleccionar
Com seleccionar

## Com seleccionar

El Kwave permet seleccionar un interval continu de mostres, així com qualsevol combinació de canals (si editeu un fitxer multicanal). Si seleccioneu un interval de mostres (àmbit de temps), totes les ordres següents es limitaran a aquest interval i desseleccionant un canal, el seu contingut no es modificarà.

### Seleccionar els canals

Seleccionar o desseleccionar un canal és molt senzill. Només feu clic al símbol del llum al costat esquerre del senyal per a canviar el seu estat:

una llum verda significa «habilitat», mentre que

una llum vermella significa «inhabilitat».

### Nota

Nota: Si un canal està desseleccionat, tampoc no serà audible durant la reproducció!

### Seleccionar les mostres

Si seleccioneu un interval de mostres al Kwave, aquest interval serà inclusiu. Això significa que la primera i última mostra seleccionades pertanyen a la selecció i s'utilitzaran per a les accions següents. De manera que, fins i tot si no heu seleccionat un interval, només una mostra, la selecció mai no estarà «buida». Així, per exemple, si no veieu un interval seleccionat, la funció «suprimeix» s'aplicarà a aquesta mostra individual.

La forma més senzilla de seleccionar un interval de mostres és fer-ho amb el ratolí. Funciona com quan l'utilitzeu en les altres aplicacions: només cal prémer el botó esquerre del ratolí en el punt on vulgueu començar la selecció i deixeu-lo anar on vulgueu que finalitzi.

Si voleu ajustar o moure el començament o el final de la selecció, podeu moure el cursor del ratolí a prop del començament o del final de la selecció fins que el cursor canviï de la fletxa estàndard a una fletxa cap a l'esquerra o dreta i, a continuació, premeu el botó esquerre del ratolí i ajusteu la selecció.

També podeu ampliar o reduir la selecció a un punt concret mantenint premuda la tecla Maj mentre feu clic amb el botó esquerre del ratolí. Depenent de quina vora sigui més propera, la vora esquerra o dreta de la selecció s'establirà fins a la posició nova. Si no hi havia res seleccionat, s'establirà des del començament.

També hi ha algunes funcions disponibles a través del menú i, per descomptat, algunes dreceres de teclat:

- seleccionar tot el senyal: Edita → Selecció → Tot (Ctrl+A)

- seleccionar un interval: Edita → Selecció → Interval (R)

- l'àrea visible actualment: Edita → Selecció → Àrea visible (V)

- el bloc de mostres següent, començant una mostra després del final de la selecció actual i amb la mateixa longitud: Edita → Selecció → Següent (Maj++)

  (Consell: utilitzeu la tecla «+» des del teclat numèric!)

- el bloc anterior de mostres, finalitzant una mostra abans del començament de la selecció actual i amb la mateixa longitud: Edita → Selecció → Anterior (Maj+-)

  (Consell: utilitzeu la tecla «-» des del teclat numèric!)

- eliminar qualsevol selecció i seleccionar «res»: Edita → Selecció → Res (N)

- ampliar la selecció fins al començament del senyal (primera mostra): Edita → Selecció → Al començament (Maj+Inici)

- ampliar la selecció fins al final del senyal (última mostra): Edita → Selecció → Al final (Maj+Fi)

- expandir la selecció actual esquerra i dreta fins a l'etiqueta següent (o començament/final del senyal si no n'hi ha cap), començant a la posició actual del cursor: Edita → Selecció → Expandeix a les etiquetes (E)

- seleccionar l'àrea entre dues etiquetes que hi ha directament des de la selecció actual o fins al final del senyal: Edita → Selecció → A les etiquetes següents (Maj+Ctrl+N)

- seleccionar l'àrea entre dues etiquetes anteriors que quedin des de la selecció actual o fins al començament del senyal: Edita → Selecció → A les etiquetes anteriors (Maj+Ctrl+P)

Porta-retalls
Porta-retalls

## Porta-retalls

El Kwave utilitza el porta-retalls del Plasma. D'aquesta manera és possible intercanviar dades d'àudio entre les diferents finestres del Kwave. També es podrien intercanviar dades entre el Kwave i altres aplicacions d'àudio, depenent de la seva capacitat per a utilitzar el porta-retalls del Plasma.

Quan copieu dades al porta-retalls a través de la característica `copy`, el Kwave utilitzarà el tipus MIME `audio/vnd.wave` com a format de les dades, d'acord amb el RFC 2361, el qual és el mateix que el conegut format `wav`. En enganxar des del porta-retalls al Kwave, seran admesos tots els formats de dades que hi hagi disponibles com a formats d'importació, com per exemple Ogg/Vorbis, FLAC, etc.

Arrossegar i deixar anar
Arrossegar i deixar anar

## Arrossegar i deixar anar

El Kwave admet el protocol d'arrossegar i deixar anar dels Frameworks del KDE. Aquest permet obrir fitxers només escollint-los en una finestra del Dolphin o Konqueror, o a l'escriptori i deixar-los anar en una finestra del Kwave.

Tingueu en compte que si deixeu anar un fitxer dins d'una finestra del Kwave que ja conté un fitxer obert, primer es tancarà el fitxer actualment obert i s'obrirà el fitxer que voleu obrir. Si no voleu això, primer haureu d'obrir una finestra nova buida del Kwave.

També podeu seleccionar un interval de mostres i arrossegar-les o deixar-les en una finestra del Kwave. Per omissió, l'operació d'arrossegament es realitzarà en el mode moure, on l'interval seleccionat s'eliminarà del lloc original i s'inserirà a la posició on s'ha deixat anar. Si premeu la tecla Ctrl, podreu modificar-ho i arrossegar-lo en el mode copia.

Capítol 4. Automatitzar i crear scripts amb el Kwave
Automatitzar i crear scripts amb el Kwave

# Capítol 4. Automatitzar i crear scripts amb el Kwave

El Kwave des de la seva primera versió utilitza un llenguatge intern per a les ordres de text. Aquest llenguatge d'ordres s'utilitza internament per a la gestió del menú, controla la IGU, els efectes integrats i crida als connectors. Les ordres es descriuen més endavant a la secció Referència d'ordres.

## Sintaxi general

- Totes les ordres consisteixen d'un nom d'ordre i una llista de paràmetres opcionals entre claudàtors, depenent de l'ordre.

- Els caràcters permesos per als noms de les ordres són lletres, dígits i dos punts. Les ordres distingeixen entre majúscules i minúscules, i sempre estan en minúscules.

- Els paràmetres dins d'una llista de paràmetres estan separats per comes.

- Els paràmetres numèrics es poden donar com a números de coma fixa o com a números de coma flotant, utilitzant un punt com a separador decimal.

- Els paràmetres de cadena es retallen automàticament (tot l'espai en blanc al començament i al final serà eliminat). Si no es vol això, es poden envoltar amb cometes dobles ("). Si un paràmetre de cadena conté caràcters especials (com «,», «;», «#» o una «\»), aquests caràcters especials s'hauran d'escapar precedint un caràcter de «\».

- Es poden concatenar múltiples ordres a una llista d'ordres utilitzant un «;» com a separador.

Exemple:

    fileinfo(Comments,"Aquest és un \"exemple\" de comentari.")

Aquest exemple consisteix en l'ordre «fileinfo» i té dos paràmetres: la paraula clau `Comments` i el text «`"Aquest és un \"exemple\" de comentari."`». (Aquests paràmetres s'expliquen a la secció corresponent de la referència d'ordres).

Usar la línia d'ordres
Usar la línia d'ordres

## Usar la línia d'ordres

A més de les opcions de la línia d'ordres que apareixen a la secció Línia d'ordres, les quals s'utilitzen per a iniciar el Kwave en el mode com una icona o sense pantalla de presentació, podeu passar ordres de text sobre la línia d'ordres, codificades en un format URI especial:

`kwave:`ordre`[?`paràmetre`[,`paràmetre` «...»] ]`

Les regles per a transformar una ordre de text del Kwave en un URI vàlid són les següents:

- L'URI començarà amb la paraula `kwave`, seguida d'un caràcter de «:» i el nom de l'ordre.

- Si l'ordre té paràmetres, s'hauran d'afegir després del nom de l'ordre, utilitzant un caràcter de «?» com a separador.

- Es poden annexar múltiples paràmetres utilitzant un caràcter de «,» com a separador.

- Tots els caràcters especials al nom de l'ordre i els paràmetres hauran de ser codificats en un URL. Aquí hi ha una llista de les traduccions:

  Taula 4.1. Taula de traducció de la codificació de l'URL

  Original | Codificat |  | Original | Codificat |  | Original | Codificat |  | Original | Codificat
  --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
  (espai) | `%20` |  | ( | `%28` |  | : | `%3A` |  | \ | `%5C`
  ! | `%21` |  | ) | `%29` |  | ; | `%3B` |  | ] | `%5D`
  " | `%22` |  | * | `%2A` |  | < | `%3C` |  | ^ | `%5E`
  # | `%23` |  | + | `%2B` |  | = | `%3D` |  | _ | `%5F`
  $ | `%24` |  | , | `%2C` |  | > | `%3E` |  | ` | `%60`
  % | `%25` |  | - | `%2D` |  | ? | `%3F` |  | { | `%7B`
  & | `%26` |  | . | `%3E` |  | @ | `%40` |  | | | `%7C`
  ' | `%27` |  | / | `%2F` |  | [ | `%5B` |  | } | `%7D`
  |  |  |  |  |  |  |  |  | ~ | `%7E`

Fitxers de script del Kwave
Fitxers de script del Kwave

## Fitxers de script del Kwave

### Estructura general

Un script del Kwave consisteix en una llista de línies, on cada línia pot ser:

- una única ordre

- una llista d'ordres, amb dues o més ordres concatenades per un caràcter de «;».

- un comentari

- una etiqueta

- o una línia buida, la qual només contindrà espai/s en blanc

### Comentaris i línies buides

Tots els caràcters que segueixin un caràcter de «#» (excepte quan s'utilitzen entre cometes o quan s'escapen) es tractaran com a comentaris, se'ls ignorarà silenciosament.

Les línies que només contenen espais en blanc o comentaris, s'ignoraran.

### Finalització

Un script del Kwave finalitzarà quan totes les ordres s'hagin executat correctament sense cap error o quan una ordre hagi retornat un codi d'error. No hi ha cap ordre especial per a cancel·lar l'execució d'un script. Si voleu implementar una possibilitat perquè l'usuari finalitzi un script, podeu utilitzar l'ordre «msgbox(``text``)». Això mostrarà un quadre de missatge amb dos botons D'acord (permet continuar l'script) i Cancel·la (retornarà un codi d'error i aturarà l'script).

### Etiquetes

Les línies que només consten d'un identificador, seguides d'un caràcter de «:» seran tractades com a etiquetes. A l'script es pot fer una referència posterior amb la paraula clau especial GOTO [2], la qual cosa farà que l'execució de l'script continuï a la ubicació d'aquesta etiqueta (vegeu l'exemple següent).

Una línia que contingui una etiqueta no haurà de contenir cap altre contingut (excepte els comentaris o espais en blanc) després del caràcter de «:».

Exemple:

    inici:  # <= això és una etiqueta
                        # fer quelcom...
                        msgbox(una altra vegada?)
                        GOTO start

[2] Nota: no confondre la paraula clau «GOTO» amb l'ordre de text «goto(``posició``)»!

Referència d'ordres
Referència d'ordres

## Referència d'ordres

### Índex alfabètic

### a

about_kde
add_track

### c

clipboard_flush
close
continue
copy
crop
cut

### d

delayed
delete
delete_track
dump_metadata

### e

label:edit
expandtolabel

### f

fileinfo
forward

### g

goto

### i

insert_at
insert_track

### l

label:add
label:delete
loadbatch
loop

### m

menu
msgbox

### n

newsignal
next

### o

open
openrecent

### p

paste
pause
playback_start
plugin
plugin:execute
plugin:setup
prev

### q

quit

### r

redo
redo_all
reenable_dna
reset_toolbars
revert
rewind

### s

save
saveas
saveselect
select_gui_type
select_track:all
select_track:invert
select_track:none
select_track:off
select_track:on
select_track:toggle
selectall
selectnext
selectnextlabels
selectnone
selectprev
selectprevlabels
selecttoleft
selecttoright
selectvisible
start
stop
sync

### u

undo
undo_all

### v

view:scroll_end
view:scroll_left
view:scroll_next
view:scroll_next_label
view:scroll_prev
view:scroll_prev_label
view:scroll_right
view:scroll_start
view:zoom_all
view:zoom_in
view:zoom_normal
view:zoom_out
view:zoom_selection

### w

window:activate
window:cascade
window:click
window:close
window:minimize
window:mousemove
window:next_sub
window:prev_sub
window:resize
window:screenshot
window:sendkey
window:tile
window:tile_vertical

``

a
a

## a

### about_kde

#### Sintaxi: about_kde()

Mostra un diàleg amb informació sobre la comunitat KDE.

### add_track

#### Sintaxi: add_track()

Afegeix una pista nova després de totes les pistes existents.

#### Vegeu també

insert_track()

c
c

## c

### clipboard_flush

#### Sintaxi: clipboard_flush()

Descarta el contingut actual del porta-retalls (pot alliberar una mica de memòria).

### close

#### Sintaxi: close()

Tanca el fitxer actual. Si la IGU està configurada al mode MDI o Pestanyes, això també tancarà la subfinestra corresponent.

#### Vegeu també

open(`nom_de_fitxer`), quit()

### continue

#### Sintaxi: continue()

Correspon al botó Continua de la barra d'eines i permet que la reproducció continuï si està en pausa.

#### Vegeu també

pause()

### copy

#### Sintaxi: copy()

Copia el contingut de la selecció actual al porta-retalls. Si la selecció està buida, aquesta ordre no farà res i el contingut del porta-retalls no canviarà. Només es copiarà al porta-retalls el contingut de les pistes seleccionades.

#### Vegeu també

paste()

### crop

#### Sintaxi: crop()

Escapça el senyal a la selecció actual suprimint tot el que hi hagi abans i després de la selecció actual. Afectarà totes les pistes. Si no se selecciona res, aquesta ordre no farà res.

### cut

#### Sintaxi: cut()

Copia el contingut de la selecció actual al porta-retalls i l'elimina del senyal. Si la selecció està buida, aquesta ordre no farà res i el contingut del porta-retalls no canviarà. Només es copiarà al porta-retalls el contingut de les pistes seleccionades, però l'interval seleccionat serà eliminat de totes les pistes.

d
d

## d

### delayed

#### Sintaxi: delayed( `mil·lisegons`, `ordre` )

Executa una `ordre` després d'un retard indicat. Tingueu en compte que l'ordre s'executarà de forma asíncrona després d'haver transcorregut un temps determinat. Es poden establir múltiples ordres, on els retards seran relatius a l'última ordre a la cua. Aquesta ordre està pensada per a utilitzar ordres a la cua quan es prenen captures de pantalla amb finalitats de documentació.

#### Paràmetres

`mil·lisegons`: | nombre de mil·lisegons a esperar abans d'executar l'ordre
`ordre`: | una ordre, inclosos els paràmetres a executar després de la demora indicada

#### Vegeu també

sync(), window:resize(), window:click(), window:sendkey(), window:close(), window:screenshot()

### delete

#### Sintaxi: delete()

Suprimeix l'interval seleccionat de les mostres. Si la selecció està buida, aquesta ordre no farà res. Afectarà totes les pistes.

### delete_track

#### Sintaxi: delete_track(`índex`)

Suprimeix una pista, identificada pel seu índex (començant pel zero). Si no hi ha cap pista amb l'índex indicat, aquesta ordre sortirà amb un error.

#### Paràmetres

`índex`: | índex de la pista a suprimir, començant pel 0

### dump_metadata

#### Sintaxi: dump_metadata()

Imprimeix a la consola una llista de totes les entrades de metadades, amb finalitats de diagnòstic. (Només estarà disponible quan s'hagi compilat el Kwave amb l'opció `WITH_DEBUG` activada).

e
e

## e

### expandtolabel

#### Sintaxi: expandtolabel()

Expandeix la selecció actual a les etiquetes esquerra i dreta a partir de les vores de la selecció actual. Si la vora de la selecció ja es troba en una etiqueta, es mantindrà sense canvis. Si no hi ha cap etiqueta a l'esquerra o dreta de la selecció actual, s'expandirà fins al començament o al final del fitxer.

f
f

## f

### fileinfo

#### Sintaxi: fileinfo(`índex`)

Estableix una entrada d'informació del fitxer a un valor nou.

#### Paràmetres

`paraula_clau`: | paraula clau de l'entrada
`valor`: | valor de l'entrada

### forward

#### Sintaxi: forward()

Correspon al botó Endavant de la barra d'eines. Si la reproducció s'està executant, saltarà endavant per 1/10 de l'interval visible. Si la reproducció no s'està executant, aquesta farà el mateix que l'ordre view:scroll_right().

#### Vegeu també

view:scroll_right(), rewind()

g
g

## g

### goto

#### Sintaxi: goto(`posició`)

Estableix el cursor a la posició indicada i la fa visible a la vista actual. Després d'això, la selecció tindrà una longitud de zero.

#### Paràmetres

`posició`: | posició en mostres on anar

i
i

## i

### insert_at

#### Sintaxi: insert_at(`posició`)

Insereix el contingut del porta-retalls a la posició indicada, com ara l'ordre paste(). Si el porta-retalls està buit, aquesta funció no farà res.

#### Paràmetres

`posició`: | posició en mostres on inserir

#### Vegeu també

paste()

### insert_track

#### Sintaxi: insert_track(`índex`)

Insereix una pista nova a l'índex indicat, utilitzant les opcions de la longitud i freqüència de mostreig del senyal. Si l'índex és superior o igual que el nombre actual de pistes, s'annexarà com a última pista, igual que per a l'ordre add_track(). L'índex de totes les pistes existents en i després de l'índex indicat s'incrementarà en un.

#### Paràmetres

`índex`: | índex de la pista a inserir, començant pel 0

#### Vegeu també

add_track()

l
l

## l

### label:add

#### Sintaxi: label:add(`posició`[,`text`])

Afegeix una etiqueta nova en una posició indicada. Si la posició indicada ja conté una etiqueta, llavors aquesta ordre no farà res. L'etiqueta pot indicar una descripció opcional.

#### Paràmetres

`posició`: | posició en mostres on inserir l'etiqueta
`text`: | algun text descriptiu (opcional)

### label:delete

#### Sintaxi: label:delete(`índex`)

Suprimeix una etiqueta, identificada pel seu índex (començant pel zero), o totes les etiquetes quan s'utilitza el valor especial -1 com a índex. Si no hi ha cap etiqueta amb l'índex indicat, aquesta ordre no farà res.

#### Paràmetres

`índex`: | índex de l'etiqueta a suprimir, començant pel 0 o -1 per a suprimir totes les etiquetes

### label:edit

#### Sintaxi: label:edit(`índex`)

Obre un diàleg on l'usuari podrà editar la posició i la descripció d'una etiqueta, el que s'identificarà amb el seu índex (començant pel zero). Si no hi ha cap etiqueta amb l'índex indicat, aquesta ordre no farà res.

#### Paràmetres

`índex`: | índex de l'etiqueta a editar, començant pel 0

### loadbatch

#### Sintaxi: loadbatch(`nom_de_fitxer`)

Obre un fitxer de script del Kwave i en processa les ordres. Utilitza el context del fitxer actualment obert o la finestra principal si no hi ha cap fitxer carregat.

#### Paràmetres

`nom_de_fitxer`: | nom del fitxer de script del Kwave, inclòs el camí i l'extensió

### loop

#### Sintaxi: loop()

Correspon al botó Repeteix de la barra d'eines. Inicia la reproducció (si encara no s'està executant) i permet reproduir en un bucle.

#### Vegeu també

playback_start()

m
m

## m

### menu

#### Sintaxi: menu (`ordre`, `camí`, [`drecera`], [`id`])

Es tracta d'una ordre molt potent, la qual s'utilitza per a afegir una entrada nova al menú o per a modificar una entrada existent. Determina quina ordre s'executarà quan s'activi l'entrada del menú, quina icona es mostrarà al menú i quina drecera de teclat s'utilitzarà. Cada entrada de menú es pot inhabilitar o ocultar, se li pot assignar un id únic i també pot unir-se a un grup del menú.

Normalment no necessitareu aquesta ordre dins d'un script del Kwave.

#### Paràmetres

`ordre`: | Una ordre de text (inclosos els paràmetres) o una llista d'ordres que s'executarà quan s'activi l'entrada del menú. Si una entrada de menú no té una ordre corresponent (p. ex., si es tracta d'un submenú i no d'una entrada del menú), haureu d'utilitzar l'ordre especial ignore().

`camí`:

El camí dins del menú, utilitzant un caràcter de «/» com a separador. L'última part del camí podrà ser una subordre, la qual modificarà algunes propietats de l'entrada del menú (vegeu a continuació). L'última porció del camí (no és una subordre) produeix una entrada del menú, les parts abans de produir l'entrada del menú principal o els submenús que ens porten a ella. Les entrades del menú principal o submenús es crearan automàticament quan es creï una entrada del menú, no cal crear-les manualment.

`drecera`:

Una màscara de bits que consisteix en una combinació de tecles i modificadors predefinits, concatenats amb un caràcter de «+». La tecla pot ser un dígit, una lletra majúscula, una tecla de funció («F1» fins a la «F12») o qualsevol altre nom de tecla entès per la classe «`QKeySequence`» de les Qt, inclosos els noms de tecla per a accions predefinides (com per exemple «`::Copy`»). Els modificadors típics són «`SHIFT`», «`ALT`» i «`CTRL`».

`id`: | Un id únic que es pot utilitzar internament per a identificar aquesta entrada del menú o menú/submenú. Només s'han d'utilitzar lletres majúscules, dígits i el caràcter «`_`», i hauria de començar amb «`ID_`». És responsabilitat vostra assegurar-vos que el mateix id no s'utilitza dues vegades.

#### Subordres:

#checkable: | Fa que l'entrada de menú es pugui marcar, de manera que es podrà activar o desactivar.
#disabled: | Inhabilita el menú, l'entrada del menú o submenú.
#enabled: | Habilita el menú, l'entrada del menú o submenú.
#exclusive(`grup`): | Afegeix l'entrada del menú a un `grup` exclusiu (una de moltes seleccions). El grup que s'indica com a paràmetre no s'haurà d'utilitzar per a cap altra finalitat. Només es podrà seleccionar una entrada alhora dins d'aquest grup.

#group(`llista`):

Afegeix el menú, l'entrada del menú o submenú a un o més grups, de manera que l'aplicació pot habilitar/inhabilitar un munt d'entrades del menú sense necessitat de conèixer tots els seus id únics. Es poden passar múltiples grups com una llista amb un caràcter de «`,`» com a separador. Els noms de grup hauran de començar amb un caràcter de «`@`». Hi ha predefinits els grups següents:

@CLIPBOARD:

  Només estarà habilitat quan el porta-retalls no estigui buit.

@LABELS:

  Només estarà habilitat quan el senyal actual contingui almenys una etiqueta.

@NOT_CLOSED:

  Habilitat quan el senyal actual no estigui tancat (el senyal podrà estar buit o amb longitud zero).

@SELECTION:

  Habilitat quan la selecció no estigui buida (hi haurà més d'una mostra seleccionada).

@SIGNAL:

  Habilitat quan hi hagi algun senyal carregat i no estigui buit o amb longitud zero.

#hidden: | Oculta el menú, l'entrada del menú o submenú.
#icon(`nom`): | Assigna una icona a l'entrada del menú. El `nom` de la icona haurà de correspondre a un fitxer d'icona (sense camí ni extensió de fitxer) instal·lat al sistema o amb el Kwave.

#listmenu(`id`,`ordre`):

Insereix un marcador de posició per a una llista d'entrades del menú dins d'un submenú. L'`id` únic especificat en aquesta subordre s'utilitzarà per a afegir/treure o esborrar la llista d'entrades del menú. El paràmetre `ordre` haurà de contenir «`%1`» com a paràmetre, el qual serà substituït pel text de l'entrada del menú quan sigui activada. Aquesta subordre s'utilitza internament per a la llista de fitxers recents, llista de pistes i llista de finestres.

#separator: | Insereix un separador dins d'un submenú.

### msgbox

#### Sintaxi: msgbox(`text`)

Mostra un quadre de missatge amb algun `text` i dos botons D'acord (retorna sense codi d'error) i Cancel·la (retorna amb un codi d'error). Podeu utilitzar aquesta ordre per a donar a l'usuari la possibilitat d'interrompre un script en execució.

#### Paràmetres

`text`: | Un missatge que es mostrarà al quadre de missatge, haurà de contenir una pregunta que es podrà respondre amb D'acord o Cancel·la.

n
n

## n

### newsignal

#### Sintaxi: newsignal( `mostres`, `taxa`, `bits`, `pistes`)

Crea un senyal nou, amb una longitud determinada en `mostres`, una `taxa` en mostres per segon (nombre en coma flotant), un nombre de `bits` per mostra i nombre de `pistes`. Podeu calcular la longitud en les mostres, multiplicant la longitud desitjada en segons amb la freqüència de mostreig.

#### Paràmetres

`mostres`: | Longitud del senyal en mostres.
`taxa`: | Freqüència de mostreig en mostres per segon.
`bits`: | El nombre de bits per mostra, no haurà de ser zero, haurà de ser un número entre 8 i 32.
`pistes`: | Nombre de pistes.

### next

#### Sintaxi: next()

Correspon al botó Següent de la barra d'eines. Si s'està executant la reproducció, saltarà endavant cap a la propera etiqueta. Si la reproducció no s'està executant, aquesta farà el mateix que l'ordre: view:scroll_next_label().

#### Vegeu també

view:scroll_next_label(), prev()

o
o

## o

### open

#### Sintaxi: open([`nom_de_fitxer`])

Obre un fitxer, el qual pot ser un fitxer de so o un script del Kwave. Si no es passa cap nom de fitxer, s'obrirà un diàleg que permeti seleccionar un fitxer existent. Segons el mode de la IGU, el fitxer s'obrirà en el context d'una subfinestra nova (MDI i Pestanyes) o en una finestra principal nova (SDI, si ja hi havia quelcom carregat).

#### Paràmetres

`nom_de_fitxer`: | nom d'un fitxer, inclòs el camí i l'extensió

#### Vegeu també

close()

### openrecent

#### Sintaxi: openrecent(`nom_de_fitxer`)

Fa pràcticament el mateix que l'ordre open(), però es pretén utilitzar internament per a la llista de fitxers oberts recentment al menú Fitxer+Obre un de recent. En aquesta ordre, el paràmetre `nom_de_fitxer` no és opcional.

#### Paràmetres

`nom_de_fitxer`: | entrada de la llista dels fitxers oberts recentment

#### Vegeu també

open()

p
p

## p

### paste

#### Sintaxi: paste()

Substitueix la selecció actual amb el contingut del porta-retalls. Si el porta-retalls està buit, aquesta ordre no farà res. Si és necessari, la freqüència de mostreig de les dades introduïdes s'ajustarà perquè coincideixi amb la freqüència de mostreig del senyal actual. Només afectarà les pistes habilitades, les pistes inhabilitades no es modificaran. Tingueu en compte que això podria produir un desplaçament en el temps entre les pistes habilitades i les inhabilitades. Si el nombre de pistes de les dades al porta-retalls difereix del nombre de pistes habilitades, llavors les dades es barrejaran per a ser distribuïdes equitativament entre totes les pistes seleccionades.

#### Vegeu també

copy()

### pause

#### Sintaxi: continue()

Correspon al botó Pausa de la barra d'eines i permet fer una pausa en la reproducció si s'està executant, o continuar si es troba en pausa.

#### Vegeu també

continue()

### playback_start

#### Sintaxi: playback_start()

Correspon al botó Inicia de la barra d'eines i permet iniciar la reproducció si es troba en pausa.

### plugin

#### Sintaxi: plugin(`nom`, [`paràmetre` «...»])

Executa un connector, amb una llista opcional de paràmetres. Si no s'indica cap llista de paràmetres, llavors es cridarà la funció de configuració del connector, utilitzant els paràmetres de la crida anterior o amb els paràmetres predeterminats com a entrada (normalment es mostrarà un diàleg de configuració, depenent del connector). Consulteu el capítol sobre els connectors per a obtenir una descripció dels diferents connectors.

#### Paràmetres

`nom`: | el nom (intern) d'un connector del Kwave
`paràmetre`: | una llista dels paràmetres entesos pel connector (opcional)

#### Vegeu també

plugin:execute(), plugin:setup()

### plugin:execute

#### Sintaxi: plugin:execute(`nom`, [`paràmetre` «...»])

Similar a l'ordre plugin(), però sense cridar la funció de configuració del connector si no s'ha passat cap paràmetre.

#### Paràmetres

`nom`: | el nom (intern) d'un connector del Kwave
`paràmetre`: | una llista dels paràmetres entesos pel connector

### plugin:setup

#### Sintaxi: plugin:setup(`nom`, [`paràmetre` «...»])

Crida a la funció de configuració d'un connector, amb una llista opcional de paràmetres. Si no s'indica cap llista de paràmetres, s'utilitzaran els paràmetres de la crida anterior o amb els paràmetres predeterminats. Normalment, es mostrarà un diàleg de configuració, depenent del connector. Consulteu el capítol sobre els connectors per a obtenir una descripció dels diferents connectors.

#### Paràmetres

`nom`: | el nom (intern) d'un connector del Kwave
`paràmetre`: | una llista dels paràmetres entesos pel connector (opcional)

### prev

#### Sintaxi: prev()

Correspon al botó Anterior de la barra d'eines. Si la reproducció s'està executant, es passarà de nou a l'etiqueta anterior o al començament de la selecció. Si la reproducció no s'està executant, aquesta farà el mateix que l'ordre view:scroll_prev_label().

#### Vegeu també

view:scroll_prev_label(), next()

q
q

## q

### quit

#### Sintaxi: quit()

Tanca la finestra principal, incloses totes les subfinestres secundàries. En el mode SDI, això és el mateix que l'ordre close().

#### Vegeu també

close()

r
r

## r

### redo

#### Sintaxi: redo()

Correspon al botó Refés de la barra d'eines i repeteix una operació que s'ha revertit amb undo().

#### Vegeu també

undo()

### redo_all

#### Sintaxi: redo_all()

Similar a redo(), però tornarà a fer tantes operacions com sigui possible.

#### Vegeu també

undo()

### reenable_dna

#### Sintaxi: reenable_dna()

Alguns quadres de missatge ofereixen la possibilitat d'evitar que tornin a aparèixer («No ho tornis a preguntar»). Aquesta ordre farà que tots tornin a aparèixer.

### reset_toolbars

#### Sintaxi: reset_toolbars()

Restaura totes les opcions de la barra d'eines, com ara la ubicació, la mida de la icona i la ubicació del text a la configuració predeterminada.

### revert

#### Sintaxi: revert()

Reverteix el fitxer carregat a l'últim estat desat, descartant tots els canvis que no s'hagin desat.

### rewind

#### Sintaxi: rewind()

Correspon al botó Rebobina de la barra d'eines. Si la reproducció s'està executant, això saltarà cap enrere per 1/10 de l'interval visible. Si la reproducció no s'està executant, aquesta farà el mateix que l'ordre view:scroll_left().

#### Vegeu també

view:scroll_left(), forward()

s
s

## s

### save

#### Sintaxi: save()

Correspon al botó Desa de la barra d'eines. Desa el fitxer actual si conté modificacions. Si el fitxer encara no té un nom (p. ex., un fitxer que s'acaba de crear i que encara no té un nom de fitxer), aquesta ordre farà el mateix que saveas().

#### Vegeu també

saveas()

### saveas

#### Sintaxi: saveas([`nom_de_fitxer`])

Desa el fitxer obert sota un nom de fitxer indicat. Si no s'indica cap nom de fitxer com a paràmetre, es mostrarà un diàleg per a seleccionar el directori i per a introduir un nom de fitxer.

#### Paràmetres

`nom_de_fitxer`: | nom del fitxer per a desar (opcional)

### saveselect

#### Sintaxi: saveselect()

Aquesta ordre fa el mateix que save(), però només desarà l'interval seleccionat i les pistes activades en comptes de tot el fitxer.

#### Vegeu també

save()

### select_gui_type

#### Sintaxi: select_gui_type(`mode`)

Selecciona un mode d'IGU, el qual pot ser el mode SDI, MDI o Tab (Pestanyes). Tingueu en compte que aquest canvi tindrà efecte immediat!

#### Paràmetres

`nom_de_fitxer`: | nom del mode, haurà de ser «SDI», «MDI» o «Tab» (Pestanyes).

### select_track:all

#### Sintaxi: select_track:all()

Marca totes les pistes «habilitades». Això és el mateix que cridar a l'ordre select_track:on() per a totes les pistes existents.

#### Vegeu també

select_track:on()

### select_track:invert

#### Sintaxi: select_track:all()

Inverteix l'estat «habilitada» de totes les pistes. Això és el mateix que cridar a l'ordre select_track:toggle() per a totes les pistes existents.

#### Vegeu també

select_track:toggle()

### select_track:none

#### Sintaxi: select_track:none()

Marca totes les pistes «inhabilitades». Això és el mateix que cridar a l'ordre select_track:off() per a totes les pistes existents.

#### Vegeu també

select_track:off()

### select_track:off

#### Sintaxi: select_track:off(`índex`)

Inhabilita una sola pista, de manera que no es vegi afectada per la majoria de les operacions.

#### Paràmetres

`índex`: | índex de la pista, començant pel zero

### select_track:on

#### Sintaxi: select_track:on(`índex`)

Habilita una única pista, de manera que es vegi afectada per totes les operacions.

#### Paràmetres

`índex`: | índex de la pista, començant pel zero

### select_track:toggle

#### Sintaxi: select_track:toggle(`índex`)

Habilita una pista si està inhabilitada o la inhabilita si està habilitada.

#### Paràmetres

`índex`: | índex de la pista, començant pel zero

### selectall

#### Sintaxi: selectall()

Selecciona l'interval de tot el senyal, des de la primera fins a l'última mostra.

### selectnext

#### Sintaxi: selectnext()

Selecciona un interval de mostres que començarà just després de la selecció actual, utilitzant la mateixa longitud que la selecció actual. La selecció es retallarà automàticament fins al final del senyal. Per exemple: si heu seleccionat les mostres 1000 fins a la 1019, el resultat serà una selecció des de la mostra 1020 fins a la 1039.

#### Vegeu també

selectprev()

### selectnextlabels

#### Sintaxi: selectnextlabels()

Selecciona un interval de mostres entre les dues etiquetes següents després de la selecció actual. Si no se selecciona res, això seleccionarà des del començament del senyal fins a la primera etiqueta. En cas contrari, la vora esquerra de la selecció nova serà la posició de la primera etiqueta després de la selecció (o l'última etiqueta si no hi ha més etiquetes a la dreta de la selecció), i la vora dreta de la selecció nova serà la primera etiqueta després de la vora esquerra de la selecció nova (o el final del senyal si no n'hi ha cap). Aquesta ordre retornarà un error quan no hi hagi cap etiqueta.

#### Vegeu també

selectprevlabels()

### selectnone

#### Sintaxi: selectnone()

Restaura la selecció a la longitud zero.

### selectprev

#### Sintaxi: selectprev()

Selecciona un interval de mostres que començarà a l'esquerra de la selecció actual, utilitzant la mateixa longitud que la selecció actual. La selecció es retallarà automàticament fins al començament del senyal. Per exemple: si heu seleccionat les mostres 1000 fins a la 1019, el resultat serà una selecció des de la mostra 980 fins a la 999.

#### Vegeu també

selectnext()

### selectprevlabels

#### Sintaxi: selectprevlabels()

Selecciona un interval de mostres entre les dues etiquetes anteriors abans de la selecció actual. Si no se selecciona res, això seleccionarà des del començament del senyal fins a la primera etiqueta. En cas contrari, la vora dreta de la selecció nova serà la posició de la primera etiqueta abans de la selecció (o la primera etiqueta si no hi ha més etiquetes a la selecció), i la vora esquerra de la selecció nova serà la primera etiqueta abans de la vora dreta de la selecció nova (o el començament del senyal si no n'hi ha cap). Aquesta ordre retornarà un error quan no hi hagi cap etiqueta.

#### Vegeu també

selectnextlabels()

### selecttoleft

#### Sintaxi: selecttoleft()

Estableix el començament de la selecció al començament del senyal, el final de la selecció actual romandrà sense canvis.

#### Vegeu també

selecttoright()

### selecttoright

#### Sintaxi: selecttoright()

Estableix el final de la selecció al final del senyal, el començament de la selecció actual romandrà sense canvis.

#### Vegeu també

selecttoleft()

### selectvisible

#### Sintaxi: selectvisible()

Selecciona l'interval de mostres que és visible a la finestra actual.

### start

#### Sintaxi: start()

Correspon al botó Inicia de la barra d'eines i permet iniciar la reproducció des del començament de la selecció o continua si està en pausa.

#### Vegeu també

stop()

### stop

#### Sintaxi: stop()

Correspon al botó Atura de la barra d'eines i permet que la reproducció s'aturi si s'està executant.

#### Vegeu també

start()

### sync

#### Sintaxi: sync()

Espera fins que finalitzin totes les ordres iniciades de forma asíncrona. Si no hi ha res en curs a la cua per a una execució retardada, aquesta ordre no tindrà cap efecte.

#### Vegeu també

delayed()

u
u

## u

### undo

#### Sintaxi: undo()

Correspon al botó Desfés de la barra d'eines i reverteix l'última operació.

#### Vegeu també

redo()

### undo_all

#### Sintaxi: undo_all()

Similar a undo(), però reverteix la quantitat més gran possible d'operacions.

#### Vegeu també

undo()

v
v

## v

### view:scroll_end

#### Sintaxi: view:scroll_end()

Desplaça la vista actual fins al final del senyal.

#### Vegeu també

view:scroll_start()

### view:scroll_left

#### Sintaxi: view:scroll_left()

Desplaça la vista actual per 1/10 de l'interval visible cap al començament del senyal. Si s'abasta el començament del senyal, l'àrea visible començarà al zero.

#### Vegeu també

view:scroll_right()

### view:scroll_next

#### Sintaxi: view:scroll_next()

Desplaça la vista actual cap al final del senyal per a l'interval visible.

#### Vegeu també

view:scroll_prev()

### view:scroll_next_label

#### Sintaxi: view:scroll_next_label()

Desplaça cap a la dreta i intenta mostrar l'etiqueta següent centrada a la vista. Si no hi ha cap etiqueta a la dreta des de la posició actual, es desplaçarà fins al final del senyal.

#### Vegeu també

view:scroll_prev_label()

### view:scroll_prev

#### Sintaxi: view:scroll_prev()

Desplaça la vista actual cap al començament del senyal per a l'interval visible.

#### Vegeu també

view:scroll_next()

### view:scroll_prev_label

#### Sintaxi: view:scroll_prev_label()

Desplaça cap a l'esquerra i intenta mostrar l'anterior etiqueta centrada a la vista. Si no hi ha cap etiqueta a l'esquerra des de la posició actual, es desplaçarà fins al començament del senyal.

#### Vegeu també

view:scroll_next_label()

### view:scroll_right

#### Sintaxi: view:scroll_right()

Desplaça la vista actual per 1/10 de l'interval visible cap al final del senyal. Si s'abasta el final del senyal, l'àrea visible finalitzarà al final del senyal.

#### Vegeu també

view:scroll_left()

### view:scroll_start

#### Sintaxi: view:scroll_start()

Desplaça la vista actual cap al començament del senyal.

#### Vegeu també

view:scroll_end()

### view:zoom_all

#### Sintaxi: view:zoom_all()

Ajusta el factor d'apropament perquè sigui visible tot el senyal a la vista actual.

### view:zoom_in

#### Sintaxi: view:zoom_in([`posició`])

Redueix el factor d'apropament (en mostres per píxel) en un 30%, de manera que es puguin veure més detalls. Si s'indica una `posició`, l'intentarà mostrar centrada a la vista actual, en cas contrari, s'utilitzarà el centre de la vista abans del canvi d'apropament. El factor d'apropament estarà limitat a un mínim de cinc mostres per amplada de la vista.

#### Paràmetres

`posició`: | una posició basada en mostres i amb origen zero per a centrar la vista (opcional)

#### Vegeu també

view:zoom_out()

### view:zoom_normal

#### Sintaxi: view:zoom_normal()

Estableix el factor d'apropament en un píxel per mostra (factor 1,0) i intentarà mantenir el centre anterior de la vista.

### view:zoom_out

#### Sintaxi: view:zoom_out([`posició`])

Augmenta el factor d'apropament (en mostres per píxel) en un 30%, de manera que es puguin veure menys detalls. Si s'indica una `posició`, l'intentarà mostrar centrada a la vista actual, en cas contrari, s'utilitzarà el centre de la vista abans del canvi d'apropament. El factor d'apropament estarà limitat al nombre de mostres de tot el senyal i l'amplada de la vista.

#### Paràmetres

`posició`: | una posició basada en mostres i amb origen zero per a centrar la vista (opcional)

#### Vegeu també

view:zoom_in()

### view:zoom_selection

#### Sintaxi: view:zoom_selection()

Ajusta la vista (factor d'apropament i el començament de l'àrea visible) de manera que coincideixi amb la selecció actual. Aquesta ordre no farà res si la selecció està buida.

w
w

## w

### window:activate

#### Sintaxi: window:activate(`títol`])

Activa una subfinestra, identificada pel seu `títol` de finestra. Si es minimitza la subfinestra, es restaurarà. Només disponible si està en el mode MDI i Pestanyes. Aquesta ordre és utilitzada internament pel menú Finestra.

#### Paràmetres

`títol`: | el títol de la subfinestra que s'hauria d'activar

### window:cascade

#### Sintaxi: window:cascade()

Mostra en cascada totes les subfinestres quan es troba en el mode MDI. Totes les subfinestres minimitzades romandran minimitzades, no es restauraran.

### window:click

#### Sintaxi: window:click( `classe`, `x`, `y` )

Envia un esdeveniment de clic del ratolí a la finestra, identificada pel seu nom de `classe`. L'esdeveniment només s'enviarà a la primera finestra que tingui el nom de la classe indicada, per tant, haureu d'assegurar-vos que només teniu una instància de la finestra indicada quan s'executi aquesta ordre.

#### Paràmetres

`classe`: | nom de la classe de la finestra
`x`: | posició X, relativa a la vora esquerra de la finestra (en píxels)
`y`: | posició Y, relativa a la vora superior de la finestra (en píxels)

### window:close

#### Sintaxi: window:close( `classe` )

Tanca una finestra, identificada pel seu nom de `classe`. Només es tancarà la primera finestra que tingui el nom de la classe indicada, per tant, haureu d'assegurar-vos que només teniu una instància de la finestra indicada quan s'executi aquesta ordre.

#### Paràmetres

`classe`: | nom de la classe de la finestra

### window:minimize

#### Sintaxi: window:minimize

Minimitza la subfinestra activa quan està en el mode MDI o la finestra de nivell superior quan es troba en el mode SDI o Pestanyes.

### window:mousemove

#### Sintaxi: window:resize( `classe`, `x`, `y` )

Envia un esdeveniment de moviment del ratolí a la finestra, identificat pel seu nom de `classe`. L'esdeveniment només s'enviarà a la primera finestra que tingui el nom de la classe indicada, per tant, haureu d'assegurar-vos que només teniu una instància de la finestra indicada quan s'executi aquesta ordre.

#### Paràmetres

`classe`: | nom de la classe de la finestra
`x`: | posició X, relativa a la vora esquerra de la finestra (en píxels)
`y`: | posició Y, relativa a la vora superior de la finestra (en píxels)

### window:next_sub

#### Sintaxi: window:next_sub()

Activa la següent subfinestra quan es troba en el mode MDI o Pestanyes. Si subfinestra següent està minimitzada, es restaurarà.

### window:prev_sub

#### Sintaxi: window:prev_sub()

Activa la subfinestra anterior quan es troba en el mode MDI o Tab. Si la subfinestra anterior està minimitzada, es restaurarà.

### window:resize

#### Sintaxi: window:resize( `classe`, `amplada`, `alçada` )

Canvia la mida d'una finestra, identificada pel seu nom de `classe` a una amplada i alçada nova. El canvi només s'aplicarà a la primera finestra que tingui el nom de la classe indicada, per tant, haureu d'assegurar-vos que només teniu una instància de la finestra indicada quan s'executi aquesta ordre.

#### Paràmetres

`classe`: | nom de la classe de la finestra
`amplada`: | l'amplada nova de la finestra (en píxels)
`alçada`: | l'alçada nova de la finestra (en píxels)

### window:screenshot

#### Sintaxi: window:screenshot( `classe`, `nom_de_fitxer` )

Pren una captura de pantalla d'una finestra, identificada per la seva `classe` i la desa en un fitxer. La captura de pantalla serà presa de la primera finestra que tingui el nom de la classe indicada, per tant, haureu d'assegurar-vos que només teniu una instància de la finestra indicada quan s'executi aquesta ordre. Actualment, el format del fitxer és fix i haurà de ser `*.png`.

#### Paràmetres

`classe`: | nom de la classe de la finestra
`nom_de_fitxer`: | nom del fitxer per a desar la captura de pantalla, haurà de tenir l'extensió `*.png`

### window:sendkey

#### Sintaxi: window:sendkey( `classe`, `codi_clau` )

Envia un esdeveniment de pulsació i alliberament de tecla a la finestra, identificada pel seu nom de `classe`. La tecla només s'enviarà a la primera finestra que tingui el nom de la classe indicada, per tant, haureu d'assegurar-vos que només teniu una instància de la finestra indicada quan s'executi aquesta ordre.

#### Paràmetres

`classe`: | nom de la classe de la finestra
`codi_clau`: | el codi clau que s'ha d'enviar, utilitzant la mateixa sintaxi que s'utilitza per a configurar els menús

#### Vegeu també

La descripció del paràmetre `drecera de teclat` de l'ordre menu().

### window:tile

#### Sintaxi: window:tile()

Mostra en mosaic totes les subfinestres quan es troba en el mode MDI, utilitzant algun esquema del Plasma. Totes les subfinestres minimitzades romandran minimitzades, no es restauraran.

### window:tile_vertical

#### Sintaxi: window:tile_vertical()

Mostra en mosaic vertical totes les subfinestres quan es troba en el mode MDI. Totes les finestres minimitzades romandran minimitzades, no es restauraran.

Capítol 5. Connectors
Connectors

# Capítol 5. Connectors

## Referència dels connectors

### Índex alfabètic

### a

about (Quant al Kwave)
amplifyfree (Amplifica amb llibertat)

### b

band_pass (Filtre passabanda)

### c

codec_ascii (Còdec ASCII)
codec_audiofile (Còdec Audiofile)
codec_flac (Còdec FLAC)
codec_mp3 (Còdec MP3)
codec_ogg (Còdec Ogg)
codec_wav (Còdec WAV)

### d

debug (Funcions de depuració)

### e

export_k3b (Exporta a un projecte del K3b)

### f

fileinfo (Informació del fitxer)

### g

goto (Ves a la posició)

### i

insert_at (Insereix a)

### l

lowpass (Filtre passabaix)

### n

newsignal (Senyal nou)
noise (Generador de soroll)
normalize (Normalitzador)
notch_filter (Filtre de supressió de la banda)

### p

pitch_shift (Desplaça el to)
playback (Reproducció)

### r

record (Enregistra)
reverse (Inverteix)

### s

samplerate (Conversió de la freqüència de mostreig)
saveblocks (Desa els blocs)
selectrange (Selecciona l'interval)
sonagram (Sonograma)
stringenter (Introdueix una ordre)

### v

volume (Volum)

### z

zero (Generador de zeros)

``

about (Quant al Kwave)
about (Quant al Kwave)

## about (Quant al Kwave)

Nom intern:

  `about`

Tipus de connector:

  IGU

Descripció:

  Mostra una finestra amb múltiples pestanyes, incloent-hi la informació següent:

  - informació general sobre el programa

  - autors, col·laboradors i titulars dels drets d'autor

  - tots els connectors trobats incloent les seves versions i autors

  - informació sobre l'equip de traducció

  - informació sobre els drets d'autor i la llicència

amplifyfree (Amplifica amb llibertat)
amplifyfree (Amplifica amb llibertat)

## amplifyfree (Amplifica amb llibertat)

Nom intern:

  `amplifyfree`

Tipus de connector:

  efecte

Descripció:

  Amplifica la selecció actual amb una corba que consisteix en un conjunt de coordenades i un mètode d'interpolació. Les coordenades dels eixos de temps i d'amplitud hauran d'estar normalitzats entre 0,0 i 1,0.

Paràmetres:
  `operació`

    Nom intern, per a desfer/refer manualment. Els valors possibles són:

    Paraula clau | Descripció
    --- | ---
    fade in | esvaeix l'entrada, corba des de 0,0/0,0 a 1,0/1,0
    fade out | esvaeix la sortida, corba des de 0,0/1,0 a 1,0/0,0
    fade intro | introducció amb esvaïment, un segon de pausa, després esvaeix l'entrada
    fade outro | sortida amb esvaïment, primer esvaeix la sortida, després un segon de pausa
    amplify free | corba definida per l'usuari

  `interpolació`

    Tipus d'interpolació, els valors possibles són:

    Paraula clau | Descripció
    --- | ---
    linear | Lineal
    spline | Línia amb corbes
    n-polynom | Polinomi de N grau
    3-polynom | Polinomi de 3r grau
    5-polynom | Polinomi de 5è grau
    7-polynom | Polinomi de 7è grau
    sample_hold | Mostreig i retenció

  `corba`

    Una llista separada per comes de parells de coordenades, establerta entre 0,0 i 1,0, haurà d'estar ordenada per l'eix de temps (ascendent), hauria de començar amb el temps 0,0 i acabar amb el temps 1,0.

band_pass (Filtre passabanda)
band_pass (Filtre passabanda)

## band_pass (Filtre passabanda)

Nom intern:

  `band_pass`

Tipus de connector:

  efecte

Descripció:

  Aplica un filtre passabanda senzill a la selecció actual. Un passabanda permet un cert interval de freqüències al voltant un pas de freqüència central i filtra (elimina) les freqüències que estan per sota o per sobre de la freqüència central en més de la meitat de l'amplada de banda del filtre.

  El filtre té el grau dos i s'implementa tal com es descriu al llibre «An introduction to digital filter theory» (Una introducció a la teoria del filtratge digital) de Smith, Julius O. i al llibre de Moore, on s'utilitza la versió normalitzada del llibre de Moore.

Paràmetres:
  `freqüència`

    La freqüència del centre del filtre en Hz, haurà de ser inferior a la meitat de la freqüència de mostreig del fitxer.

  `amplada de banda`

    Amplada de banda del filtre en Hz.

codec_ascii (Còdec ASCII)
codec_ascii (Còdec ASCII)

## codec_ascii (Còdec ASCII)

Nom intern:

  `codec_ascii`

Tipus de connector:

  còdec

Tipus de fitxers admesos:

  Descripció: | Àudio codificat en ASCII
  Extensions de fitxer: | `*.ascii`
  Tipus MIME: | `audio/x-audio-ascii`

Metadades admeses:

  (Tots els elements d'informació de fitxer coneguts, vegeu la secció Informació del fitxer).

codec_audiofile (Còdec Audiofile)
codec_audiofile (Còdec Audiofile)

## codec_audiofile (Còdec Audiofile)

Nom intern:

  `codec_audiofile`

Tipus de connector:

  còdec [només importa]

Tipus de fitxers admesos:

  Descripció: | Format de fitxers de so IFF/8SVX de l'Amiga
  Extensions de fitxer: | `*.8svx` | `*.iff`
  Tipus MIME: | `audio/x-8svx`

  Descripció: | Àudio en NeXT de Sun
  Extensions de fitxer: | `*.au`, `*.snd`
  Tipus MIME: | `audio/basic`

  Descripció: | Format d'intercanvi d'àudio comprimit
  Extensions de fitxer: | `*.aifc`
  Tipus MIME: | `audio/x-aifc`

  Descripció: | Format d'intercanvi d'àudio
  Extensions de fitxer: | `*.aif`, `*.aiff`
  Tipus MIME: | `audio/x-aiff`

  Descripció: | Format de fitxer per a la investigació visual de l'àudio
  Extensions de fitxer: | `*.avr`
  Tipus MIME: | `audio/x-avr`

  Descripció: | Format de fitxer Core Audio
  Extensions de fitxer: | `*.caf`
  Tipus MIME: | `audio/x-caf`

  Descripció: | Format de so de Berkeley, IRCAM, Carl
  Extensions de fitxer: | `*.sf`
  Tipus MIME: | `audio/x-ircam`

  Descripció: | Format de fitxer d'àudio NIST SPHERE
  Extensions de fitxer: | `*.nist`
  Tipus MIME: | `audio/x-nist`

  Descripció: | Format visual pel mostratge
  Extensions de fitxer: | `*.smp`
  Tipus MIME: | `audio/x-smp`

  Descripció: | Creative Voice
  Extensions de fitxer: | `*.voc`
  Tipus MIME: | `audio/x-voc`

Metadades admeses:

  (Cap)

codec_flac (Còdec FLAC)
codec_flac (Còdec FLAC)

## codec_flac (Còdec FLAC)

Nom intern:

  `codec_flac`

Tipus de connector:

  còdec

Tipus de fitxers admesos:

  Descripció: | Àudio FLAC (còdec d'àudio lliure sense pèrdues)
  Extensions de fitxer: | `*.flac`
  Tipus MIME: | `audio/x-flac`

Metadades admeses:

  Data, Nom, Versió, Àlbum, Pista, Autor, Intèrpret, Drets d'ús, Llicència, Organizació, Assumpte, Gènere, Origen, Contacte, ISRC, Programari, Enginyer, Qualitat base

codec_mp3 (Còdec MP3)
codec_mp3 (Còdec MP3)

## codec_mp3 (Còdec MP3)

Nom intern:

  `codec_mp3`

Tipus de connector:

  còdec

Tipus de fitxers admesos:

  Descripció: | Àudio en MPEG de capa III
  Extensions de fitxer: | `*.mp3`
  Tipus MIME: | `audio/x-mp3`, `audio/mpeg`s

  Descripció: | Àudio en MPEG de capa II
  Extensions de fitxer: | `*.mp2`
  Tipus MIME: | `audio/x-mp2`, `audio/mpeg`

  Descripció: | Àudio en MPEG de capa I
  Extensions de fitxer: | `*.mp1`, `*.mpg`, `*.mpga`
  Tipus MIME: | `audio/x-mpga`, `audio/mpeg`

Metadades admeses:

  Àlbum, Anotació, Autor, CD, els CD, Comentaris, Per encàrrec de, Contacte, Drets d'ús, Data, Gènere, ISRC, Durada, Llicència, Suport, Nom, Organizació, Intèrpret, Programari, Tècnic, Pista, Pistes, Versió

codec_ogg (Còdec Ogg)
codec_ogg (Còdec Ogg)

## codec_ogg (Còdec Ogg)

Nom intern:

  `codec_ogg`

Tipus de connector:

  còdec

Tipus de fitxers admesos:

  Descripció: | Àudio en Ogg Opus
  Extensions de fitxer: | `*.opus`
  Tipus MIME: | `audio/ogg`, `application/ogg`, `audio/opus`

  Descripció: | Àudio en Ogg Vorbis
  Extensions de fitxer: | `*.ogg`
  Tipus MIME: | `audio/ogg`, `audio/x-ogg`, `application/x-ogg`, `audio/x-vorbis+ogg`

Metadades admeses:

  Àlbum, Autor, Contacte, Drets d'ús, Data, Enginyer, Gènere, ISRC, Llicència, Nom, Organizació, Intèrpret, Programari, Origen, Assumpte, Pista, Qualitat base, Versió,

codec_wav (Còdec WAV)
codec_wav (Còdec WAV)

## codec_wav (Còdec WAV)

Nom intern:

  `codec_wav`

Tipus de connector:

  còdec

Tipus de fitxers admesos:

  Descripció: | Àudio WAV
  Extensions de fitxer: | `*.wav`
  Tipus MIME: | `audio/x-wav`, `audio/vnd.wave`, `audio/wav`

Metadades admeses:

  Àlbum, Anotació, Ubicació de l'arxiu, Autor, CD, Comentaris, Per encàrrec de, Contacte, Drets d'ús, Data, Enginyer, Gènere, ISRC, Paraules clau, Llicència, Suport, Nom, Organizació, Intèrpret, Producte, Programari, Origen, Format d'origen, Assumpte, Tècnic, Pista, Versió,

debug (Funcions de depuració)
debug (Funcions de depuració)

## debug (Funcions de depuració)

Nom intern:

  `debug`

Tipus de connector:

  funció

Descripció:

  Proporciona diverses ordres internes útils per a la depuració i la creació de scripts del Kwave. Aquestes característiques només estaran disponibles a través del menú principal si el Kwave s'ha compilat en el mode de depuració (construït amb l'opció CMAKE_WITH_DEBUG).

Ordres:

  window:click, window:close window:mousemove, window:resize, window:screenshot, window:sendkey

export_k3b (Exporta a un projecte del K3b)
export_k3b (Exporta a un projecte del K3b)

## export_k3b (Exporta a un projecte del K3b)

Nom intern:

  `export_k3b`

Tipus de connector:

  funció

Descripció:

  Desa totes les seccions entre marcadors en un fitxer a part i crea un fitxer de projecte del K3b. Després d'haver escrit correctament tots els fitxers, és possible iniciar el K3b i gravar el resultat en un CD d'àudio. Això és útil per a dividir un fitxer amb una gravació que consta de diverses parts, les quals estan separades per etiquetes, i després es graven en un CD d'àudio amb múltiples pistes, incloses les metadades de text del CD que s'extrauran de les descripcions de les etiquetes.

  (Aquest connector utilitza internament el connector saveblocks (Desa els blocs)).

Paràmetres:
  `patró`

    Un patró que s'utilitzarà per a detectar el títol i l'artista a partir de l'etiqueta al començament d'una secció. Això admet els comodins següents que se substituiran pel contingut corresponent quan es creïn les metadades de text del CD:

    Comodí | Descripció
    --- | ---
    [%artist] | Serà substituït per l'artista que realitzés el bloc corresponent o, de manera alternativa, l'autor.
    [%title] | Serà substituït amb el títol del bloc, el qual s'extraurà a partir del text descriptiu de l'etiqueta al començament del bloc. Si aquest text està buit, es tornarà al títol del fitxer (vegeu l'element Nom d'informació del fitxer). Si tampoc existeix, es tornarà al nom del fitxer base tal com s'ha descrit anteriorment.

    Exemple: «`[%title] ([%artist])`» detectarà a l'autor «`Beethoven`» i el títol «`Simfonia núm. 5`» a partir de la cadena «`Simfonia núm. 5 (Beethoven)`».

  `només la selecció`

    Valor | Descripció
    --- | ---
    0 | Desa totes les seccions de tot el fitxer.
    1 | Només desa les seccions que es troben dins de la selecció actual. Si no se selecciona res, es desarà tot el fitxer.

  `fitxer del projecte`

    El nom del fitxer del projecte K3b, el qual també s'utilitzarà com el nom base per als noms dels fitxers exportats.

  `exporta la ubicació`

    La ubicació a on s'hauran de desar els blocs.

  `política de sobreescriptura`

    Determina a on haurà de començar la numeració.

    Valor | Descripció
    --- | ---
    0 | Sempre comença amb l'índex 1, amb el risc de sobreescriure els fitxers existents.
    1 | Continua després de l'índex de l'índex més alt que ja existeix, això evita sobreescriure els fitxers existents.

fileinfo (Informació del fitxer)
fileinfo (Informació del fitxer)

## fileinfo (Informació del fitxer)

Nom intern:

  `fileinfo`

Tipus de connector:

  IGU

Descripció:

  Proporciona un diàleg per a veure i canviar els paràmetres i metadades del fitxer obert. Vegeu la secció Propietats del fitxer d'aquest manual.

goto (Ves a la posició)
goto (Ves a la posició)

## goto (Ves a la posició)

Nom intern:

  `goto`

Tipus de connector:

  funció

Descripció:

  Mostra un diàleg amb la possibilitat d'establir la posició actual de la selecció a un valor nou, ja sigui en mil·lisegons, en una posició en mostres o en un percentatge de la longitud del fitxer actual.

Ordres:

  goto

Paràmetres:
  `mode`

    Valor | Descripció
    --- | ---
    0 | la posició s'indica en mil·lisegons
    1 | la posició s'indica en mostres
    2 | la posició s'indica en un percentatge de la longitud del fitxer

  `posició`

    posició ves a, en mil·lisegons, mostres o percentatge de la longitud del fitxer, depenent del `mode` del paràmetre.

insert_at (Insereix a)
insert_at (Insereix a)

## insert_at (Insereix a)

Nom intern:

  `insert_at`

Tipus de connector:

  funció

Descripció:

  Similar al connector goto (Ves a la posició), però mostra un diàleg amb la possibilitat d'inserir el contingut actual del porta-retalls en una posició indicada, ja sigui en mil·lisegons, en una posició en mostres o en un percentatge de la longitud del fitxer actual.

Ordres:

  insert_at

Paràmetres:
  `mode`

    Valor | Descripció
    --- | ---
    0 | la posició s'indica en mil·lisegons
    1 | la posició s'indica en mostres
    2 | la posició s'indica en un percentatge de la longitud del fitxer

  `posició`

    Posició on inserir les dades del porta-retalls, en mil·lisegons, mostres o percentatge de la longitud del fitxer, depenent del `mode` del paràmetre.

lowpass (Filtre passabaix)
lowpass (Filtre passabaix)

## lowpass (Filtre passabaix)

Nom intern:

  `lowpass`

Tipus de connector:

  efecte

Descripció:

  S'aplica un filtre passabaix senzill a la selecció actual. Un filtre passabaix permet freqüències per sota d'un pas de freqüència de la vora i filtrarà (eliminarà) les freqüències que estan per sobre de la freqüència de la vora.

  El filtre té el grau dos i s'ha implementat tal com es descriu al llibre «The manifold joys of conformal mapping, applications to digital filtering in the studio (Les múltiples alegries del mapatge conforme, les aplicacions de filtratge digital a l'estudi) per Moorer, James A. (JAES, Vol. 31, Núm. 11, novembre de 1983).

Paràmetres:
  `freqüència`

    La freqüència de la vora del filtre passabaix en Hz.

newsignal (Senyal nou)
newsignal (Senyal nou)

## newsignal (Senyal nou)

Nom intern:

  `newsignal`

Tipus de connector:

  funció

Descripció:

  Proporciona un diàleg per a crear un fitxer nou. Per a obtenir més informació, consulteu la secció Crear un fitxer nou que hi ha en aquest manual.

Ordres:

  newsignal,

noise (Generador de soroll)
noise (Generador de soroll)

## noise (Generador de soroll)

Nom intern:

  `noise`

Tipus de connector:

  efecte

Descripció:

  Afegeix una mica de soroll blanc a la selecció actual. La quantitat de soroll es pot seleccionar entre zero (sense soroll, l'original romandrà sense canvis) i un (l'original serà substituït per un 100% de soroll).

Paràmetres:
  `nivell`

    Nivell de soroll, sempre haurà de ser un nombre de coma flotant per sobre de zero i per sota o igual que u.

  `mode`

    Valor | Descripció
    --- | ---
    0 | Introduïu el valor de soroll com a percentatge de l'amplitud, des de 0 a 100.
    1 | Introduïu el soroll en decibels, des de -21 dB a 0 dB.

normalize (Normalitzador)
normalize (Normalitzador)

## normalize (Normalitzador)

Nom intern:

  `normalize`

Tipus de connector:

  efecte

Descripció:

  Normalitza el nivell de volum de la selecció actual. Feu-lo servir si el volum del senyal és massa baix o massa alt.

  L'algorisme es pren del projecte normalize, i va ser escrit originalment Vaill, Chris.

notch_filter (Filtre de supressió de la banda)
notch_filter (Filtre de supressió de la banda)

## notch_filter (Filtre de supressió de la banda)

Nom intern:

  `notch_filter`

Tipus de connector:

  efecte

Descripció:

  Aplica un filtre de supressió de la banda a la selecció actual. Aquest filtre suprimeix un petit interval de freqüències al voltant d'una freqüència central sense afectar la resta de freqüències que hi ha per sota i per sobre de la freqüència central més de la meitat de l'amplada de banda del filtre.

  Feu-lo servir per a filtrar (eliminar) freqüències de distorsió úniques.

  El filtre té grau dos i es basa en la implementació d'en Sadeharju, Juhana.

Paràmetres:
  `freqüència`

    La freqüència del centre del filtre en Hz, haurà de ser inferior a la meitat de la freqüència de mostreig del fitxer.

  `amplada de banda`

    Amplada de banda del filtre en Hz.

pitch_shift (Desplaça el to)
pitch_shift (Desplaça el to)

## pitch_shift (Desplaça el to)

Nom intern:

  `pitch_shift`

Tipus de connector:

  efecte

Descripció:

  L'efecte desplaça el to, modifica el senyal canviant la velocitat del contingut, però mantenint la longitud original. Podeu seleccionar la velocitat relativa en un factor d'1/10 fins al x5, o utilitzant un percentatge des de l'1% fins al 400% de la velocitat original.

  Un factor de velocitat més petit que 1,0 farà més greu el senyal (fa que les veus sonin més velles), el factor 1,0 no modificarà el senyal i un factor per sobre d'1,0 farà més agut el senyal (efecte «Mickey Mouse»).

  La implementació es basa en el treball d'en Tranter, Jeff i Westerfeld, Stefan.

Paràmetres:
  `velocitat`

    Factor per a canviar la velocitat, haurà de ser un nombre de coma flotant entre 0,001 i 4,0.

  `freqüència`

    La freqüència utilitzada internament pel filtre en Hz, haurà d'estar entre 2,0 i 10,0.

  `mode`

    Valor | Descripció
    --- | ---
    0 | Introduïu el valor de la velocitat com a factor a partir d'1/10 fins al x5.
    1 | Introduïu el valor de la velocitat com a percentatge a partir d'1 fins al 400.

playback (Reproducció)
playback (Reproducció)

## playback (Reproducció)

Nom intern:

  `playback`

Tipus de connector:

  funció

Descripció:

  Proporciona un diàleg per a configurar els paràmetres de la reproducció. Per a obtenir més informació, consulteu la secció Reproducció que hi ha en aquest manual.

Paràmetres:
  `mètode de reproducció`

    El mètode utilitzat per a la reproducció, vegeu `PlayBackParam.h`.

  `dispositiu de reproducció`

    Una cadena que determina el dispositiu o canal de reproducció. El significat dependrà del mètode de reproducció.

  `canals`

    El nombre de canals a utilitzar per a la reproducció, actualment només admet 1 (mono) o 2 (estèreo).

  `bits per mostra`

    El nombre de bits per mostra per a la reproducció, hauran de ser de 8, 16, 24 o 32. Dependrà del mètode de reproducció i del dispositiu de reproducció.

  `mida de la memòria intermèdia`

    Determina la mida de la memòria intermèdia per a la reproducció, utilitzada com a exponent per a calcular la mida real de la memòria intermèdia com 2^n, p. ex., establint això a 16 donarà una mida de memòria intermèdia de 2^16 = 64 kB.

record (Enregistra)
record (Enregistra)

## record (Enregistra)

Nom intern:

  `record`

Tipus de connector:

  funció

Descripció:

  Proporciona un diàleg per a configurar els paràmetres de l'enregistrament i fer un enregistrament. Per a obtenir més informació, consulteu la secció Enregistrament que hi ha en aquest manual.

Paràmetres:
  `mètode d'enregistrament`

    El mètode utilitzat per a l'enregistrament, vegeu `RecordParams.h`.

  `preenregistrament habilitat`

    Habilita/inhabilita el preenregistrament (1 si està habilitat, 0 si està inhabilitat).

  `temps a preenregistrar`

    Nombre de segons per al preenregistrament.

  `limita el temps a enregistrar`

    Habilita/inhabilita la limitació del temps a enregistrar (1 si està limitat, 0 si no ho està).

  `temps a enregistrar`

    Durada de l'enregistrament en segons.

  `utilitza l'hora de començar`

    Habilita/inhabilita l'hora de començar (1 si s'utilitza, 0 si no s'utilitza).

  `hora de començar`

    Data/hora per a començar l'enregistrament, en el format ISO.

  `utilitza el nivell de detecció`

    Habilita/inhabilita el nivell de detecció (1 si s'utilitza, 0 si no s'utilitza).

  `nivell de detecció`

    Nivell de detecció en percentatge.

  `dispositiu d'enregistrament`

    Una cadena que determina el dispositiu d'enregistrament.

  `canals`

    El nombre de canals que s'utilitzaran per a enregistrar.

  `freqüència de mostreig`

    Freqüència de mostreig en mostres per segon.

  `compressió`

    Compressió a utilitzar per a emmagatzemar les mostres.

  `format de la mostra`

    El format de la mostra que s'utilitzarà per a emmagatzemar les mostres, vegeu la secció sobre formats de mostra.

  `bits per mostra`

    El nombre de bits per mostra per a l'enregistrament, haurà de ser de 8, 16, 24 o 32.

  `nombre de memòries intermèdies`

    Determina el nombre de memòries intermèdies utilitzades per a l'enregistrament.

  `mida de la memòria intermèdia`

    Determina la mida de la memòria intermèdia per a l'enregistrament, utilitzada com a exponent per a calcular la mida real de la memòria intermèdia com 2^n, p. ex., establint això a 16 donarà una mida de memòria intermèdia de 2^16 = 64 kB.

Paràmetres alternatius:
  `mode directe del connector d'enregistrament`

    Es pot utilitzar com un paràmetre únic per a configurar el connector. Es permeten els valors següents:

    Valor | Descripció
    --- | ---
    format | Obre el diàleg d'enregistrament i selecciona la pestanya Format.
    source | Obre el diàleg d'enregistrament i selecciona la pestanya Origen.
    start_now | Obre el diàleg d'enregistrament i comença amb aquesta.

reverse (Inverteix)
reverse (Inverteix)

## reverse (Inverteix)

Nom intern:

  `reverse`

Tipus de connector:

  efecte

Descripció:

  Aquest senzill efecte inverteix el contingut de la selecció actual.

samplerate (Conversió de la freqüència de mostreig)
samplerate (Conversió de la freqüència de mostreig)

## samplerate (Conversió de la freqüència de mostreig)

Nom intern:

  `samplerate`

Tipus de connector:

  efecte

Descripció:

  Canvia la freqüència de mostreig de la selecció actual o de tot el senyal.

Paràmetres:
  `freqüència nova`

    La freqüència nova de mostreig en mostres per segon (valor en coma flotant).

  `mode` (opcional)

    Si s'utilitza aquest paràmetre i està establert al valor «`all`», llavors aquest efecte s'aplicarà a tot el senyal. Si no, només s'aplicarà a la secció actual.

saveblocks (Desa els blocs)
saveblocks (Desa els blocs)

## saveblocks (Desa els blocs)

Nom intern:

  `saveblocks`

Tipus de connector:

  funció

Descripció:

  Desa totes les seccions entre els marcadors, cadascuna dins de fitxers separats. A cada fitxer se li dona un nom que es pot personalitzar utilitzant un patró que pot contenir el nom del fitxer original, un índex i el nombre de seccions.

  Es permet que el patró del nom de fitxer contingui barres com a separadors del camí, permetent desar les seccions en diferents subdirectoris. Tingueu en compte que tots els espais al voltant d'aquests separadors de camí seran eliminats silenciosament, evitant crear noms de directori que comencin o acabin amb un espai en blanc.

Paràmetres:
  `patró`

    Un patró que s'utilitzarà per a crear els noms dels fitxers. Pot contenir els comodins següents que seran substituïts pel contingut corresponent en crear el nom final dels fitxers:

    Comodí | Descripció
    --- | ---
    [%nr] | Se substituirà amb l'índex actual del fitxer a desar.
    [%count] | Se substituirà amb el nombre de seccions que es desaran.
    [%total] | Se substituirà amb l'índex de l'últim fitxer a desar.
    [%filename] | Se substituirà amb el nom del fitxer, sense camí i sense extensió.
    [%fileinfo{`paraula_clau`}] | Se substituirà amb el contingut d'un fitxer d'informació identificat per la `paraula clau`. Vegeu la secció Informació del fitxer per a veure una llista completa de les paraules clau disponibles.
    [%title] | Serà substituït amb el títol del bloc, el qual s'extraurà a partir del text descriptiu de l'etiqueta al començament del bloc. Si aquest text està buit, es tornarà al títol del fitxer (vegeu l'element Nom d'informació del fitxer). Si tampoc existeix, es tornarà al nom del fitxer base tal com s'ha descrit anteriorment.

    Tots els comodins numèrics poden contenir un argument numèric després del «`%`» i l'identificador, per a forçar un determinat nombre de dígits. Si el número és precedit per un 0, llavors el resultat contindrà zeros precedents, en qualsevol altre cas contindrà espais precedents.

    Exemple: `[%04nr]` produeix un número entre el 0001 i el 9999.

  `mode de la numeració`

    Determina a on haurà de començar la numeració.

    Valor | Descripció
    --- | ---
    0 | Continua després de l'índex de l'índex més alt que ja existeix, això evita sobreescriure els fitxers existents.
    1 | Sempre comença amb l'índex 1, amb el risc de sobreescriure els fitxers existents.

  `extensió`

    L'extensió del nom de fitxer a usar per als blocs desats. Això determina quina codificació s'utilitza.

  `exporta la ubicació`

    La ubicació a on exportar els blocs desats.

  `només la selecció`

    Valor | Descripció
    --- | ---
    0 | Desa totes les seccions de tot el fitxer.
    1 | Només desa les seccions que es troben dins de la selecció actual. Si no se selecciona res, es desarà tot el fitxer.

selectrange (Selecciona l'interval)
selectrange (Selecciona l'interval)

## selectrange (Selecciona l'interval)

Nom intern:

  `selectrange`

Tipus de connector:

  funció

Descripció:

  Mostra un diàleg per a seleccionar l'interval de mostres. El començament i la longitud de la selecció pot establir-se com un temps en mil·lisegons, en mostres o com a un percentatge de la longitud total del fitxer.

Paràmetres:
  `mode en començar`

    Determina les unitats en què s'indicarà el començament de la selecció.

    Valor | Descripció
    --- | ---
    0 | mil·lisegons
    1 | mostres
    2 | percentatge de longitud del fitxer

  `mode de l'interval`

    Determina les unitats en què s'indicarà la longitud de la selecció. Vegeu la descripció del paràmetre `mode per a començar` per a una llista dels valors possibles.

  `comença`

    El començament de la selecció, en mil·lisegons, mostres o percentatge de la longitud del fitxer, depenent del paràmetre `mode per a l'interval`.

  `longitud`

    La longitud de la selecció, en mil·lisegons, mostres o percentatge de la longitud del fitxer, depenent del paràmetre `mode per a l'interval`.

sonagram (Sonograma)
sonagram (Sonograma)

## sonagram (Sonograma)

Nom intern:

  `sonagram`

Tipus de connector:

  funció

Descripció:

  Avalua la selecció actual generant un sonograma. Un sonograma és una avaluació del senyal en el temps (eix x), la freqüència (eix y) i la intensitat (color).

Paràmetres:
  `punts de la FFT`

    Nombre de punts de la FFT, un nombre enter entre el 4 i el 32767, el qual determina la resolució de la freqüència.

  `funció de la finestra`

    La funció de la finestra utilitzada per al càlcul de la FFT, els valors admesos són:

    Valor | Descripció
    --- | ---
    cap | Sense funció de la finestra
    hamming | Finestra de Hamming
    hanning | Finestra de Hanning
    blackman | Finestra de Blackman
    triangular | Finestra triangular

  `utilitza els colors`

    Si s'estableix a un valor diferent de 0, utilitzarà colors per a la intensitat, si s'estableix a 0, utilitzarà una escala de grisos.

  `segueix els canvis`

    Si s'estableix a un valor diferent de 0, el sonograma serà actualitzat quan l'àrea avaluada hagi canviat. Si s'estableix a un valor de 0, no s'actualitzarà mai.

  `segueix els seleccionats`

    Encara no està implementat, utilitzeu 0 per aquest paràmetre.

stringenter (Introdueix una ordre)
stringenter (Introdueix una ordre)

## stringenter (Introdueix una ordre)

Nom intern:

  `stringenter`

Tipus de connector:

  funció

Descripció:

  Un petit diàleg que permet introduir una ordre de text al Kwave. Vegeu el capítol Referència d'ordres que hi ha en aquest manual.

Paràmetres:
  `valor predefinit` (opcional)

    Un text que es mostrarà en el camp d'edició quan aparegui el diàleg. Aquest paràmetre és opcional, si s'omet, el camp d'edició del diàleg apareixerà buit.

volume (Volum)
volume (Volum)

## volume (Volum)

Nom intern:

  `volume`

Tipus de connector:

  efecte

Descripció:

  Amb aquest connector podreu canviar el volum de la secció actual per un factor constant. El diàleg corresponent permetrà introduir aquest factor com un factor numèric indicat com un valor en coma flotant entre el 0.10 i el 10.0, un percentatge entre l'1 i el 1000, o en decibels entre -21 i +21.

  Utilitza un factor més gran que 1,0 (o un percentatge per sobre de 100 o més de 0 dB) si el fitxer és molt silenciós, o un factor per sota d'1,0 (percentatge per sota de 100 o menys que 0 dB) si el fitxer massa sorollós.

Paràmetres:
  `factor`

    Un valor en coma flotant amb el factor d'amplificació.

  `mode`

    Valor | Descripció
    --- | ---
    0 | factor
    1 | percentatge
    1 | decibel

zero (Generador de zeros)
zero (Generador de zeros)

## zero (Generador de zeros)

Nom intern:

  `zero`

Tipus de connector:

  efecte

Descripció:

  Aquest connector té dos modes de funcionament. Si s'utilitza sense paràmetres, s'esborrarà la selecció actual sobreescrivint-la en silenci. Quan s'utilitza amb dos paràmetres, s'inserirà una quantitat de silenci al començament de la selecció actual.

Paràmetres:
  `mode de la durada`

    Determina les unitats en què s'indicarà la durada del silenci inserit.

    Valor | Descripció
    --- | ---
    0 | mil·lisegons
    1 | mostres
    2 | percentatge de longitud del fitxer

  `longitud`

    La durada del silenci a inserir en mil·lisegons, mostres o percentatge de la longitud del fitxer, depenent del paràmetre `mode per a la durada`.

Capítol 6. Preguntes i respostes
Preguntes i respostes

# Capítol 6. Preguntes i respostes

6.1. Què em cal per a compilar el Kwave?
6.2. Quines targetes de so admet el Kwave?
6.3. Per què el Kwave consumeix més memòria de la que es podria esperar per la mida del fitxer obert?
6.4. Quins formats de so admet el Kwave?
6.5. Què passa si tinc fitxers amb un format no admès pel Kwave?
6.6. Obtinc errors quan vull fer la reproducció.
6.7. La reproducció sembla funcionar però no sento res.
6.8. Alguns fitxers són reproduïts a la meitat de la seva velocitat normal.
6.9. La reproducció algunes vegades és alterada i interrompuda.
6.10. La reproducció no s'atura immediatament en prémer el botó Atura.
6.11. S'admet l'ALSA?
6.12. És possible reproduir amb 18, 20, 24 o 32 bits per mostra o més de dos canals?

6.1. | Què em cal per a compilar el Kwave?
| Llegiu-ho a la documentació del desenvolupador.
6.2. | Quines targetes de so admet el Kwave?
| El Kwave no necessita admetre cap targeta de so en particular. La targeta de so només haurà d'estar admesa pel vostre sistema operatiu i el Kwave l'utilitzarà la seva interfície al controlador de so del sistema operatiu mitjançant una interfície ALSA, PulseAudio, Qt o OSS.
6.3. | Per què el Kwave consumeix més memòria de la que es podria esperar per la mida del fitxer obert?
| La raó per això, és que el Kwave emmagatzema internament totes les mostres en enters de 32 bits. Això va ser molt més fàcil de programar, va fer que l'aplicació fos més ràpida i una mica més fiable. De manera que si es carrega un fitxer de 8 bits d'un megabyte, consumirà sobre els 4 megabytes. Potser canviarem això en algun moment en el futur...
6.4. | Quins formats de so admet el Kwave?
| El Kwave actualment admet els fitxers .wav amb 8, 16 i 24 bits per mostra, amb qualsevol nombre de canals (per descomptat incloent el mono i estèreo). A més, pot importar tots els tipus de fitxer que admet la «libaudiofile» i altres formats com Ogg/Vorbis i MP3.
6.5. | Què passa si tinc fitxers amb un format no admès pel Kwave?
| Si heu de treballar amb diferents formats, podeu convertir-los al format .wav. Un bon conjunt d'eines per a aquesta finalitat és el paquet SoX, el qual disposa d'una bona documentació.
6.6. | Obtinc errors quan vull fer la reproducció.

Potser heu escollit una combinació de freqüència de reproducció i grandària de la mostra que no està admesa pel vostre controlador de so i/o maquinari. Proveu reproduint amb 8 bits per mostra i en mono, això hauria de funcionar sempre. Després intenteu incrementar el nombre de bits per mostra i canvieu a estèreo pas a pas. Tingueu en compte que certes freqüències de reproducció no estan admeses per algunes targetes de so.

6.7. | La reproducció sembla funcionar però no sento res.
| Potser heu oblidat incrementar el volum del canal reproduït. El Kwave no és responsable de canviar el volum de la reproducció.
6.8. | Alguns fitxers són reproduïts a la meitat de la seva velocitat normal.
| Proveu escollint un altre dispositiu de reproducció.
6.9. | La reproducció algunes vegades és alterada i interrompuda.
| Hauríeu d'incrementar la mida de la memòria intermèdia de la reproducció per a obtenir una reproducció més «suau» (això també farà que els controls de la reproducció responguin una mica més lentament).
6.10. | La reproducció no s'atura immediatament en prémer el botó Atura.
| La raó d'això és que el controlador de so ja ha rebut algunes dades de reproducció des del Kwave en el moment en què premeu el botó Atura. Disminuint la mida de la memòria intermèdia de la reproducció hauria de provocar una resposta més ràpida (tot i que pot provocar interrupcions en la reproducció).
6.11. | S'admet l'ALSA?
| Sí, des de la versió 0.7.4 per a reproduir i enregistrar.
6.12. | És possible reproduir amb 18, 20, 24 o 32 bits per mostra o més de dos canals?
| Això és possible a través de la interfície ALSA des de la versió 0.7.4.

Capítol 7. Crèdits i llicència
Crèdits i llicència

# Capítol 7. Crèdits i llicència

Kwave

Copyright del programa 1998-2000 Martin Wilz `(martin AT wilz.de)`

Copyright del programa des de 2000 Thomas Eschenbacher `(thomas.eschenbacher AT gmx.de)`

Per a una llista completa dels autors i llicències de tots els fitxers, consulteu el fitxer `LICENSES`, el qual està inclòs en les fonts. També hi ha un fitxer amb el nom `AUTHORS`, el qual llista tots els autors i col·laboradors del Kwave.

Copyright de la documentació (C) 2020 Thomas Eschenbacher `(thomas.eschenbacher AT gmx.de)`

Copyright de la documentació (C) 2024 Mark Penner `(mrp AT markpenner.space)`

Traductor de la documentació: Antoni Bella `(antonibella5 AT yahoo.com)`

Aquesta documentació està llicenciada d'acord amb les clàusules de la Llicència de Documentació Lliure de GNU.

Aquest programa està llicenciat d'acord amb les clàusules de la Llicència Pública General de GNU.

## Autors principals

- Martin Wilz `(martin AT wilz.de)`

  Creador del projecte, desenvolupador 1998-2000

- Thomas Eschenbacher `(thomas.eschenbacher AT gmx.de)`

  Mantenidor des de 2000, desenvolupador principal

Col·laboradors principals
Col·laboradors principals

## Col·laboradors principals

- Aurelien Jarno `(aurel32 AT debian.org)`

  Empaquetador de la Debian, pedaços

- Carlos R `(pureacetone AT gmail.com)`

  Traducció al castellà

- David Flogeras `(dflogera AT nbnet.nb.ca)`

  Connector del filtre supressió de la banda

- Gilles Caulier `(caulier.gilles AT free.fr)`

  i18n, traducció al francès, pantalla de presentació, provador de les versions beta

- Mark Penner `(mrp AT markpenner.space)`

  desenvolupament

- Pavel Fric `(pavelfric AT seznam.cz)`

  Traducció al txec

- Ralf Waspe `(rwaspe AT web.de)`

  Connector «Ajuda»/«Quant al»

- Sven-Steffen Arndt `(ssa29 AT gmx.de)`

  Pàgina d'inici, traducció a l'alemany

Col·laboradors menors, titulars dels drets d'autor i d'altres
Col·laboradors menors, titulars dels drets d'autor i d'altres

## Col·laboradors menors, titulars dels drets d'autor i d'altres

- Bertrand Songis `(bsongis AT gmail.com)` [històric]

  Correccions a la traducció al francès, substitucions per al codi patentat del «libaudiofile», error 419124 de Debian

- Carsten Lohrke `(carlo AT gentoo.org)`

  svn r2163, pedaç per a la detecció de «libaudiofile»

- Chris Vaill `(chrisvaill AT gmail)`

  Base del codi per al connector de normalització

- David Faure `(faure AT kde.org)`

  cmake/FindAlsa.cmake

- Diederick de Vries `(diederick76 AT gmail.com)`

  Empaquetatge per a la Crux Linux

- Espen Sand `(espen AT kde.org)` + Mirko Boehm `(mirko AT kde.org)`

  K3AboutContainer, base del KwaveAboutContainer

- Everaldo Coelho `(contact AT everaldo.com)`

  El tema d'icones Crystal http://www.everaldo.com/crystal/

- Jaroslav Kysela

  Parts de plugins/playback/PlayBack-ALSA.cpp

- Jeff Tranter

  Parts de plugins/pitch_shift/PitchShiftFilter.{h,cpp}

- Juhana Sadeharju `(kouhia AT nic.funet.fi)`

  plugins/band_pass/BandPass.{h,cpp}, plugins/lowpass/LowPassFilter.cpp, plugins/notch_filter/NotchFilter.{h,cpp}

- Kurt Roeck `(Q AT ping.be)`

  svn r1370, esmena per a l'error núm. 288781 de debian, compilació per a amd64

- Mark Donohoe (KDE) `(donohoe AT kde.org)`

  Algunes icones i mapes de bits per a la barra d'eines i la IGU

- Martin Hinsch `(vidas AT sourceforge.net)`

  La classe matrix

- Matthias Kretz `(kretz AT kde.org)`

  cmake/FindAlsa.cmake

- Richard Laerkaeng, `(richard AT goteborg.utfors.se)`

  cmake/FindOggVorbis.cmake

- Rik Hemsley `(rik AT kde.org)`

  Mesurador del nivell

- Stefan Westerfeld `(stefan AT space.twc.de)`

  Parts de plugins/pitch_shift/PitchShiftFilter.{h,cpp}

- Joerg-Christian Boehme `(joerg AT chaosdorf.de)`

  plugins/record/Record-PulseAudio.cpp plugins/record/Record-PulseAudio.h

- Sebastian Trueg `(trueg AT k3b.org)`, Gustavo Pichorim Boiko `(gustavo.boiko AT kdemail.net)`, Michal Malek `(michalm AT jabster.pl)`

  Parts de plugins/export_k3b/K3BExportPlugin.cpp

Gràcies a
Gràcies a

## Gràcies a

- Martin Kuball `(makube AT user.sourceforge.net)`

  Provador

- Jorge Luis Arzola `(arzolacub AT gmx.de)`

  Empaquetatge per a la SuSE Linux

- Michael Favreau `(michel.favreau AT free.fr)`

  Empaquetatge per a l'Arch Linux

- T.H.F. Klok i Cedric Tefft

  Mantenidors de la biblioteca id3lib

- Robert Leslie `(rob AT mars.org)`

  Autor de la biblioteca descodificadora mad d'MP3

- Robert M. Stockmann `(stock AT stokkie.net)`

  Empaquetador de la Mandrake / X86_64

- Erik de Castro Lopo `(erikd AT zip.com.au)`

  Autor de la biblioteca sndfile

- Michael Pruett `(mpruett AT sgi.com)`

  Autor de la biblioteca audiofile

Apèndix A. Informació del fitxer
Informació del fitxer

# Apèndix A. Informació del fitxer

Taula A.1. Llista d'identificadors d'informació del fitxer

Paraula clau |  | Descripció
--- | --- | ---
Àlbum |  | Nom de l'àlbum si l'origen és un àlbum que consisteix en més suports.
Anotació |  | Proporciona comentaris generals sobre el fitxer o el tema del fitxer. Si el comentari consisteix en diverses frases llargues, finalitzeu cada frase amb un punt. No incloure-hi caràcters de línia nova.
Ubicació de l'arxiu |  | Indica on s'arxiva el tema del fitxer.
Autor |  | Identifica el nom de l'autor del tema original del fitxer. Exemple: «van Beethoven, Ludwig»
Taxa de bits mínima |  | Especifica el límit baix en un flux de bits VBR.
Mode de la taxa de bits |  | Mode de la taxa de bits (ABR, VBR, CBR, etc.)
Taxa de bits |  | Taxa de bits nominal del flux d'àudio en bits per segon.
Taxa de bits màxima |  | Especifica el límit superior en un flux de bits VBR.
Bits per mostra |  | Especifica el nombre de bits per mostra.
CD |  | Número del CD, si l'origen és un àlbum amb més CD-ROM.
Els CD |  | Nombre de CD, si l'origen és un àlbum amb més CD-ROM.
Per encàrrec de |  | Llista el nom de la persona o organització que va encarregar el tema del fitxer.
Comentaris |  | Proporciona comentaris generals sobre el fitxer o el tema del fitxer. Si el comentari consisteix en diverses frases llargues, finalitzeu cada frase amb un punt. No incloure-hi caràcters de línia nova.
Compressió |  | Estableix un mode per a comprimir l'àudio per a reduir l'espai usat en el disc.
Contacte |  | Informació de contacte pels creadors o distribuïdors de la pista. Pot ser un URL, una adreça de correu electrònic, l'adreça postal de la discogràfica.
Copyright |  | Registra la informació sobre els drets d'autor pel fitxer. Si hi ha diferents drets d'autor, separeu-los amb un punt i coma seguit d'un espai. Exemple: «Copyright Linux community 2002»
Amb copyright |  | Indica si el fitxer està subjecte o no a drets d'autor.
Data |  | Especifica la data de creació del tema del fitxer. Exemple: «2001-12-24»
Enginyer |  | Mostra el nom de l'enginyer que ha treballat en el fitxer. Si existeixen múltiples enginyers, separeu-los amb un punt i coma seguit d'un espai en blanc.
Durada estimada |  | Durada estimada del fitxer en mostres.
Nom del fitxer |  | Nom del fitxer obert.
Mida del fitxer |  | Mida del fitxer en bytes.
Gènere |  | Descriu el gènere o estil del treball original. Exemples: «clàssica», «pop»
ISRC |  | Número ISRC per a la pista. Vegeu una introducció sobre els números ISRC. http://isrc.ifpi.org/
Paraules clau |  | Proporciona una llista de paraules clau que fan referència al fitxer o al tema que conté.
Etiquetes |  | La llista d'etiquetes i marcadors.
Durada |  | Durada del fitxer en mostres.
Llicència |  | Informació sobre la llicència, p. ex., «Tots els drets reservats», «Es permet qualsevol ús», un URL a la llicència o Attribution-ShareAlike 4.0 International («distribuïda sota els termes de la llicència Attribution-ShareAlike 4.0 International. Per a més detalls, vegeu https://creativecommons.org/licenses/by-sa/4.0/»), etc.
Suport |  | Descriu el tema original del fitxer, on fou gravat inicialment. Exemple: «orquestra»
Tipus MIME |  | Tipus MIME del format de fitxer.
Èmfasi |  | Mode d'èmfasi de l'àudio.
Capa |  | MPEG de capa I, II o III.
Extensió del mode |  | Extensió del mode MPEG (només si és estèreo combinat).
Versió |  | Versió de MPEG 1, 2 o 2.5.
Nom |  | Emmagatzema el títol del tema del fitxer. Exemple: «Simfonia núm. 6, Op. 68 "Pastoral"»
Durada de les trames Opus |  | Durada de les trames Opus en ms (s'admeten els valors 2,5, 5, 10, 20, 40 o 60 ms).
Organització |  | Nom de l'organització que produeix la pista (és a dir, la «discogràfica»).
Original |  | Indica si el fitxer és un original o una còpia.
Intèrpret |  | El/s artista/es que interpreta/en la pista. En música clàssica seria el director de l'orquestra, l'orquestra o el solista. En un audiollibre seria l'actor que va realitzar la lectura.
Privat |  | Indica si el tema és privat.
Producte |  | Especifica el nom o el títol previst inicialment pel fitxer. Exemple: «Col·lecció d'àudio per a Linux»
Format de la mostra |  | Format utilitzat per a emmagatzemar les mostres d'àudio digitalitzades. Exemple: «IEEE de 32 bits amb decimals»
Freqüència de mostreig |  | Nombre de mostres per segon.
Programari |  | Identifica el nom del paquet de programari usat per a crear el fitxer. Exemple: «Kwave v0.6.4-1»
Origen |  | Identifica el nom de la persona o organització que va proporcionar el tema original del fitxer. Exemple: «Chaotic Sound Research»
Format de l'origen |  | Identifica el format original del material que s'ha digitalitzat. Exemples: «disc/vinil/90 RPM», «àudio DAT», «cinta/CrO2/60 min»
Tema |  | Descriu el tema del fitxer. Exemple: «Càntics d'ocells a la matinada»
Tècnic |  | Identifica al tècnic que ha digitalitzat el tema del fitxer. Exemple: «Torvalds, Linus»
Pista |  | Pista del CD si l'origen era un CD-ROM.
Pistes |  | Nombre de pistes del CD si l'origen era un CD-ROM.
Canals |  | Especifica el nombre de canals del senyal.
Qualitat base |  | Qualitat base de la compressió en mode VBR.
Versió |  | Es pot utilitzar per a diferenciar múltiples versions del mateix títol d'una pista en una única col·lecció (p. ex., informació sobre una mescla).