Copyright 2003 Adobe Systems Incorporated. All rights reserved. Adobe® <strong>PDF</strong> <strong>Library</strong> <strong>Supplement</strong> <strong>to</strong> <strong>the</strong> <strong>Core</strong> <strong>API</strong> <strong>Reference</strong>.If this guide is distributed with software that includes an end user agreement, this guide, as well as <strong>the</strong> software described in it, is furnished under licenseand may be used or copied only in accordance with <strong>the</strong> terms of such license. Except as permitted by any such license, no part of this guide may bereproduced, s<strong>to</strong>red in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or o<strong>the</strong>rwise, without <strong>the</strong> priorwritten permission of Adobe Systems Incorporated. Please note that <strong>the</strong> content in this guide is protected under copyright law even if it is not distributedwith software that includes an end user license agreement.Please remember that existing artwork or images that you may want <strong>to</strong> include in your project may be protected under copyright law. The unauthorizedincorporation of such material in<strong>to</strong> your new work could be a violation of <strong>the</strong> rights of <strong>the</strong> copyright owner. Please be sure <strong>to</strong> obtain any permissionrequired from <strong>the</strong> copyright owner.Any references <strong>to</strong> company names in sample templates are for demonstration purposes only and are not intended <strong>to</strong> refer <strong>to</strong> any actual organization.PostScript is a registered trademark of Adobe Systems Incorporated. All instances of <strong>the</strong> name PostScript in <strong>the</strong> text are references <strong>to</strong> <strong>the</strong> PostScriptlanguage as defined by Adobe Systems Incorporated unless o<strong>the</strong>rwise stated. The name PostScript also is used as a product trademark for Adobe Systems’implementation of <strong>the</strong> PostScript language interpreter.Except as o<strong>the</strong>rwise stated, any reference <strong>to</strong> a "PostScript printing device,” "PostScript display device,” or similar item refers <strong>to</strong> a printing device, displaydevice or item (respectively) that contains PostScript technology created or licensed by Adobe Systems Incorporated and not <strong>to</strong> devices or items thatpurport <strong>to</strong> be merely compatible with <strong>the</strong> PostScript language.Adobe, <strong>the</strong> Adobe logo, Acrobat, Acrobat Capture, <strong>the</strong> Adobe <strong>PDF</strong> logo, Distiller, PostScript, <strong>the</strong> PostScript logo and Reader are ei<strong>the</strong>r registeredtrademarks or trademarks of Adobe Systems Incorporated in <strong>the</strong> United States and/or o<strong>the</strong>r countries.Apple, Macin<strong>to</strong>sh, and Power Macin<strong>to</strong>sh are trademarks of Apple Computer, Inc., registered in <strong>the</strong> United States and o<strong>the</strong>r countries. PowerPC is aregistered trademark of IBM Corporation in <strong>the</strong> United States. ActiveX, Microsoft, Windows, and Windows NT are ei<strong>the</strong>r registered trademarks ortrademarks of Microsoft Corporation in <strong>the</strong> United States and/or o<strong>the</strong>r countries. UNIX is a registered trademark of The Open Group. All o<strong>the</strong>r trademarksare <strong>the</strong> property of <strong>the</strong>ir respective owners.This publication and <strong>the</strong> information herein is furnished AS IS, is subject <strong>to</strong> change without notice, and should not be construed as a commitment by AdobeSystems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies, makes no warranty of any kind(express, implied, or statu<strong>to</strong>ry) with respect <strong>to</strong> this publication, and expressly disclaims any and all warranties of merchantability, fitness for particularpurposes, and noninfringement of third party rights.Portions include software under <strong>the</strong> following terms:Portions derived from <strong>the</strong> RSA DataSecurity, Inc. MD5 Message-Digest Algorithm.Portions of <strong>the</strong> software were developed by <strong>the</strong> University of California, Berkeley.The author of this software is David M. Gay. Copyright (c) 1991 by AT&T. Permission <strong>to</strong> use, copy, modify, and distribute this software for any purposewithout fee is hereby granted, provided that this entire notice is included in all copies of any software which is or includes a copy or modification of thissoftware and in all copies of <strong>the</strong> supporting documentation for such software. THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS ORIMPLIED WARRANTY. IN PARTICULAR, NEITHER THE AUTHOR NOR AT&T MAKES ANY REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THEMERCHANTABILITY OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.Portions of <strong>the</strong> software were developed at Cygnus Solutions.Portions copyright (c) 1995-2003 International Business Machines Corporation and o<strong>the</strong>rs. All rights reserved. Permission is hereby granted, free ofcharge, <strong>to</strong> any person obtaining a copy of this software and associated documentation files (<strong>the</strong> "Software"), <strong>to</strong> deal in <strong>the</strong> Software without restriction,including without limitation <strong>the</strong> rights <strong>to</strong> use, copy, modify, merge, publish, distribute, and/or sell copies of <strong>the</strong> Software, and <strong>to</strong> permit persons <strong>to</strong>whom <strong>the</strong> Software is furnished <strong>to</strong> do so, provided that <strong>the</strong> above copyright notice(s) and this permission notice appear in all copies of <strong>the</strong> Softwareand that both <strong>the</strong> above copyright notice(s) and this permission notice appear in supporting documentation. THE SOFTWARE IS PROVIDED "AS IS",WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR APARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED INTHIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROMLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR INCONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. Except as contained in this notice, <strong>the</strong> name of a copyright holder shall not beused in advertising or o<strong>the</strong>rwise <strong>to</strong> promote <strong>the</strong> sale, use or o<strong>the</strong>r dealings in this Software without prior written authorization of <strong>the</strong> copyright holder.Portions copyright (c) 1994 Hewlett-Packard Company. Permission <strong>to</strong> use, copy, modify, distribute and sell this software and its documentation for anypurpose is hereby granted without fee, provided that <strong>the</strong> above copyright notice appear in all copies and that both that copyright notice and thispermission notice appear in supporting documentation. Hewlett-Packard Company makes no representations about <strong>the</strong> suitability of this software forany purpose. It is provided "as is" without express or implied warranty.Copyright (c) 1996 Silicon Graphics Computer Systems, Inc. Permission <strong>to</strong> use, copy, modify, distribute and sell this software and its documentation forany purpose is hereby granted without fee, provided that <strong>the</strong> above copyright notice appear in all copies and that both that copyright notice and thispermission notice appear in supporting documentation. Silicon Graphics makes no representations about <strong>the</strong> suitability of this software for anypurpose. It is provided "as is" without express or implied warranty.Contains an implementation of <strong>the</strong> LZW algorithm licensed under U.S. Patent 4,558,302.Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Notice <strong>to</strong> U.S. Government End Users. The Software and Documentationare “Commercial Items,” as that term is defined at 48 C.F.R. ß2.101, consisting of “Commercial Computer Software” and “Commercial Computer SoftwareDocumentation,” as such terms are used in 48 C.F.R. ß12.212 or 48 C.F.R. ß227.7202, as applicable. Consistent with 48 C.F.R. ß12.212 or 48 C.F.R. ßß227.7202-1 through 227.7202-4, as applicable, <strong>the</strong> Commercial Computer Software and Commercial Computer Software Documentation are being licensed <strong>to</strong> U.S.Government end users (a) only as Commercial Items and (b) with only those rights as are granted <strong>to</strong> all o<strong>the</strong>r end users pursuant <strong>to</strong> <strong>the</strong> terms andconditions herein. Unpublished-rights reserved under <strong>the</strong> copyright laws of <strong>the</strong> United States.Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees <strong>to</strong> comply with all applicableequal opportunity laws including, if appropriate, <strong>the</strong> provisions of Executive Order 11246, as amended, Section 402 of <strong>the</strong> Vietnam Era VeteransReadjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of <strong>the</strong> Rehabilitation Act of 1973, as amended, and <strong>the</strong> regulations at 41 CFR Parts 60-1 through 60-60, 60-250, and 60-741. The affirmative action clause and regulations contained in <strong>the</strong> preceding sentence shall be incorporated by reference.
<strong>PDF</strong> <strong>Library</strong>-specific MethodsASA<strong>to</strong>mGetCountASInt32 ASA<strong>to</strong>mGetCount (void);DescriptionGets <strong>the</strong> number of ASA<strong>to</strong>ms that have been allocated. The maximum number ofASA<strong>to</strong>ms is 0xFFFFFFFF. (This was a 16-bit value in Acrobat 4.x, and changed <strong>to</strong> a 32-bitvalue in Acrobat 5.)ASA<strong>to</strong>ms cannot be deleted or freed. Use this method <strong>to</strong> determine if it is necessary <strong>to</strong> reinitialize<strong>the</strong> library before creating more ASA<strong>to</strong>ms.ParametersNoneReturn ValueNumber of ASA<strong>to</strong>ms currently allocated.Header File<strong>PDF</strong>LCalls.hRelated MethodsASA<strong>to</strong>mExistsForString<strong>PDF</strong>LInit<strong>PDF</strong>LTerm<strong>PDF</strong> <strong>Library</strong> <strong>Supplement</strong> <strong>to</strong> <strong>the</strong> Acrobat <strong>Core</strong> <strong>API</strong> <strong>Reference</strong> 3