색상 - 범위 지정, 전역

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 3분

    • PDF의 요소에 적용할 수 있는 색상 속성을 정의하는 데 사용되는 색상 객체를 만듭니다. 셀, 테이블, 줄 등이 있습니다.

    이 API는 PDF Generation Utilities 플러그인(com.snc.apppdfgenerator)의 ServiceNow 일부이며 sn_pdfgeneratorutils 네임스페이스 내에서 제공됩니다. 플러그인은 기본적으로 활성화되어 있습니다.

    이 API는 PDF를 생성하기 위해 문서 API 와 함께 사용되는 구성요소입니다.

    색상 - 색상(배열 색상)

    RGB 값으로 새 Color 개체를 인스턴스화합니다.

    색상은 다음 시나리오에 적용할 수 있습니다.

    표 1. 매개변수
    이름 유형 설명
    그림 물감 배열 0에서 1까지의 10진수 값을 사용하여 RGB 값을 나타내는 세 개의 숫자입니다. 예를 들어 [0.1, 0.9, 0.5]에서 첫 번째 위치의 값은 빨간색, 두 번째 값은 녹색, 세 번째 위치는 파란색입니다. 또한 [0, 0, 0] 은 검정색, [0.5, 0.5, 0.5] 는 회색, [1, 1, 1] 은 흰색 단색입니다.

    다음 예제에서는 Color 객체를 만드는 방법을 보여줍니다.

    var color = new sn_pdfgeneratorutils.Color([0.1, 0.9, 0.5]); //given as object containing RGB values

    색상 - 같음(색상 색상)

    서로 다른 두 색상 개체의 값이 일치하는지 여부를 나타냅니다.

    표 2. 매개변수
    이름 유형 설명
    색상 색상 일치 여부를 확인할 색상 객체입니다.
    표 3. 반환
    유형 설명
    부울

    두 색상 객체의 값이 일치하는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 색상이 일치합니다.
    • false: 색상이 일치하지 않습니다.

    다음 예시에서는 두 개의 색상 객체를 만들고 색상이 일치하는지 확인하는 방법을 보여줍니다.

    var color1 = new sn_pdfgeneratorutils.Color([1,0.5,0.5]);  // given as an array of RGB values
var color2 = new sn_pdfgeneratorutils.Color([0.8,0.5,0.5]);         // given as an array of RGB values
var isequal = color1.equals(color2);

    색상 – getGrayColor(Number grayScale)

    검정색, 회색 또는 흰색 객체를 반환합니다.

    표 4. 매개변수
    이름 유형 설명
    그레이스케일 번호 0에서 1까지의 10진수 값으로, 여기서 0은 검은색이고 1은 흰색입니다.
    표 5. 반환
    유형 설명
    객체 제공된 회색조 값을 반영하는 색상 객체입니다.

    다음 예제에서는 50% 회색조의 색상 객체를 만드는 방법을 보여줍니다.

    var grayColor = new sn_pdfgeneratorutils.Color.getGrayColor(0.5);

    색상 – setColorValue(배열 색상)

    주어진 값으로 색상을 생성하고 기존 색상의 값을 변경할 수 있습니다. 각 값은 0에서 1 사이여야 합니다.

    표 6. 매개변수
    이름 유형 설명
    그림 물감 배열 0에서 1까지의 10진수 값을 사용하여 RGB 값을 나타내는 세 개의 숫자입니다. 예를 들어 [0.1, 0.9, 0.5]에서 첫 번째 위치의 값은 빨간색, 두 번째 값은 녹색, 세 번째 위치는 파란색입니다. 또한 [0, 0, 0] 은 검정색, [0.5, 0.5, 0.5] 는 회색, [1, 1, 1] 은 흰색 단색입니다.
    표 7. 반환
    유형 설명
    없음

    다음 예는 기존 색상의 값을 변경하는 방법을 보여줍니다.

    var color = new sn_pdfgeneratorutils.Color([1,0.5,0.5]);   //given as array of RGB values;
color.setColorValue(color);

    색상 - setOpacity(숫자 불투명도)

    색상 불투명도 수준을 설정합니다.

    표 8. 매개변수
    이름 유형 설명
    색상 색상 0에서 1까지의 부동 10진수 값으로, 0은 완전히 투명하고 1은 완전히 불투명입니다.
    표 9. 반환
    유형 설명
    없음

    다음 예제에서는 색상 개체를 만들고 불투명도를 50%로 설정하는 방법을 보여 줍니다.

    var color = new Color([1,0.5,0.5]);
color.setOpacity(0.5);