Tints, Color, and Pattern Management

175
XML Professional Publisher: Tints, Color, and Pattern Management for use with XPP 9.4 January 2020

Transcript of Tints, Color, and Pattern Management

XML Professional Publisher:

Tints, Color, andPattern Management

for use with XPP 9.4

January 2020

Notice

© SDL Group 1999, 2003-2005, 2009, 2012-2020. All rights reserved.Printed in U.S.A.

SDL Group has prepared this document for use by its personnel, licensees, and customers.The information contained herein is the property of SDL and shall not, in whole or in part,be reproduced, translated, or converted to any electronic or machine-readable formwithout prior written approval from SDL. Printed copies are also covered by this noticeand subject to any applicable confidentiality agreements.

The information contained in this document does not constitute a warranty ofperformance. Further, SDL reserves the right to revise this document and to make changesfrom time to time in the content thereof. SDL assumes no liability for losses incurred as aresult of out-of-date or incorrect information contained in this document.

Trademark Notice

See the Trademark file at http://docs.sdl.com for trademark information.

U.S. Government Restricted Rights Legend

Use, duplication or disclosure by the government is subject to restrictions as set forth insubparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause atDFARS 252.227-7013 or other similar regulations of other governmental agencies, whichdesignate software and documentation as proprietary. Contractor or manufacturer isSDL Group, 201 Edgewater Drive, Wakefield, MA 01880-6216.

ii

Contents

Chapter 1 Overview

Understanding Tints, Patterns, and Colors . . . . . . . . . . . . . . . . . . . . 1-2

Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

Tints and Patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

Using Tints, Patterns, and Colors with XyMacros . . . . . . . . . . . . . . 1-3

XyMacros for Filled Rectangles . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

XyMacros for Filled Circles/Ellipses . . . . . . . . . . . . . . . . . . . . . . . 1-4

XyMacros for Filled Tabular Elements . . . . . . . . . . . . . . . . . . . . . 1-4

XyMacros for Tints and Color in Text . . . . . . . . . . . . . . . . . . . . . . 1-5

Displaying Tints, Patterns, and Colors . . . . . . . . . . . . . . . . . . . . . 1-5

Outputting Tints, Patterns, and Colors . . . . . . . . . . . . . . . . . . . . . . . 1-6

Part I Managing Color

Chapter 2 Overview of Color Management

Questions to Ask About Color Requirements . . . . . . . . . . . . . . . . . 2-2

Understanding Color Control Specifications . . . . . . . . . . . . . . . . . . 2-4

Color Control Spec Naming Conventions . . . . . . . . . . . . . . . . . . 2-5

Color Definition Naming Conventions . . . . . . . . . . . . . . . . . . . . . 2-5

The Default Color Control Specification . . . . . . . . . . . . . . . . . . . . 2-6

Specifying a Color Spec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

Tints, Color, and Pattern Management Contents iii

Chapter 3 Managing Color Control Specs

Understanding the Color Control Window . . . . . . . . . . . . . . . . . . . 3-2

File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3

Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3

Separation Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4

Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4

Exiting Color Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5

Managing Color Control Specs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6

Creating a Color Control Spec . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6

Copying Color Control Specs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6

Renaming a Color Spec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7

Deleting a Color Spec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7

Colorspec Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7

Chapter 4 Managing Color Definitions

Understanding Color Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2

Adding XPP Color Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

Modifying Color Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5

Editing Color Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5

Understanding the Edit Color Dialog Box . . . . . . . . . . . . . . . . . . . . 4-6

Types of Edit Color Dialog Boxes . . . . . . . . . . . . . . . . . . . . . . . . . 4-6

Uses of the Edit Color Dialog Boxes . . . . . . . . . . . . . . . . . . . . . . . 4-7

Color Definition Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8

Deleting a Color Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13

Importing EPSF Spot Color Definitions . . . . . . . . . . . . . . . . . . . . . . 4-14

Importing EPSF Color Definitions at the Job Level . . . . . . . . . . 4-14

Importing EPSF Color Definitions at the Style Library orSystem Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14

Chapter 5 Managing Color Separations

Controlling Color Separation Values . . . . . . . . . . . . . . . . . . . . . . . . . 5-2

Setting Screen Angle and Frequency . . . . . . . . . . . . . . . . . . . . . . . 5-2

Setting the Halftone Dot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

Understanding Undercolor Removal . . . . . . . . . . . . . . . . . . . . . . 5-4

Understanding Spot Color Mapping . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

Assigning a Color to a Spot Map . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

Naming a Plate Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9

iv Contents Tints, Color, and Pattern Management

Removing a Color from a Spot Map . . . . . . . . . . . . . . . . . . . . . . . 5-9

Part II Managing Tints and Patterns

Chapter 6 Setting Up Tints and Patterns

The Special Effects Patterns (SEP) Spec . . . . . . . . . . . . . . . . . . . . . . . 6-2

The Default SEP Spec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

SEP Spec Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

Creating Multiple SEP Specs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

After Upgrading to a New XPP Release . . . . . . . . . . . . . . . . . . . . . . 6-6

Non-customized SEP Spec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6

Customized/Copied SEP Specs . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

XPP-delivered Patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

Part III Using Tints, Patterns, and Color

Chapter 7 Filled Rectangles

Understanding Filled Rectangles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

Rectangle Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

Display of Filled Rectangles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

Filled Rectangle XyMacros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

Draw Filled Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

fbox Draw Filled Box . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

Draw Filled Box with Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10

fboxt Draw Filled Box with Text . . . . . . . . . . . . . . . . . . 7-10

Start Filled Box with Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14

sfboxt Start Filled Box with Text . . . . . . . . . . . . . . . . . . . 7-14

End Filled Box with Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-21

efboxt End Filled Box with Text . . . . . . . . . . . . . . . . . . . . 7-21

Tints, Color, and Pattern Management Contents v

Chapter 8 Filled Circles and Ellipses

Understanding Filled Circles/Ellipses . . . . . . . . . . . . . . . . . . . . . . . 8-2

Circle/Ellipse Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2

Circle/Ellipse Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

Display of Filled Circles/Ellipses . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

Filled Circle/Ellipse XyMacro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

Draw Filled Oval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

oval Draw Filled Oval . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

Chapter 9 Filled Tabular Elements

Understanding Filled Tabular Elements . . . . . . . . . . . . . . . . . . . . . . 9-2

Display of Filled Tabular Elements . . . . . . . . . . . . . . . . . . . . . . . . 9-2

Filled Tabular Element XyMacros . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3

Fill Cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3

fcell Fill Cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4

Fill with Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-6

fpat Fill Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7

Fill with Main Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-8

fmcolor Fill with Main Color . . . . . . . . . . . . . . . . . . . . . . . . 9-9

Fill with Alternate Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-9

facolor Fill with Alternate Color . . . . . . . . . . . . . . . . . . . . 9-10

Fill Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-10

ftype Fill Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-10

Fill Priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11

fprio Fill Priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11

Fill Angle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-12

fangle Fill Angle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-12

Fill Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-12

ffreq Fill Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13

Fill Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13

fwidth Fill Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13

Fill Depth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14

fdepth Fill Depth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14

Chapter 10 Filled Blocks and Text

Understanding Filled Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2

Page Layout Spec Fields for Colors and Patterns . . . . . . . . . . . . . . 10-3

vi Contents Tints, Color, and Pattern Management

Item Format Spec Fields for Colors and Patterns . . . . . . . . . . . . . . 10-6

Colors and Patterns in Pickup Element Blocks . . . . . . . . . . . . . . . . 10-8

Colors and Patterns in Layout Blocks . . . . . . . . . . . . . . . . . . . . . . . . 10-11

Creating Text with Tints and Spot Color . . . . . . . . . . . . . . . . . . . . . . 10-13

Display of Text with Tints, Patterns, and Colors . . . . . . . . . . . . . 10-13

Outputting Text with Tints, Patterns, and Colors . . . . . . . . . . . . 10-13

Reverse Video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-14

rv Reverse Video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-14

erv End Reverse Video . . . . . . . . . . . . . . . . . . . . . . . . . 10-14

Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-15

co Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-15

Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-15

pt Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-16

Filled Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-16

System Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-18

% Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-18

! Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-18

Chapter 11 Gradient Fills

Guidelines for Using Gradient Fills . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2

Gradient Fill XyMacros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3

gcell Gradient Fill Tabular Cell . . . . . . . . . . . . . . . . . . . 11-3

grad Gradient Fill Text . . . . . . . . . . . . . . . . . . . . . . . . . . 11-5

Examples of Gradient Fills . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-7

Examples of Gradient Fills in Text . . . . . . . . . . . . . . . . . . . . . . . . . 11-7

Examples of Gradient Fills in Tables . . . . . . . . . . . . . . . . . . . . . . . 11-8

Part IV Outputting Tints, Patterns, and Color

Chapter 12 Outputting Tints, Patterns, and Color

Outputting Documents With Spot Color . . . . . . . . . . . . . . . . . . . . . 12-2

Printing From an Open Division . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2

Xyraster Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3

Outputting Documents with Patterns . . . . . . . . . . . . . . . . . . . . . . . . 12-4

Print Options for Tints, Patterns, and Color . . . . . . . . . . . . . . . . . . . 12-5

Tints, Color, and Pattern Management Contents vii

Glossary

Index

viii Contents Tints, Color, and Pattern Management

Figures

1-1 Sample Filled Rectangles with Different Tints and Patterns . . . . . 1-2

3-1 Color Control Window and Menus . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3

4-1 Color Control window with default and EPSF colors . . . . . . . . . . 4-2

4-2 Default Edit Color Dialog Box (XPP Color) . . . . . . . . . . . . . . . . . . . 4-6

4-3 Edit External Color Dialog Box (EPSF Color) . . . . . . . . . . . . . . . . . . 4-7

4-1 Example of Knockout Color Separations . . . . . . . . . . . . . . . . . . . . . 4-10

4-2 Example of Overprinting Color Separations . . . . . . . . . . . . . . . . . . 4-10

6-1 Default SEP Spec — Pattern Table . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

6-2 XPP-delivered Patterns 101-132 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

6-3 XPP-delivered Patterns 133-164 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10

7-1 Rectangle with Outline Inside the Shape . . . . . . . . . . . . . . . . . . . . . 7-2

7-2 Rectangle with Outline Straddling the Shape . . . . . . . . . . . . . . . . . 7-3

7-3 Rectangle with Outline Outside the Shape . . . . . . . . . . . . . . . . . . . . 7-3

7-4 Sample Filled Rectangles with Different Outline Placement . . . . . 7-8

7-5 Sample Filled Rectangle with a Dashed Outline . . . . . . . . . . . . . . . 7-9

7-6 Sample Rectangles with Different Priorities . . . . . . . . . . . . . . . . . . . 7-9

7-7 Sample Filled Rectangle with Text . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14

7-8 Sample Filled Rectangle with Text using the sfboxt and efboxtMacros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-19

7-9 Sample Rectangle with Rounded Corners . . . . . . . . . . . . . . . . . . . . 7-19

7-10 Sample Boxed Text with White Background, .4q Outline . . . . . . . 7-20

7-11 Sample Boxed Text with White Background, .8q Outline . . . . . . . 7-20

7-12 Sample Boxed Text with White Background, 1.69q Outline . . . . . 7-20

8-1 Ellipse with Outline Inside the Shape . . . . . . . . . . . . . . . . . . . . . . . . 8-2

8-2 Ellipse with Outline Straddling the Shape . . . . . . . . . . . . . . . . . . . . 8-2

8-3 Ellipse with Outline Outside the Shape . . . . . . . . . . . . . . . . . . . . . . 8-3

8-4 Cursor Position with a Circle/Ellipse . . . . . . . . . . . . . . . . . . . . . . . . 8-3

8-5 Sample Filled Circles with Different Outline Placement . . . . . . . . 8-8

8-6 Sample Filled Ellipse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9

8-7 Sample Filled Circle with a Double Outline . . . . . . . . . . . . . . . . . . . 8-9

8-8 Sample Circles with Different Priorities . . . . . . . . . . . . . . . . . . . . . . 8-10

9-1 Sample Table with Filled Cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7

9-2 Sample Table with Filled Spanning Cells . . . . . . . . . . . . . . . . . . . . . 9-8

9-3 Sample Table with Cells Filled to Table Width . . . . . . . . . . . . . . . . . 9-14

9-4 Sample Table with Cells Filled to Table Depth . . . . . . . . . . . . . . . . . 9-15

10-1 Page Layout Spec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3

10-2 Item Format Spec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6

10-3 Sample Tinted Text Using a Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7

Tints, Color, and Pattern Management Contents ix

10-4 Windows for Creating Pickup Element Blocks . . . . . . . . . . . . . . . . 10-8

10-5 Sample Patterned Background Using Pickup Element BlockFields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-10

10-6 Form Modify Window for Layout Blocks . . . . . . . . . . . . . . . . . . . . . 10-11

10-7 Sample Reverse Video Text Using the rv XyMacro . . . . . . . . . . . . . 10-14

10-8 Sample Reverse Video Text Without White Space Between Lines . 10-14

x Contents Tints, Color, and Pattern Management

Tables

2-1 Questions to Ask When Setting Up Color Controls . . . . . . . . . . . . 2-2

11-1 Table with Two Gcell XyMacros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-8

11-2 Table with Three gcell XyMacros . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-8

12-1 Print Options for Tints, Patterns, and Color . . . . . . . . . . . . . . . . . . . 12-6

Tints, Color, and Pattern Management Contents xi

xii Contents Tints, Color, and Pattern Management

About This Manual

The manual:

• Describes the concepts of tints, patterns, and color

• Describes the Color Control graphical user interface

• Shows the patterns available with XPP

• Details the XyMacros used to generate filled rectangles,circles/ellipses, and tabular elements

• Shows examples of rectangles, circles, ellipses, and tabular elementsfilled with tints and patterns

• Describes how to perform color separations

Tints, Color, and Pattern Management About This Manual xiii

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Audience

This manual is for users who are familiar with XML Professional Publisher(XPP) and want to produce rectangles, circles/ellipses, and tabular elementsfilled with tints, patterns, and colors.

This manual is also for those users responsible for setting up the specs thatdefine tints, patterns, and colors.

Audience

xiv About This Manual Tints, Color, and Pattern Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Where Do I Start?

The following table describes where to find information in this book.

To . . . Read

Understand tints, patterns, and color,and learn how XPP generates them

Chapter 1, “Overview”

Understand how to set up colordefinitions and separation platecontrols.

Part 1, “Managing Color”

Understand how to set up tints andpatterns, and edit the appropriate specsand files.

Part 2, “Managing Tints and Patterns”

Create filled rectangles, circles, ellipses,tabular elements, blocks, and text.

Part 3, “Using Tints, Patterns, andColors”

Output documents with color, tints, orpatterns

Part 4, “Outputting Tints, Patterns, andColors”

Where Do I Start?

Tints, Color, and Pattern Management About This Manual xv

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Conventions Used in This Manual

This manual uses a set of symbolic, typographic, and terminologyconventions to categorize specific information. Take a few moments tobecome familiar with these conventions before you use this manual.

Convention Description

Bold Bold type, used in procedures, indicates the object of theaction. It may be a menu option, a push button, or a field,and so forth. For example, “select Open” means select themenu option called Open. Position cursor means to move thecursor to a specific location. Enter appropriate informationmeans that you enter information that is appropriate for yoursite or for the specific job.Bold may be used elsewhere in the manual to denoteemphasis.

Key Capital first letter and the word “key” indicates a key on thekeyboard. Capital first letter and the words “Softkey Menu”indicate the menu pad to the right of the XyView. Unlessotherwise indicated, this manual assumes that you press theEnter key at the end of a command line.

Key+Key This sequence indicates a Shortcut Key combination. Holddown the first key while also pressing the second key, that isALT+F4 means to hold down the Alt key while also pressingthe F4 key.

Message A monospaced typeface indicates an application’s responseto your action. For example, “the message Enter Valueappears” means that the application displays the words“Enter Value.”

Italics In running text, an italic typeface indicates a new term; forexample, “The replacement string of characters is the outputstring.”

In a system message, a field entry, or an argument to acommand, an italic typeface indicates a variable. Forexample, filename is a variable in the message “Can’t openfilename.”

Italics are also used for the names of programs, such as Perl.

“ ” Quotation marks indicate that you should enter exactly whatthe instructions tell you to enter. For example, type “yes”means to type the letter y, the letter e, and the letter s.

[ ] Reverse-video square brackets represent tags in standardXPP. Tags are general-purpose commands defined in the ItemFormat Spec and embedded in a document. They generallyformat logical components of text, such as chapter openings,headers, or lists. For example, the tag for beginning a chaptermight be [chap ].

Conventions Used in This Manual

xvi About This Manual Tints, Color, and Pattern Management

Convention Description

< > Reverse-video angle brackets represent XPP-supplied macros(XyMacros) and user-defined macros. XyMacros arecommands embedded in text to set or change formatting ortypographic style. For example, the XyMacro to end a page is

<ep >.

Reverse-video angle brackets also represent tags when youuse XPP in either XML or SGML mode. Note that when inXML or SGML mode, XPP does not use the conventionalreverse-video square brackets.

<?xxx> Reverse-video angle brackets with a beginning questionmark represent macros when using XPP in SGML mode.

<?xxx?> Reverse-video angle brackets with a beginning and endingquestion mark represent macros when using XPP in XMLmode.

When entering values for some arguments in macros and for some fields inspecs, you must qualify the value by specifying a unit of measure. Theavailable unit qualifiers are:

• q — Points

• p — Picas

• c — Ciceros

• d — Didots

• i — Inches

• m — Millimeters

• k — Kyus

• n — Microns (XPP units)

• z — Centimeters

For example, 6q means 6 points, 4p means 4 picas.

Note: You can also use pc, pt, in, mm, and cm in fields where the system allows thestandard ISO unit abbreviations.

Conventions Used in This Manual

Tints, Color, and Pattern Management About This Manual xvii

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

For More Information

This manual is part of a comprehensive XML Professional Publisherdocument set.

Refer to these XPP documents for related information:

• Managing XPP for information on screening methods in the ps_ctrl file.

• XyMacros for information on using colors in the Insert Graphic (ig) andInsert Graphic in Table (igt) XyMacros

Refer to the list of XPP user documentation for complete details ondocument titles and descriptions.

For More Information

xviii About This Manual Tints, Color, and Pattern Management

Chapter 1

Overview

This chapter provides the following information:

• An overview of tints, patterns, and color in the XML ProfessionalPublisher (XPP) application.

• An introduction to the XyMacros and specs used to produce tints,patterns and colors.

Tints, Color, and Pattern Management Overview 1-1

123456123456123456123456

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Understanding Tints, Patterns, and Colors

You can use colors, tints, and patterns with XPP to create a variety of specialeffects. Refer to the Glossary for terms related to color, tints, and patterns.

Colors

Colors in XPP can be process colors or spot colors.

You define colors in the Color Control Spec through the Color Controlwindow, described in Part 1 of this manual, ″Managing Color.″

You apply Color Control specifications in XPP by doing the following:

• Enter a color definition number as an argument to a XyMacro.

• Select print options on the Color tab of the Print Process Dialog.

Tints and Patterns

A tint is a screened area of dots having a density between 1 and 100%.

Patterns are more varied and can be lines, shapes, or other designs, eitherXPP-delivered or ones that you create.

You can apply these tints and patterns to text, table cells, or to shapescreated from XyMacros.

The following figure shows the difference between tints and patterns.

You define tints and patterns with the Special Effects Patterns (SEP) Spec,described in Part II of this manual, ″Managing Tints and Patterns.”

You apply tints and patterns in XPP by specifying the SEP rule number in:

• XyMacros

• The Item Format and/or Page Layout Specs

• Pop-up windows for pickup element blocks

• The Form Modify window in Interactive Page Layout

15% Tinted Screen 30% Tinted Screen Pattern #159

Figure 1-1 Sample Filled Rectangles with Different Tints and Patterns

Understanding Tints, Patterns, and Colors

1-2 Overview Tints, Color, and Pattern Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Using Tints, Patterns, and Colors with XyMacros

With XyMacros and specs, you can create the following:

• Rectangles, ellipses, and circles filled with tints, patterns and colors.

• Tables with cells filled with tints, patterns and colors.

• Text blocks filled with tints, patterns, and colors.

• Type set in a tint or color, or reverse type.

You can output these features on PostScript™ imagesetting devices that arecapable of generating the desired tint, pattern, or color. This feature doesnot create tints, patterns or colors that are not supported by the imagesetter.

XyMacros are sensitive to block boundaries, leading, table components,page column spanning, and both horizontal and vertical justification.

XyMacros for Filled Rectangles

The following XyMacros create filled rectangles:

• Draw Filled Box — < fbox >

• Draw Filled Box with Text — < fboxt >

• Start Filled Box with Text — <sfboxt >

• End Filled Box Text — <efboxt >

With an open division, you can access these XyMacros from the Softkeymenu, using the following sequence:

Menu > Command > General Catalog; then > Color and Special Effects(from the General Catalog list box).

Refer to Part III, Chapter 7, “Filled Rectangles”, for detailed information onthese XyMacros and their arguments.

Using Tints, Patterns, and Colors with XyMacros

Tints, Color, and Pattern Management Overview 1-3

XyMacros for Filled Circles/Ellipses

The XyMacro for creating filled circles and ellipses is:

• Draw Filled Oval — <oval >

With an open division, you can access this XyMacro from the Softkey menu,using the following sequence:

Menu > Command >General Catalog; then > Color and Special Effects(from the General Catalog list box):

Refer to Part III, Chapter 8, “Filled Circles and Ellipses”, for detailedinformation on this XyMacro and its arguments.

XyMacros for Filled Tabular Elements

The following XyMacros fill tabular elements:

• Fill Cell — < fcell >

• Fill Pattern — < fpat >

• Fill with Main Color — < fmcolor >

• Fill with Alternate Color — < facolor >

• Fill Type — < ftype >

• Fill Priority —< fprio >

• Fill Angle — < fangle >

• Fill Frequency — < ffreq >

• Fill Width — < fwidth >

• Fill Depth — < fdepth >

For spot color separations, the screen angle and screen frequency defined inthe fangle and ffreq XyMacros override what is defined in the Plate Editdialog box of the Color Control Spec.

You access the Fill Cell (fcell) XyMacro from the Softkey menu, using thefollowing sequence:

Menu > Tabular Catalog; then > Miscellaneous > OK > Filled TabularElements from the Tabular Catalog list box. .

Other XyMacros for creating filled tabular elements are not in the TabularCatalog, however, you can enter valid XyMacros in the change style and setstyle tabular XyMacros.

Refer to Part III, Chapter 9, “Filled Tabular Elements”, for detailedinformation on the XyMacros, their arguments, and which XyMacros arevalid in the set style and change style macros.

Using Tints, Patterns, and Colors with XyMacros

1-4 Overview Tints, Color, and Pattern Management

XyMacros for Tints and Color in Text

The following XyMacros set text in tints, colors, and reverse video:

• Fill Text — < ftext >

• Reverse Video — <rv >

• End Reverse Video — <erv >

• Color — <co >

• Pattern — <pt >

With an open division, you can access these XyMacros from the Softkeymenu, using the following sequence:

Menu > Command >General Catalog; then > Color and Special Effects(from the General Catalog list box):

These XyMacros override the tints, patterns, and colors defined in the PageLayout (PL) Spec, Item Format (IF) Spec, or pickup or layout block. Also,while you cannot set a pattern for text, you can set a pattern for thebackground.

Refer to Part III, Chapter 10, “Filled Blocks and Text”, for detailedinformation on these XyMacros and their arguments.

Displaying Tints, Patterns, and Colors

You can display tints, patterns, and colors for filled elements.

Refer to the appropriate chapter in Part III of this manual for specificinformation on the display of each element.

Using Tints, Patterns, and Colors with XyMacros

Tints, Color, and Pattern Management Overview 1-5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Outputting Tints, Patterns, and Colors

Composition generates an internal representation of tints, patterns, andcolors. XPP provides default Color Control and Special Effects Patterns(SEP) Specs that contain information for translating the internalrepresentation into language that the supported PostScript device canunderstand. You can define additional colors and patterns.

You can use the Plate Edit dialog box from the Color Control Spec to definescreen angles and frequencies for each color when outputting pages bycolor separation. You can output a document as color separations or asspecified colors.

Refer to Part I, “Managing Color” for information on setting up ColorControl Specs and separation plate controls.

Refer to Part II, “Managing Tints and Patterns” for information on SEPSpecs.

Refer to Part IV, “Outputting Tints, Patterns, and Colors” for information onthe output options for jobs containing these special effects.

Outputting Tints, Patterns, and Colors

1-6 Overview Tints, Color, and Pattern Management

Part I

Managing Color

Chapter 2

Overview of ColorManagement

This chapter explains the following topics:

• Determining your color requirements

• Understanding the Color Control specifications

Other chapters in Part I describe how to perform the following tasks:

• Understanding the Color Control window

• Create, copy, rename, and delete Color Control specs

• Manage color definitions

• Import spot color information from EPSF files

• Manage color separations

Tints, Color, and Pattern Management Overview of Color Management 2-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Questions to Ask About Color Requirements

When setting up your site for outputting colors, you need to consider the types ofoutput you want and the output devices you have. The following table provides someguidance in addressing these questions.

Table 2-1 Questions to Ask When Setting Up Color Controls

Questions Solution Read

Do you need colors otherthan the eight XPP-definedcolors in the default ColorControl Spec?

Create a new Color ControlSpec with all the necessarycolors, or add to an existingspec.

“Creating a Color ControlSpec” on page 3-6

Chapter 4, “Managing ColorDefinitions”.

Do you have a job that uses aspecific set of colors?

Create a Color Control Spec,containing the necessarycolors for that job.

“Creating a Color ControlSpec” on page 3-6

Chapter 4, “Managing ColorDefinitions”.

When printing while editinga division (using the Printbutton on the XButtonsmenu), do you want to use aset of colors different fromthose used by other operatorsat your site?

Specify the Color ControlSpec on the Color tab of thePrint Process Dialog.

“Printing From an OpenDivision” on page 12-2.

Have you upgraded to a newrelease of XPP software?

Access the new SpecialEffects Patterns (SEP ) Specwith an updated set of tintsand patterns.

“After Upgrading to a NewXPP Release” on page 6-6.

Do you want colored tabularrules?

Specify a color in the Ruling(t3) Spec, or enter the SetColor for Rules, setcolor, orSet Color and Pattern forBox Rules, setbcolor, tabularXyMacro.

XML Professional Publisher:Mastering Tables.

Do you want tinted tabularrules?

Specify a pattern in theRuling (t3) Spec, or enter theSet Pattern for Rules,setpattern, or Set Color andPattern for Box Rules,setbcolor, tabular XyMacro.You could also define thetint as a color in the ColorControl Spec, then specifythat color in the Ruling (t3)Spec.

XML Professional Publisher:Mastering Tables.

“Editing Color Definitions”on page 4-5.

Questions to Ask About Color Requirements

2-2 Overview of Color Management Tints, Color, and Pattern Management

Table 2-1 Questions to Ask When Setting Up Color Controls (Continued)

Do you want to colorizegraphics?

Specify a color in the ig origt XyMacro, or in the Color

field of the Graphic Blockpop-up window.

XML Professional Publisher:Creating Pickups.

Do you want to override thescreening values and otherPostScript output parametersof TIFF, EPS, JPEG, PDF,SVG, SVGZ, CGM, PNG,BMP, and GIF graphics,whether or not you areperforming colorseparations?

Define screen method rulesfor specific device types(resolutions) in the ps ctrlfile.

XML Professional Publisher:Managing XPP.

Consider the following questions only if you are using XPP for color separation (Postscriptonly).

Do you need spot colorseparations from XPP-defined spot colors, and doyou want to see the spotcolors in color proofs oncomposite pages?

In the Edit Color dialog box,define a spot color and setpercentages in the CMYK orRGB slider bars.

“Editing Color Definitions”on page 4-5

Do you want to output jobsby color separation?

XPP uses the settings youmake in the Separationsection of the Edit Colordialog box when outputtingcolor separations. If thevalues for halftone dotshape, screen angle andfrequency for a separationplate in a spec are notacceptable, you can modifythe spec to meet yourrequirements.

Chapter 5, “Managing ColorSeparations.”

“Print Options for Tints,Patterns, and Colors” onpage 12-5.

Do moire patterns (grid-likepatterns) appear in your colorscreens?

Control screen frequenciesand screen angles by settingthe values for eachseparation plate in theSeparation section of theEdit Color dialog box.

“Setting Screen Angle andFrequency” on page 5-2.

For colors defined using theRGB color model, do youwant to perform undercolorremoval for magenta, yellow,or black?

Use the UndercolorRemoval dialog box to setthe values for undercolorremoval.

“Setting Undercolor RemovalValues” on page 5-5.

.

Questions to Ask About Color Requirements

Tints, Color, and Pattern Management Overview of Color Management 2-3

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Understanding Color Control Specifications

You use XPP Color Control specifications to perform the following tasks:

• Define colors.

• Control color separations, including mapping spot colors to plate sets.

You manage the Color Control Specs and their contents using the ColorControl window.

Color Control specifications consist of the following:

• One or more sets of color definitions.

• Control color separations (screen values, overprinting, spot color platemanagement).

XPP uses information in the Color Control Spec to convert the internalrepresentation of the colors into the PostScript language so that the outputdevice can understand it.

The Color Control Spec, as displayed in the Color Control window, has thefollowing parts:

• Color definitions

• Color separation and controls

Color Definitions

Color definitions include the following information:

• Color name

• XPP color number

• Color percentage values for cyan, magenta, yellow, and black (whenusing the CMYK color model)

• Color percentage values for red, green, and blue (when using the RGBcolor model)

• Whether to overprint the color

• Whether the color is a spot color

• Color separation (Postscript only)

• Whether spot mapping is enabled (whether the spot color isavailable for plate sets)

• Screen angle and frequency

Understanding Color Control Specifications

2-4 Overview of Color Management Tints, Color, and Pattern Management

Color Control Spec Naming Conventions

At the library (system or style) level, XPP names Color Control Spec files asname.clrspec. The default Color Control Spec is ps.clrspec.

At the job level, XPP names Color Control Spec files _clrspec_name.p. Thereare no default Color Control Specs at the job level.

At the library and job levels, you do not use or see the complete file namein the Color Control window.

Valid Characters

For name, use only the following characters to identify Color Control Specs:

• A through Z

• a through z

• 0 through 9

• Hyphen (–)

• Underscore ( )

Name Length

The Color Spec field in the Job Ticket accepts a maximum of eight (8)characters.

Although the Color Control Spec field on the Color tab of the Print ProcessDialog accepts more than eight characters, a general recommendation is touse a maximum of eight (8) characters if you intend to reference the spec inthe Job Ticket.

Color Definition Naming Conventions

There are two types of color definitions in XPP:

• XPP colors − defined/named in the Color Control window.

• EPSF colors − imported to the Color Control Spec from EPSF files.

You should import EPSF color definitions into a Color Control Spec only ifyou want to do either of the following:

• Define the EPSF color as a process color.

• Define a spot mapping (a plate set) containing the EPSF color.

There is no restriction when naming color definitions for process or spotcolors. When you open a Color Control Spec in the Color Definitionswindow, XPP lists the names of EPSF spot colors after the XPP colors.

Understanding Color Control Specifications

Tints, Color, and Pattern Management Overview of Color Management 2-5

The Default Color Control Specification

When you create a new specification, XPP uses a default Color ControlSpec, which consists of the following:

• The numbers 1-8 are reserved for the eight standard colors: black,white, red, green, blue, cyan, magenta, and yellow, and are numberedconsecutively from 1 through 8.

While you can modify the definitions for the colors 1 through 8, andassign them different names, you cannot change the numbers. EveryColor Control Spec reserves the numbers 1-8 and must includedefinitions for these standard colors.

• The number 65535 is reserved for a color that is output on each plateof a color separation, and for enabling tints.

You can change the definition of this color, but do not delete thisentry.

• The remaining numbers, 9 through 65534, are available for you todefine any colors that you need for your site or for specific jobs.

Specifying a Color Spec

You can specify the name of a Color Control Spec in the following locations:

• The Color Spec field of the Job Ticket.

• The Alternate Color Spec field of the Division Ticket.

• The Color Control Spec field on the Color tab in the Print Process Dialog(overrides the spec named in the Job Ticket).

XPP looks for the named spec in this order:

1. The job level

2. The style library level

3. The system level

If a document contains spot color commands (for example, from XyMacros,pop-up fields, or style spec fields), XPP uses the colors associated with thecolor number in the named spec.

Using the Job Ticket

Use the Color Spec field in the Job Ticket to specify a Color Control Spec:

• The default entry is ps.

• The spec you name can reside at the job level, the style library level, orthe system level.

Understanding Color Control Specifications

2-6 Overview of Color Management Tints, Color, and Pattern Management

• If XPP cannot find the spec you name, it uses ps.

• If you leave the field blank, no spec is used; the job does not use anycolors.

Using the Division Ticket

Use the Alternate Color Spec field of the Division Ticket to specify a ColorControl spec:

• The spec you specify can reside at the job level, the style library level,or the system level.

• If XPP cannot find the specified spec, it uses ps.

• If you leave this field blank, XPP uses the Color Spec specified in thecorresponding field in the Job Ticket.

Using the Print Process Dialog

To override the Job Ticket and Division Ticket, enter the name of the ColorControl Spec in the Color Control Spec field on the Color tab in the PrintProcess Dialog.

For example, if you are using a Fill With Main Color XyMacro < fmcolor;5 >

to fill a cell in a table with blue, and you want to use another shade of bluefor output on a different color paper, you can do the following:

1. Create an alternate Color Control Spec with a different shade of bluefor color number 5.

2. Select that alternate spec when you output the job by doing one of thefollowing:

• Specify the name of the spec in the Color Spec field of the Job Ticket.

• Specify the name of the spec in the Alternate Color Spec field of theDivision Ticket.

• Specify the name of the spec in the Color Control Spec field on theColor tab in the Print Process Dialog. (Specifying the Color ControlSpec in the Print Process Dialog overrides the spec named in theJob Ticket.)

Understanding Color Control Specifications

Tints, Color, and Pattern Management Overview of Color Management 2-7

2-8 Overview of Color Management Tints, Color, and Pattern Management

Chapter 3

Managing Color ControlSpecs

The following sections describe the Color Control window and its menu.This chapter also contains procedures for how to create, copy, rename, anddelete Color Control Spec files.

Tints, Color, and Pattern Management Managing Color Control Specs 3-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Understanding the Color Control Window

The Color Control window is a graphical user interface (GUI) that lets youmanage Color Control specs. You can access this interface in different ways.

To access the Color Control window at the system level:

1. In the PathFinder tree view, in Lsyslib, click Color.

2. In the list view, double-click the color spec.

To access the Color Control window at the style library level:

1. In the PathFinder tree view, under the desired style library, clickColor.

2. In the list view, double-click the color spec.

To access the Color Control window at the job level:

1. In the PathFinder tree view, under the desired job, click Color.

2. In the list view, double-click the color spec.

You can also access the Color Control window from an open division. Thislets you create or edit color or spot map definitions, and work with platesets. However, you cannot create, copy, rename, or delete color specs whenyou access the Color Control window this way. Refer to ″Managing ColorControl Specs″ on page 3-6 for how to perform those tasks.

To access the Color Control window in an open division:

• On the Softkey menu, press Menu > Activity > Edit Job Styles >Color.

The following figure displays the Color Control window and its menus.

Understanding the Color Control Window

3-2 Managing Color Control Specs Tints, Color, and Pattern Management

The Color Control window has four menus.

Menu Description

File Save and exit color specification files.

Edit Change the color definitions.

Separation Manage XPP color separation (Postscript only).

Help Get Help for using Color Control.

File Menu

Use the File menu to save and close Color Control Spec files.

The File menu options are:

Option Description

Save Saves the active Color Control Spec.

Quit Exits the Color Control window. If a spec is open andmodified, but not saved, the Exit dialog box appears andprompts you to save or abandon the changes.

Edit Menu

Use the Edit menu to access the contents of a Color Control Spec. If the speccontains more color definitions than fit within the Color Control window,you can scroll through all the items in the spec.

The Edit menu has the following options:

Figure 3-1 Color Control Window and Menus

Understanding the Color Control Window

Tints, Color, and Pattern Management Managing Color Control Specs 3-3

Option Description

Edit Color Displays the Edit Color dialog box, allowing you to edit thedefinition of the selected color. The names and numbers ofsystem colors cannot be modified in this dialog box.

Add Color Displays the Edit Color dialog box, allowing you to add anddefine a new color to XPP.

Delete Color Deletes the seleted color unless it is a system color. Systemcolors cannot be deleted.

Import Image Colors Use to add EPSF spot colors to the open spec. EPSF spotcolors must be imported if you want to map them togetheronto one plate, or to treat them as process colors. The actionof the Import option differs depending on whether you are atthe system or the job level. The two options are:

• At the job level, select Import to have XPP examine alldivisions in the job and add to the spec all EPSF spot colordefinitions in images referenced within any division.

• At the system level, select Import to display the Importdialog box and select one graphic library at a time fromwhich to import spot colors.

Separation Menu

If you use XPP to perform color separation (Postscript only), use theSeparation menu to manage color separation.

The General menu has the following options:

Option Description

Undercolor Removal Displays the Undercolor Removal dialog box, allowing youto change the CMYK values. (Refer to ″UnderstandingUndercolor Removal″ on page 5-4.)

Spot Function Displays the Color Separation dialog box, allowing you toselect the Halftone Spot function.

Help Menu

The Help menu has one command, Help, which provides general help onworking with XPP color specs.

Understanding the Color Control Window

3-4 Managing Color Control Specs Tints, Color, and Pattern Management

Exiting Color Control

To exit the Color Control window:

1. Select Quit from the File menu.

If you have left any specifications open without having updatedchanges, an Exit Confirmation dialog box appears.

2. Click:

• Yes to exit and save any changes.

• No to exit without updating an unsaved specifications.

• Cancel to return to the Color Control window without updatingany unsaved specifications.

Understanding the Color Control Window

Tints, Color, and Pattern Management Managing Color Control Specs 3-5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing Color Control Specs

You manage the Color Control Specs through PathFinder.

Creating a Color Control Spec

To create a Color Control Spec:

1. Do one of the following:

• To create a color control spec at the job level, right-click a job, thenselect New Style File > Color.

• To create a color control spec at the style library level, right-click astyle library, then select New > Color.

• To create a color control spec at the system library level, right-clickthe Lsyslib library, then select New > Color.

2. In the list view, name the Color Control Spec as desired.Refer to “Color Control Spec Naming Conventions” on page 2-5 foraccepted characters.

Copying Color Control Specs

You can create a new Color Control Spec by copying an existing spec at thecurrent level and using it as a template. You can copy specs at the samelevel (job, style library, or system) or between levels.

To copy a Color Control Spec:

1. Access the Color Control window at the level (job, style library, orsystem) at which you want to copy a Color Control Spec. (Refer to“Understanding the Color Control Window” on page 3-2.)

2. In the list view, right-click the spec you want to copy.

3. Click Copy.

4. In the tree view, right-click the job or library to paste the spec into.

5. Click Paste.

Managing Color Control Specs

3-6 Managing Color Control Specs Tints, Color, and Pattern Management

Renaming a Color Spec

To rename a Color Control Spec:

1. Access the Color Control window at the level (job, style library, orsystem) at which the spec exists. (Refer to “Understanding the ColorControl Window” on page 3-2.)

2. In the list view, right-click the spec you want to rename.

3. Click Rename.

4. Modify the name, then press Return.

Deleting a Color Spec

To delete a Color Control Spec:

1. Access the Color Control window at the level (job, style library, orsystem) at which the spec exists. (Refer to “Understanding the ColorControl Window” on page 3-2.)

2. In the list view, right-click the color spec.

3. Click Delete.

4. Click Yes to confirm the deletion.

XPP deletes the selected spec, and no longer displays it in the list.

Colorspec Utility

The Color Input/Output utility adds the ability for a style developer tocreate a Color Spec from an XML file, which automates the process ofadding colors to XPP. For more information on the colorio.pl utility,refer to Chapter 2 “Supported Command Line Utilities” in XML ProfessionalPublisher: Command Line Utilities.

Managing Color Control Specs

Tints, Color, and Pattern Management Managing Color Control Specs 3-7

3-8 Managing Color Control Specs Tints, Color, and Pattern Management

Chapter 4

Managing Color Definitions

This chapter describes the following topics:

• Understanding Color Definitions

• Add XPP color definitions

• Modify and delete color definitions

• Import EPSF color definitions

Tints, Color, and Pattern Management Managing Color Definitions 4-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Understanding Color Definitions

When you open a spec, the color definitions display automatically.

If this is a new spec, it has a set of default colors, numbered 1-8 and 65535.An existing spec may also include user-defined colors and/or importedEPSF colors as shown in thefollowing figure.

For each color, the Color Control window displays a sample block and thefollowing information.

• XPP number

• Color name

• Type (CMYK or RGB)

• Overprint

• Whether the color is a spot color

• Spot map to which the color is assigned (if any)

There are two types of color definitions:

• Standard XPP colors, including default and user-defined colors

• Colors derived from EPSF files

Figure 4-1 Color Control window with default and EPSF colors

Understanding Color Definitions

4-2 Managing Color Definitions Tints, Color, and Pattern Management

XPP colors have a number as well as a name. They are listed first(in numerical order), followed by EPSF color definitions (in ASCIIalphabetical order). Initially, before importing, there are no EPSF-derivedcolor definitions in a Color Control Spec.

To modify XPP and EPSF color definitions, refer to the section “EditingColor Definitions” on page 4-5.

To import EPSF color definitions, refer to “Importing EPSF Spot ColorDefinitions” on page 4-14.

Understanding Color Definitions

Tints, Color, and Pattern Management Managing Color Definitions 4-3

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Adding XPP Color Definitions

You can add an XPP color definition to a Color Control Spec.

To add an XPP color definition to a Color Control Spec:

1. Access the Color Control window at the appropriate level (job, stylelibrary, or system). (Refer to “Understanding the Color ControlWindow” on page 3-2.)

2. Select Add Color from the Edit menu.XPP displays the default Edit Color dialog box.

3. Use the Edit Color dialog box to name and define the new XPP color.

Refer to the section “Understanding the Edit Color Dialog Box” onpage 4-6 for information on how to edit each field.

4. Click OK to add the color definition or Cancel to exit the Edit Colordialog box without saving the changes.

Adding XPP Color Definitions

4-4 Managing Color Definitions Tints, Color, and Pattern Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Modifying Color Definitions

You can edit XPP color definitions as well as EPSF color definitions.

Editing Color Definitions

To modify color definitions:

1. Access the Color Control window at the appropriate level (job, stylelibrary, or system). (Refer to “Understanding the Color ControlWindow” on page 3-2.)

2. In the Color Control window, do one of the following:

• Select the color whose definition you want to edit and select EditColor from the Edit menu.

• Click the underlined Color Name.

If an XPP color was selected, XPP displays the Edit Color dialog box; ifan EPSF color was selected, XPP displays the Edit External Colordialog box. The dialog box contains information about the selectedcolor and controls you can use to edit its definition.

In the dialog box, XPP colors have numbers and names, and are listedbefore EPSF colors.

3. Edit the color settings as desired. Refer to the section “Color DefinitionSettings” on page 4-8 for information about each field in the EditColor and Edit External Color dialog boxes.

4. Do one of the following when you finish editing the fields:

• Click the OK button to update the definition.

• Click the Cancel button to exit without updating the definition.

5. Repeat steps 2 through 3 for each XPP color you want to modify inthis spec.

6. Save the changes and close the spec when you are satisfied with itscontents.

Modifying Color Definitions

Tints, Color, and Pattern Management Managing Color Definitions 4-5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Understanding the Edit Color Dialog Box

XPP displays an Edit Color dialog box when you have a Color Control Specopen and do any of the following:

• Select Add Color from the Edit menu.

• Select Edit Color from the Edit menu.

• Click the underlined Color Name in the Color Control window.

The type of Edit Color dialog box displayed depends on whether an XPP orEPSF color is being edited.

Types of Edit Color Dialog Boxes

The fields available in the Color Definitions dialog box depend on whattype of color definition (XPP or EPSF) you are editing.

The following figure shows the default Color Definitions dialog box thatXPP displays when you select Add Color to add an XPP color or Edit Colorto edit an XPP color.

Figure 4-2 Default Edit Color Dialog Box (XPP Color)

Understanding the Edit Color Dialog Box

4-6 Managing Color Definitions Tints, Color, and Pattern Management

The following figure shows the Edit External Color dialog box, whichappears when you select an EPSF color definition to modify.

Uses of the Edit Color Dialog Boxes

For XPP colors, you can use the Edit Color dialog box to perform thefollowing tasks:

• Assign a name and number to identify the color.

• Select the color model as RGB or CMYK.

• Adjust the color percentages by using sliders or by typing in valuesand view how your adjustments affect the look of the color.

• Set the color to overprint or knockout.

• Designate whether the definition is a spot color.

• Control color separation.

For EPSF colors, you can use the Edit External Color dialog box to do thefollowing:

• Designate whether the definition is a spot color.

• Control color separation.

The following “Color Definition Settings” section provides information onthe fields in the Edit Color and Edit External Color dialog boxes.

Figure 4-3 Edit External Color Dialog Box (EPSF Color)

Understanding the Edit Color Dialog Box

Tints, Color, and Pattern Management Managing Color Definitions 4-7

Color Definition Settings

For XPP colors, you can modify all settings. For EPSF colors, you canmodify the Spot Color, Spot Map, and Map Name settings.

Color Name and Number (XPP colors only)

Enter the name and number for the color in the Color Name and Number fields.If this is a spot color, XPP displays the name from the Color Name field in theslug line of the plate for this color when you output separations. If youleave the Color Name field blank, XPP displays the color number as thedefault in the slug of the separation plate. If this is a spot color that isdefined as part of a named plate set, then XPP outputs the plate set name.

Entry Description

1 black Default black.

2 white Default white.

3 red Default red.

4 green Default green.

5 blue Default blue.

6 cyan Default cyan.

7 magenta Default magenta.

8 yellow Default yellow.

9 – 65534 Numbers for user-defined colors.

65535 Reserved to designate a special color that appears on everyplate when outputting color separations. Also required inevery Color Control Spec to ensure that tints 1 through 100appear in filled shapes created with XyMacros.

You can use any color you want for this number, but youcannot use this number for any other purpose.

Comments If you use a color chart to determine your colors, you may want to follow anumbering scheme similar to the numbers used in the chart for any colorsthat you define.

Values 1 through 8 are reserved for the default colors. While you can adjustthe values of these colors, you cannot change their numbers or names.

Color Model (XPP colors only)

The Color Model field indicates the model used for the selected color. Thesetting determines which set of color percentage slider bars and numericfields XPP uses to define the selected color.

Understanding the Edit Color Dialog Box

4-8 Managing Color Definitions Tints, Color, and Pattern Management

Entry Description

RGB Designates that this color is in RGB format. The colorpercentage slider bars and numeric entry fields that displayare Red, Green, and Blue.

RGB colors are additive — the more you add of each color, themore you approach white. 100% each of all three colorsproduces white. Projected light uses RGB colors.

Defining colors for video display is the most common use forthe RGB color model, for example, for online documentation.Although you can use this model to define colors for printedmaterials, SDL recommends using the CMYK color model.

When using the RGB color model, XPP applies undercolorremoval when converting to CMYK for separation plates.

CMYK Designates that this color is in CMYK format. The colorpercentage slider bars and numeric entry fields that displayare Cyan, Magenta, Yellow, and Black. CMYK colors aresubtractive — the more you subtract of each color, the moreyou approach white. 100% of each color (CMY) produces animpure black. Printers use this system.

Color Values (XPP colors only)

Depending on the Color Model that you select (RGB or CMYK), there arethree or four slider bars and corresponding numeric fields available toadjust the color percentages for the selected color definition.

To use a slider bar, press and hold the cursor on the slider and drag it to thedesired percentage. As you move the slider, XPP shows the effect on thecolor in the New field. Compare this color to the existing color shown in theOld field and continue adjusting until you are satisfied with the result.

Alternatively, to use a numeric field, enter a value to three decimal places.

Refer to appropriate color charts for percentage values.

Comments When outputting a proof to a color printer or when previewing the page ona color monitor, XPP uses the values in these fields to determine the color.The tint currently in effect in the Special Effects Patterns (SEP) Spec(patterns 1−100) determines the density of the color. Refer to Chapter 6,“Setting Up Tints and Patterns” for information on the SEP Spec.

When outputting separations, colors appear as shades of gray. XPP convertsRGB values to their CMYK values and uses the tint currently in effect todetermine the density of the gray.

When outputting a composite page (not separations) to a black and whiteprinter, colors appear as shades of gray. The printer uses the values in theRGB fields or the CYMK fields and the tint currently in effect to determinethe density of the gray.

Understanding the Edit Color Dialog Box

Tints, Color, and Pattern Management Managing Color Definitions 4-9

Overprint (XPP colors only)

Indicates whether this color prints on top of other colors. This check boxhas an effect only when you perform color separations.

When printing a dark color element, such as black type, over a light colorbackground, you can sometimes use overprinting to avoid the need fortrapping. You can also sometimes use overprinting to create the effect of athird color, for example overprinting yellow and blue to create green. Toavoid this effect, clear the Overprint check box to ″knock out″ the overlappingcolors, as shown in Figure 4-1. When Overprint is selected, XPP createsseparations with no knock-outs, as shown in the Figure 4-2.

You may have a color that you want to overprint in some cases andknockout in other cases. One way to do this is to create two definitions ofthe same color. Give each color a unique number, and specify overprint forone and no overprint for the other. You can then call in the appropriatecolor number to produce the desired effect. The following figure is anexample of overprinting.

If both colors are defined as spot colors, they appear on different plateswhen outputting separations, unless they have been mapped to one plateset. Refer to Chapter 5, “Managing Color Separations”.

The following table describes the printing behavior of a color based onwhether its Overprint check box is selected.

Overprint selected? Description

YES This color prints on top of other colors (if any), resulting in ablending of the colors. The region under this color is notknocked out.

TTT

Top color Bottom color Printed piece

Figure 4-1 Example of Knockout Color Separations

TT

Top color Bottom color Printed piece

Figure 4-2 Example of Overprinting Color Separations

Understanding the Edit Color Dialog Box

4-10 Managing Color Definitions Tints, Color, and Pattern Management

Overprint selected? Description

NO The region underneath this color is knocked out, that is, onlythe foreground color prints, the background color does notprint (default).

Spot Color

Indicates whether this definition is for a spot color.

The following table describes the properties of a color based on whether itsSpot Color check box is selected.

Spot Color selected? Description

YES This definition is a spot color.

NO This definition is not a spot color (default).

Comments If you define spot colors and output separations, each spot color appears onits own plate unless you map it to a set of colors using spot color mapping.Refer to Chapter 5, “Managing Color Separations” for more information onspot mapping. Spot colors display in shades of gray. The current tint in theSpecial Effects Patterns (SEP) Spec (patterns 1−100) determines the densityof the gray. Refer to Chapter 6, “Setting Up Tints and Patterns” forinformation on the SEP Spec.

If you define a spot color, XPP uses values set in the CMYK or RGB sliderbars to print color proofs. Color charts are available that provideinformation on the percentages of process colors that make up spot colors.If you do not define CMYK or RGB values for a spot color, the color appearsblack or gray.

Spot Map

Determines whether you can map one color with another color to appear onthe same plate.

The following table describes the properties of a color based on whether itsSpot Map check box is selected.

Spot Map selected? Description

YES This color can be mapped with other colors on the sameplate.

NO This color cannot be mapped with other colors (default).

Understanding the Edit Color Dialog Box

Tints, Color, and Pattern Management Managing Color Definitions 4-11

Comments Because this is an option for spot colors, it is not available unless you selectSpot Color in the Edit Color or Edit External Color dialog box.

Refer to Chapter 5, “Managing Color Separations” for information onmapping spot colors and spot maps.

Map Name

Determines the map to which a spot color is assigned.

The Map Name drop down lists the available spot maps to which the colorcan be assigned. To assign the color to a spot map, select the desired spotmap from the list.

Comments Because this is an option for spot colors, it is not available unless you selectSpot Color and Spot Map in the Edit Color or Edit External Color dialogbox.

To add a new spot map to the list of available spot maps, click the NewButton to display the New Map dialog box.

Refer to Chapter 5, “Managing Color Separations” for information onmapping spot colors and spot maps.

Understanding the Edit Color Dialog Box

4-12 Managing Color Definitions Tints, Color, and Pattern Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Deleting a Color Definition

You can delete a user-defined XPP color definition or an EPSF colordefinition from a Color Control Spec.

Note: You cannot delete the system colors 1-8 or 65535.

To delete a color definition from a Color Control Spec:

1. Access the Color Control window at the appropriate level (job, stylelibrary, or system). (Refer to “Understanding the Color ControlWindow” on page 3-2.)

2. Select the color definition you want to delete.

When you select Delete Color, the selected color is deleted. There is no confirmation

dialog box.

3. From the edit menu, select Delete Color.The selected color is deleted.

Deleting a Color Definition

Tints, Color, and Pattern Management Managing Color Definitions 4-13

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Importing EPSF Spot Color Definitions

You can import spot color definitions from EPSF graphics and add them toa Color Control Spec at the system level, the style library level, or the joblevel.

Note the following information concerning EPSF graphics:

• You can use the information from spot color mapping definitions ofEPSF graphics to define non-standard behavior in spot color mapping,or to use EPSF spot colors as process colors.

• There is no need to import any spot colors into a Color Control Spec ifyou intend to output EPSF spot colors on separate spot colorseparation plates.

• At the system and style library levels, you can search specificgraphics libraries for EPSF files with spot color definitions.

• At the job level, XPP searches all of the divisions in that job andimports, to the open spec, any spot color definitions for any EPSFgraphics referenced within any division in the job.

• XPP imports only new EPSF color definitions. That is, XPP does notoverwrite any EPSF color names that already exist in a spec, either atthe job or system level.

Importing EPSF Color Definitions at the Job Level

XPP searches for spot colors in all EPSF graphics referenced in divisions ofthe specified job.

To import EPSF color definitions at the job level:

1. Access the Color Control window at the job level. (Refer to“Understanding the Color Control Window” on page 3-2.)

2. Select Import Image Colors from the Edit menu.XPP begins to import all of the EPSF color definitions available at thejob level and displays a wait cursor.

3. Click OK to return to the Color Control window.

Importing EPSF Color Definitions at the Style Library orSystem Level

To import EPSF color definitions at the style library or system level:

1. Access the Color Control window at the style library or system level.(Refer to “Understanding the Color Control Window” on page 3-2.)

Importing EPSF Spot Color Definitions

4-14 Managing Color Definitions Tints, Color, and Pattern Management

2. Select Import Image Colors from the Edit menu.XPP displays the Import Image Colors dialog box, listing graphiclibraries.

3. Select the graphic library from which you want to import EPSF colordefinitions.

4. Click OK.XPP imports all the EPSF color definitions in the selected graphiclibrary to the open Color Control Spec while displaying a wait cursor.When the colors have been imported, XPP displays a confirmationmessage.

5. Click OK to return to the Color Definitions window.

6. When you finish importing, from the File menu, select Save to savethe changes to the spec or Quit to exit the window without saving thechanges.

Importing EPSF Spot Color Definitions

Tints, Color, and Pattern Management Managing Color Definitions 4-15

4-16 Managing Color Definitions Tints, Color, and Pattern Management

Chapter 5

Managing Color Separations

You can output color-separated PostScript files with the following options:

• Cyan, magenta, yellow, black, and optional spot colors for eachdocument page.

• CMYK or RGB color models (RGB is converted to CMYK).

• A slug line that identifies the color separation page as cyan, yellow,magenta, black, or as a spot color page, or a name of a plate mappingset.

• Specified screen angles, and frequencies for each separation plate.

• A specified dot shape for all separation plates.

• Undercolor removal techniques for each process or spot color if thecolor uses the RGB model.

Color separation is controlled by:

• Separation properties associated with each color

• Undercolor removal

• Spot function (dot shape)

Tints, Color, and Pattern Management Managing Color Separations 5-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Controlling Color Separation Values

You can control the values used for color separations if the XPP Postscriptdriver is used to generate color separated pages.

To control the values for color separations:

1. Access the Color Control window at the job level. (Refer to“Understanding the Color Control Window” on page 3-2.)

2. Modify the following separation controls and values for all separationplates:

• Halftone Spot Function—Select the shape of the halftone dot. (Refer to″Setting the Halftone Spot Shape″ on page 5-3.)

• Undercolor Removal—Use to adjust the percentage of undercolorremoval, if needed. (Refer to ″Setting Undercolor Removal Values″

on page 5-5.)

3. Set the separation properties for each color whose values you want tomodify.

• Separation Properties—Use to edit individual separation plates or aplate mapping set for screen angle and frequency. (Refer to ″SettingScreen Angle and Frequency,″ which follows.)

4. Do one of the following:

• Click the Save button to save changes and exit.

• Click the Quit button to exit without making any changes.

Setting Screen Angle and Frequency

You can edit individual separation plates (cyan, magenta, yellow, black) andeach spot color or spot map to specify screen angle values and screenfrequency.

To edit individual separation plates:

1. Click the underlined name of the spot color you want to edit in theColor Control window. If the color is assigned to a spot map, thesettings you apply will be made to all the colors assigned to that map.XPP displays the Edit Color dialog box for system and user-definedcolors, or the Edit External Color dialog box for EPSF colors.

2. In the Color Separation section of the dialog box, set the values forAngle and Frequency as described in the following section.

Controlling Color Separation Values

5-2 Managing Color Separations Tints, Color, and Pattern Management

3. Do one of the following:

• Click the OK button to save changes and return to the ColorControl window.

• Click the Cancel button to exit the dialog box without making anychanges.

Angle

Drag the Angle slider bar to the desired angle. The defaults are: 0° for yellow,15° for cyan, 45° for black and 75° for magenta.

The value in the Angle field is the angle at which XPP places the dots in ascreened area. The angle is set so that even though the dots in thesuperimposed screens are different colors, the eye perceives a single color.On close inspection, you can detect the different color dots because thescreen for each separation plate is set at a different angle. When the screensare superimposed, the dots are printed adjacent to each other instead ofdirectly on top of each other.

When superimposing screens, undesirable moire patterns (grid-likepatterns) may appear. You can eliminate moire patterns by adjusting thescreen angle.

Frequency

The default value of 0 (zero) tells XPP to use the currently defined defaultfor the selected device. Change the screen frequency value by clicking in theFrequency field, deleting the existing value and entering a new number.

The value displayed in the Frequency field determines the size and density ofthe dots that comprise the screen. Screen frequency is equivalent to thenumber of dots per inch, or line value (such as 150-line screen or 133-linescreen). A high screen frequency (also called linescreen or screen ruling)prints the dots close together, creating sharp, distinct colors and images. Alow screen frequency prints the dots farther apart, creating a coarser effect.

Setting the Halftone Dot Shape

You can set the dot shape with the Color Separation dialog box. Only onedot shape can be active in a separation print job.

To set the dot shape:

1. From the Color Control window Separation menu, select SpotFunction.XPP displays the Color Separation dialog box.

Controlling Color Separation Values

Tints, Color, and Pattern Management Managing Color Separations 5-3

2. Select one of the following dot shapes for printing halftones:

• Printer default

• Round dot

• Elliptical dot

• Diamond dot

• Rhomboid dot

• Line screen

3. Do one of the following:

• Click the OK button to save changes and return to the ColorControl window.

• Click the Cancel button to exit the dialog box without making anychanges.

Understanding Undercolor Removal

When outputting color separations, XPP converts to the CMYK color model,all pictures or XPP files that were colored with the RGB color model.

In almost all cases, you should use the CMYK model from the beginning sothat no conversion is necessary. Exceptions are documents you prepare forelectronic viewing (such as for Adobe Acrobat), because RGB is the nativecolor model of computer displays.

If you are importing color TIFF photos that have been scanned as RGB, SDLrecommends converting them to CMYK in an application such asPhotoshop before importing them into XPP, so you can have control overthe RGB-to-CMYK conversion of each photo, and be able to view the resultson the monitor.

Controlling Color Separation Values

5-4 Managing Color Separations Tints, Color, and Pattern Management

In summary:

• Undercolor removal (UCR) affects only RGB colors that are convertedby XPP on output to CMYK.

• UCR has no effect on standard CMYK graphics and color separationsin a job.

• You cannot view the effects of UCR on the monitor. Results are visibleonly with a color proof.

If the results of the XPP RGB-to-CMYK conversion are not what youexpected or wanted, you can override the XPP routine by using theUndercolor Removal dialog box, as described in the next section.

Setting Undercolor Removal Values

You can use the undercolor removal slider bars in the Undercolor Removaldialog box to adjust the color threshold for removal of underprinting colorsin separation plates. However, this is necessary only if you defined theoriginal colors as RGB, and if the automatic XPP routine does not produceexpected results.

The amount of black replacement and undercolor removal that is requireddepends on many factors, such as the halftone screen value, the printingpress, and the paper. For example, adjustments in undercolor removalvalues can compensate for dot gain that often occurs on low-grade papersuch as newsprint.

The default values work in most cases. Do not change the default values unless it is

necessary for specialized cases, and unless you are knowledgeable about color

separations and printing.

To set the undercolor removal values:

1. From the Color Control window Separation menu, select UndercolorRemoval.XPP displays the Undercolor Removal dialog box.

Controlling Color Separation Values

Tints, Color, and Pattern Management Managing Color Separations 5-5

2. Use the sliders to adjust the color thresholds for yelow, magenta, andblack undercolor removal.

3. Do one of the following:

• Click the OK button to save changes and return to the ColorControl window.

• Click the Cancel button to exit the dialog box without making anychanges.

Undercolor Yellow Removal

To perform color correction by removing yellow from magenta, drag theUndercolor Yellow Removal slider bar to the desired percentage. To determinethe amount of yellow to remove, XPP uses the value specified by theUndercolor Yellow Removal slider bar and the amount of magenta. To removemore yellow, set the slider to a higher percentage. The default value is 48%.

On separation, the yellow plate displays with a lighter shade of gray andthe magenta plate displays with a darker shade of gray.

Undercolor Magenta Removal

To perform color correction by removing magenta from cyan, drag theUndercolor Magenta Removal slider bar to the desired percentage. To determinethe amount of magenta to remove, XPP uses the percentage specified by theUndercolor Magenta Removal slider bar and the amount of cyan. To removemore magenta, drag the slider to a higher percentage. The default value is31%.

On separation, the magenta plate displays with a lighter shade of gray andthe cyan plate displays with a darker shade of gray.

Controlling Color Separation Values

5-6 Managing Color Separations Tints, Color, and Pattern Management

For example, if you create a color using the RGB model, on output, XPPconverts the RGB values to CMYK values. The resulting color is now acombination of yellow and magenta. To decrease the amount of yellow inthe color, set the value in the Yellow Undercolor Removal slider bar to a higherpercentage.

Undercolor Black Removal Threshold

The black produced by a combination of cyan, magenta, and yellow is not apure black (it is a muddy-black color). You can use undercolor removal toreplace this black with black ink, instead of producing black by combininginks. This allows you to produce truer colors.

To remove the black produced by combining cyan, magenta, and yellow,drag the Undercolor Black Removal Threshold slider bar to a value less than thethreshold for cyan, magenta, and yellow. When the percentages of cyan,magenta, and yellow are all above the threshold, XPP performs undercolorremoval. It takes the difference between the threshold value and the colorvalue closest to the threshold and deducts that amount from each of thecolors.

On separation, the cyan, magenta, and yellow plates display with a lightershade of gray and the black plate displays with a darker shade of gray. Thedefault threshold value is 50%.

For example, you have the black undercolor removal value set to 50%. If acolor contains 80% cyan, 70% magenta, and 60% yellow, the value closest tothe threshold of 50% is 60 (yellow). The difference (60% - 50%) is 10%. XPPdeducts 10% from each of the colors, then adds that same amount (plus acalculated adjustment to compensate for additive failure) to the value forblack. The resulting color a combination of 70% cyan, 60% magenta, and50% yellow and 12.5% black.

Controlling Color Separation Values

Tints, Color, and Pattern Management Managing Color Separations 5-7

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Understanding Spot Color Mapping

You can use spot color mapping to output two or more XPP and/or EPSFdefined spot colors as a single color on one separation plate.

By default, each spot color with a unique name is output on its ownseparation plate unless you combine groups of spot colors into plate sets.Each spot color plate set, or spot map, can consist of any combination oftwo or more XPP and EPSF spot colors.

You can do the following:

• Assign names to spot color plates sets.

• Define any number of spot color plate sets.

• Assign two or more colors to a plate set.

To output two or more spot colors as a single color on one separation plate:

• Select the Spot Map check box in the Edit Color or Edit External Colordialog box for each spot color that you want to include.

• Assign each color to a new or existing spot map (color separationplate).

In the Color Control window, XPP shows the spot map to which these spotcolors are assigned.

Refer to Chapter 4, “Managing Color Definitions,” for more information onthe Edit Color and Edit External Color dialog boxes.

Assigning a Color to a Spot Map

You can assign a color to a new or existing spot map by selecting in theColor Control window for editing.

To assign a color to a spot map:

1. Access the Color Control window at the job or division level. (Refer to“Understanding the Color Control Window” on page 3-2.)

By default, the Color Control window shows the spec’s colordefinitions. Figure 4-1 on page 4-2 shows an example of a speccontaining XPP and EPSF color definitions.

In the Color Control window, the Spot column indicates whether eachcolor is a spot color. For each spot color, the Spot Map columnindicates which spot map, if any, to which the color is assigned.

2. Select the color you want to edit and select Edit Color from the Edit

Understanding Spot Color Mapping

5-8 Managing Color Separations Tints, Color, and Pattern Management

menu.XPP displays the Edit Color dialog box for a system or user-definedcolor, or the Edit External Color dialog box for an EPSF color. (Refer to″Understanding the Edit Color Dialog Box″ on page 4-6.)

3. If the color you want to assign to a spot map is not defined as a spotcolor, select Spot Color to define it as a spot color.

4. Select Spot Map to enable the color for spot mapping.

5. If you want to assign the color to a map that has not yet been created:

a. Click New.XPP displays the New Map dialog box.

b. In the New Map Name field, type the name of the new map.

c. Click OK to save the new map name and return to the Edit Color orEdit External Color dialog box.

6. From the Map Name list, select the map to which you want to assignthe color.

7. Do one of the following:

• Click the OK button to save changes and return to the ColorControl window.

• Click the Cancel button to exit the dialog box without making anychanges.

Naming a Plate Set

As with process color plates, spot color plates have a name in the slugline.With spot color plate sets, this name can be any user-defined name. Forexample, you can assign a name to a plate set to identify it by color, job, orcustomer.

Removing a Color from a Spot Map

When you remove a color from a spot map, the color returns to the defaultof having its own separation plate.

To remove a color from a spot map:

1. Access the Color Control window at the job or division level. (Refer to“Understanding the Color Control Window” on page 3-2.)

2. Select the color you want to remove from a spot map, and select EditColor from the Edit menu.XPP displays the Edit Color dialog box for a system or user-definedcolor, or the Edit External Color dialog box for an EPSF color. (Refer to″Understanding the Edit Color Dialog Box″ on page 4-6.)

Understanding Spot Color Mapping

Tints, Color, and Pattern Management Managing Color Separations 5-9

3. Clear the Spot Map check box.The map name is removed from the Map Name field, which is thendisabled.

4. Do one of the following:

• Click the OK button to save changes and return to the ColorControl window.

• Click the Cancel button to exit the dialog box without making anychanges.

When you click OK, XPP immediately removes the color from the spot map. There is

no confirmation dialog box.

Understanding Spot Color Mapping

5-10 Managing Color Separations Tints, Color, and Pattern Management

Part II

Managing Tints and Patterns

Chapter 6

Setting Up Tints andPatterns

This chapter describes the following topics:

• The Special Effects Patterns (SEP) Spec

• The process to update the SEP Spec when upgrading XPP

• The patterns delivered by SDL with XPP

Tints, Color, and Pattern Management Setting Up Tints and Patterns 6-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

The Special Effects Patterns (SEP) Spec

The Special Effects Patterns (SEP) Spec contains definition rules for tintsand patterns:

• Rule numbers 1−100 are reserved as tints, each number representingthe density of the screen from 1% to 100%.

• Rule numbers 101− 164 are reserved for the XPP-delivered patternsshown in the figures on pages 6-9 and 6-10.

• Rule numbers 165 and higher are reserved for you to define additionalrules for customized patterns.

When you initially install software, SDL delivers a default SEP Spec, namedsep ps.sde, to the $XYV STYLES/Lsyslib directory. The default SEP Spec

references a definepatt2 definition that describes XPP patterns in level 2PostScript output.. If you are using level 1 output, SDL continues to deliverthe original file, now called _sep_level1.sde, which references the originaldefinepatt file for backward compatibility.

When you upgrade to a new release of software, SDL delivers a new defaultPostScript SEP Spec, _sep_ps.sde, to the xylibrary distribution directory. TheSEP Spec in the syslib library is not overwritten during a software upgrade.Refer to the section “After Upgrading to a New XPP Release” on page 6-6for instructions on accessing the information in the newly-delivered SEPSpec.

The Default SEP Spec

The SEP Spec contains two tables: shape and pattern.

The first table in the default SEP Spec is the shape table, which containsdefinitions that XPP uses to fill rectangles, tabular elements, and circles. Youdo not directly access the information in this table; XPP uses it internally.

The second table, the pattern table, contains rules with the following patternnumbers and definitions:

The pattern rule with this name... is used by XPP to...

0 fill an element with a color

1− 100 fill an element with a tint, or screen percentageof 1 through 100%

101 – 164 fill an element with one of the 64 SDL-delivered patterns

165 – 65535 fill an element with a user-defined pattern

The Special Effects Patterns (SEP) Spec

6-2 Setting Up Tints and Patterns Tints, Color, and Pattern Management

The following figure shows the pattern table in the default SEP Spec.

SEP Spec Fields

Note: Do not modify the definitions of the SDL-delivered shapes or patterns in thedefault spec. To define additional patterns, add rules to the pattern table or createadditional SEP Specs.

Table Comment

A comment, such as whether this table defines patterns or shapes.

Entry Description

string Maximum 71⁄2 lines.

Type

Specifies whether this table defines patterns or shapes.

Entry Description

pattern Specifies that the table defines patterns.

shape Specifies that the table defines shapes. The shape table is forinternal use —do not modify.

Figure 6-1 Default SEP Spec — Pattern Table

The Special Effects Patterns (SEP) Spec

Tints, Color, and Pattern Management Setting Up Tints and Patterns 6-3

Name

The number of the shape or pattern. This is the number you enter in thefollowing locations:

• pattern argument(s) of XyMacros

• Pattern fields in the Item Format (IF) or Page Layout (PL) Spec

• Pop-up window for creating annotation, caption, and title blocks

• Form Modify pop-up window when using Interactive Page Layout

Entry Description

0 Specifies no pattern.

1 – 100 Specifies a tint (in percent).

101 – 164 Specifies an SDL-delivered pattern.

165 – 65535 Specifies a user-defined pattern.

Output

The syntax required to output the specified pattern.

Entry Description

string Outputs the specified pattern.

You may enter a command in the typesetter language,followed by the characters you want output directly to thetypesetter.

Creating Multiple SEP Specs

You can create multiple SEP Specs for use on output. You can choosewhether you want to include the XPP-delivered patterns in alternate SEPSpecs. To output any additional patterns you create, your output devicemust be able to support those patterns.

Creating a New SEP Spec

Create new SEP Specs in the syslib library. For XPP to use the SEP Spec, itmust be in the syslib library.

To create a new SEP Spec:

1. Select STYLE LIBRARIES > Lsyslib in the PathFinder Tree View.

2. Right-click Lsyslib.PathFinder displays a pop-up menu.

3. Select New > Special Effects Patterns.

The Special Effects Patterns (SEP) Spec

6-4 Setting Up Tints and Patterns Tints, Color, and Pattern Management

XPP creates a new spec, named new, in the Special Effects Patternfolder in the PathFinder List View, ready to be renamed.

4. Rename the spec.

5. Edit the new spec as desired.To include the XPP-delivered patterns in your new SEP Spec:

a. Open the default SEP Spec, sep ps.

b. Select and save the tables for the XPP-delivered patterns.

c. Open the new SEP Spec.

d. Restore the tables you saved from the sep ps Spec.

6. Select Store/Exit from the Softkey menu when you are finished editingthe spec.

Copying the Default SEP Spec

You may want to copy the default SEP Spec, then modify the copy. If youcopy the default spec, the copied spec contains the XPP-delivered patterns.

To copy the default SEP Spec:

1. Double-click STYLE LIBRARIES in the PathFinder Tree View.PathFinder expands STYLE LIBRARIES, displaying all the availablelibrary types.

2. Click Lsyslib > Special Effects Patterns.PathFinder displays the names of the SEP specs in the PathFinder ListView.

3. Right-click the spec you want to copy.PathFinder displays a Popup menu.

4. Select Copy.

5. Right-click Lsyslib in the Tree View.PathFinder displays a pop-up menu.

6. Select Paste.PathFinder copies the selected SEP Spec and pastes it in the SpecialEffects Patterns folder as nameCOPY1, ready to be renamed.

7. Rename the nameCOPY1 spec.

8. Open and edit the spec.

9. Select Store/Exit from the Softkey menu to save your changes whenyou complete the edits.

The Special Effects Patterns (SEP) Spec

Tints, Color, and Pattern Management Setting Up Tints and Patterns 6-5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

After Upgrading to a New XPP Release

When you upgrade to a new release of XPP software, SDL may deliver anew default PostScript SEP Spec (sep_ps) to the following distributiondirectory:

$XYV STYLES/xylibrary/Lsyslib

Note: XPP does not overwrite the existing SEP Spec in the $XYV STYLES/Lsyslib directory during a software upgrade.

XPP requires the updated version of the SDL-delivered tables in the SEPSpec. The procedure for accessing the updated version of the SEP Specvaries depending on whether you have customized/copied the spec.

Non-customized SEP Spec

If you have not customized the SEP Spec in Lsyslib, perform the followingsteps to copy the newly-delivered spec to the syslib library.

This procedure overwrites the sep ps Spec in the syslib library. Do not perform this

procedure if you have modified the spec — you will lose your customizations.

UNIX

1. Log in as root.

2. Enter: source /etc/xyvision/xyv.cshrc at the command line.

3. Change directory to the destination library:

cd $XYV STYLES/Lsyslib

4. Copy the SEP Specs from the xylibrary directory to the current library:

cp $XYV STYLES/xylibrary/Lsyslib/_sep ps.sde .

cp $XYV STYLES/xylibrary/Lsyslib/_sep level1.sde .

(_sep_ps.sde references the definepatt2 definition, which describesXPP patterns in level 2. This spec is incompatible with –colorsep in theoutput driver since XPP only supports color separation in level 1.Therefore, if you intend to output color separation, you need to copy_sep_level1.sde to obtain backwards compatibility.)

After Upgrading to a New XPP Release

6-6 Setting Up Tints and Patterns Tints, Color, and Pattern Management

Windows

You can copy the SEP Spec using Windows Explorer.

1. Navigate to %XYV_STYLES%\xylibrary\Lsyslib

2. Copy _sep_ps.sde and _sep_level1.sde.(_sep_ps.sde references the definepatt2 definition, which describesXPP patterns in level 2. This spec is incompatible with –colorsep in theoutput driver since XPP only supports color separation in level 1.Therefore, if you intend to output color separation, you need to copy_sep_level1.sde to obtain backwards compatibility.)

3. Paste to %XYV_STYLES%\Lsyslib.

Customized/Copied SEP Specs

If you have customized or copied the sep ps Spec, you need to access onlythe SDL-defined tables in the updated spec. Using this procedure, you canaccess the updated table without losing the customizations you have madeto the spec.

To access the updated tables only:

1. Navigate to $XYV_STYLES/xylibrary/Lsyslib.

2. Open the spec:

a. UNIX: Enter run sdedit sep ps at the command line.

b. Windows: Double-click _sep_ps.sde.

3. Select and save Table 1, the shape table to one save file, and Table 2,the pattern table, to a different save file.To save a table to a save file:

a. Position cursor in the table.

b. Press Select Table > Save/Restore > Save on the Softkey Menu.Sdedit displays a Save dialog box.

c. Enter a unique name in the File Name text box and click the OKbutton.

4. Select Abandon Edit to exit the spec.

5. Navigate to $XYV_STYLES/Lsyslib.

6. Open the customized or copied SEP Spec.

7. Select the Shape table and delete it.

8. Select the Save/Restore > Restore options to restore the shape tableyou saved, selecting the uniquely named saved shape table.

After Upgrading to a New XPP Release

Tints, Color, and Pattern Management Setting Up Tints and Patterns 6-7

9. Repeat Steps 7 and 8 to restore the Pattern table.

Make sure that the shape table is the first table in the spec, and thepattern table is the second table in the spec.Now you have the newly delivered tables, but have not lost yourcustomizations.

10. Select the Store/Exit option to save the spec.

Repeat steps 7 through 10 for all your customized or copied SEP Specs.

After Upgrading to a New XPP Release

6-8 Setting Up Tints and Patterns Tints, Color, and Pattern Management

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

XPP-delivered Patterns

SDL delivers 64 patterns, numbered 101 through 164. The following figureshows patterns 101-132.

101 102 103 104

105 106 107 108

109 110 111 112

113 114 115 116

117 118 119 120

121 122 123 124

125 126 127 128

129 130 131 132

Figure 6-2 XPP-delivered Patterns 101-132

XPP-delivered Patterns

Tints, Color, and Pattern Management Setting Up Tints and Patterns 6-9

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123412341234

123456123456123456123456123456123456

123456123456123456123456123456123456

1234567890112345678901123456789011234567890112345678901123456789011234567890112345678901123456789011234567890112345678901

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

123456123456123456123456123456123456

1212

123412341234

123123123

123412341234

123123123

1212

123456123456123456123456123456123456

1234123412341234

1212

123456123456

123456789011234567890112345678901123456789011234567890112345678901

123456123456123456123456123456123456123456123456123456123456123456

123123123123123

The following figure shows patterns 133-164.

Note: Patterns 1-100 define tints.

133 134 135 136

137 138 139 140

141 142 143 144

145 146 147 148

149 150 151 152

153 154 155 156

157 158 159 160

161 162 163 164

Figure 6-3 XPP-delivered Patterns 133-164

XPP-delivered Patterns

6-10 Setting Up Tints and Patterns Tints, Color, and Pattern Management

Part III

Using Tints, Patterns, and Color

Chapter 7

Filled Rectangles

Using XyMacros, you can create a rectangle filled with a tint, pattern, orcolor. You can specify many characteristics of the rectangle, including thefollowing:

• Size — the width and depth of the rectangle

• Pattern — the pattern with which to fill the rectangle

• Color — the color with which to fill the rectangle, or, for patterns, thecolor of the pattern foreground and background

• Outline — the type of outline (such as single, double, or dashed), andthe thickness of the outline rule

• Corner type — square or rounded

Tints, Color, and Pattern Management Filled Rectangles 7-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Understanding Filled Rectangles

You can enter the XyMacros for rectangles in text or in a tag definition inthe Item Format (IF) Spec. You can place the rectangle in a specific positionon the page or you can create a filled rectangle with start and end positionsthat depend on the position of text.

XPP starts a filled rectangle at the current position and draws it to the rightand down. The remaining block depth is from the baseline of the currentline to the depth of the block.

Any text overlapping a tinted rectangle remains black, unless you alsoapply a special effect to the text.

Rectangle Dimensions

You can specify width and depth of the rectangle and the placement of theoutline rule:

• Inside the rectangle

• Outside the rectangle

• Straddling the rectangle

Outline Rule Inside Rectangle

If the outline rule is inside the rectangle, as shown in the following figure,the dimensions of the rectangle are from the outside edges of the outlinerule. In this case, the top of the rectangle is at the baseline.

Figure 7-1 Rectangle with Outline Inside the Shape

The dimensions of the rectangle are measuredfrom the outside edges of the outline rule.

baseline (at the top of the outline rule)

Understanding Filled Rectangles

7-2 Filled Rectangles Tints, Color, and Pattern Management

Outline Rule Straddling Rectangle

If the outline rule straddles the outline of the rectangle, as shown in thefollowing figure , the dimensions of the rectangle are from the midpoints ofthe outline rule. In this case, the midpoint of the outline rule is at thebaseline of the current position.

Outline Rule Outside Rectangle

If the outline rule is outside the rectangle, as shown in the following figure,the dimensions of the rectangle are from the inside edges of the outline. Inthis case, the inside of the outline is at the baseline.

Display of Filled Rectangles

PostScript devices display filled rectangles based on their special effectscapabilities.

Figure 7-2 Rectangle with Outline Straddling the Shape

The dimensions of the rectangle are measuredfrom the midpoints of the outline rule.

baseline (at the midpoint of the outline rule)

Figure 7-3 Rectangle with Outline Outside the Shape

The dimensions of the rectangle are measuredfrom the inside edges of the outline rule.

baseline (at the inside of the outline rule)

Understanding Filled Rectangles

Tints, Color, and Pattern Management Filled Rectangles 7-3

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Filled Rectangle XyMacros

The following sections detail the syntax and arguments of the filledrectangle XyMacros:

Description XyMacro

Draw Filled Box < fbox >

Draw Filled Box with Text < fboxt >

Start Filled Box with Text < sfboxt >

End Filled Box with Text <efboxt >

Draw Filled Box

Draws a box with the specified parameters, then returns the cursor to itscurrent position.

fbox Draw Filled Box

Format < fbox; pattern; main-color; alternate-color; width; depth; outline-size;

outline-type; dash-length; space-between-dashes; corner-radius; priority;

screen-angle; screen-frequency >

Argument Valid Entries

pattern 0 — No color fill (transparent)

An integer from 1 through 65535 — Selects a valid rulenumber from the Special Effects Patterns (SEP) Spec.

Pattern numbers 1 through 100 correspond to the density ofthe specified main color. Lower tint values produce lightershades; higher tint values produce darker shades.

Pattern numbers 101 through 164 specify XPP-deliveredpatterns. The main and alternate colors are always 100percent of the specified color.

To create a pattern with a lighter or darker shade of a color,you must define the color in the Color Control Spec, thenspecify that color in the main-color or alternate-color field.

Filled Rectangle XyMacros

7-4 Filled Rectangles Tints, Color, and Pattern Management

Argument Valid Entries

main-color 0 = No color (transparent) if pattern is also 0 or greater than100; otherwise, 0 = Normal color (color specified for theblock contents) if pattern is 1-100.

65535 — Specifies no color (transparent).

Activates the following rules in the Color Control Spec:(Numbers 1-8 correspond to the standard XPP colors.)

1 — black (default)

2 — white

3 — red

4 — green

5 — blue

6 — cyan

7 — magenta

8 — yellow

9 through 65534 — user-defined rules.

For tints (pattern numbers 1 – 100), the main color is thecolor of the fill.

For patterns (pattern numbers 101 – 164), the main color isthe foreground of the pattern.

alternate-color 65535 — Specifies no color (transparent).

Note: 0 is not allowed.

Activates the following rules in the Color Control Spec:(Numbers 1-8 correspond to the standard XPP colors.)

1 — black

2 — white (default)

3 — red

4 — green

5 — blue

6 — cyan

7 — magenta

8 — yellow

9 through 65534 — user-defined rules.

For patterns (pattern numbers 101 – 164), the alternate coloris the background of the pattern.

width A positive qualified numeric value that specifies thehorizontal extent of the rectangle.

Defaults to the current line measure.

depth A positive qualified numeric value that specifies the verticalextent of the rectangle.

Defaults to the remaining block depth.

Filled Rectangle XyMacros

Tints, Color, and Pattern Management Filled Rectangles 7-5

Argument Valid Entries

outline-size A positive qualified numeric value up to 2.25 inches thatspecifies the thickness of the outline rules.

Defaults to 1q.

outline-type Specifies the type of outline rule to draw around the box:

non — no outline.

Single outlines:1

sn — A single outline that straddles the boundary of thefilled area (default).

sni — A single outline placed inside the filled area.

sno — A single outline placed outside the filled area.

Double outlines:2

db — A double outline that straddles the boundary of thefilled area.

dbi — A double outline placed inside the filled area.

dbo — A double outline placed outside the filled area.

odb — A double outline, with outer line twice as wide asinner line, that straddles the boundary of the filledarea.

odbi — A double outline, with outer line twice as wide asinner line, placed inside the filled area.

odbo — A double outline, with outer line twice as wide asinner line, placed outside the filled area.

idb — A double outline, with inner line twice as wide asouter line, that straddles the boundary of the filledarea.

idbi — A double outline, with inner line twice as wide asouter line, that is placed inside the filled area.

idbo — A double outline, with inner line twice as wide asouter line, that is placed outside the filled area.

Dashed outlines:3

dsh — A dashed outline that straddles the boundary of thefilled area.

dshi — A dashed outline placed inside the boundary of thefilled area.

dsho — A dashed outline placed outside the boundary of thefilled area.

dash-length For dashed outlines, a positive qualified numeric value thatspecifies the length of the dash.

Defaults to the outline size.

space-between-dashes

For dashed outlines, a positive qualified numeric value thatspecifies the amount of space between dashes.

Defaults to the dash length.

Filled Rectangle XyMacros

7-6 Filled Rectangles Tints, Color, and Pattern Management

Argument Valid Entries

corner-radius A positive qualified numeric value that specifies the radiusof all four corners for rounded corners. Enter larger values inthis argument to make box corners more curved.

Defaults to 0 for square corners.

priority Controls which area is visible on top of another area. An areawith a higher priority hides any portion of a lower priorityarea that it overlaps. If areas have the same priority, thearea(s) lower on the page hide the portion(s) of the area(s)higher on the page that they overlap.

Text and graphic blocks have a priority of 0; you cannotchange the priority of text. Assign a priority less than 0 tofilled areas that you want text to overlap. Assign a prioritygreater than 0 to filled areas you want to overlap the text. Ifyou assign a priority of 0 to a filled area, text overlaps thearea, but the area overlaps any filled area with a priority lessthan 0.

An integer in the range from -127 to 127 that specifies thepriority of the current shape.

Defaults to -30

screen-angle Number of degrees by which the halftone screen should berotated with respect to the device coordinate system. Thevalue in this argument overrides values in the Color ControlSpec for regions filled with spot colors only.

Screen angle values are applied only if the associated tintcolors have their spot color field turned on. Defaults to nochange in the screen angle.

Acceptable values are device-dependent.

screen-frequency Sets screen frequency in halftone cells per inch in devicespace. The value in this argument overrides the valuesdefined in the Color Control Spec for regions filled with spotcolors only.

Screen frequency values are applied only if the associatedtint colors have their spot color field turned on. Defaults tono change in the screen frequency.

Acceptable values are device-dependent.

1 Single outlines — the outline rule is 100 percent of the main color.2 Double outlines — the outline-size argument specifies the width of the entire

outline, including the inner line, the space, and the outer line. The outline rulesare in 100 percent of the specified main color and the space between the doubleoutlines is in 100 percent of the alternate color.

3 Dashed outlines — the foreground dashes are 100 percent of the main color. Thebackground dashes are 100 percent of the alternate color if the pattern used is 101or greater. If a tint is used (1 through 100), background dashes appear in thatpercentage.

Filled Rectangle XyMacros

Tints, Color, and Pattern Management Filled Rectangles 7-7

Comments For rounded corners, the text may not be within the rounded portion of thecorner. To place the text within a box with rounded corners, use additionalmacros or tags, such as move horizontal (mh), preleading (lp), and so on.

If you specify db, dbi, or dbo to create a double outline, XPP creates anoutline with an inner rule, a space, and an outer rule in the ratio 2:1:2.

If you specify odb, odbi, or odbo to create a double outline where the outerline is twice the width of the inner line, XPP creates an outline with an innerrule, a space, and an outer rule in the ratio 1:1:2.

If you specify idb, idbi, idbo to create a double outline where the inner lineis twice the width of the outer line, XPP creates an outline with an innerrule, a space, and an outer rule in the ratio 2:1:1.

The following example shows three rectangles with different outlineplacements. Each rectangle is 6 picas wide and 4 picas deep, is filled with atint of 15 percent, and has an outline 4 points wide. The specifieddimensions of the rectangles are the same, however the rectangles aredifferent sizes because of the outline placement.

Rectangle 1 has a single outline placed inside the filled area.

To generate Rectangle 1, enter this macro:

< fbox;15;1;2;6p;4p;4q;sni >

Rectangle 2 has a single outline that straddles the boundary of the filledarea.

To generate Rectangle 2, enter this macro:

< fbox;15;1;2;6p;4p;4q;sn >

Rectangle 3 has a single outline placed outside the filled area.

To generate Rectangle 3, enter this macro:

< fbox;15;1;2;6p;4p;4q;sno >

Rectangle 1 Rectangle 2 Rectangle 3

Figure 7-4 Sample Filled Rectangles with Different Outline Placement

Filled Rectangle XyMacros

7-8 Filled Rectangles Tints, Color, and Pattern Management

In the following example, the rectangle has a dashed outline placed insidethe filled area. The rectangle is 7 picas wide and 7 picas deep, is filled witha 25 percent tint, and has an outline of 8 points wide consisting of dashesthat are 4 points wide.

Enter this macro:

< fbox;25;1;2;7p;7p;8q;dshi;4q >

To generate this filled rectangle:

The following example shows two rectangles that have different priorities.The large, dark rectangle has a priority of 0, while the small, light rectanglehas a priority of 1. The rectangle with a priority of 1 hides the portion of therectangle with a priority of 0 that it overlaps.

Enter these macros:

<mh;6p > < fbox;15;1;2;6p;4p;2q;sn;;;;1 > <mh;-3p >

< fbox;30;1;2;12p;6p;2q;sn;;;;0 >

To generate these rectangles:

Figure 7-5 Sample Filled Rectangle with a Dashed Outline

Figure 7-6 Sample Rectangles with Different Priorities

Filled Rectangle XyMacros

Tints, Color, and Pattern Management Filled Rectangles 7-9

Draw Filled Box with Text

Draws a box with the specified parameters and positions the cursor withinthe box at a specified indentation, ready for text entry. Text is placed withinthe width of the box; overflow is allowed at the bottom of the box.

fboxt Draw Filled Box with Text

Format < fboxt; pattern; main-color; alternate-color; width; depth; outline-size;

outline-type; dash-length; space-between- dashes; inside-gutter; corner-

radius; priority; screen-angle; screen-frequency >

Argument Valid Entries

pattern 0 — No color fill (transparent).

An integer from 1 through 65535 — Selects a valid rulenumber from the Special Effects Patterns (SEP) Spec.

Pattern numbers 1 through 100 correspond to the density ofthe specified main color. Lower tint values produce lightershades; higher tint values produce darker shades.

Pattern numbers 101 through 164 specify XPP-deliveredpatterns. The main and alternate colors are always 100percent of the specified color. To create a pattern with alighter or darker shade of a color, you must define the colorin the Color Control Spec, then specify that color in themain-color or alternate-color field.

main-color 0 = No color (transparent) if pattern is also 0 or greater than100; otherwise, 0 = Normal color (color specified for theblock) if pattern is 1-100.

65535 — Specifies no color (transparent).

Activates the following rules in the Color Control Spec:(Numbers 1-8 correspond to the standard XPP colors.)

1 — black (default)

2 — white

3 — red

4 — green

5 — blue

6 — cyan

7 — magenta

8 — yellow

9 through 65534 — user-defined rules

For tints (pattern numbers 1 – 100), the main color is thecolor of the fill.

For patterns (pattern numbers 101 – 164), the main color isthe foreground of the pattern.

Filled Rectangle XyMacros

7-10 Filled Rectangles Tints, Color, and Pattern Management

Argument Valid Entries

alternate-color 65535 — Specifies no color (transparent).

Note: 0 is not allowed

Activates the following rules in the Color Control Spec:(Numbers 1-8 correspond to the standard XPP colors.)

1 — black

2 — white (default)

3 — red

4 — green

5 — blue

6 — cyan

7 — magenta

8 — yellow

9 through 65534 — user-defined rules

For patterns (XPP-delivered pattern numbers 101 – 164), thealternate color is the background of the pattern.

width A positive qualified numeric value that specifies thehorizontal extent of the rectangle.

Defaults to the current line measure.

depth A positive qualified numeric value that specifies the verticalextent of the rectangle.

Defaults to the remaining block depth.

outline-size A positive qualified numeric value up to 2.25 inches thatspecifies the thickness of the outline rules.

Defaults to 1q.

outline-type Specifies the type of outline rule to draw around shape:

non — Specifies no outline.

Single outlines:1

sn — A single outline that straddles the boundary of thefilled area (default).

sni — A single outline placed inside the filled area.

sno — A single outline placed outside the filled area.

Double outlines:2

db — A double outline that straddles the boundary of thefilled area.

dbi — A double outline placed inside the filled area.

dbo — A double outline placed outside the filled area.

odb — A double outline, with outer line twice as wide asinner line, that straddles the boundary of the filledarea.

odbi — A double outline, with outer line twice as wide asinner line, placed inside the filled area.

Filled Rectangle XyMacros

Tints, Color, and Pattern Management Filled Rectangles 7-11

Argument Valid Entries

odbo — A double outline, with outer line twice as wide asinner line, placed outside the filled area.

idb — A double outline, with inner line twice as wide asouter line, that straddles the boundary of the filledarea.

idbi — A double outline with inner line twice as wide asouter line, placed inside the filled area.

idbo — A double outline with inner line twice as wide asouter line, placed outside the filled area.

Dashed outlines:3

dsh — A dashed outline that straddles the boundary of thefilled area.

dshi — A dashed outline placed inside the boundary of thefilled area.

dsho — A dashed outline placed outside the boundary of thefilled area.

dash-length A positive qualified numeric value that specifies the length ofthe dash for dashed outlines.

Defaults to the outline size.

space-between-dashes A positive qualified numeric value that specifies the amountof space between dashes for dashed outlines.

Defaults to the dash length.

inside-gutter A positive qualified numeric value that specifies the gutterbetween the internal text and the filled box.

Defaults to 1q.

corner-radius A positive qualified numeric value that specifies the radiusof all four corners for rounded corners. Enter larger values inthis argument to make box corners more curved.

Defaults to 0 for square corners.

Filled Rectangle XyMacros

7-12 Filled Rectangles Tints, Color, and Pattern Management

Argument Valid Entries

priority Controls which area is visible on top of another area. An areawith a higher priority hides any portion of a lower priorityarea that it overlaps. If areas have the same priority, therectangles lower on the page hide the portions of rectanglehigher on the page that they overlap.

Text and graphic blocks have a priority of 0; you cannotchange the priority of text. Assign a priority less than 0 tofilled areas that you want text to overlap. Assign a prioritygreater than 0 to filled areas you want to overlap the text. Ifyou assign a priority of 0 to a filled area, text overlaps thearea, but the area overlaps any filled area with a priority lessthan 0.

An integer in the range from -127 to 127 that specifies thepriority of the current shape.

Defaults to -30.

screen-angle Number of degrees by which the halftone screen should berotated with respect to the device coordinate system. Thevalue in this argument overrides the values defined in theColor Control Spec for regions filled with spot colors only.

Screen angle values are applied only if the associated tintcolors have their spot color field turned on. Defaults to nochange in the screen angle.

Acceptable values are device dependent.

screen-frequency Sets screen frequency in halftone cells per inch in devicespace. The value in this argument overrides the valuesdefined in the Color Control Spec for regions filled with spotcolors only.

Screen frequency values are applied only if the associatedtint colors have their spot color field turned on. Defaults tono change in the screen frequency.

Acceptable values are device dependent.

1 Single outlines — the outline rule is 100 percent of the main color.2 Double outlines — the outline-size argument specifies the width of the entire

outline, including the inner line, the space, and the outer line. The outline rulesare in 100 percent of the specified main color and the space between the doubleoutlines is in 100 percent of the alternate color.

3 Dashed outlines — the foreground dashes are 100 percent of the main color. Thebackground dashes are 100 percent of the alternate color.

Comments

For rounded corners, the text may not be within the rounded portion of thecorner. To place the text within a box with rounded corners, use additionalinside gutter.

Filled Rectangle XyMacros

Tints, Color, and Pattern Management Filled Rectangles 7-13

123456123456123456123456123456

If you specify db, dbi, or dbo to create a double outline, XPP creates anoutline with an inner rule, a space, and an outer rule in the ratio 2:1:2.

If you specify odb, odbi, or odbo to create a double outline where the outerline is twice the width of the inner line, XPP creates an outline with an innerrule, a space, and an outer rule in the ratio 1:1:2.

If you specify idb, idbi, idbo to create a double outline where the inner lineis twice the width of the outer line, XPP creates an outline with an innerrule, a space, and an outer rule in the ratio 2:1:1.

In the following example, the rectangle contains text and has a singleoutline straddling the boundary of the filled area. The rectangle is 6 picaswide and 4 picas deep, and a 2 point wide outline.

Enter this macro:

< fboxt;156;1;2;6p;4p;2q;sn >

To generate this filled rectangle with text:

Start Filled Box with Text

Creates a box where the top of the box is at the top of the maximumascender on the current line and the bottom of the box is at the bottom ofthe descender on the line containing the efboxt XyMacro. The width of thebox is equal to the current line measure.

sfboxt Start Filled Box with Text

Format <sfboxt; pattern; main-color; alternate-color; outline-size; outline-type;

dash-length; space-between-dashes; inside-gutter; outside-gutter; corner-

radius; priority; screen-angle; screen-frequency >

Sample

Figure 7-7 Sample Filled Rectangle with Text

Filled Rectangle XyMacros

7-14 Filled Rectangles Tints, Color, and Pattern Management

Argument Valid Entries

pattern 0 — No color fill (transparent)

An integer from 1 through 65535 — Selects a valid rulenumber from the Special Effects Patterns (sep) Spec.

Pattern numbers 1 through 100 correspond to the density ofthe specified main color. Lower tint values produce lightershades; higher tint values produce darker shades.

Pattern numbers 101 through 164 specify XPP-deliveredpatterns. The main and alternate colors are always 100percent of the specified color. To create a pattern with alighter or darker shade of a color, you must define the colorin the Color Control Spec, then specify that color in themain-color or alternate-color field.

main-color 0 = No color (transparent) if pattern is also 0 or greater than100; otherwise, 0 = Normal color (color specified for theblock contents) if pattern is 1-100.

Activates the following rules in the Color Control Spec:(Numbers 1-8 correspond to the standard XPP colors.)

1 — black (default)

2 — white

3 — red

4 — green

5 — blue

6 — cyan

7 — magenta

8 — yellow

9 through 65534 — a user-defined rule.

For tints (pattern numbers 1 – 100), the main color is thecolor of the fill.

For patterns (XPP-delivered pattern numbers 101-164), themain color is the foreground of the pattern.

alternate-color 65535 — Specifies no color (transparent).

Note: 0 is not allowed.

Activates the following rules in the Color Control Spec:(Numbers 1-8 correspond to the standard XPP colors.)

1 — black (default)

2 — white

3 — red

4 — green

5 — blue

6 — cyan

7 — magenta

8 — yellow

Filled Rectangle XyMacros

Tints, Color, and Pattern Management Filled Rectangles 7-15

Argument Valid Entries

9 through 65534 — a user-defined rule.

For patterns (XPP-delivered pattern numbers 101-164), thealternate color is the background of the pattern.

outline-size A positive qualified numeric value up to 2.25 inches thatspecifies the thickness of the outline rules.

Defaults to 1q.

outline-type Specifies the type of outline rule to draw around shape:

non — Specifies no outline.

Single outlines:1

sn — A single outline that straddles the boundary of thefilled area (default).

sni — A single outline placed inside the filled area.

sno — A single outline placed outside the filled area.

Double outlines:2

db — A double outline that straddles the boundary of thefilled area.

dbi — A double outline placed inside the filled area.

dbo — A double outline placed outside the filled area.

odb — A double outline, with outer line twice as wide asinner line, that straddles the boundary of the filledarea.

odbi — A double outline, with outer line twice as wide asinner line, placed inside the filled area.

odbo — A double outline, with outer line twice as wide asinner line, placed outside the filled area.

idb — A double outline, with inner line twice as wide asouter line, that straddles the boundary of the filledarea.

idbi — A double outline, with inner line twice as wide asouter line, placed inside the filled area.

idbo — A double outline, with inner line twice as wide asouter line, placed outside the filled area.

Dashed outlines:3

dsh — A dashed outline that straddles the boundary of thefilled area.

dshi — A dashed outline placed inside the boundary of thefilled area.

dsho — A dashed outline placed outside the boundary of thefilled area.

dash-length A positive qualified numeric value that specifies the length ofthe dash for dashed outlines.

Defaults to the outline size.

Filled Rectangle XyMacros

7-16 Filled Rectangles Tints, Color, and Pattern Management

Argument Valid Entries

space-between-dashes A positive qualified numeric value that specifies the amountof space between dashes for dashed outlines.

Defaults to the dash length.

inside-gutter A positive qualified numeric value that specifies the gutterbetween the internal text and the filled box.

Defaults to 1q.

outside-gutter A positive qualified numeric value that specifies the gutterbetween the external text and the filled box.

Defaults to 1q.

corner-radius A positive qualified numeric value that specifies the radiusof all four corners for rounded corners. Enter larger values inthis argument to make box corners more curved.

Defaults to 0 for square corners.

priority Controls which area is visible on top of another area. An areawith a higher priority hides any portion of a lower priorityarea that it overlaps. If areas have the same priority, therectangles lower on the page hide the portions of rectanglehigher on the page that they overlap.

Text and graphic blocks have a priority of 0; you cannotchange the priority of text. Assign a priority less than 0 tofilled areas that you want text to overlap. Assign a prioritygreater than 0 to filled areas you want to overlap the text. Ifyou assign a priority of 0 to a filled area, text overlaps thearea, but the area overlaps any filled area with a priority lessthan 0.

An integer in the range from -127 to 127 that specifies thepriority of the current shape.

Defaults to -30.

screen-angle Number of degrees by which the halftone screen should berotated with respect to the device coordinate system. Thevalue in this argument overrides the values defined in theColor Control Spec for regions filled with spot colors only.

Screen angle values are applied only if the associated tintcolors have their spot color field turned on. Defaults to nochange in the screen angle.

Acceptable values are device dependent.

Filled Rectangle XyMacros

Tints, Color, and Pattern Management Filled Rectangles 7-17

Argument Valid Entries

screen-frequency Sets screen frequency in halftone cells per inch in devicespace. The value in this argument overrides the valuesdefined in the Color Control Spec for regions filled with spotcolors only.

Screen frequency values are applied only if the associatedtint colors have their spot color field turned on. Defaults tono change in the screen frequency.

Acceptable values are device dependent.

1 Single outlines — the outline rule is 100 percent of the main color.2 Double outlines — the outline-size argument specifies the width of the entire

outline, including the inner line, the space, and the outer line. The outline rulesare in 100 percent of the specified main color and the space between the doubleoutlines is in 100 percent of the alternate color.

3 Dashed outlines — the foreground dashes are 100 percent of the main color. Thebackground dashes are 100 percent of the alternate color.

Comments

For rounded corners, the text may not be within the rounded portion of thecorner. To place the text within a box with rounded corners, use additionalinside gutter.

If you specify db, dbi, or dbo to create a double outline, XPP creates anoutline with an inner rule, a space, and an outer rule in the ratio 2:1:2.

If you specify odb, odbi, or odbo to create a double outline where the outerline is twice the width of the inner line, XPP creates an outline with an innerrule, a space, and an outer rule in the ratio 1:1:2.

If you specify idb, idbi, idbo to create a double outline where the inner lineis twice the width of the outer line, XPP creates an outline with an innerrule, a space, and an outer rule in the ratio 2:1:1.

In the following example, the rectangle has a double outline placed insidethe filled area. The inner outline is twice the width of the outer outline.

Enter these macros and text:

<sfboxt;160;1;2;4q;idbi > Bob’s Lightning Rod Company¶All WorkGuaranteed<efboxt >

To generate this rectangle containing text:

In the following example, the corner radius of the rectangle is 4q, makingthe corners rounded.

Filled Rectangle XyMacros

7-18 Filled Rectangles Tints, Color, and Pattern Management

1234567890112345678901

Enter this macro and text:

<sfboxt;10;1;2;3q;1;;;;;8q > <mh;8q > < lp;1p > < ix >

This shows how you can position text in a filled box with rounded corners.This example uses XyMacros to place the text within the box so that it doesnot run into the rounded corners of the outline.<xix >

To generate this rectangle, containing text, with rounded corners:

This example shows rectangles, with rounded corners, containing text. Thefill for the rectangle is white.

If you create a rectangle with a single outline and specify white as the maincolor, the outline will also be white. In this case, the outline will not appearsince it is the same color as the fill. If the rectangle is on a coloredbackground, the rectangle appears larger than the specified dimensionsbecause of the thickness of the outline.

To create a rectangle with a black outline, specify a double outline, a maincolor of white and an alternate color of black. The double outline is whiteand the space between the outlines is black. It is the space between theoutlines that appears as the black outline around the rectangle. By varyingthe thickness of the outline rule, you can control the thickness of the spacebetween the rules. Note that the ratio of the thicknesses of the inner andouter rules and the space between them is dependent on the argument youuse when specifying the rule type. If this rectangle appears on a coloredbackground, the white double outline shows.

Using the db argument and a specified rule thickness of 2q, XPP creates anoutline where the inner rule and the outer rule are .8q thick and the spacebetween the rules is .4q thick (a ratio of 2:1:2). The double outline rules arewhite, so they do not appear. The space between the rules is black, so that isthe rule that appears around the text.

Bob’s Lightning Rod Company

All Work Guaranteed

Figure 7-8 Sample Filled Rectangle with Text using the sfboxt and efboxt Macros

This shows how you can position text in a filled box with roundedcorners. Using XyMacros, the text is positioned so that it does not run intothe rounded corners of the outline.

Figure 7-9 Sample Rectangle with Rounded Corners

Filled Rectangle XyMacros

Tints, Color, and Pattern Management Filled Rectangles 7-19

Enter the following:

<sfboxt;;2;1;2q;db;;;4q;;5q > The rectangle contains text on a whitebackground. The inner rule around the rectangle is .4q thick.<efboxt >

To generate this rectangle:

The following example shows a rectangle created using the same macro asin the previous example, except this time, specifying an outline rulethickness of 4q. The space between the outlines is black and .8q thick.

Enter the following:

<sfboxt;;2;1;4q;db;;;4q;;5q > The rectangle contains text on a whitebackground. The rule around the rectangle is .8q thick.<efboxt >

To generate this rectangle:

The following example shows another rectangle created with the samemacro, but with an outline rule thickness of 8q. The space between theoutlines is black and 4q thick.

Enter the following:

<sfboxt;;2;1;8q;db;;;4q;;5q > The rectangle contains text on a whitebackground. The rule around the rectangle is 1.69q thick.<efboxt >‘‘‘‘‘‘

To generate this rectangle:

The rectangle contains text on a white background. The rule around therectangle is .4q thick.

Figure 7-10 Sample Boxed Text with White Background, .4q Outline

The rectangle contains text on a white background. The rule around therectangle is .8q thick.

Figure 7-11 Sample Boxed Text with White Background, .8q Outline

The rectangle contains text on a white background. The rule around therectangle is 1.69q thick.

Figure 7-12 Sample Boxed Text with White Background, 1.69q Outline

Filled Rectangle XyMacros

7-20 Filled Rectangles Tints, Color, and Pattern Management

End Filled Box with Text

Marks the end of text to be set in a filled box. If XPP does not encounter anefboxt macro, the box ends at the bottom of the descender of the last line inthe current block. To start a filled box with text, use the sfboxt XyMacro.

efboxt End Filled Box with Text

Format <efboxt >

Filled Rectangle XyMacros

Tints, Color, and Pattern Management Filled Rectangles 7-21

7-22 Filled Rectangles Tints, Color, and Pattern Management

Chapter 8

Filled Circles and Ellipses

You can create a circle or ellipse and fill it with a tint, pattern, or color. Youcan specify characteristics of the circle or ellipse, including the following:

• Size — the x-radius and y-radius

• Tint/Pattern — the tint or pattern with which to fill the circle/ellipse

• Color — the color with which to fill the circle/ellipse, or, for patterns,the color of the pattern foreground and background

• Outline — the type of outline (such as single, double, or dashed ), andthe thickness of the outline rule

Refer to:

• Part 1, “Managing Color,” for information on the Color Control Spec

• Part 2, “Managing Tints and Patterns,” for information on the SEPSpec

Tints, Color, and Pattern Management Filled Circles and Ellipses 8-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Understanding Filled Circles/Ellipses

You can enter the XyMacros for circles/ellipses in text or in a tag definitionin the Item Format (IF) Spec.

Circle/Ellipse Dimensions

You can specify width and depth of the circle or ellipse and the placementof the outline rule

• Inside the circle/ellipse

• Outside the circle/ellipse

• Straddling the circle/ellipse

Note: The XyMacro that creates the circle/ellipse does not change the cursorposition.

Outline Rule Inside Circle/Ellipse

If the outline rule is inside the circle/ellipse, as shown in the followingfigure, the dimensions of the circle/ellipse are from the outside edges of theoutline rule.

Outline Rule Straddling Circle/Ellipse

If the outline rule straddles the outline of the circle/ellipse, as shown in thefollowing figure, the dimensions of the circle/ellipse are from the midpointsof the outline rule.

Figure 8-1 Ellipse with Outline Inside the Shape

The dimensions of the ellipse are measuredfrom the outside edges of the outline rule.

Figure 8-2 Ellipse with Outline Straddling the Shape

The dimensions of the ellipse are measuredfrom the midpoints of the outline rule.

Understanding Filled Circles/Ellipses

8-2 Filled Circles and Ellipses Tints, Color, and Pattern Management

Outline Rule Outside Circle/Ellipse

If the outline rule is outside the circle/ellipse , as shown in the followingfigure, the dimensions of the circle/ellipse are from the inside edges of theoutline.

Circle/Ellipse Position

When you create a filled circle/ellipse, XPP positions it so that theintersection of the tangents of the left and top sides are at the current cursorposition, as shown in the following figure.

Note: The tangents are positioned so they touch the filled area of the circle orellipse. They are not positioned relative to the outline.

Display of Filled Circles/Ellipses

PostScript devices display filled circles/ellipses based on their specialeffects capabilities.

Figure 8-3 Ellipse with Outline Outside the Shape

The dimensions of the ellipse are measuredfrom the inside edges of the outline rule.

Figure 8-4 Cursor Position with a Circle/Ellipse

Cursor position

Understanding Filled Circles/Ellipses

Tints, Color, and Pattern Management Filled Circles and Ellipses 8-3

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Filled Circle/Ellipse XyMacro

Use the oval, <oval >, XyMacro to create a filled circle or filled ellipse, asdescribed in the following section.

Draw Filled Oval

Draws a circle or ellipse and fills it with the specified tint, pattern, or color.To draw a filled circle, specify an x-radius and y-radius that are equal toeach other. To draw an ellipse, specify an x-radius and y-radius withdifferent values.

oval Draw Filled Oval

Format <oval; pattern; main-color; alternate-color; x-radius; y-radius; outline-size;

outline-type; dash-length; space-between-dashes; x-offset; y-offset; priority;

screen-angle; screen-frequency >

Argument Valid Entries

pattern 0 — No color fill (transparent)

An integer from 1 through 65535 — Selects a valid rulenumber from the Special Effects Patterns (SEP) Spec.

Pattern numbers 1 through 100 correspond to the density ofthe specified main color. Lower tint values produce lightershades; higher tint values produce darker shades.

Pattern numbers 101 through 164 specify XPP-deliveredpatterns. The main and alternate colors are always 100percent of the specified color. To create a pattern with alighter or darker shade of a color, you must define the colorin the Color Control Spec, then specify that color in themain-color or alternate-color field.

main-color 0 = No color (transparent) if pattern is also 0 or greater than100; otherwise, 0 = Normal color (color specified for theblock contents) if pattern is 1-100.

65535 — Specifies no color (transparent).

Activates the following rules in the Color Control Spec:(Numbers correspond to the standard XPP colors.)

1 — black (default)

2 — white

3 — red

4 — green

5 — blue

6 — cyan

Filled Circle/Ellipse XyMacro

8-4 Filled Circles and Ellipses Tints, Color, and Pattern Management

Argument Valid Entries

7 — magenta

8 — yellow

9 through 65534 — a user-defined rule.

For tints (pattern numbers 1 – 100), the main color is thecolor of the fill.

For patterns (XPP-delivered pattern numbers 101 – 164), themain color is the foreground of the pattern.

alternate-color 65535 — Specifies no color (transparent).

Note: 0 is not allowed.

Activates the following rules in the Color Control Spec:(Numbers correspond to the standard XPP colors.)

1 — black

2 — white (default)

3 — red

4 — green

5 — blue

6 — cyan

7 — magenta

8 — yellow

9 through 65534 — a user-defined rule.

For patterns (XPP-delivered pattern numbers 101 – 164), thealternate color is the background of the pattern.

x-radius A positive qualified numeric value, up to 169,000 inches, thatspecifies the x-radius of the circle or ellipse. The maximumx-radius of a circle/ellipse depends on the size of the pageand on the output device.

Defaults to half of the remaining block width.

y-radius A positive qualified numeric value, up to 169,000 inches, thatspecifies the y-radius of the ellipse. The maximum y-radiusof a circle/ellipse depends on the size of the page and on theoutput device.

Defaults to the x-radius.

outline-size A positive qualified numeric value up to 2.25 inches thatspecifies the thickness of the outline rules.

Defaults to 1q.

outline-type Specifies the type of outline rule to draw around a shape:

Single outlines:1

non — Specifies no outline.

sn — A single outline that straddles the boundary of thefilled area (default).

sni — A single outline placed inside the filled area.

Filled Circle/Ellipse XyMacro

Tints, Color, and Pattern Management Filled Circles and Ellipses 8-5

Argument Valid Entries

sno — A single outline placed outside the filled area.

Double outlines:2

db — A double outline that straddles the boundary of thefilled area.

dbi — A double outline placed inside the filled area.

dbo — A double outline placed outside the filled area.

odb — A double outline, with outer line twice as wide asinner line, that straddles the boundary of the filledarea.

odbi — A double outline, with outer line twice as wide asinner line, placed inside the filled area.

odbo — A double outline, with outer line twice as wide asinner line, placed outside the filled area.

idb — A double outline, with inner line twice as wide asouter line, that straddles the boundary of the filledarea.

idbi — A double outline, with inner line twice as wide asouter line, placed inside the filled area.

idbo — A double outline, with inner line twice as wide asouter line, placed outside the filled area.

Dashed outlines:3

dsh — A dashed outline that straddles the boundary of thefilled area.

dshi — A dashed outline placed inside the boundary of thefilled area.

dsho — A dashed outline placed outside the boundary of thefilled area.

dash-length A positive qualified numeric value that specifies the length ofthe dash for dashed outlines.

Defaults to the outline size.

space-between-dashes

A positive qualified numeric value that specifies the amountof space between dashes for dashed outlines.

Defaults to the dash length.

x-offset A qualified numeric value that specifies the distance betweenthe current position and the center of the circle or ellipse.

A positive value positions the circle or ellipse toward theright while a negative value positions the circle or ellipsetoward the left. A circle/ellipse cannot be positioned so thatits edge is beyond the left edge of the block.

Defaults to 0.

Filled Circle/Ellipse XyMacro

8-6 Filled Circles and Ellipses Tints, Color, and Pattern Management

Argument Valid Entries

y-offset A qualified numeric value that specifies the distance betweenthe current baseline and the center of the circle or ellipse.

A positive value positions the circle or ellipse toward thebottom of the page while a negative value positions it towardthe top of the page.

Defaults to 0.

priority Controls which area is visible on top of another area. An areawith a higher priority hides any portion of a lower priorityarea that it overlaps. If areas have the same priority, thecircles/ellipses lower on the page hide the portions of thecircle/ellipse higher on the page that they overlap.

Text and graphic blocks have a priority of 0; you cannotchange the priority of text. Assign a priority less than 0 tofilled areas that you want text to overlap. Assign a prioritygreater than 0 to filled areas you want to overlap the text. Ifyou assign a priority of 0 to a filled area, text overlaps thearea, but the area overlaps any filled area with a priority lessthan 0.

An integer in the range from -127 to 127 that specifies thepriority of the current shape.

Defaults to -30.

screen-angle The number of degrees by which the halftone screen shouldbe rotated with respect to the device coordinate system. Thevalue in this argument overrides the values defined in theColor Control Spec for regions filled with spot colors only.

Screen angle values are applied only if the associated tintcolors have their spot color field turned on. Defaults to nochange in the screen angle.

Acceptable values are device dependent.

screen-frequency Sets screen frequency in halftone cells per inch in devicespace. The value in this argument overrides the valuesdefined in the Color Control Spec for regions filled with spotcolors only.

Screen frequency values are applied only if the associatedtint colors have their spot color field turned on. Defaults tono change in the screen frequency.

Acceptable values are device dependent.

1 Single outlines — the outline rule is 100 percent of the main color.2 Double outlines — the outline-size argument specifies the width of the entire

outline, including the inner line, the space, and the outer line. The outline rulesare in 100 percent of the specified main color and the space between the doubleoutlines is in 100 percent of the alternate color.

3 Dashed outlines — the foreground dashes are 100 percent of the main color. Thebackground dashes are 100 percent of the alternate color.

Filled Circle/Ellipse XyMacro

Tints, Color, and Pattern Management Filled Circles and Ellipses 8-7

Comments

If you specify db, dbi, or dbo to create a double outline, XPP creates anoutline with an inner rule, a space, and an outer rule in the ratio 2:1:2.

If you specify odb, odbi, or odbo to create a double outline where the outerline is twice the width of the inner line, XPP creates an outline with an innerrule, a space, and an outer rule in the ratio 1:1:2.

If you specify idb, idbi, idbo to create a double outline where the inner lineis twice the width of the outer line, XPP creates an outline with an innerrule, a space, and an outer rule in the ratio 2:1:1.

The following example shows three circles with different outlineplacements. Note that the x-radius specified for all three circles is 3.6p.

To generate Circle 1, with a single outline placed inside the filled area, enterthis macro:

<oval;15;1;2;3.6p;;2q;sni >

To generate Circle 2, with a single outline that straddles the boundary of thefilled area, enter this macro:

<oval;15;1;2;3.6p;;2q;sn >

To generate Circle 3, with a single outline placed inside the filled area, enterthis macro:

<oval;15;1;2;3.6p;;2q;sno >

Note: The specified dimensions of the circles are the same, however, the circles aredifferent sizes because of the outline placement.

Circle 1 Circle 2 Circle 3

Figure 8-5 Sample Filled Circles with Different Outline Placement

Filled Circle/Ellipse XyMacro

8-8 Filled Circles and Ellipses Tints, Color, and Pattern Management

1234567890123456123456789012345612345678901234561234567890123456123456789012345612345678901234561234567890123456123456789012345612345678901234561234567890123456123456789012345612345678901234561234567890123456123456789012345612345678901234561234567890123456

In the following example, the filled ellipse has a single outline placed insidethe filled area.

Enter this macro:

<oval;15;1;2;2p;3p;2q;sni;;;1p;1p >

To generate this filled ellipse:

The following figure shows a filled circle with a double outline where theouter rule is twice the width of the inner rule.

Enter this macro:

<oval;106;1;2;5p;;1p;odbi;;;3q;3q >

To generate this circle:

Figure 8-6 Sample Filled Ellipse

Figure 8-7 Sample Filled Circle with a Double Outline

Filled Circle/Ellipse XyMacro

Tints, Color, and Pattern Management Filled Circles and Ellipses 8-9

In the following figure, the circles have different priorities; the large circlehas a priority of 5, the small circle has a priority of 10. The circle with apriority of 10 hides the portion of the circle with a priority of 5 that itoverlaps.

Enter these macros:

<oval;30;1;2;4p;;2q;sn;;;;;10 ><oval;15;1;2;8p;;2q;sn;;;;;5 >

To generate these circles:

Figure 8-8 Sample Circles with Different Priorities

Filled Circle/Ellipse XyMacro

8-10 Filled Circles and Ellipses Tints, Color, and Pattern Management

Chapter 9

Filled Tabular Elements

Using the tabular fill XyMacros, you can fill

• Cells

• Rows

• Columns

• Portions of tables

Refer to:

• XML Professional Publisher: Mastering Tables for information on tabularspecs and XyMacros.

• Part 1, “Managing Color,” for information on the Color Control Spec

• Part 2, “Managing Tints and Patterns,” for information on the SEPSpec

Tints, Color, and Pattern Management Filled Tabular Elements 9-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Understanding Filled Tabular Elements

Using XyMacros, you can fill a single cell or multiple cells with a tint,pattern, or color. Entering a tabular fill XyMacro , between the begtabXyMacro and the first Tr XyMacro (in the tabular overrides area), affects thewhole table.

Entering a tabular fill XyMacro within a cell may affect that one cell or fromthat cell to the end of the table (or the end of the block if the table breaksacross blocks).

Some tabular fill XyMacros are also valid in the set style or change styleXyMacros, or in an exception rule in the Composition (t5) Spec. Refer to thedetailed description of each XyMacro for information on where to enter theXyMacro.

Note: The fill tabular elements XyMacros do not produce outline rules. You controlthe weight of tabular rules in the ruling (t3) Spec or with tabular overrideXyMacros.

Display of Filled Tabular Elements

PostScript devices display filled tabular elements based on their specialeffects capabilities.

Understanding Filled Tabular Elements

9-2 Filled Tabular Elements Tints, Color, and Pattern Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Filled Tabular Element XyMacros

The following sections detail the syntax and arguments of the filled tabularelement XyMacros:

Description XyMacro

Fill Cell < fcell >

Fill with Pattern < fpat >

Fill with Main Color < fmcolor >

Fill with Alternate Color < facolor >

Fill Type < ftype >

Fill Priority < fprio >

Fill Angle < fangle >

Fill Frequency < ffreq >

Fill Width < fwidth >

Fill Depth < fdepth >

Fill Cell

Fills the cell(s) with the specified pattern or color.

Location For the whole table, after the begtab XyMacro and before the first TrXyMacro. To specify from this cell to the end of the table, after theappropriate Tr or Tc XyMacro.

The fcell XyMacro applies only to tabular cells in the current block. To applythe fcell XyMacro to a table that breaks across blocks, enter the fcell XyMacroin the continuation header row.

Filled Tabular Element XyMacros

Tints, Color, and Pattern Management Filled Tabular Elements 9-3

fcell Fill Cell

Format < fcell; pattern; main-color; alternate-color; type; priority; screen-angle;

screen-frequency; width; depth >

Argument Valid Entries

pattern An integer from 1 through 65535 — Selects a valid rulenumber from the Special Effects Patterns (SEP) Spec.

Pattern numbers 1 through 100 correspond to the density ofthe specified main color. Lower tint values produce lightershades; higher tint values produce darker shades.

Pattern numbers 101 through 164 specify XPP-deliveredpatterns. The main and alternate colors are always 100percent of the specified color. To create a pattern with alighter or darker shade of a color, you must define the colorin the Color Control Spec, then specify that color in themain-color or alternate-color field.

main-color 0 = No color (transparent) if pattern is greater than 100;otherwise, 0 = Normal color (color specified for the blockcontents) if pattern is 1-100.

65535 — Specifies no color (transparent).Activates the following rules in the Color Control Spec:(Numbers correspond to names of the XPP Standard colors.)

1 — black (default)

2 — white

3 — red

4 — green

5 — blue

6 — cyan

7 — magenta

8 — yellow

For pattern numbers 1 – 100, the main color is the fill color.

For XPP-delivered pattern numbers 101 – 164, the main coloris the foreground of the pattern.

alternate-color 0 or 65535— Specifies no color (transparent).

Activates the following rules in the Color Control Spec:(Numbers correspond to names of the XPP Standard colors.)

1 — black

2 — white (default)

3 — red

4 — green

5 — blue

6 — cyan

7 — magenta

Filled Tabular Element XyMacros

9-4 Filled Tabular Elements Tints, Color, and Pattern Management

Argument Valid Entries

8 — yellow

9 through 65534 — a user-defined rule.

For tints (pattern numbers 1-100) the alternate color does notapply. For patterns (XPP-delivered pattern numbers 101 –164), the alternate color is the background of the pattern.

type Specifies the extents of the fill, where:

0 or ruletorule — Fills the cell from rule to rule (default).This entry fills a cell halfway through each rule in alldirections (or where each rule would be if rules were output).

1 or textmeasure — Fills the cell horizontally to the textmeasure; fills the cell vertically from rule-to-rule.

2 or all — Fills the cell from gutter-to-gutter (does not extendthe fill into any gutter).

3 or halfgutter — Fills the cell halfway through each gutterin all directions, except at table boundaries where the fillextends through the box gutter. This entry is useful whencancelled horizontal rules are not centered in the gutter andyou want the fill to extend to the center of the gutter.

4 or guttermeasure — Fills the cell horizontally to the textmeasure; fills the cell vertically halfway through the top andbottom gutters, except at table boundaries.

priority Controls which area is visible on top of another area. An areawith a higher priority hides any portion of a lower priorityarea that it overlaps. If areas have the same priority, the arealower on the page hide the portions higher on the page thatthey overlap.

Text and graphic blocks have a priority of 0; you cannotchange the priority of text. Assign a priority less than 0 tofilled areas that you want text to overlap. Assign a prioritygreater than 0 to filled areas you want to overlap the text. Ifyou assign a priority of 0 to a filled area, text overlaps thearea, but the area overlaps any filled area with a priority lessthan 0.

An integer in the range from -127 to 127 that specifies thepriority of the current shape.

Defaults to -30.

screen-angle The number of degrees by which XPP should rotate thehalftone screen with respect to the device coordinate system.The value in this argument overrides the values defined inthe Color Control Spec for regions filled with spot colorsonly.

XPP applies the screen angle values only if the associated tintcolors have their spot color field turned on. Defaults to nochange in the screen angle.

Acceptable values are device dependent.

Filled Tabular Element XyMacros

Tints, Color, and Pattern Management Filled Tabular Elements 9-5

Argument Valid Entries

screen-frequency Sets screen frequency in halftone cells per inch in device Thevalue in this argument overrides the values defined in theColor Control Spec for regions filled with spot colors only.

Screen frequency values are applied only if the associatedtint colors have their spot color field turned on. Defaults tono change in the screen frequency.

Acceptable values are device dependent.

width A qualified positive value, or:

1 or block — From the current cell to the end of the block.

2 or cell — Within the current cell (default).

3 or table — From the current cell to the end of the table.

depth A qualified positive value, or:

1 or block — From the current cell to the end of the block.

2 or cell — Within the current cell (default).

3 or table — From the current cell to the end of the table.

Comments To define colored tabular rules, enter:

• A color number in the Color for Standard and Exception Rules field and/or theSingle Underline Rules: Color or Double Underline Rules: Color fields in the Ruling(t3) Spec

• Or enter the Set Color for Rules, setcolor, tabular XyMacro

The color fields in the Ruling Spec and the style arguments for the setcolorXyMacro accept color values from 0 through 65534. For more informationon the tabular specs and XyMacros, refer to XML Professional Publisher:Mastering Tables.

Fill with Pattern

Fills the cell(s) with the specified pattern.

To specify the main color and the alternate color for the pattern, use thefmcolor and facolor XyMacros.

If the upper left corner of a spanning cell is in the row or column to fill, theentire spanning cell is filled with the pattern. Otherwise, the entirespanning cell remains white.

Location After the Tr or Tc XyMacro if for a single cell, in conjunction with thetabular set style XyMacros or change style XyMacros, or in an exceptionrule in the Composition (t5) Spec.

Filled Tabular Element XyMacros

9-6 Filled Tabular Elements Tints, Color, and Pattern Management

fpat Fill Pattern

Format < fpat; pattern >

Argument Valid Entries

pattern An integer from 1 through 65535 — Selects a valid rulenumber from the Special Effects Patterns (SEP) Spec.

Pattern numbers 1 through 100 correspond to the density ofthe specified main color. Lower tint values produce lightershades; higher tint values produce darker shades.

Pattern numbers 101 through 164 specify XPP-deliveredpatterns. The main and alternate colors are always 100percent of the specified color. To create a pattern with alighter or darker shade of a color, you must define the colorin the Color Control Spec, then specify that color in themain-color or alternate-color field.

In the following example, you can fill a cell with a 15 per cent gray tint byentering this macro in the cell:

< fpat;15 >

The following figure shows a table with cells filled using this macro.

In the following example, you can generate a 10 per cent gray tint (such asin the cells for “Pam” and “Bob”), by entering this XyMacro in the cell:

< fpat;10 >

The cells in the example that contain a 10 per cent gray tint are spanningcells. The < fpat;10 > macro appears after the <Tc;2 > macro.

You can generate a diagonal stripe pattern by entering this XyMacro in thecell:

< fpat;117 >

Monday Tuesday Wednesday Thursday Friday

Composition Biology Psychology Philosophy Sociology

Sociology Composition Philosophy Sociology Composition

Biology Sociology Biology Psychology Biology

Psychology Philosophy Composition Biology Philosophy

Figure 9-1 Sample Table with Filled Cells

Filled Tabular Element XyMacros

Tints, Color, and Pattern Management Filled Tabular Elements 9-7

1234567812345678123456781234567812345678

123456712345671234567

123456781234567812345678

123456781234567812345678

123456123456123456123456

You can produce the box containing the pattern in the footnote by using thisXyMacro:

< fbox;117 >

The following example shows a table filled using these three XyMacros:

Fill with Main Color

Fills the cell(s) with the main fill color. If you have entered the Fill withPattern, fpat, XyMacro, the fmcolor XyMacro specifies the main color of thepattern.

To fill the cell(s) with a tint of this color, enter the fill with pattern XyMacro,fpat, and specify a tint value from 1 to 100.

If the upper left corner of a spanning cell is in the row or column to fill, theentire spanning cell is filled with the specified color. Otherwise, the entirespanning cell remains white.

Location After the Tr or Tc XyMacro if for a single cell, in conjunction with thetabular set style XyMacros or change style XyMacros, or in an exceptionrule in the Composition (t5) Spec.

Lifeguard Duty Schedule

Time Monday Tuesday Wednesday Thursday Friday Saturday

8:00 Pam Pam Pam Pam Pam

9:00 Nancy Nancy

10:00 Susan Susan Susan Susan Susan Bob

11:00 Dave Dave Dave

12:00 Kate Bob Kate Bob Kate Bob

1:00 Dave Dave Dave Dave

= pool closed for cleaning

Figure 9-2 Sample Table with Filled Spanning Cells

Filled Tabular Element XyMacros

9-8 Filled Tabular Elements Tints, Color, and Pattern Management

fmcolor Fill with Main Color

Format < fmcolor; main-color >

Argument Valid Entries

main-color 0 = No color (transparent) if pattern is also 0 or greater than100; otherwise, 0 = Normal color (color specified for theblock contents) if pattern is 1-100.

65535 — Specifies no color (transparent).

Activates the following rules in the Color Control Spec:(Numbers correspond to names of the XPP Standard colors.)

1 — black (default)

2 — white

3 — red

4 — green

5 — blue

6 — cyan

7 — magenta

8 — yellow

9 through 65534 — a user-defined rule.

Fill with Alternate Color

Fills the cell with the alternate color. If you have entered the Fill withPattern, fpat, XyMacro, the facolor XyMacro specifies the alternate color ofthe pattern.

If the upper left corner of a spanning cell is in the row or column to fill, theentire spanning cell is filled with the color. Otherwise, the entire spanningcell remains white.

Location After the Tr or Tc XyMacro if for a single cell, in conjunction with thetabular set style XyMacros or change style XyMacros, or in an exceptionrule in the Composition (t5) Spec.

Filled Tabular Element XyMacros

Tints, Color, and Pattern Management Filled Tabular Elements 9-9

facolor Fill with Alternate Color

Format < facolor; alternate-color >

Argument Valid Entries

alternate-color 0 or 65535 — Specifies no color (transparent).

Activates the following rules in the Color Control Spec:(Numbers correspond to names of the XPP Standard colors.)

1 — black

2 — white (default)

3 — red

4 — green

5 — blue

6 — cyan

7 — magenta

8 — yellow

9 through 65534 — user-defined rules

Fill Type

Specifies the extent of fill within a tabular cell. If the upper left corner of aspanning cell is in the row or column to tint, the entire spanning cell istinted. Otherwise, the entire spanning cell remains white.

Location After the Tr or Tc XyMacro if for a single cell, in conjunction with thetabular set style XyMacros or change style XyMacros, or in an exceptionrule in the Composition (t5) Spec.

ftype Fill Type

Format < ftype; type >

Argument Valid Entries

type Specifies the extents of the fill, where:

0 or ruletorule — Fills the cell from rule to rule (default).This entry fills a cell halfway through each rule in alldirections (or where each rule would be if rules were output).

1 or textmeasure — Fills the cell horizontally to the textmeasure; fills the cell vertically from rule-to-rule.

2 or all — Fills the cell from gutter-to-gutter (does not extendthe fill into any gutter).

Filled Tabular Element XyMacros

9-10 Filled Tabular Elements Tints, Color, and Pattern Management

Argument Valid Entries

3 or halfgutter — Fills the cell halfway through each gutterin all directions, except at table boundaries where the fillextends through the box gutter. This entry is useful whencancelled horizontal rules are not centered in the gutter andyou want the fill to extend to the center of the gutter.

4 or guttermeasure — Fills the cell horizontally to the textmeasure; fills the cell vertically halfway through the top andbottom gutters, except at table boundaries.

Fill Priority

Specifies the priority of the fill for an area in the table.

Location After the Tr or Tc XyMacro if for a single cell, in conjunction with thetabular set style XyMacros or change style XyMacros, or in an exceptionrule in the Composition (t5) Spec.

fprio Fill Priority

Format < fprio; priority >

Argument Valid Entries

priority Controls which area is visible on top of another area. An areawith a higher priority hides any portion of a lower priorityarea that it overlaps. If areas have the same priority, the arealower on the page hide the portions higher on the page thatthey overlap.

Text and graphic blocks have a priority of 0; you cannotchange the priority of text. Assign a priority less than 0 tofilled areas that you want text to overlap. Assign a prioritygreater than 0 to filled areas you want to overlap the text. Ifyou assign a priority of 0 to a filled area, text overlaps thearea, but the area overlaps any filled area with a priority lessthan 0.

An integer in the range from -127 to 127 that specifies thepriority of the current shape.

Defaults to -30.

Filled Tabular Element XyMacros

Tints, Color, and Pattern Management Filled Tabular Elements 9-11

Fill Angle

Specifies the screen angle of the tint for a spot color in an area in the table. Ifthe upper left corner of a spanning cell is in the row or column to tint, theentire spanning cell is tinted. Otherwise, the entire spanning cell remainswhite.

Location After the Tr or Tc XyMacro if for a single cell, in conjunction with thetabular set style XyMacros or change style XyMacros, or in an exceptionrule in the Composition (t5) Spec.

fangle Fill Angle

Format < fangle; screen-angle >

Argument Valid Entries

screen-angle Number of degrees XPP should rotate the halftone screenwith respect to the device coordinate system. The value inthis argument overrides the values in the Color Control Specfor regions filled with spot colors only.

XPP applies screen angle values only if the associated tintcolors have their spot color field turned on. Defaults to nochange in the screen angle.

Acceptable values are device dependent.

Fill Frequency

Specifies the screen frequency of the tint for a spot color in an area in thetable. If the upper left corner of a spanning cell is in the row or column totint, the entire spanning cell is tinted. Otherwise, the entire spanning cellremains white.

Location After the Tr or Tc XyMacro if for a single cell, in conjunction with thetabular set style XyMacros or change style XyMacros, or in an exceptionrule in the Composition (t5) Spec.

Filled Tabular Element XyMacros

9-12 Filled Tabular Elements Tints, Color, and Pattern Management

ffreq Fill Frequency

Format < ffreq; screen-frequency >

Argument Valid Entries

screen-frequency Sets screen frequency in halftone cells per inch in devicespace. The value in this argument overrides the valuesdefined in the Color Control Spec for regions filled with spotcolors only.

XPP applies screen frequency values only if the associatedtint colors have their spot color field turned on. Defaults tono change in the screen frequency.

Acceptable values are device dependent.

Fill Width

Overrides the calculated value for width of the tint in the specified area inthe table. If the upper left corner of a spanning cell is in the row or columnto tint, the entire spanning cell is tinted. Otherwise, the entire spanning cellremains white.

Location After the Tr or Tc XyMacro if for a single cell, in conjunction with thetabular set style XyMacros or change style XyMacros, or in an exceptionrule in the Composition (t5) Spec.

fwidth Fill Width

Format < fwidth; width >

Argument Valid Entries

width Specifies width of the tint. A qualified positive value or:

• block — Fills from the current cell to the end of the block.

• cell — Fills to the current cell width (default).

• table — Fills from the current cell to the end of the table.

In the following example, you can generate a 10 per cent gray tint that fillsto the current table width, such as in the rows in this table by entering thisXyMacro in the cell (in this table the XyMacros appear in the first cell of therow):

< fpat;10 > < fwidth;table >

The following table is an example using these XyMacros:

Filled Tabular Element XyMacros

Tints, Color, and Pattern Management Filled Tabular Elements 9-13

Fill Depth

Overrides the calculated value for depth of the tint in the specified area inthe table. If the upper left corner of a spanning cell is in the row or columnto tint, the entire spanning cell is tinted. Otherwise, the entire spanning cellremains white.

Location After the Tr or Tc XyMacro if for a single cell, in conjunction with thetabular set style XyMacros or change style XyMacros, or in an exceptionrule in the Composition (t5) Spec.

fdepth Fill Depth

Format < fdepth; depth >

Argument Valid Entries

depth Specifies depth of the tint. A qualified positive value or:

• block — Fills from the current cell to the end of the block.

• cell — Fills to the current cell depth (default).

• table — Fills from the current cell to the end of the table.

In the following example, you can generate a 10 per cent gray tint that fillsto the current table depth, such as in the columns in this table, by enteringthis XyMacro in the cell (in this table the XyMacros appear in the first cell inthe column):

< fpat;10 > < fdepth;table >

The following table used these XyMacros:

Time Monday Tuesday Wednesday Thursday Friday Saturday

8:00 Pam Pam Pam Pam Pam Pam

9:00 Nancy Nancy Nancy Nancy Nancy Nancy

10:00 Susan Susan Susan Susan Susan Susan

11:00 Dave Dave Dave Dave Dave Dave

12:00 Bob Bob Bob Bob Bob Bob

1:00 Kate Kate Kate Kate Kate Kate

Figure 9-3 Sample Table with Cells Filled to Table Width

Filled Tabular Element XyMacros

9-14 Filled Tabular Elements Tints, Color, and Pattern Management

Time Monday Tuesday Wednesday Thursday Friday Saturday

8:00 Pam Pam Pam Pam Pam Pam

9:00 Nancy Nancy Nancy Nancy Nancy

10:00 Susan Susan Susan Susan Susan Susan

11:00 Dave Dave Dave Dave Dave Dave

12:00 Bob Bob Bob Bob Bob Bob

1:00 Kate Kate Kate Kate Kate Kate

Figure 9-4 Sample Table with Cells Filled to Table Depth

Filled Tabular Element XyMacros

Tints, Color, and Pattern Management Filled Tabular Elements 9-15

9-16 Filled Tabular Elements Tints, Color, and Pattern Management

Chapter 10

Filled Blocks and Text

When creating blocks, you can specify a block background filled with thefollowing:

• Tints

• Patterns

• Colors

You can specify a tint or color for the contents of a block or for text.

For example, you can define a two-column page in which one block has apatterned background with white text, while the second block has a darkblue background with text appearing in gold.

Refer to:

• Refer to XML Professional Publisher: Managing Document Styles forinformation on the Page Layout and Item Format Specs.

• Part 1, “Managing Color,” for information on the Color Control Spec.

• Part 2, “Managing Tints and Patterns,” for information on the SEPSpec.

Tints, Color, and Pattern Management Filled Blocks and Text 10-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Understanding Filled Blocks

You can specify a color and a pattern for the block background and/or theblock contents using fields in any of the following:

• Page Layout (PL) Spec

• Item Format (IF) Spec

• Pop-up dialog box for creating annotation, caption, and title blocks

• Form Modify pop-up dialog box when using Interactive Page Layout

Below are some important points concerning tints, patterns, and spot colorfor block contents and block backgrounds.

Block Contents

• The contents of the block includes text, boxes, rules, and so on, placedin the block.

• The contents of the block does not include tabular rules.

• You can specify a color or a tint for block contents; you cannot specifya pattern for block contents (you cannot create patterned text orpatterned rules).

• If you specify a tint and a color for the block contents, the colorappears in the percent of the tint you specify. For example, if youspecify a 10 percent tint and the color red, XPP displays a 10% red tint.

Block Background

• The block background is defined as being the same dimensions andposition as the block.

• You can specify a color, tint, or pattern for the background of a block.

For example, in the Page Layout Spec, you can define a main text block thathas a width of 12p and a depth of 11p placed on a page with a width of51.1p and a depth of 66.2p. The background of the block is tinted with 25percent gray. The gray tint extends the full width and depth of the block(12p by 11p).

Understanding Filled Blocks

10-2 Filled Blocks and Text Tints, Color, and Pattern Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page Layout Spec Fields for Colors and Patterns

The Page Layout (PL) Spec defines blocks, including the colors or patternsthat apply to the background and contents of the block.

When you specify a color or pattern for a block, XPP creates a filled areawith a priority of -50, placing it behind the text. Priority only applies to thebackground color of blocks and applies to all blocks, not just those blocksdefined in the page layout, including pickup blocks. Any blocks you createby interpage columnation inherit the color or pattern of the previous block.

The color fields in the PL Spec indicate which colors in the Color ControlSpec XPP should use for the block contents and background.

Using the pattern fields, you can specify a tint for the block background orcontents or a pattern for the block background. You cannot specify a patternfor the block contents.

Note: You cannot create patterned text or patterned rules.

The following figure shows a sample Page Layout Spec and highlights thefields for specifying colors and patterns for the block contents andbackground. Refer to the following descriptions of these fields. Forinformation on other fields in the Page Layout Spec, refer to XMLProfessional Publisher: Managing Document Styles.

Figure 10-1 Page Layout Spec

Page Layout Spec Fields for Colors and Patterns

Tints, Color, and Pattern Management Filled Blocks and Text 10-3

Note: In any ″Color″ field, if you enter a value of 0 through 8, then move thecursor out of the field, XPP automatically replaces the number with normal or thename of the color, as appropriate.

Block Contents: Color

Specifies a color for the contents of the block. XPP uses the correspondingrule in the Color Control Spec. To use the value specified in this field, theColor field in the IF Spec for any tags in the block must contain the entrynormal or the first tag in a division must use active.

Entry Description

0 or normal The “normal” color for block contents is black (default).

1 or black Specifies the rule for black.

2 or white Specifies the rule for white.

3 or red Specifies the rule for red.

4 or green Specifies the rule for green.

5 or blue Specifies the rule for blue.

6 or cyan Specifies the rule for cyan.

7 or magenta Specifies the rule for magenta.

8 or yellow Specifies the rule for yellow.

9 through 65533 Specifies a user-defined rule.

65535 Reserved for XPP use.

Comments To specify a density for the color, use the Block Contents: Pattern field.

Block Contents: Pattern

Specifies a tint for the contents of the block. XPP uses the correspondingrule in the SEP Spec. To use the value specified in this field, the Pattern fieldin the IF Spec for any tags in the block must contain the entry normal.

Entry Description

0 Specifies filling with solid color of the color specified in theBlock Contents: Color field (default).

1 – 100 Specifies a tint. Lower tint values produce lighter shades;higher tint values produce darker shades.

Page Layout Spec Fields for Colors and Patterns

10-4 Filled Blocks and Text Tints, Color, and Pattern Management

Block Background: Color

Specifies a color for the background of the block. XPP uses thecorresponding rule in the Color Control Spec.

Entry Description

0 or normal Specifies no color (transparent).

1 - 8 Specifies the rule for standard XPP colors. You can enter thenumber or corresponding color, for example, 1 or black.Refer to page 10-4 for the list of standard XPP colors.

9 through 65533 Specifies a user-defined rule.

65535 Reserved for XPP use.

Block Background: Pattern

Specifies a tint or pattern for the background of the block. XPP uses thecorresponding rule in the SEP Spec.

Entry Description

0 Fills solid with the color specified in the Block Background: Color

field (default).

1 – 100 Specifies a tint. Lower tint values produce lighter shades;higher tint values produce darker shades.

101 – 164 Specifies an XPP-delivered pattern.

165 – 65534 Specifies a user-defined pattern.

Page Layout Spec Fields for Colors and Patterns

Tints, Color, and Pattern Management Filled Blocks and Text 10-5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Item Format Spec Fields for Colors and Patterns

Use fields in the Item Format (IF) Spec to specify a tint and color for thecontents of each tag and pgraf. You can specify a color or a tint for thecontents of a tag/pgraf. You cannot specify a pattern for the contents of atag/pgraf (you cannot create patterned text).

The values in these fields override any tint and color specified in the PageLayout (PL) Spec or pop-up window for a pickup block element. To use thetint or color specified in the PL Spec or pop-up window for a pickup blockelement, enter active in the Pattern and Color fields for the tag/pgraf.

The following figure shows an Item Format (IF) Spec and highlights thefields for specifying colors and patterns for the contents of tags and pgrafs.

Note: In any ″Color″ field, if you enter a value of 0 through 8, then move thecursor out of the field, XPP automatically replaces the number with normal or thename of the color, as appropriate.

Figure 10-2 Item Format Spec

Item Format Spec Fields for Colors and Patterns

10-6 Filled Blocks and Text Tints, Color, and Pattern Management

Color

Enter the color for the contents of this tag/pgraf. XPP uses thecorresponding rule in the Color Control Spec.

Entry Description

0 or normal References the color specified in the Block Contents: Color fieldin the Page Layout (PL) Spec (default).

1 - 8 Specifies the rule for standard XPP colors. You can enter thenumber or the corresponding color, for example, 1 or black.Refer to page 10-4 for the list of standard XPP colors.

9 through 65533 Specifies a user-defined rule.

65535 Reserved for XPP use.

65534 or active Uses the color currently in effect. If this field is set to activein the first tag in a division, Compose uses the color specifiedin the Block Contents: Color field in the Page Layout (PL) Spec(whose default is black).

Pattern

Specifies a tint for the contents of this tag/pgraf. XPP uses thecorresponding rule in the SEP Spec.

Entry Description

none or 0 Specifies no pattern.

1 – 100 Specifies a tint. Lower tint values produce lighter shades;higher tint values produce darker shades.

normal or 65534 Default. Uses the pattern specified in the Block Contents: Pattern

field in the Page Layout (PL) Spec (whose default is 0).

active or 65535 Uses the pattern currently in effect. If this field is set to activein the first tag in a division, composition treats it as an entryof 0.

The following figure shows text that is tinted 15 percent gray. The tag in theItem Format Spec that defines the text contains the entry 15 in the Patternfield.

You cannot teach a person anything.You can only help him discover it within himself. – Galileo

Figure 10-3 Sample Tinted Text Using a Tag

Item Format Spec Fields for Colors and Patterns

Tints, Color, and Pattern Management Filled Blocks and Text 10-7

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Colors and Patterns in Pickup Element Blocks

Using the fields in the appropriate windows for creating or modifyingpickup element blocks, you can apply a tint, color, or pattern to the blockbackground. You can also apply a tint or color to the block contents.

You cannot apply a pattern to the block contents. Nor can you apply a tintor pattern to the graphic block of a pickup. Note that color only applies toXyraster images.

The following figure shows the windows for creating annotation, caption,title, and graphic blocks.

Note: In any ″Color″ field, if you enter a value of 0 through 8, then move thecursor out of the field, XPP automatically replaces the number with normal or thename of the color, as appropriate.

Figure 10-4 Windows for Creating Pickup Element Blocks

Colors and Patterns in Pickup Element Blocks

10-8 Filled Blocks and Text Tints, Color, and Pattern Management

Block Contents: Color

Specifies a color for the contents of the block. XPP uses the correspondingrule in the Color Control Spec. To use the value specified in this field, theColor field in the IF Spec for any tags in the block must contain the entrynormal or the first tag in the block must use active.

Entry Description

0 or normal The “normal” color for block contents is black (default).

1 - 8 Specifies the rule for standard XPP colors. You can enter anumber or the corresponding color, for example, 1 or black.Refer to page 10-4 for the list of standard XPP colors.

9 through 65533 Specifies a user-defined rule.

65535 Reserved for XPP use.

Block Contents: Pattern

Specifies a tint for the contents of the block. XPP uses the correspondingrule in the SEP Spec. To use the value specified in this field, the Pattern fieldin the IF Spec for any tags in the block must contain the entry normal.

Entry Description

0 or none Fills solid with the color specified in the Block Contents: Color

field (default).

1 – 100 Specifies a tint. Lower tint values produce lighter shades;higher tint values produce darker shades.

Block Background: Color

Specifies a color for the background of the block. XPP uses thecorresponding rule in the Color Control Spec. XPP automatically replacesthe number with normal or the name of the color, as appropriate.

Entry Description

0 or normal Specifies no color (transparent) (default).

1 - 8 Specifies the rule for standard XPP colors. You can enter anumber or the corresponding color, for example, 1 or black.Refer to page 10-4 for the list of standard XPP colors.

9 through 65533 Specifies a user-defined rule.

65535 Reserved for XPP use.

Colors and Patterns in Pickup Element Blocks

Tints, Color, and Pattern Management Filled Blocks and Text 10-9

12345678901234567890123456789012123456789012345678123456789012345678901234567890121234567890123456781234567890123456789012345678901212345678901234567812345678901234567890123456789012123456789012345678123456789012345678901234567890121234567890123456781234567890123456789012345678901212345678901234567812345678901234567890123456789012123456789012345678

Block Background: Pattern

Specifies a tint or pattern for the background of the block. XPP uses thecorresponding rule in the SEP Spec.

Entry Description

0 or none Fills solid with the color specified in the Block Background: Color

field (default).

1 – 100 Specifies a tint. Lower tint values produce lighter shades;higher tint values produce darker shades.

101 – 164 Specifies an XPP-delivered pattern.

165 – 65534 Specifies a user-defined pattern.

The following figure shows text on a patterned background. Thebackground is patterned by entering 109 in the Block Background: Pattern fieldin the Annotation Block pop-up window. The text is emboldened using thebdit XyMacro.

You cannot teach a person anything.You can only help him discover it within him-self. – Galileo

Figure 10-5 Sample Patterned Background Using Pickup Element Block Fields

Colors and Patterns in Pickup Element Blocks

10-10 Filled Blocks and Text Tints, Color, and Pattern Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Colors and Patterns in Layout Blocks

When using Interactive Page Layout, you can assign a color and a pattern toboth the block contents and the block background.

The Form Modify window contains fields for specifying colors and patternsfor the block contents and the block background.The following figure shows the Form Modify window.

Note: In any ″Color″ field, if you enter a value of 0 through 8, then move thecursor out of the field, XPP automatically replaces the number with normal or thename of the color, as appropriate.

Block Contents: Color

Specifies a color for the contents of the block. XPP uses the corresponding rulein the Color Control Spec. To use the value specified in this field, the Color fieldin the IF Spec for any tags in the block must contain the entry normal or thefirst tag in the block must use active.

Entry Description

0 or normal The “normal” color for block contents is black (default).

1 - 8 Specifies the rule for standard XPP colors. You can enter anumber or the corresponding color, for example, 1 or black.Refer to page 10-4 for the list of standard XPP colors.

9 through 65533 Specifies a user-defined rule.

65535 Reserved for XPP use.

Figure 10-6 Form Modify Window for Layout Blocks

Colors and Patterns in Layout Blocks

Tints, Color, and Pattern Management Filled Blocks and Text 10-11

Block Contents: Pattern

Specifies a tint for the contents of the block. XPP uses the correspondingrule in the SEP Spec. To use the value specified in this field , the Pattern fieldof any tags in the block must contain the entry normal.

Entry Description

0 or none Specifies filling with solid color of the color specified in theBlock Contents: Color field (default).

1 – 100 Specifies a tint. Lower tint values produce lighter shades;higher tint values produce darker shades.

Block Background: Color

Specifies a color for the background of the block. XPP uses thecorresponding rule in the Color Control Spec.

Entry Description

0 or none Specifies no color (transparent) (default).

1 or black Specifies the rule for standard XPP colors. You can enter anumber or the corresponding color, for example, 1 or black.Refer to page 10-4 for the list of standard XPP colors.

9 through 65533 Specifies a user-defined rule.

65535 Reserved for XPP use.

Block Background: Pattern

Specifies a tint or pattern for the background of the block. XPP uses thecorresponding rule in the SEP Spec.

Entry Description

0 or none Specifies filling with solid color of the color specified in theBlock Background: Color field (default).

1 – 100 Specifies a tint. Lower tint values produce lighter shades;higher tint values produce darker shades.

101 – 164 Specifies an XPP-delivered pattern.

165 – 65534 Specifies a user-defined pattern.

Colors and Patterns in Layout Blocks

10-12 Filled Blocks and Text Tints, Color, and Pattern Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Creating Text with Tints and Spot Color

Using XyMacros you can do the following:

• Assign a color or tint to text.

• Create reverse video text.

• Specify the color and tint for text and the text background.

The colors and tints specified using XyMacros override those in the block(in the Page Layout Spec or pop-up windows for blocks) or in the tag/pgraf(in the Item Format Spec).

Display of Text with Tints, Patterns, and Colors

On a monochrome screen or printer, colored and/or tinted text appears inshades of grey. The density of the grey depends on both the tint and thecolor. For example, yellow text appears lighter than blue text. To proof textthat may be difficult to read because it is light, use the –nocolor switchwhen printing. The colored text prints in black and is easier to read.

If the background is colored or tinted, it also appears as shades of grey withthe background extending from the maximum ascender in each line to themaximum descender in each line. If the text and the background are coloredand you use the –nocolor switch to print, both the text and the backgroundprint in black and the text is indiscernible from the background.

Outputting Text with Tints, Patterns, and Colors

On a PostScript output device, text with a color or tint overlaps thebackground with a color, tint, or pattern. By default, the foreground is blackand the background is transparent. The background extends from themaximum ascender in each line to the maximum descender in each line.

Creating Text with Tints and Spot Color

Tints, Color, and Pattern Management Filled Blocks and Text 10-13

Reverse Video

Marks the start of white text on a black background. This XyMacroproduces text that is white on a black background even if the background ofthe block is colored or patterned and the text is colored or tinted.

The depth of the reverse video area is determined by the maximumascender and maximum descender on each line. To create an area of whitetext on a black background, with no white space between the lines of text,use a tag in which no extra leading is defined. If you want extra leading,add the desired amount to the descender leading (if any) and enter thevalue in the Descender Lead field in the IF Spec for the tag definition.

You can also control the ascender leading using the ascender leading, laXyMacro. You can control the descender leading using the descenderleading, ld, XyMacro.

rv Reverse Video

Format <rv >

To end reverse video text, use the erv XyMacro. This XyMacro marks theend of reverse video text and sets the text color to black and thebackground color to none. To start reverse video text, use the rv XyMacro.

erv End Reverse Video

Format <erv >

The following figures show examples of reverse text: Figure 11-7 showsreverse video text. The rv XyMacro generates the reverse video effect. 11-8

shows reverse video text in which the black area covers the area betweenthe lines of text. The format of the text is controlled by a tag named reverse.In the tag definition, the Extra Lead field is set to 0. The extra leading isspecified in the Descender Lead field.

You cannot teach a person anything.You can only help him discover it within himself. – Galileo

Figure 10-7 Sample Reverse Video Text Using the rv XyMacro

You cannot teach a person anything.You can only help him discover it within himself. – Galileo

Figure 10-8 Sample Reverse Video Text Without White Space Between Lines

Creating Text with Tints and Spot Color

10-14 Filled Blocks and Text Tints, Color, and Pattern Management

Color

Designates a color. The text appears in the tint currently in effect. To changethe tint, use the Pattern (pt) XyMacro.

co Color

Format <co; text-color; background-color >

Argument Valid Entries

text-color Selects a valid rule in the Color Control Spec:

0 = Specifies the “normal” color (the color specified forthe block contents).

1 - 8—Specifies the rule for standard XPP colors. You canenter a number or corresponding color (1 or black). Referto page 10-4 for the list of standard XPP colors.

9 through 65533 = user-defined rules.

65535 = black.

background-color Selects a valid rule in the Color Control Spec:

0 = No color (transparent) if background pattern is also0; otherwise, 0 = black if background pattern is non-zero.

65535 = No color (transparent) if background pattern is0-100; otherwise, 65535 = no color (white) if backgroundpattern is 101-65534.

1 - 8—Specifies the rule for standard XPP colors. You canenter a number or corresponding color ( 1 or black).Refer to page 10-4 for the list of standard XPP colors.

9 through 65533 = user-defined rules.

Pattern

Designates a pattern for text and for the background. The pattern XyMacroonly has an effect if a tint is chosen (patterns 1–100). The text pattern doesnot have an effect if you specify a pattern number 101 through 65534.

The main color of the background pattern is the current text backgroundcolor. The alternate color of the background pattern is always white.

Creating Text with Tints and Spot Color

Tints, Color, and Pattern Management Filled Blocks and Text 10-15

pt Pattern

Format <pt; text-pattern; background-pattern >

Argument Valid Entries

text-pattern Selects a valid rule number from the Special Effects Patterns(SEP) Spec:

0 = Specifies a solid color (same as 100).

1 through 100 = Specifies a tint. Lower tint values producelighter shades; higher tint values produce darker shades.

background- pattern Selects a valid rule number from the Special Effects Patterns(SEP) Spec.

0 = Specifies a solid color (same as 100 unless backgroundcolor is also 0 for transparent).

1 through 100 = Specifies a tint. Lower tint values producelighter shades; higher tint values produce darker shades.

101 – 164 = Specifies an XPP-delivered pattern.

165 – 65534 = Specifies a user-defined pattern.

Filled Text

Marks the start of text with a filled background (such as reverse video).

Format < ftext; text-color; text-pattern; background-color; background-pattern >

Argument Valid Entries

text-color Selects a valid rule in the Color Control Spec: No default.

0 = Specifies the “normal” color (the color specified forthe block contents).

1 - 8—Specifies the rule for standard XPP colors. You canenter a number or corresponding color (1 or black). Referto page 10-4 for the list of standard XPP colors.

9 through 65533 = user-defined rules.

65535 = black.

text-pattern Selects a valid rule number from the Special EffectsPatterns (SEP) Spec: No default.

0 = Specifies a solid color (same as 100).

1 through 100 = Specifies a tint. Lower tint valuesproduce lighter shades; higher tint values producedarker shades.

Creating Text with Tints and Spot Color

10-16 Filled Blocks and Text Tints, Color, and Pattern Management

Argument Valid Entries

background-color Selects a valid rule in the Color Control Spec: No default.

0 = No color (transparent) if background pattern is also0; otherwise, 0 = black if background pattern is non-zero.

65535 = No color (transparent) if background pattern is0-100; otherwise, 65535 = no color (white) if backgroundpattern is 101-65534.

1 - 8—Specifies the rule for standard XPP colors. You canenter a number or corresponding color (1 or black). Referto page 10-4 for the list of standard XPP colors.

9 through 65533 = user-defined rules.

background-pattern Selects a valid rule number from the Special EffectsPatterns (SEP) Spec. No default.

0 = Specifies a solid color (same as 100 unlessbackground color is also 0 for transparent).1 – 100 = Specifies a tint. Lower tint values producelighter shades; higher tint values produce darker shades.

101 – 164 = Specifies an XPP-delivered pattern.

165 – 65534 = Specifies a user-defined pattern.

Creating Text with Tints and Spot Color

Tints, Color, and Pattern Management Filled Blocks and Text 10-17

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

System Variables

The following tables show the % variables and ! variables associated withtints, patterns, and spot color.

% Variables

% Variable Data Stored

%color Text color for the line

%pattern Text pattern for the line

%bgcolor Background color for the line

%bgpattern Background pattern for the line

! Variables

! Variable Data Stored

!lcolor True whenever a special effect is in the line, whether thespecial effect is a color or a pattern.

!bcolor Block color

!bpattern Block pattern

!bbgcolor Background color of the block

!bbgpattern Background pattern of the block

System Variables

10-18 Filled Blocks and Text Tints, Color, and Pattern Management

Chapter 11

Gradient Fills

The Gradient Fills feature outputs gradient filled shapes of a single color intext and in tables.

This chapter describes the following:

• How to use Gradient Fills.

• Examples of gradient filled shapes in text and in tables.

Tints, Color, and Pattern Management Gradient Fills 11-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Guidelines for Using Gradient Fills

Gradient Fills outputs gradient filled shapes of a single color in text and intables.

• You can output three shapes—a rectangle (square), a half oval (leftside of an ellipse), or a full oval (circle).

• To produce a circle, set the width and depth of a full oval to the samevalue.To produce a square, set the width and depth of a rectangle to thesame value.

• You can fill a shape with color either vertically (from top to bottom) orhorizontally (from left to right).

• The gradient color starts at a specified percentage and ″fades″ toanother percentage of the same color.

• The starting and ending percentages of a color can range from 0 (zero)to 100.

• A gradient fill can fade from low to high or from high to low. Thechange in color percentage is uniform across the width and/or depthof the shape, depending on the gradient direction (horizontal orvertical).

• Shape type numbers less than 10 produce horizontal gradients(left/right). Shape type numbers greater than or equal to 10 producevertical gradients (top/bottom).

• Two XyMacros are delivered to the xy sys XyMacro Spec in theLsyslib library:

grad produces gradient colored shapes.

gcell produces gradient colored shapes in tables.

You can use the gcell and grad XyMacros with other color XyMacros.For example, you can use the gcell XyMacro to draw a shape behind atable and use another XyMacro, such as fcell, to color and tint selectedcells inside the table.

For information on tables, refer to XML Professional Publisher: MasteringTables.

Guidelines for Using Gradient Fills

11-2 Gradient Fills Tints, Color, and Pattern Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Gradient Fill XyMacros

This section describes the gcell and grad XyMacros that produce gradientfilled shapes.

gcell Gradient Fill Tabular Cell

Generates a gradient fill inside a table.

Format <gcell;shtype;color;stint;etint;type;priority;width;depth >

Entry Description

shtype Shape type and fill direction.

Rectangle:

0 — Fill from left to right10 — Fill from top to bottom

Half Oval:

1 — Fill from left to right11 — Fill from top to bottom

Full Oval:

2 — Fill from left to right12 — Fill from top to bottom

color Color with which to fill the shape. Enter the color number orname from the Color Control Spec listed in the Job Ticket.For example, 1=black, 2=white, 3=red. To fill with no color(transparent), enter 65535

stint Starting tint percentage,Enter a number from 0 to 100. Do not enter a percent sign.

etint Ending tint percentage.Enter a number from 0 to 100. Do not enter a percent sign.

type Specifies the extent of the fill shape.

0 or ruletorule — Fills the cell from rule to rule (default).This entry fills a cell halfway through each rule in alldirections (or where each rule would be if rules were output).

1 or textmeasure — Fills the cell horizontally to the textmeasure; fills the cell vertically from rule-to-rule.

2 or all — Fills the cell from gutter-to-gutter (does not extendthe fill into any gutter).

3 or halfgutter — Fills the cell halfway through each gutterin all directions, except at table boundaries where the fillextends through the box gutter. This entry is useful whencancelled horizontal rules are not centered in the gutter andyou want the fill to extend to the center of the gutter.

Gradient Fill XyMacros

Tints, Color, and Pattern Management Gradient Fills 11-3

Entry Description

4 or guttermeasure — Fills the cell horizontally to the textmeasure; fills the cell vertically halfway through the top andbottom gutters, except at table boundaries.

priority Controls which area is visible on top of another area. Ahigher priority area hides any portion of a lower priority areathat it overlaps.

If two areas have the same priority, the area lower on thepage hides overlapping portions of the area higher on thepage.

Text and graphic blocks have a priority of 0; you cannotchange the priority of text.

Enter a value from -127 to 127 to specify the priority of thecurrent shape. Defaults to -30.

• Assign a priority less than 0 if you want text to overlap thefill shape.

• Assign a priority greater than 0 if you want the fill shapeto overlap text.

• If you assign a priority of 0 to a fill shape, text overlaps theshape, but the shape overlaps any filled area with apriority less than 0.

width Width of the filled shape.

A qualified positive value, or:

1 or block — From the current cell to the end of the block.

2 or cell — Within the current cell (default).

3 or table — From the current cell to the end of the table.

depth Depth of the filled shape.

A qualified positive value, or:

1 or block — From the current cell to the end of the block.

2 or cell — Within the current cell (default).

3 or table — From the current cell to the end of the table.

Note: For any of the fields in the gcell macro, entering a value outside the rangedocumented in the field’s entry in the above table, may produce unpredictableresults.

Comments

Place the gcell XyMacro in the cell where you want to start the gradient fill(after the Tr or Tc XyMacro).

For header text, if you want the gradient fill shape to continue in the nextsection of table that breaks across blocks, place the gcell XyMacro on thefirst line of the header row(s) and set the number of continued header rowsto at least one.

Gradient Fill XyMacros

11-4 Gradient Fills Tints, Color, and Pattern Management

If you do not want the fill shape to continue in the header text of a brokentable, place the gcell XyMacro after the begtab XyMacro and before the firstTr XyMacro.

To output a gradient fill shape in individual cells, you can place the gcellXyMacro in the Tabular Composition (T5) Spec.

When outputting a gradient fill inside a tabular cell, Gradient Fillsautomatically calculates the position of the fill based on the cell fill type andthe width and depth of the cell.

grad Gradient Fill Text

Generates a gradient filled shape.

Gradient Fills draws the shape inside a bounding box based on the widthand depth from the current x/y position where you place the XyMacro.

• For ovals and circles, the center point is down and to the right, by halfthe height and width of the shape.

• For rectangles, the current point is the upper left corner of the box.

Format <grad;shtype;color;stint;etint;priority;width;depth >

Entry Description

shtype Shape type and fill direction.

Rectangle:

0 — Fill from left to right10 — Fill from top to bottom

Half Oval:

1 — Fill from left to right11 — Fill from top to bottom

Full Oval:

2 — Fill from left to right12 — Fill from top to bottom

color Color with which to fill the shape. Enter the color number orname from the Color Control Spec listed in the Job Ticket.For example, 1=black, 2=white, 3=red.

stint Starting tint percentage,

Enter a number from 0 to 100. Do not enter a percent sign.

etint Ending tint percentage.

Enter a number from 0 to 100. Do not enter a percent sign.

Gradient Fill XyMacros

Tints, Color, and Pattern Management Gradient Fills 11-5

Entry Description

priority Controls which area is visible on top of another area. An areawith a higher priority hides any portion of a lower priorityarea that it overlaps.

If two areas have the same priority, the area lower on thepage hides overlapping portions of the area higher on thepage.

Text and graphic blocks have a priority of 0, and you cannotchange the priority of text.

Enter a value from -127 to 127 to specify the priority of thecurrent shape. Defaults to -30.

• Assign a priority less than 0 if you want text to overlap thefill shape.

• Assign a priority greater than 0 if you want the fill shapeto overlap the text.

• If you assign a priority of 0 to a fill shape, text overlaps theshape, but the shape overlaps any filled area with apriority less than 0.

width Width of the filled shape, in qualified units.

depth Depth of the filled shape, in qualified units.

Note: For any of the fields in the grad XyMacro, entering a value outside the rangedocumented in the field’s entry in the above table, may produce unpredictableresults.

Comments To change the position of the gradient fill, you can change the location ofthe XyMacro. For example, to center a circle or oval around the currentpoint, move back half the width and depth of the oval or shape beforeentering the XyMacro.

To place a gradient fill behind a graphic block, set the priority fields of thetwo blocks so that the graphic block has a higher priority. Refer to thesection, Examples of Gradient Fills, which follows.

If a graphic block has computed width or depth, write a custom XyMacro tocapture the width and depth of the graphic in x-registers by using theXyMacros <px > < ig;imagename > <pa > and getting the values of the%imwidth and %imdepth system variables.

Gradient Fill XyMacros

11-6 Gradient Fills Tints, Color, and Pattern Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Examples of Gradient Fills

This section shows examples of gradient fills in text and in tables.

Examples of Gradient Fills in Text

This <grad;1;3;100;10;;2p;3p > example uses the grad XyMacro to draw ahalf oval. The fill color starts at 100% and goes to 10% horizontally from leftto right. The XyMacro uses the default priority of -30, which allows text tooverlap the filled shape.

Changing the fill direction and the placement of the grad XyMacro changesthe location and color of the half oval. <grad;11;3;100;10;20;2p;3p >. Thefill color starts at 100% and goes to 10% vertically (from top to bottom). TheXyMacro set the priority to 20, which allows the shape to overlap text.

This example uses the grad XyMacro to draw arectangle.<grad;0;5;80;20;0;5p;2p >. The starting point of the rectangle isthe current position of the grad XyMacro and the text overlaps the filledshape.

This example uses the grad XyMacro to draw a circle.

<grad;2;7;80;20;0;2p;2p >. The starting point of the circle is the currentposition of the grad XyMacro and the text overlaps the filled shape.

This is an example of placing a filled shape behind a graphic block.

In this case the annotation block comes before the graphic block and bothhave the priority set to 0. The fields for width and depth in the <grad >

XyMacro are used to generate the shape and size needed to create thebackground to the graphic block. The annotation block contains thisXyMacro: <grad;2;4;80;60;0;12p;5p >.

You can also place the filled shape behind the graphic block by placing theblocks in whatever order you wish and assigning the filled shape a lowerpriority than the graphic block.

Examples of Gradient Fills

Tints, Color, and Pattern Management Gradient Fills 11-7

Examples of Gradient Fills in Tables

This example shows a table with two gcell XyMacros, as follows:

• Before the first Tr XyMacro: <gcell;1;7;100;40;1;0;table;table >

produces the purple half oval that fills the table.

• After Tr in cell A13, <gcell;10;3;80;60;2;-10;2;3 > produces the redrectangle—filled from top to bottom, the width of the cell and with adepth that goes to the end of the table.

Table 11-1 Table with Two Gcell XyMacros

A B C D E F

1 2 3 4 5 6

7 8 9 10 11 12

13 14 15 16 17 18

19 20 21 22 23 24

This example shows a table with three gcell XyMacros, as follows:

• After Tr in cell A, <gcell;1;4;40;100;1;-30;cell;table > produces thegreen half oval the width of the first cell and the depth of the table.

• After Tc in cell D16, <gcell;2;5;60;25;0;-30;cell;cell > produces the blueoval shape that fills the cell.

• After Tc in cell F, <gcell;12;3;50;40;4;10;cell;block > produces the redoval, which is the width of the cell and the depth of the block. Becausethe oval has a priority of 10, the gradient fill overlaps and hides thetabular text (with a priority of 0) .

Table 11-2 Table with Three gcell XyMacros

A B C D E F

1 2 3 4 5 6

7 8 9 10 11 12

13 14 15 16 17 18

19 20 21 22 23 24

Examples of Gradient Fills

11-8 Gradient Fills Tints, Color, and Pattern Management

Part IV

Outputting Tints, Patterns, and Color

Chapter 12

Outputting Tints, Patterns,and Color

This chapter describes outputting documents in the following ways:

• With spot color

• With patterns

• By color separation

• Without color

• Using a specified Color Control or SEP spec

Tints, Color, and Pattern Management Outputting Tints, Patterns, and Color 12-1

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Outputting Documents With Spot Color

If you output a color document to a color PostScript printer, you do nothave to turn on special options. If a document contains spot colorcommands (for example, by using XyMacros, or entering values in pop-upfields or style spec fields), XPP looks at the spec called for by the –cspnameoption, the spec named in the Job Ticket, or the spec named in the DivisionTicket to determine which colors to output.

Use the Color Spec field in the Job Ticket or the Alternate Color Spec field in theDivision Ticket to specify a Color Control spec at the job level or the stylelibrary level, respectively:

• The default entry is ps.

• The spec you name can reside at the job level, style library level, or thesystem level.

• If XPP cannot find the spec you name, it uses ps.

• If you leave the field blank, XPP uses no spec and the job uses nocolors.

• Spot colors appear as shades of gray on output to clack and whiteoutput devices. On composite pages (not separations), XPP uses thevalues in the CMYK or RGB fields to determine the density of thegray. On separations, XPP uses the tint currently in effect (patterns1−100) to determine the density of the gray.

Printing From an Open Division

When printing from an open division, you use the XButtons menu. XPPdisplays the Print Dialog. Unless you specify a Color Control spec on theColor tab, XPP uses the Color Control spec named in the Division Ticket, orif none is named there, the Color Control spec named in the Job Ticket.

To override the Division Ticket and Job Ticket:

1. Click the Print button on the XButtons menu.XPP displays the Print dialog.

2. Select the Color tab.XPP displays the Color dialog box.

3. Check Use color control spec box, located below the Color outputsection.XPP enables the corresponding text box.

4. Enter the name of the Color Control spec you want to use in the textbox.

Outputting Documents With Spot Color

12-2 Outputting Tints, Patterns, and Color Tints, Color, and Pattern Management

5. Click the Run button when you are finished making selections in thePrint Dialog.

Xyraster Images

The default output for Xyraster images is in color. For an ig or igt XyMacro,unless you specify a color argument, the color defaults to whatever color iscurrently in effect. A pickup defaults to the color assigned to it. You can usethe print option –blgr to override the default output behavior of imagescalled by pickups and ig/igt XyMacros. You can also use the –blgr optionwith the output driver to turn off the colorizing of Xyraster and Xycontonegraphics and ouput them as black.

Refer to ″Print Options for Tints, Patterns, and Color″ on page 12-5 forinformation on the print options for tints, patterns, and color.

Outputting Documents With Spot Color

Tints, Color, and Pattern Management Outputting Tints, Patterns, and Color 12-3

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Outputting Documents with Patterns

If you output a document with patterns, and the output device can supportthose patterns, you do not have to turn on special options. If a documentcontains patterns other than those defined in the default SEP spec, sep ps,you can check the Special-effects Spec for tints box on the Color tab of the PrintDialog to specify which SEP spec you want XPP to use.

Note that the _sep_ps.sde file now references definepatt2 definition, whichdescribes XPP patterns in level 2. The _sep_ps.sde file is delivered toxylibrary/Lsyslib (unless you are doing a brand new installation—then XPPinstalls the file directly in Lsyslib). You need to copy this file to Lsyslib to beable to use the level 2 patterns.

The XyView experiences increased speed and readability with the new level2 definitions.

SDL continues to deliver the original sep_ps file, now named _sep_level1.sdefile, which references the original definepatt file for backwards compatibility.

Note: The −sep_ps.sde file is now incompatible with the –colorsep option inthe output driver because XPP only supports color separation in level 1. However,if you copy the _sep_level1.sde file into Lsyslib, you can still obtain colorseparation by using the –sep level1 option for the output driver.

Outputting Documents with Patterns

12-4 Outputting Tints, Patterns, and Color Tints, Color, and Pattern Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Print Options for Tints, Patterns, and Color

When printing a document containing color, tints, and patterns, you canselect which of the color separations you want to print. You can also select aspecific Color Control or SEP spec you want XPP to use from the Color tabon the Print Dialog.

Note: XPP only colorizes Xyraster images.

To set the print options:

1. Right-click a job or division from PathFinder.PathFinder displays a pop-up menu.

2. Select Print.XPP displays the Print Dialog

3. Select the Color tab.XPP displays the Color dialog box.

4. Click the Color Separation radio button.The Print Dialog enables a variety of options on the Color tab.

5. Select the options you want XPP to use for this document.

6. Click the Run button when you have finished selecting options on thevarious tabs on the Print Dialog.

SDL periodically delivers new print options and obsoletes others. Afterupgrading to a new release of XPP software, you may need to access a newDevice Options File so you have the current set of print options.

Refer to:

• XML Professional Publisher: Release Notes for information on whetherSDL has delivered new print options or removed options.

• XML Professional Publisher: Command Line Utilities for new options tothe psfmtdrv program.

Note: If you output a document containing color to a black and white printer anddo not use any of the special effects options, the document contains tints of grayonly. The density of the gray depends on the color and the tint in effect.

Print Options for Tints, Patterns, and Color

Tints, Color, and Pattern Management Outputting Tints, Patterns, and Color 12-5

The following table describes the options available when outputting jobscontaining tints, patterns, and color to a PostScript printer.

Table 12-1 Print Options for Tints, Patterns, and Color

Option Description

–allowbl Outputs all separation plates, including blanks. To use thisoption, you must also specify the –colorsep option.

• No –allowbl option — during color separation XPP doesnot output CMYK or spot color plates that are blank. XPPoutputs only separation plates for pages on whichsomething should appear. This default behavior eliminatesthe generation of unnecessary blanks.

• The –allowbl option with the –colorc, –colorm, –colory,–colork options — XPP outputs the plates for the specifiedcolor(s), including blanks.

• The –allowbl option without any color options specified— XPP outputs all plates for cyan, magenta, yellow, andblack for each page of the document, including blanks.

For example, to output all magenta plates, including blanks,specify the options –allowbl –colorm –colorsep.

–allspots Outputs all spot color separations. To use this option, youmust also specify the –colorsep option. The –allspots optionoverrides the –spotsep option.

On black and white output devices, spot colors appear asshades of gray with the density determined by the tint(patterns 1−100) that is currently in effect.

You can use this option with –colorc, –colorm, –colory, and–colork.

–blgr Outputs Xyraster or Xycontone graphics in black.

The –blgr option overrides any color specified in an ig or igtXyMacro, or pickup definition.

–colorc Outputs cyan separations. To use this option, you must alsospecify the –colorsep option.

May be used with the following options to outputseparations for more than one color: –colorm, –colory,–colork options, –spotsep –allspots.

–colorm Outputs magenta separations. To use this option, you mustalso specify the –colorsep option.

May be used with the following options to outputseparations for more than one color: –colorc, –colory,–colork options, –spotsep –allspots.

Print Options for Tints, Patterns, and Color

12-6 Outputting Tints, Patterns, and Color Tints, Color, and Pattern Management

Table 12-1 Print Options for Tints, Patterns, and Color (Continued)

Option Description

–colory Outputs yellow separations. To use this option, you mustalso specify the –colorsep option.

May be used with the following options to outputseparations for more than one color: –colorc, –colorm,–colork options, –spotsep –allspots.

–colork Outputs black separations. To use this option, you must alsospecify the –colorsep option.

May be used with the following options to outputseparations for more than one color: –colorc, –colorm,–colory options, –spotsep –allspots.

–colorsep Produces color separations using the color separationcontrols defined in the Color Control spec called by the–cspname option.

This option outputs separations for cyan, magenta, yellow,and black, plus a separation for each spot color.

If you use the –colorsep option with the –colorc, –colorm,–colory, –colork, –allspots, or –spotsep option(s), XPPoutputs the separation plates specified.

The _sep_ps.sde file is incompatible with the –colorsep option.Refer to page 12-4.

If you print a document containing a color to a black andwhite PostScript device, using the –colorsep option, the tintappears as a shade of gray. Spot colors appear as shades ofgray with the density determined by the tint (patterns 1−100)that is currently in effect.

–cspname The Color Control spec to use, where name is analphanumeric string that is the name or number of a specthat you have defined in the Color Control window.

Overrides the Color Spec field in the Job Ticket and the Alternate

Color Spec field in the Division Ticket.

–dotshnumber The dot shape used for halftone screens.

The –dotsh option overrides the dot shape setting made inthe Color Control spec when outputting color separations.Valid entries are:

0 − printer default1 − round dot2 − elliptical dot3 − diamond dot4 − rhomboid dot5 − line screen

Print Options for Tints, Patterns, and Color

Tints, Color, and Pattern Management Outputting Tints, Patterns, and Color 12-7

Table 12-1 Print Options for Tints, Patterns, and Color (Continued)

Option Description

–freqnumber The screen frequency used for halftones.

The –freq option overrides the screen frequency settingmade in the Color Control spec when outputting colorseparations. A value of 0 uses the default frequency of theprinter. Any other value is the screen frequency in dots perinch.

–nocolor Use with black and white printers only to print colored textin black.

This option is useful for proofing colored text that mightotherwise be difficult to read. For example, a page of yellowtext may be difficult to proofread because it prints in a lightshade of gray. Using this option, the text prints in black andis easier to read.

If you do not use this option, XPP prints the document usingcolors from the specified Color Control spec.

Do not use this option with the –colorsep option.

–pgcyan Enables you to choose cyan when printing in Page LayoutMode using the –pglayout option. This could be used with acolor printer, for example, to print pages with no text, justlayout lines, in non-repro blue for use in making up pagedummies.

You must use –pgcyan with the –pglayout option.

–sepname The SEP spec to use, where name consists of as many asseven alphanumeric characters.

–spotsepname Outputs the separation for a spot color, where namecorresponds to the name or number of a spot color defined inthe Color Control spec. You can only specify one spot colorusing this option.

Onb black and white output devices, spot colors appear asshades of gray with the density determined by the tint(patterns 1−100) that is currently in effect.

To use this option, you must also specify the –colorsepoption. The –allspots option overrides the –spotsep option.If you specify the –spotsep option and the –allspots option,XPP outputs all spot color separations, not just the onespecified with the –spotsep option.

You can use this option with the –colorc, –colorm, –colory,and –colork options.

Print Options for Tints, Patterns, and Color

12-8 Outputting Tints, Patterns, and Color Tints, Color, and Pattern Management

Glossary

block backgroundHas the same dimensions and position as the block. It does not include elements such as text,boxes, and rules. You can specify a tint, pattern, or color for a block background.

block contentsIncludes text, boxes, and rules. It does not include tabular rules. You can specify a color or tintfor block contents, but not a pattern.

CMYK color modelThe standard ink colors for four-color printed materials (Cyan, Magenta, Yellow, and blacK).This is the common color model used for producing colors that appear in the printed medium.Cyan, magenta, yellow, and black are also known as subtractive colors.

Color Control specificationA Color Control Spec contains definitions of colors that are available for output to a PostScriptdevice, values for color separation plates, and spot color mapping information.

color definitionsThere are two types of color definitions: XPP and imported EPSF. For an XPP color, you canspecify name, number, color model, color percentage values, and overprinting. For an XPP coloror an imported EPSF color, you can specify whether it is a spot color, and whether to allow spotcolor mapping.

color modelsIn an XPP color definition, you can specify either the RGB (additive) color model or the CMYK(subtractive) color model.

densityA measure, usually expressed as a percentage, of how much of a color is in a tint. Tints with lessdensity are paler, tints with higher density are deeper.

dot shapeThe shape of the dot used for printing halftones. You can choose round, elliptical, diamond, orrhomboid shape dots to vary the appearance of a halftone. You can also choose a line screen dotshape for a different effect.

Tints, Color, and Pattern Management Glossary 1

knockoutPrinting only the foreground color, not the background. You can allow this in XPP colordefinitions. See overprinting.

overprintingPrinting on top of another color. You can allow this in XPP color definitions. Not allowingoverprinting produces a knockout.

patternA single design element (for example, a line) that is repeated until it fills a defined area.

pattern tableThe section of the Special Effects Patterns (SEP) Spec that defines rules for tints and patterns.

plate setA group of spot colors that are output on one separation plate.

process colorOne of the four standard printing inks (cyan, magenta, yellow, or black) that combine to form afull-color printed piece.

RGB color modelThe colors of light (Red, Green, and Blue). These are the colors used to produce the range ofcolors that appear on video displays such as televisions and color computer monitors. Therefore,this is the common color model used for information appearing in that medium, such as onlinedocumentation. Red, green, and blue are also known as additive colors.

screen angleThe angle at which the application places the dots in a screened area. If superimposed screenshave different angles, the dots in the two screens are not printed directly on top of each other.Instead, they are printed adjacent to each other. When superimposing screens, moire patterns(grid-like patterns), may appear. By controlling the screen angle, you can eliminate moirepatterns.

screen frequencyThe number of lines (or rows) of halftone dots printed per inch on the page. A high screenfrequency (also called linescreen or screen ruling) prints the dots close together, creating sharp,distinct colors and images. A low screen frequency prints the dots farther apart, creating acoarser effect. Screen frequencies are usually device-dependent.

shape tableThe section of the Special Effects Patterns (SEP) Spec that defines rules for shapes. Do not modifythis table. It is for internal use only.

special effectA tint, pattern, or color applied to text or regions.

Special Effects Patterns (SEP) specificationThe Special Effects Patterns (SEP) Spec contains fields defining patterns and tints. Patternnumbers 1-100 are reserved for tints. Each number represents the percentage of the screen. AnSEP of 20, for example, would indicate a 20% screen of color. In addition, XPP delivers 64decorative patterns, numbered 101-164. Refer to the section “XPP-delivered Patterns” on page 6-9for samples of the XPP-delivered patterns. You can create additional patterns. However, youroutput device must be able to support those patterns.

spot colorA color, other than cyan, magenta, yellow, or black, that is printed in a single color of ink.

2 Glossary Tints, Color, and Pattern Management

spot color mappingOutputting two or more spot colors on one separation plate. Allowing spot color mapping in acolor definition makes that color available for plate sets.

tintA type of pattern, or even-toned area formed by repeating segments of dots. Lighter tints areproduced by increasing the space between the dots. Also called a screen.

undercolor removalIn RGB-to-CMYK conversions, overlapping CMY colors are reduced proportionally. TheSeparation Plate Control dialog box has fields to adjust the color threshold for removal ofunderprinting colors in separation plates.

XyMacroAny macro designed and documented by SDL and furnished with the XPP system. XyMacrosperform a variety of typesetting tasks, such as quadding a line or drawing a box. You can useXyMacros to change or override typographic parameters defined in the style specs. A XyMacromust contain a begin character, a mnemonic, and an end character. It may also contain one ormore arguments. XyMacros provide a flexible way to make specific typographical changes, andto produce highly individualized single pages or exception pages.

Tints, Color, and Pattern Management Glossary 3

4 Glossary Tints, Color, and Pattern Management

Index

AAdd Color 3-4Allow Spot Mapping field 4-11allowbl option 12-6allspots option 12-6Angle field 5-3

separation plate control 5-3

BBlack% field 4-9Black

undercolor removal 5-7blgr option 12-6Block Background: Color field

layout blocks 10-12Page Layout (PL) Spec 10-5pickup element blocks 10-9

Block Background: Color 10-510-9 10-12

Block Background: Patternfield

layout blocks 10-12Page Layout (PL) Spec 10-5pickup element blocks 10-10

Block Background: Pattern 10-510-10 10-12

Block Contents: Color fieldlayout blocks 10-11Page Layout (PL) Spec 10-4pickup element blocks 10-9

Block Contents: Color 10-4 10-910-11

Block Contents: Pattern fieldlayout blocks 10-12

Page Layout (PL) Spec 10-4pickup element blocks 10-9

Block Contents: Pattern 10-410-9 10-12

Block 10-2filled 10-2layout 10-11pickup 10-8

Blue% field 4-9Boxes See Rectangles

CCircles

dimensions 8-2filled 1-4 8-1position 8-3

CMYKcolor model 4-9color values 12-2

co XyMacro 10-15Color (co) XyMacroColor Control Spec 2-4

copying 3-6creating 3-6default 2-6deleting 3-7naming conventions 2-5renaming 3-7

Color Control specspecifying 12-7

Color Control window 3-2Color definition

deleting 4-13settings 4-8

Color Definitions dialog box4-6

Color definitionsadding 4-4importing 4-14modifying 4-5naming conventions 2-5XPP 4-5

Color fieldItem Format (IF) Spec 10-7

Color Model field 4-8Color Model (XPP colors only)

4-8Color model

CYMK 2-4RGB 2-4

Color Name and Number (XPPcolors only) 4-8

Color Name field 4-8Color Values field 4-9Color Values (XPP colors only)

4-9colorc option 12-6colork option 12-7colorm option 12-6Color 10-7

alternate 9-10knockout 4-10layout blocks 10-11overprinting 4-10Page Layout (PL) Spec 10-3pickup 10-8requirements 2-2separation plate control 5-2separation 5-1spot 4-11

Tints, Color, and Pattern Management Index 1

colorsep option 12-7colory option 12-7Copying

Color Control Spec 3-6csp option 12-7Cyan% field 4-9CYMK

color model 2-4

DDefault

Color Control Spec 2-6SEP Spec 6-2

Delete Color 3-4Deleting

color definition 4-13Dot shape

selecting 12-7dotsh option 12-7Draw Filled Box (fbox)

XyMacro 7-4Draw Filled Box with Text

(fboxt XyMacro 7-10Draw Filled Oval (oval)

XyMacro 8-4

EEdit Color 3-4efboxt XyMacro 7-21Ellipses

dimensions 8-2filled 1-4 8-1position 8-3

End Filled Box with Text(efboxt) XyMacro 7-21

End Reverse Video (erv)XyMacro 10-14

EPSF color definitionsimporting 4-14

erv XyMacro 10-14

Ffacolor XyMacro 9-10fangle XyMacro 9-12fbox XyMacro 7-4fboxt XyMacro 7-10fcell XyMacro 9-4fdepth XyMacro 9-14ffreq XyMacro 9-13Fields

Item Format (IF) Spec 10-6Page Layout (PL) Spec 10-3SEP Spec 6-3

Fill Angle (fangle) XyMacro9-12

Fill Cell (fcell) XyMacro 9-3Fill Depth (fdepth) XyMacro

9-14Fill Frequency (ffreq) XyMacro

9-12Fill Priority (fprio) xym 9-11Fill Type (ftype) XyMacro 9-10Fill Width (fwidth) XyMacro

9-13Fill with Main Color (fmcolor)

XyMacro 9-8Fill with Pattern (fpat)

XyMacro 9-6Filled Text (ftext) XyMacro

10-16Filled

blocks 10-2circles/ellipses 1-4 8-1rectangles 1-3 7-2tabular elements 1-4 9-2text 10-16

fmcolor XyMacro 9-9fpat XyMacro 9-7fprio XyMacro 9-11freq option 12-8Frequency field 5-3ftext XyMacro 10-16ftype XyMacro 9-10fwidth XyMacro 9-13

Ggcell XyMacro 11-3grad XyMacro 11-5Gradient Fill Tabular Cell 11-3Gradient Fill Text 11-5Green% field 4-9

HHalftone Spot Function field

5-3Halftones

angle 9-5dot shape 5-3 12-7screen angle 7-7 9-12screen frequency 7-7 9-6

9-13 12-8

IImport Image Colors 3-4Importing

EPSF color definitions 4-14

Item Format (IF) Spec 10-6

KKnockout 4-10

LLayout blocks

color 10-11patterns 10-11

MMagenta% field 4-9Magenta

undercolor removal 5-6Map Name 4-12Mapping spot colors 5-8

NName field 6-4Name 6-4Naming conventions

Color Control Spec 2-5Color definitions 2-5

Namingplate sets 5-9

nocolor option 12-8Number field 4-8

OOutput field 6-4Output 6-4

options 12-5patterns 12-4spot color 12-2tints, patterns, color 1-6

oval XyMacro 8-4Overprint field 4-10Overprint (XPP colors only)

4-10Overprinting colors 4-10

PPage Layout (PL) Spec 10-3Pattern field

Item Format (IF) spec 10-7Pattern (pt) XyMacro

2 Index Tints, Color, and Pattern Management

Pattern 10-7layout blocks 10-11outputting 12-4Page Layout (PL) Spec 10-3pickup 10-8XPP-delivered 6-9

pgcyan option 12-8Pickup

color 10-8pattern 10-8

Plate setsaccessing 5-8naming 5-9

Positioning circles/ellipses 8-3PostScript

color separation 5-1Print options 12-5pt XyMacro 10-15

QQuit 3-3

RRectangles

dimensions 7-2filled 1-3 7-2

Red% field 4-9Renaming

Color Control Spec 3-7Reverse Video (rv) XyMacro

10-14Reverse video 10-14RGB

color model 2-4values 12-2

rv XyMacro 10-14

SScreen angleScreen frequencyScreen

angle 5-3 7-7 9-5 9-12dot shape 12-7frequency 5-3 7-7 9-6 9-13

12-8sep option 12-8SEP Spec 6-2

copying default 6-5creating 6-4default 6-2fields 6-3

specifying 12-8sfboxt XyMacro 7-14Slug line 5-1Special Effects Patterns Spec

6-2Special effects

Color Control Spec 2-4Spec

Color Control 2-4default SEP Spec 6-2Item Format (IF) Spec 10-6Page Layout (PL) Spec 10-3SEP 6-2

Spot Color field 4-11Spot color mapping definitions

accessing 5-8Spot Color 4-11Spot color 4-11

mapping 5-8output 12-2text 10-13

Spot Function 3-4Color Control Spec 3-5

Spot Map field 5-8Spot Map 4-11spotsep option 12-8Start Filled Box with Text

(sfboxt) XyMacro 7-14syslib library 6-6System variables 10-18

TTable Comment field 6-3Table Comment 6-3Tabular elements 9-2

filled 1-4Text

filled 10-16spot color 10-13tints 10-13

Tintstext 10-13

Type 6-3

UUndercolor Black Removal

Threshold field 5-7Undercolor Black Removal

Threshold 5-7Undercolor Magenta Removal

field 5-6

Undercolor Magenta Removal5-6

Undercolor Removal 3-4Undercolor removal 5-4 5-5

black 5-7magenta 5-6yellow 5-6

Undercolor Yellow Removalfield 5-6

Undercolor Yellow Removal 5-6Upgrading XPP 6-6

VVariables

! system 10-18% system 10-18

XXPP

color definitions 4-4 4-5XyMacros

color 1-5 10-15fill angle 9-12fill cell 9-3fill depth 9-14fill frequency 9-12fill priorityacro 9-11fill type 9-10fill width 9-13fill with alternate color 9-9

9-10fill with main color 9-8fill with pattern 9-6filled cell 9-4filled circles/ellipses 8-4filled rectangles 7-4filled tabular elements 9-3filled text 10-16pattern 10-15reverse video 10-14tints 1-5

YYellow% field 4-9Yellow

undercolor removal 5-6

Tints, Color, and Pattern Management Index 3

SDL Group201 Edgewater DriveWakefield, MA 01880-6216

www.sdl.com