XMP Custom Panels.pdf

(323 KB) Pobierz
b
c
XMP Custom Panels
ADOBE SYSTEMS INCORPORATED
Corporate Headquarters
345 Park Avenue
San Jose, CA 95110-2704
(408) 536-6000
http://partners.adobe.com
September 2003
Copyright 2003 Adobe Systems Incorporated. All rights reserved.
NOTICE: All information contained herein is the property of Adobe Systems Incorporated. No part of this publication (whether in hardcopy or
electronic form) may be reproduced or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or
otherwise, without the prior written consent of the Adobe Systems Incorporated.
PostScript is a registered trademark of Adobe Systems Incorporated. All instances of the name PostScript in the text are references to the
PostScript language as defined by Adobe Systems Incorporated unless otherwise stated. The name PostScript also is used as a product
trademark for Adobe Systems’ implementation of the PostScript language interpreter.
Except as otherwise stated, any reference to a
"
PostScript printing device,”
"
PostScript display device,” or similar item refers to a printing
device, display device or item (respectively) that contains PostScript technology created or licensed by Adobe Systems Incorporated and not
to devices or items that purport to be merely compatible with the PostScript language.
Adobe, the Adobe logo, Acrobat, the Acrobat logo, Acrobat Capture, Distiller, PostScript, the PostScript logo and Reader are either registered
trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.
Apple, Macintosh, and Power Macintosh are trademarks of Apple Computer, Inc., registered in the United States and other countries. PowerPC
is a registered trademark of IBM Corporation in the United States. ActiveX, Microsoft, Windows, and Windows NT are either registered
trademarks or trademarks of Microsoft Corporation in the United States and other countries. UNIX is a registered trademark of The Open Group.
All other trademarks are the property of their respective owners.
This publication and the information herein is furnished AS IS, is subject to change without notice, and should not be construed as a
commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies,
makes no warranty of any kind (express, implied, or statutory) with respect to this publication, and expressly disclaims any and all warranties
of merchantability, fitness for particular purposes, and noninfringement of third party rights.
Contents
XMP Custom File Info Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Custom Panel Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Custom Panel Description File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
File Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Custom Panel Description File Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Custom Panel Widget Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Container Widgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Leaf Widgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Widget Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Widget Variable Key-Value Pairs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Scoping for Linked Variable Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
General Widget Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Container Widget Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Dynamic-Value Leaf Widget Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Type-Specific Leaf Widget Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
ZString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
The ZString Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
ZString Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Localization Dictionary Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Localization Dictionary File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Matching ZStrings for Localization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Troubleshooting a Custom Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Additional Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Sample Custom Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Overview of Samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Sample Custom Panel Description Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Example 1: All Widgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Example 2: Document Description Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
ZString Escape Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Backslash Escape Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
XMP Custom Panels
3
Contents
Hat Escape Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
ISO-based Escape Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
4
XMP Custom Panels
XMP Custom File Info Panels
Introduction
The custom File Info panel for XMP metadata allows you to define, create, and manage
custom metadata properties using standard Adobe applications. You can do this by
creating a Custom Panel Description file, as described in this document, and placing it in a
common location referenced by Adobe applications that support this feature. You can also
supply localization dictionary files to localize the contents of your Custom Panel
Description files.
The resulting custom dialog panel is seen by users when they select the
File Info
menu
option.
The File Info panel allows you to support paths to metadata properties which are not
defined in default or other standard XMP schemas, but are needed for your application,
company, or industry. By using XMP for that metadata, you take advantage of the potential
of XMP for interchange and participation in asset management systems, while providing
the ability to use standard Adobe applications to manage it.
Custom Panel Files
There are two types of files used in creating a File Info custom panel:
Panel description files
These files directly describe and create the custom panels. See
“Custom Panel
Description File Format” on page 5
for a complete description.
Localization dictionary files
These optional files localize the panel description file contents to other languages at run
time. See
“Localization Dictionary Files” on page 26
for a complete description.
Adobe applications that support this feature look for these files in the prescribed locations,
and add your custom panel or panels to their
File Info
dialogs in the language of the dialog.
Custom Panel Description File Format
The panel description file is a 7-bit ASCII file in a simple form of XML, containing the user-
interface definitions for a panel. See
Sample Custom Panels
for example of the format. One
description file describes exactly one custom file panel; however, you can have as many
custom panel files as you wish.
The following file creation tools are recommended:
On Mac OS 9 use SimpleText or a free third-party text editor such as MPW Shell.
XMP Custom Panels
5
Zgłoś jeśli naruszono regulamin