Gruppo Colore↵
Abstract
Questo gruppo contiene funzioni per manipolare i colori
color_cmyk↵
Restituisce una rappresentazione stringa di un colore basato sui suoi componenti ciano, magenta, giallo e nero
Sintassi:
- color_cmyk(cyan, magenta, yellow, black)
Argomenti:
- cyan componente ciano del colore, come valore percentuale intero da 0 a 100
- magenta componente magenta del colore, come valore percentuale intero da 0 a 100
- yellow componente giallo del colore, come valore percentuale intero da 0 a 100
- black componente nero del colore, come valore percentuale intero da 0 a 100
Esempi:
osservazioni:
color_cmyka↵
Restituisce una rappresentazione stringa di un colore basato sui suoi componenti ciano, magenta, giallo, nero e alfa (trasparenza)
Sintassi:
- color_cmyka(cyan, magenta, yellow, black, alpha)
Argomenti:
- cyan componente ciano del colore, come valore percentuale intero da 0 a 100
- magenta componente magenta del colore, come valore percentuale intero da 0 a 100
- yellow componente giallo del colore, come valore percentuale intero da 0 a 100
- black componente nero del colore, come valore percentuale intero da 0 a 100
- alpha componente alfa come valore intero da 0 (completamente trasparente) a 255 (opaco).
Esempi:
osservazioni:
color_grayscale_average↵
Applica un filtro in scala di grigio e restituisce una rappresentazione di stringa da un colore fornito.
Sintassi:
- color_grayscale_average(color)
Argomenti:
- color una stringa di colore
Esempi:
color_hsl↵
Restituisce una rappresentazione stringa di un colore basato sui suoi attributi tonalità, saturazione e luminosità.
Sintassi:
- color_hsl(hue, saturation, lightness)
Argomenti:
- hue tonalità del colore, come valore intero da 0 a 360
- saturation percentuale di saturazione del colore come valore intero da 0 a 100
- lightness/span> percentuale di luminosità de_ colore come valore intero da 0 a 100
Esempi:
osservazioni:
color_hsla↵
Restituisce una rappresentazione stringa di un colore basato sui suoi attributi tonalità, saturazione, luminosità e alfa (trasparenza)
Sintassi:
- color_hsl(hue, saturation, lightness, alpha)
Argomenti:
- hue tonalità del colore, come valore intero da 0 a 360
- saturation percentuale di saturazione del colore come valore intero da 0 a 100
- lightness percentuale di luminosità del colore come valore intero da 0 a 100
- alpha componente alfa come valore intero da 0 (completamente trasparente) a 255 (opaco).
Esempi:
osservazioni:
color_hsv↵
Restituisce una rappresentazione stringa di un colore basato sui suoi attributi tonalità, saturazione e valore.
Sintassi:
- color_hsv(hue, saturation, value)
Argomenti:
- hue tonalità del colore, come valore intero da 0 a 360
- saturation percentuale di saturazione del colore come valore intero da 0 a 100
- value valore percentuale del colore come intero da 0 a 100
Esempi:
osservazioni:
color_hsva↵
Restituisce una rappresentazione stringa di un colore basato sui suoi attributi tonalità, saturazione, valore e alfa (trasparenza).
Sintassi:
- color_hsva(hue, saturation, value, alpha)
Argomenti:
- hue tonalità del colore, come valore intero da 0 a 360
- saturation percentuale di saturazione del colore come valore intero da 0 a 100
- value valore percentuale del colore come intero da 0 a 100
- alpha componente alfa come valore intero da 0 (completamente trasparente) a 255 (opaco)
Esempi:
osservazioni:
color_mix_rgb↵
Restituisce una stringa che rappresenta un colore che mescola i valori rosso, verde, blu e alfa di due colori forniti in base a un determinato rapporto.
Sintassi:
- color_mix_rgb(color1,color2,ratio)
Argomenti:
- color1 una stringa di colore
- color2 una stringa di colore
- ratio un rapporto
Esempi:
color_part↵
Restituisce uno specifico componente colore da una stringa colore, es. la componente rosso o alfa.
Sintassi:
- color_part(color, component)
Argomenti:
- color una stringa di colore
-
component una stringa corrispondente al componente colore da restituire. Opzioni valide sono:
- red: componente rosso RGB (0-255)
- green: componente verde RGB (0-255)
- blue: componente blu RGB (0-255)
- alpha: valore alfa (trasparenza) (0-255)
- hue: tonalità HSV (0-360)
- saturation: saturazione HSV (0-100)
- value: valore HSV (0-100)
- hsl_hue: tonalità HSL (0-360)
- hsl_saturation: saturazione HSL (0-100)
- lightness: luminosità HSL (0-100)
- cyan: componente ciano CMYK (0-100)
- magenta: componente magenta CMYK (0-100)
- yellow: componente giallo CMYK (0-100)
- black: componente nero CMYK (0-100)
Esempi:
color_rgb↵
Restituisce una rappresentazione stringa di un colore basato sui suoi componenti rosso, verde e blu.
Sintassi:
- color_rgb(red, green, blue)
Argomenti:
- red componente rosso del colore, come valore intero da 0 a 255
- green componente verde del colore, come valore intero da 0 a 255
- blue componente blu del colore, come valore intero da 0 a 255
Esempi:
color_rgba↵
Restituisce una rappresentazione stringa di un colore basato sui suoi componenti rosso, verde, blue ed alpha (trasparenza).
Sintassi:
- color_rgba(red, green, blue,alpha)
Argomenti:
- red componente rosso del colore, come valore intero da 0 a 255
- green componente verde del colore, come valore intero da 0 a 255
- blue componente blu del colore, come valore intero da 0 a 255
- alpha componente alfa come valore intero da 0 (completamente trasparente) a 255 (opaco).
Esempi:
create_ramp↵
Restituisce una scala di colori a gradiente per una mappa di colori e passi.
Sintassi:
- create_ramp(map[,discrete=false])
[ ] indica componenti opzionali
Argomenti:
- map una mappa di colori e passi
- discrete imposta questo parametro su vero per creare una rampa di colore discreta
Esempi:
darker↵
Restituisce una stringa di colore più scuro (o più chiaro)
Sintassi:
- darker(color, factor)
Argomenti:
- color una stringa di colore
- factor un numero intero corrispondente al fattore scurente:
- se il fattore è più grande di 100, questa funzione restituisce un colore più scuro (per es., impostando il fattore a 300 viene restitituito un colore che ha un terzo della luminosità);
- se il fattore è minore di 100, il colore restituito è più chiaro, ma per questo scopo si raccomanda l'uso della funzione lighter();
- se il fattore è 0 o negativo, il valore restituito non è specificato.
Esempi:
lighter↵
Restituisce una stringa di colore più chiaro (o più scuro)
Sintassi:
- lighter(color, factor)
Argomenti:
- color una stringa di colore
- factor un numero intero corrispondente al fattore schiarente:
- se il fattore è più grande di 100, questa funzione restituisce un colore più chiaro (per es., impostando il fattore a 150 viene restitituito un colore al 50% più luminoso);
- se il fattore è minore di 100, il colore restituito è più scuro, ma per questo scopo si raccomanda l'uso della funzione darker();
- se il fattore è 0 o negativo, il valore restituito non è specificato.
Esempi:
project_color↵
Restituisce un colore dallo schema colore del progetto.
Sintassi:
- project_color(name)
Argomenti:
- name un nome colore
Esempi:
osservazioni
ramp_color↵
Restituisce una stringa rappresentante un colore ottenuto da una scala colore.
Variante di scala salvata↵
Restituisce una stringa che rappresenta un colore da una scala salvata
Sintassi:
- ramp_color(ramp_name, value)
Argomenti:
- ramp_name il nome della scala colore come stringa, peesempi:o 'Spectral'
- value la posizione nella scala colore da cui selezionare il colore come numero reale fra 0 e 1
Esempi:
nota
Le scale di colore disponibili differiscono fra le varie installazioni di QGIS. Questa funzione potrebbe non restituire il risultato atteso se sposti i tuoi progetti QGIS fra le diverse installazioni.
Variante di scala creata con un'espressione↵
Restituisce una stringa che rappresenta un colore da una scala creata con un'espressione
Sintassi:
- ramp_color(ramp, value)
Argomenti:
- ramp la scala di colori
- value la posizione nella scala colore da cui selezionare il colore come numero reale fra 0 e 1
Esempi:
set_color_part↵
Imposta uno specifico componente colore per una stringa colore, es. la componente rosso o alpha.
Sintassi:
- set_color_part(color, component, value)
Argomenti:
- color una stringa di colore
-
component una stringa corrispondente al componente colore da impostare. Opzioni valide sono:
- red: componente rosso RGB (0-255)
- green: componente verde RGB (0-255)
- blue: componente blu RGB (0-255)
- alpha: valore alfa (trasparenza) (0-255)
- hue: tonalità HSV (0-360)
- saturation: saturazione HSV (0-100)
- value: valore HSV (0-100)
- hsl_hue: tonalità HSL (0-360)
- hsl_saturation:saturazione HSL (0-100)
- lightness: luminosità HSL (0-100)
- cyan: componente ciano CMYK (0-100)
- magenta: componente magente CMYK (0-100)
- yellow: componente giallo CMYK (0-100)
- black: componente nero CMYK (0-100)
-
value nuovo valore per il componente colore, rispettando gli intervalli listati sopra
Esempi:
