# Manuale di &kmyapplication;

## Introduzione

&kmyapplication; permette all'utente di controllare il rapporto di contrasto tra i colori, e di determinare se il risultato è adatto per le persone con deficienze visive coi colori. Gli utenti possono selezionare i colori in vari modi, ad esempio immettendo manualmente i valori esadecimali, oppure utilizzando lo strumento selettore di colore per selezionare i valori del colore sullo schermo.

Il rapporto di contrasto controllato da quest'applicazione è relativo alla differenza di colore tra due oggetti che gli permette di essere distinguibili. Un valore di contrasto di 21 indica un contrasto perfetto (in genere nero su bianco), mentre uno di 0 che i due colori sono uguali. I colori vengono controllati in base alle Web Content Accessibility Guidelines (WCAG).

## Uso di &kmyapplication;

Ecco una schermata di &kmyapplication; Schermata di &kmyapplication;

Dopo aver aperto l'applicazione ti si presenta un schermata simile a quella sopra, che è la principale di &kmyapplication;, quella che contiene la maggior parte delle sue funzionalità. Come esempio verranno visualizzati un colore di testo selezionato e uno di sfondo scelti casualmente, oltre al loro rapporto di contrasto.

### Selezionare i colori del testo e dello sfondo

Ci sono cinque modalità principali con le quali i colori possono essere selezionati per il confronto. Queste sono delineate di seguito.

#### Immissione di valori esadecimali

Se conosci i valori esadecimali dei colori che vorresti controllare, allora puoi immetterli direttamente. Per farlo, fai clic sui valori esadecimali del colore campione attualmente sullo schermo, poi digita il valore desiderato.

#### Selettore di colore

Se attualmente sullo schermo c'è un colore, ad esempio in una pagina di campioni, puoi usare l'apposito strumento per immetterlo direttamente nell'applicazione. Per farlo, fai clic sull'icona del selettore di colore, poi sul colore che vorresti campionare nello schermo: esso verrà selezionato nell'applicazione.

#### Tonalità, saturazione e luminosità

Se ti piacerebbe mettere a punto la selezione corrente, in modo da vedere se certe modifiche hanno o meno un effetto sul contrasto, puoi farlo usando i regolatori di tonalità, saturazione e chiarezza: si trovano al di sotto dei valori esadecimali della selezione corrente. La selezione dei colori verrà aggiornata automaticamente durante lo spostamento dei regolatori.

#### Inverti

Il pulsante Inverti scambierà i due colori attualmente selezionati, impostando il colore dello sfondo a quello del testo, e viceversa.

#### Casuale

Il pulsante Casuale assegnerà dei colori casuali, sia allo sfondo che al testo.

### Risultato del contrasto

Il rapporto di contrasto risultante della selezione verrà mostrato nella parte alta della schermata, insieme ad una breve nota. Essa spiega quanto bene questo contrasto sia adatto al testo nelle varie dimensioni, inoltre verrà aggiornata automaticamente man mano che vengono apportate delle modifiche ai valori del colore.

### Preferiti

&kmyapplication; permette all'utente di salvare delle combinazioni di colori per riferimenti futuri. Per farlo, premi il pulsante Segna come preferita situato nella parte bassa della schermata. Puoi accedere a queste combinazioni di colori dalla voce di menu Colori preferiti, come meglio descritto nel capitolo successivo.

## Opzioni del menu

Questo capitolo descrive tutte le funzionalità dell'applicazione accessibili dopo aver fatto clic sull'icona Menu nell'angolo in alto a sinistra.

### Controllo del contrasto

Questa è la schermata predefinita dell'applicazione: permette all'utente di selezionare i colori e di vedere il loro rapporto di contrasto. La funzionalità è descritta nel capitolo precedente.

### Colori preferiti

Questa schermata conterrà tutte le combinazioni di colori salvate come «preferite» nella schermata Controllo del contrasto. Le combinazioni di colori possono essere eliminate premendo il pulsante Rimuovi.

### Aiuto

Questa schermata contiene un breve riepilogo della teoria che c'è dietro a questa applicazione, ad esempio come funziona il contrasto e come interpretare al meglio il rapporto del contrasto, in linea con lo standard WCAG.

### Informazioni su

Questa schermata contiene alcune informazioni generali sull'applicazione, quali l'autore e le librerie utilizzate. C'è anche un pulsante per segnalare agli sviluppatori qualsiasi bug incontrato.

## Riconoscimenti e licenza

&kmyapplication;

Copyright del programma 2020-2022 Carl Schwan carl@carlschwan.eu

Copyright della documentazione © 2022 Vlad Rakhmanin vladimir.rakhmanin@ucdconnect.ie

&underGPL;
&documentation.index;