Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

contrast() — contraste do filtro de imagem

`contrast()` afasta ou aproxima os componentes RGB do ponto médio, aumentando ou reduzindo a diferença entre tons claros e escuros.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

contrast( [ <number> | <percentage> ]? )

contrast() afasta ou aproxima os componentes RGB do ponto médio, aumentando ou reduzindo a diferença entre tons claros e escuros.

O exemplo define filter: contrast(200%), calculado como contrast(2): o píxel rgb(64 128 192) passa a 0,128,255. O limite contrast(0) reduz a cor ao cinzento 127,127,127, demonstrando processamento real dos píxeis.

Gramática: contrast( [ <number> | <percentage> ]? ).

O argumento pode ser <number> ou <percentage>: 1 e 100% não alteram a imagem, 0 e 0% produzem cinzento uniforme e valores acima de 1 aumentam o contraste sem limite superior. Valores negativos são proibidos e omitir o argumento equivale a 1. O filtro não altera alfa nem geometria de composição; componentes de saída fora do intervalo são limitados.

Exemplos

const source=document.createElement('canvas'),high=document.createElement('canvas'),flat=document.createElement('canvas');for(const canvas of [source,high,flat]){canvas.width=canvas.height=1}const input=source.getContext('2d');input.fillStyle='rgb(64 128 192)';input.fillRect(0,0,1,1);const highContext=high.getContext('2d');highContext.filter='contrast(200%)';highContext.drawImage(source,0,0);const flatContext=flat.getContext('2d');flatContext.filter='contrast(0)';flatContext.drawImage(source,0,0);const highPixel=[...highContext.getImageData(0,0,1,1).data].slice(0,3),flatPixel=[...flatContext.getImageData(0,0,1,1).data].slice(0,3);const box=document.createElement('div');document.body.append(box);box.style.filter='contrast(200%)';const computed=getComputedStyle(box).filter;if(computed!=='contrast(2)'||highPixel.join(',')!=='0,128,255'||flatPixel.join(',')!=='127,127,127')throw new Error('contrast filter evidence mismatch: '+[computed,highPixel,flatPixel]);console.log('computed='+computed+'; doubled='+highPixel.join(',')+'; zero='+flatPixel.join(','));

Resultado

computed=contrast(2); doubled=0,128,255; zero=127,127,127

`contrast()` afasta ou aproxima os componentes RGB do ponto médio, aumentando ou reduzindo a diferença entre tons claros e escuros.

Fontes