Bitbybit Docs
    Preparing search index...

    Class Color

    Cores nas duas formas que a biblioteca usa: um texto hexadecimal como #ff5733, e um objeto { r, g, b } ou { r, g, b, a } cujos canais vão de 0 a 255 ou de 0 a 1. Os métodos aqui constroem cores em cada forma, convertem entre elas com um intervalo de canais explícito, leem canais individuais e invertem uma cor.

    Index

    Constructors

    convert

    • Lê uma cor hexadecimal para um objeto { r, g, b } com canais de 0 a 255.

      O texto pode começar com ou sem #; qualquer coisa que não sejam seis dígitos hexadecimais lança um erro. Exemplo: '#FF5733' -> { r: 255, g: 87, b: 51 }

      Parameters

      • inputs: HexDto

        A cor hexadecimal

      Returns ColorRGB

      O objeto de cor com canais de 0 a 255

      const rgb = bitbybit.color.hexToRgb({ color: "#ff5733" });
      
    • Escreve três valores de canal como uma cor hexadecimal.

      min e max dizem que intervalo os valores usam; um intervalo diferente de 0 a 255 é primeiro remapeado, por isso canais de 0 a 1 também funcionam. Exemplo: r 255, g 87, b 51 em [0,255] -> '#ff5733'; r 1, g 0.5, b 0.2 em [0,1] -> '#ff8033'

      Parameters

      • inputs: RGBMinMaxDto

        Os valores de vermelho, verde e azul e o seu intervalo

      Returns string

      A cor hexadecimal

      const hex = bitbybit.color.rgbToHex({ r: 1, g: 0.5, b: 0.2, min: 0, max: 1 });
      
    • Escreve uma cor { r, g, b } como uma cor hexadecimal.

      min e max dizem que intervalo os canais usam; um intervalo diferente de 0 a 255 é primeiro remapeado. Exemplo: { r: 1, g: 0.5, b: 0.2 } em [0,1] -> '#ff8033'

      Parameters

      • inputs: RGBObjectMaxDto

        O objeto de cor e o intervalo que os seus canais usam

      Returns string

      A cor hexadecimal

      const hex = bitbybit.color.rgbObjToHex({ rgb: { r: 1, g: 0.5, b: 0.2 }, min: 0, max: 1 });
      
    • Lê uma cor hexadecimal para um objeto { r, g, b } com os canais remapeados para um intervalo à sua escolha.

      Exemplo: '#FF5733' mapeado para [0,1] -> { r: 1, g: 0.341, b: 0.2 }

      Parameters

      • inputs: HexDtoMapped

        A cor hexadecimal e o intervalo para o qual mapear os canais

      Returns ColorRGB

      O objeto de cor com canais nesse intervalo

      const rgb = bitbybit.color.hexToRgbMapped({ color: "#ff5733", from: 0, to: 1 });
      

    create

    • Passa uma cor hexadecimal adiante sem alteração, para que uma cor possa receber um nome e ser reutilizada.

      Exemplo: '#FF5733' -> '#FF5733'

      Parameters

      • inputs: HexDto

        A cor hexadecimal

      Returns string

      A mesma cor hexadecimal

    • Passa adiante sem alteração uma cor { r, g, b } com canais de 0 a 255, para que possa receber um nome e ser reutilizada.

      Exemplo: { r: 255, g: 87, b: 51 } -> o mesmo objeto

      Parameters

      Returns ColorRGB

      O mesmo objeto de cor

    • Passa adiante sem alteração uma cor { r, g, b } com canais de 0 a 1, para que possa receber um nome e ser reutilizada.

      Exemplo: { r: 1, g: 0.34, b: 0.2 } -> o mesmo objeto

      Parameters

      Returns ColorRGB

      O mesmo objeto de cor

    • Passa adiante sem alteração uma cor { r, g, b, a } com canais de cor de 0 a 255 e opacidade de 0 a 1, para que possa receber um nome e ser reutilizada.

      Exemplo: { r: 255, g: 87, b: 51, a: 1 } -> o mesmo objeto

      Parameters

      Returns ColorRGBA

      O mesmo objeto de cor

    • Passa adiante sem alteração uma cor { r, g, b, a } com todos os canais de 0 a 1, para que possa receber um nome e ser reutilizada.

      Exemplo: { r: 1, g: 0.34, b: 0.2, a: 1 } -> o mesmo objeto

      Parameters

      Returns ColorRGBA

      O mesmo objeto de cor

    • Constrói uma cor { r, g, b } a partir de três valores de canal separados de 0 a 255.

      Exemplo: r 255, g 87, b 51 -> { r: 255, g: 87, b: 51 }

      Parameters

      Returns ColorRGB

      O objeto de cor

      const orange = bitbybit.color.rgbAtomic255Color({ r: 255, g: 87, b: 51 });
      
    • Constrói uma cor { r, g, b } a partir de três valores de canal separados de 0 a 1.

      Exemplo: r 1, g 0.34, b 0.2 -> { r: 1, g: 0.34, b: 0.2 }

      Parameters

      Returns ColorRGB

      O objeto de cor

      const orange = bitbybit.color.rgbAtomic1Color({ r: 1, g: 0.34, b: 0.2 });
      

    hex to

    • Lê o canal vermelho de uma cor hexadecimal, remapeado para um intervalo à sua escolha.

      Exemplo: '#FF5733' em [0,1] -> 1

      Parameters

      • inputs: HexDtoMapped

        A cor hexadecimal e o intervalo para o qual mapear o canal

      Returns number

      O canal vermelho nesse intervalo

      const red = bitbybit.color.getRedParam({ color: "#ff5733", from: 0, to: 1 });
      
    • Lê o canal verde de uma cor hexadecimal, remapeado para um intervalo à sua escolha.

      Exemplo: '#FF5733' em [0,1] -> 0.341

      Parameters

      • inputs: HexDtoMapped

        A cor hexadecimal e o intervalo para o qual mapear o canal

      Returns number

      O canal verde nesse intervalo

      const green = bitbybit.color.getGreenParam({ color: "#ff5733", from: 0, to: 1 });
      
    • Lê o canal azul de uma cor hexadecimal, remapeado para um intervalo à sua escolha.

      Exemplo: '#FF5733' em [0,1] -> 0.2

      Parameters

      • inputs: HexDtoMapped

        A cor hexadecimal e o intervalo para o qual mapear o canal

      Returns number

      O canal azul nesse intervalo

      const blue = bitbybit.color.getBlueParam({ color: "#ff5733", from: 0, to: 1 });
      
    • Inverte uma cor hexadecimal, transformando cada canal no seu oposto: 255 menos o valor.

      Com blackAndWhite ligado, o resultado é preto puro para uma cor clara ou branco para uma escura, o que serve para texto sobre um fundo colorido. Exemplo: '#FF5733' -> '#00a8cc'; com blackAndWhite -> '#ffffff'

      Parameters

      • inputs: InvertHexDto

        A cor hexadecimal e se deve reduzir o resultado a preto ou branco

      Returns string

      A cor hexadecimal invertida

      const textColor = bitbybit.color.invert({ color: "#ff5733", blackAndWhite: true });
      

    rgb to

    • Lê o canal vermelho de uma cor { r, g, b }.

      Exemplo: { r: 255, g: 87, b: 51 } -> 255

      Parameters

      Returns number

      O canal vermelho, no intervalo que o objeto usar

    • Lê o canal verde de uma cor { r, g, b }.

      Exemplo: { r: 255, g: 87, b: 51 } -> 87

      Parameters

      Returns number

      O canal verde, no intervalo que o objeto usar

    • Lê o canal azul de uma cor { r, g, b }.

      Exemplo: { r: 255, g: 87, b: 51 } -> 51

      Parameters

      Returns number

      O canal azul, no intervalo que o objeto usar