RedGPU API - v3.0.0-Alpha
    Preparing search index...

    Class ColorRGBA

    빨강, 초록, 파랑, 알파(투명도) 값을 가진 색상을 나타내는 클래스입니다. ColorRGB 클래스를 상속받아 투명도 기능을 추가합니다.

    이 클래스는 RGBA 색상 값을 생성, 조작, 변환하는 메서드를 제공하며, 알파 채널을 통한 투명도 처리가 가능합니다.

    // 불투명한 흰색 생성
    const white = new RedGPU.ColorRGBA();

    // 반투명한 빨간색 생성
    const semiTransparentRed = new RedGPU.ColorRGBA(255, 0, 0, 0.5);

    // 변경 콜백과 함께 생성
    const color = new RedGPU.ColorRGBA(100, 150, 200, 0.8, () => console.log('색상이 변경되었습니다'));

    // RGBA 문자열로 색상 설정
    color.setColorByRGBAString('rgba(255, 87, 51, 0.7)');

    // 정규화된 값 가져오기
    const normalized = color.rgbaNormal; // [1, 0.34, 0.2, 0.7]

    Hierarchy (View Summary)

    Index

    Constructors

    • ColorRGBA 클래스의 새 인스턴스를 생성합니다.

      Parameters

      • r: number = 255

        RGB 색상의 빨간색 구성 요소. 0에서 255 사이의 값이어야 합니다.

      • g: number = 255

        RGB 색상의 초록색 구성 요소. 0에서 255 사이의 값이어야 합니다.

      • b: number = 255

        RGB 색상의 파란색 구성 요소. 0에서 255 사이의 값이어야 합니다.

      • a: number = 1

        색상의 알파(투명도) 구성 요소. 0(완전 투명)에서 1(완전 불투명) 사이의 값이어야 합니다.

      • onChange: Function = undefined

        색상이 변경될 때 호출되는 선택적 콜백 함수입니다.

      Returns ColorRGBA

      RGB 값이 0-255 범위를 벗어나거나 알파 값이 0-1 범위를 벗어나면 오류가 발생합니다.

      const color = new RedGPU.ColorRGBA(255, 128, 0, 0.75); // 75% 불투명도의 주황색
      

    Accessors

    • get a(): number

      알파(투명도) 구성 요소를 가져옵니다.

      Returns number

      0(완전 투명)에서 1(완전 불투명) 사이의 알파 값

    • set a(value: number): void

      알파(투명도) 구성 요소를 설정합니다.

      Parameters

      • value: number

        설정할 알파 값 (0-1)

      Returns void

      값이 0-1 범위를 벗어나면 오류가 발생합니다.

      const color = new RedGPU.ColorRGBA(255, 0, 0, 1);
      color.a = 0.5; // 50% 투명도로 설정
    • get b(): number

      파란색 구성 요소를 가져옵니다.

      Returns number

      0에서 255 사이의 파란색 값

    • set b(value: number): void

      파란색 구성 요소를 설정합니다.

      Parameters

      • value: number

        설정할 파란색 값 (0-255)

      Returns void

      값이 0-255 범위를 벗어나면 오류가 발생합니다.

    • get g(): number

      초록색 구성 요소를 가져옵니다.

      Returns number

      0에서 255 사이의 초록색 값

    • set g(value: number): void

      초록색 구성 요소를 설정합니다.

      Parameters

      • value: number

        설정할 초록색 값 (0-255)

      Returns void

      값이 0-255 범위를 벗어나면 오류가 발생합니다.

    • get hex(): string

      RGB 색상의 16진수 표현을 반환합니다.

      Returns string

      16진수 색상 값 (예: "#FF8000")

      const color = new RedGPU.ColorRGB(255, 128, 0);
      console.log(color.hex); // "#FF8000"
    • get r(): number

      빨간색 구성 요소를 가져옵니다.

      Returns number

      0에서 255 사이의 빨간색 값

    • set r(value: number): void

      빨간색 구성 요소를 설정합니다.

      Parameters

      • value: number

        설정할 빨간색 값 (0-255)

      Returns void

      값이 0-255 범위를 벗어나면 오류가 발생합니다.

    • get rgb(): number[]

      색상의 RGB 값을 포함하는 배열을 반환합니다.

      Returns number[]

      [r, g, b] 형식의 RGB 값을 나타내는 숫자 배열

      const color = new RedGPU.ColorRGB(255, 128, 0);
      console.log(color.rgb); // [255, 128, 0]
    • get rgba(): number[]

      색상의 RGBA 값을 포함하는 배열을 반환합니다.

      Returns number[]

      [r, g, b, a] 형식의 RGBA 값을 나타내는 숫자 배열

      const color = new RedGPU.ColorRGBA(255, 128, 0, 0.8);
      console.log(color.rgba); // [255, 128, 0, 0.8]
    • get rgbaNormal(): number[]

      정규화된 RGBA 값을 배열로 반환합니다. RGB 값은 0에서 1 사이로 정규화되고, 알파 값은 이미 정규화된 상태입니다.

      Returns number[]

      정규화된 RGBA 값을 포함하는 배열 [r/255, g/255, b/255, a]

      const color = new RedGPU.ColorRGBA(255, 128, 0, 0.8);
      console.log(color.rgbaNormal); // [1, 0.501, 0, 0.8]
    • get rgbNormal(): number[]

      정규화된 RGB 값을 배열로 반환합니다. 각 값은 0에서 1 사이로 정규화됩니다.

      Returns number[]

      정규화된 RGB 값을 포함하는 배열 [r/255, g/255, b/255]

      const color = new RedGPU.ColorRGB(255, 128, 0);
      console.log(color.rgbNormal); // [1, 0.501, 0]

    Methods

    • 16진수 색상 코드를 사용하여 객체의 색상을 설정합니다.

      Parameters

      • hexColor: string | number

        색상을 설정할 16진수 색상 코드 (문자열 또는 숫자)

      Returns void

      유효하지 않은 16진수 색상 코드인 경우 오류가 발생합니다.

      const color = new RedGPU.ColorRGB();
      color.setColorByHEX('#FF8000');
      color.setColorByHEX(0xFF8000);
    • 제공된 RGB 값을 기반으로 객체의 색상을 설정합니다.

      Parameters

      • r: number

        0-255 범위의 빨간색 값

      • g: number

        0-255 범위의 초록색 값

      • b: number

        0-255 범위의 파란색 값

      Returns void

      RGB 값이 0-255 범위를 벗어나면 오류가 발생합니다.

      const color = new RedGPU.ColorRGB();
      color.setColorByRGB(255, 128, 0); // 주황색으로 설정
    • RGBA 값을 사용하여 객체의 색상을 설정합니다.

      Parameters

      • r: number

        색상의 빨간색 구성 요소. 0에서 255 사이의 값이어야 합니다.

      • g: number

        색상의 초록색 구성 요소. 0에서 255 사이의 값이어야 합니다.

      • b: number

        색상의 파란색 구성 요소. 0에서 255 사이의 값이어야 합니다.

      • a: number

        색상의 알파(투명도) 구성 요소. 0에서 1 사이의 값이어야 합니다.

      Returns void

      RGBA 색상 값이 유효하지 않으면 오류가 발생합니다.

      const color = new RedGPU.ColorRGBA();
      color.setColorByRGBA(255, 128, 0, 0.6); // 60% 불투명도의 주황색으로 설정
    • RGBA 문자열을 사용하여 객체의 색상을 설정합니다.

      Parameters

      • rgbaString: string

        "rgba(r, g, b, a)" 형식의 RGBA 색상 값을 나타내는 문자열

      Returns void

      주어진 rgbaString이 유효한 RGBA 색상 값이 아닌 경우 오류가 발생합니다.

      const color = new RedGPU.ColorRGBA();
      color.setColorByRGBAString('rgba(255, 128, 0, 0.75)');
      color.setColorByRGBAString('rgba( 255 , 128 , 0 , 0.75 )'); // 공백 허용
      color.setColorByRGBAString('rgba(255, 128, 0, .5)'); // 소수점 앞의 0 생략 허용
    • RGB 색상 값을 나타내는 문자열을 파싱하여 객체의 색상을 설정합니다.

      Parameters

      • rgbString: string

        "rgb(r, g, b)" 형식의 RGB 색상 값을 나타내는 문자열

      Returns void

      주어진 rgbString이 유효한 RGB 색상 값이 아닌 경우 오류가 발생합니다.

      const color = new RedGPU.ColorRGB();
      color.setColorByRGBString('rgb(255, 128, 0)');
      color.setColorByRGBString('rgb( 255 , 128 , 0 )'); // 공백 허용