색상 - 범위, 전역

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

이 API는 PDF 생성 유틸리티 플러그인(com.snc.apppdfgenerator)의 ServiceNow 일부이며 sn_pdfgeneratorutils 네임스페이스 내에서 제공됩니다. 플러그인은 기본적으로 활성화됩니다.

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

Color 색 - 색(배열 색)

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

색상 – equals(색상 색상)

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

표 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(숫자, grayScale)

검은색, 회색 또는 흰색 개체를 반환합니다.

표 4. 매개변수

이름	유형	설명
그레이스케일	번호	0에서 1 사이의 10진수 값으로 0은 검은색이고 1은 흰색입니다.

표 5. 반환

유형	설명
객체	제공된 회색조 값을 반영하는 색상 객체입니다.

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

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

색상 – setColorValue(Array colors)

주어진 값으로 색상을 작성하고 기존 색상의 값을 변경할 수 있습니다. 각 값은 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. 반환

유형	설명
안 함

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

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