Presentation Text Object Content Architecture Reference - AFP CONSORTIUM

Advanced Function Presentation Consortium

Data Stream and Object Architectures

Presentation Text Object Content Architecture Reference

AFPC-0009-03

Note: Before using this information, read the information in "Notices" on page 171.

AFPC-0009-03 Fourth Edition (March 2016) This edition applies to the Presentation Text Object Content Architecture (PTOCA). It is the first edition produced by the AFP ConsortiumTM(AFPCTM) and replaces and makes obsolete the previous edition, SC31-6803-02, published by the IBM? Corporation. This edition remains current until a new edition is published.

Specific changes are indicated by a vertical bar to the left of the change. For a detailed list of the changes, see "Summary of Changes" on page ix.

Internet Visit our home page:

Copyright ? AFP Consortium 1997, 2016

ii

Preface

This book describes the functions and services associated with the Presentation Text Object Content Architecture (PTOCA) architecture.

This book is a reference, not a tutorial. It complements individual product publications, but does not describe product implementations of the architecture.

Who Should Read This Book

This book is for systems programmers and other developers who need such information to develop or adapt a product or program to interoperate with other presentation products.

Copyright ? AFP Consortium 1997, 2016

iii

AFP Consortium

AFP Consortium (AFPC)

The Advanced Function PresentationTM(AFPTM) architectures began as the strategic, general purpose document and information presentation architecture for the IBM Corporation. The first specifications and products go back to 1984. Although all of the components of the architecture have grown over the years, the major concepts of object-driven structures, print integrity, resource management, and support for high print speeds were built in from the start.

In the early twenty-first century, IBM saw the need to enable applications to create color output that is independent from the device used for printing and to preserve color consistency, quality, and fidelity of the printed material. This need resulted in the formation, in October 2004, of the AFP Color ConsortiumTM (AFPCCTM). The goal was to extend the object architectures with support for full-color devices including support for comprehensive color management. The idea of doing this via a consortium consisting of the primary AFP architecture users was to build synergism with partners from across the relevant industries, such as hardware manufacturers that produce printers as well as software vendors of composition, work flow, viewer, and transform tools. Quickly more than 30 members came together in regular meetings and work group sessions to create the AFP Color Management Object Content ArchitectureTM (CMOCATM). A major milestone was reached by the AFP Color Consortium with the initial official release of the CMOCA specification in May 2006.

Since the cooperation between the members of the AFP Color Consortium turned out to be very effective and valuable, it was decided to broaden the scope of the consortium efforts and IBM soon announced its plans to open up the complete scope of the AFP architecture to the consortium. In June 2007, IBM's role as founding member of the consortium was transferred to the InfoPrint? Solutions Company, an IBM/Ricoh? joint venture. In February 2009, the consortium was incorporated under a new set of bylaws with tiered membership and shared governance resulting in the creation of a formal open standards body called the AFP Consortium (AFPC). Ownership of and responsibility for the AFP architectures was transferred at that time to the AFP Consortium.

How to Use This Book

This book is divided into six chapters, three appendixes, and a glossary.

? Chapter 1, "Overview of Presentation Architecture" introduces the AFP presentation architectures and positions Presentation Text Object Content Architecture as a strategic object content architecture.

? Chapter 2, "Introduction to PTOCA" briefly states the purpose and function of PTOCA.

? Chapter 3, "Overview of PTOCA" introduces the concepts that form the basis of PTOCA and provides a brief description of the data structures.

? Chapter 4, "Data Structures in PTOCA" provides the detailed syntax, semantics, and pragmatics of the data structures found in PTOCA.

? Chapter 5, "Exception Handling in PTOCA" describes how exceptions are handled in PTOCA and lists the exception codes.

? Chapter 6, "Compliance with PTOCA" describes how products may be valid generators or receivers of PTOCA.

? Appendix A, "MO:DCA Environment" describes the Presentation Text object in the context of a MO:DCATM data stream.

? Appendix B, "IPDS Environment" describes the Presentation Text object in the context of an IPDSTM data stream.

? Appendix C, "PTOCA Retired Functions" describes the retired PTOCA functions.

? The "Glossary" on page 173 defines some of the terms used within this book.

iv PTOCA Reference

How to Use This Book

How to Read the Syntax Diagrams

Throughout this book, syntax is described using the structure defined below. Six basic data types are used in

the syntax descriptions:

CODE

Architected constant

CHAR

Character string, which may consist of any code points

BITS

Bit string

UBIN

Unsigned binary

SBIN

Signed binary

UNDF

Undefined type

Syntax for PTOCA is shown in tables like the following:

Offset Type

Name

Range

Meaning

M/O

Def

Ind

The field's offset, data Name of field if

type, or both

applicable

Range of

Meaning or purpose of

valid values if the data element

applicable

M/O

M means mandatory. O means optional.

Def

Y means that a default value is defined for the field. N means that there is no default value

defined for the field.

Ind

Y means that the field defaults to a hierarchical default value when the default

indicator (X'F..F') is present. N means that the default indicator semantic is not valid for the

field.

The following is an example of PTOCA syntax for the Begin Line (BLN) control sequence as it appears in this book:

Offset Type

Name

Range

Meaning

M/O

Def

Ind

0

CODE PREFIX

X'2B'

Control sequence Prefix

M

N

N

1

CODE CLASS

X'D3'

Control sequence class

M

N

N

2

UBIN

LENGTH

2

Control sequence length

M

N

N

3

CODE TYPE

X'D8' ? X'D9' Control sequence function type

M

N

N

Please refer to "Control Sequence Detailed Descriptions" on page 45 for a more detailed description of PTOCA syntax.

PTOCA Reference v

Related Publications

Related Publications

Several other publications can help you understand the architecture concepts described in this book. AFP Consortium publications and a few other AFP publications are available on the AFP Consortium web site, .

Table 1. AFP Consortium Architecture References

AFP Architecture Publication AFP Programming Guide and Line Data Reference Bar Code Object Content ArchitectureTM Reference Color Management Object Content Architecture Reference Font Object Content Architecture Reference Graphics Object Content Architecture for Advanced Function Presentation Reference Image Object Content Architecture Reference Intelligent Printer Data StreamTM (IPDS) Reference Metadata Object Content Architecture Reference Mixed Object Document Content ArchitectureTM (MO:DCA) Reference Presentation Text Object Content Architecture Reference

Book Identification S544-3884 (IBM) AFPC-0005 AFPC-0006 AFPC-0007 AFPC-0008 AFPC-0003 AFPC-0001 AFPC-0013 AFPC-0004 AFPC-0009

Table 2. Additional AFP Consortium Documentation

AFPC Publication AFP Color Management ArchitectureTM (ACMATM) AFPC Company Abbreviation Registry AFPC Font Typeface Registry BCOCATM Frequently Asked Questions MO:DCA-L:The OS/2 PM Metafile (.met) Format Presentation Object Subsets for AFP Recommended IPDS Values for Object Container Versions

Book Identification AFPC-0015 AFPC-0012 AFPC-0016 AFPC-0011 AFPC-0014 AFPC-0002 AFPC-0017

Table 3. AFP Font-Related Documentation

Publication Character Data Representation Architecture Reference and Registry; please refer to the online version for the most current information:

Font Summary for AFP Font Collection How To Use TrueType and OpenType Fonts in an AFP System Technical Reference for Code Pages

Book Identification SC09-2190 (IBM)

S544-5633 (IBM) G544-5876 (IBM) S544-3802 (IBM)

vi PTOCA Reference

Table 4. UP3ITM Architecture Documentation

UP3I Publication Universal Printer Pre- and Post-Processing Interface (UP3I) Specification; please refer to the online version:



Related Publications

Book Identification Version 1.20

PTOCA Reference vii

Related Publications viii PTOCA Reference

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

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download