Vai al contenuto

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:

color_cmyk(100,50,0,10) → 0,115,230

osservazioni:

color_cmyk(100,50,0,10) = color_rgb( 0,115,230 )

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:

color_cmyka(100,50,0,10,200) → '0,115,229,200'

osservazioni:

color_cmyka(100,50,0,10,200) = color_rgba(0,115,230,200)`

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_grayscale_average('255,100,50') → '135,135,135,255'


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:

color_hsl(100,50,70) → 166,217,140

osservazioni:

color_hsl(100,50,70) =  color_rgb( 166,217,140)

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:

color_hsla(100,50,70,200) → '166,217,140,200'

osservazioni:

color_hsla(100,50,70,200) =  color_rgba( 166,217,140,200)

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:

color_hsv(40,100,100) → '255,170,0'

osservazioni:

color_hsv(40,100,100) =  color_rgb( 255,170,0 )

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:

color_hsva(40,100,100,200) → '255,170,0,200'

osservazioni:

color_hsva(40,100,100,200) = color_rgba( 255,170,0,200 )

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_mix_rgb('0,0,0','255,255,255',0.5) → 127,127,127,255


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_part('200,10,30','green') → 10


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_rgb(255,127,0) → 255,127,0


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:

color_rgba(255,127,0,200) → '255,127,0,200'


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:

ramp_color(create_ramp(map(0,'0,0,0',1,'255,0,0')),1) → '255,0,0,255'


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:

darker('200,10,30',300) → '66,3,10,255'


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:

lighter('200,10,30',200) → '255,158,168,255'


project_color

Restituisce un colore dallo schema colore del progetto.

Sintassi:

  • project_color(name)

Argomenti:

  • name un nome colore

Esempi:

project_color('Logo color') → '20,140,50'

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:

ramp_color('Spectral',0.3) → '253,190,115,255'

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:

ramp_color(create_ramp(map(0,'0,0,0',1,'255,0,0')),1) →255,0,0,255

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:

set_color_part('200,10,30','green',50) → 200,50,30


Torna su