Color- Scoped, Global

Creates a Color object used to define color attributes that you can apply to elements in a PDF; such as cells, tables, and lines.

This API is part of the ServiceNow PDF Generation Utilities plugin (com.snc.apppdfgenerator) and is provided within the sn_pdfgeneratorutils namespace. The plugin is activated by default.

This API is a component used with the Document API to generate a PDF.

Parent Topic:Server API reference

Color - Color(Array colors)

Instantiates a new Color object with RGB values.

Color can be applied to the following scenarios:

The following example shows how to create a Color object.

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

Color – equals(Color color)

Indicates whether the values of two different color objects match.

The following example shows how to create two color objects and determine if the colors match.

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);

Color – getGrayColor(Number grayScale)

Returns a black, gray, or white color object.

The following example shows how to create a color object that is 50% grayscale.

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

Color – setColorValue(Array colors)

Creates color with given values and enables you to change the values of an existing color. Each of the values must be from 0 through 1.

The following example shows how to change the values of an existing color.

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

Color – setOpacity(Number opacity)

Sets the level of color opacity.

The following example shows how to create a color object and set its opacity to 50 percent.

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