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 Consortium™(AFPC™) 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: www.afpcinc.org 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 Presentation™(AFP™) 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 Consortium™ (AFPCC™). 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 Architecture™ (CMOCA™). 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:DCA™ data stream. • Appendix B, “IPDS Environment” describes the Presentation Text object in the context of an IPDS™ 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 Range of Meaning or purpose of type, or both applicable 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 M N N function type 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, http://www.afpcinc.org. Table 1. AFP Consortium Architecture References AFP Architecture Publication Book Identification AFP Programming Guide and Line Data Reference S544-3884 (IBM) Bar Code Object Content Architecture™ Reference AFPC-0005 Color Management Object Content Architecture Reference AFPC-0006 Font Object Content Architecture Reference AFPC-0007 Graphics Object Content Architecture for Advanced Function Presentation Reference AFPC-0008 Image Object Content Architecture Reference AFPC-0003 Intelligent Printer Data Stream™ (IPDS) Reference AFPC-0001 Metadata Object Content Architecture Reference AFPC-0013 Mixed Object Document Content Architecture™ (MO:DCA) Reference AFPC-0004 Presentation Text Object Content Architecture Reference AFPC-0009 Table 2. Additional AFP Consortium Documentation AFPC Publication Book Identification AFP Color Management Architecture™ (ACMA™) AFPC-0015 AFPC Company Abbreviation Registry AFPC-0012 AFPC Font Typeface Registry AFPC-0016 BCOCA™ Frequently Asked Questions AFPC-0011 MO:DCA-L:The OS/2 PM Metafile (.met) Format AFPC-0014 Presentation Object Subsets for AFP AFPC-0002 Recommended IPDS Values for Object Container Versions AFPC-0017 Table 3. AFP Font-Related Documentation Publication Book Identification Character Data Representation Architecture Reference and Registry; SC09-2190 (IBM) please refer to the online version for the most current information: http://www-01.ibm.com/software/globalization/cdra/index.html Font Summary for AFP Font Collection S544-5633 (IBM) How To Use TrueType and OpenType Fonts in an AFP System G544-5876 (IBM) Technical Reference for Code Pages S544-3802 (IBM) vi PTOCA Reference Related Publications Table 4. UP3I™ Architecture Documentation UP3I Publication Book Identification Universal Printer Pre- and Post-Processing Interface (UP3I) Specification; Version 1.20 please refer to the online version: http://www.afpcinc.org PTOCA Reference vii Related Publications viii PTOCA Reference Summary of Changes Summary of Changes This fourth edition of the PTOCA Reference contains the following changes: • The description of font usage in PTOCA has been expanded to include TrueType/Open Type fonts. • The definition of control sequences to support the processing of complex scripts: – Glyph Advance Run (GAR) – Glyph ID Run (GIR) – Glyph Layout Control (GLC) – Glyph Offset Run (GOR) – Unicode Complex Text (UCT) • The definition of a new PTOCA subset - PT4 - that consists of the PT3 subset plus the new control sequences listed above • The Precision byte in the Set Text Color control sequence has been retired; this is documented in a new PTOCA Migration Functions appendix • Editorial updates and clarifications • An updated glossary • Information about the AFP Consortium • IBM product-specific information has been removed (CCS, CPI, CUA, MO:DCA-P, SAA, etc.) • Style changes to make this book more consistent with other AFPC publications As stated in the