将PDF转换为Postscript和图像文件 converting-pdf-to-postscript-andimage-files
本文档中的示例和示例仅适用于JEE环境上的AEM Forms。
关于转换PDF服务
转换PDF服务将PDF文档转换为PostScript和多种图像格式(JPEG、JPEG2000、PNG和TIFF)。 将PDF文档转换为PostScript对于在任何PostScript打印机上进行基于服务器的无人参与打印很有用。 在不支持PDF文档的内容管理系统中归档文档时，将PDF文档转换为多页TIFF文件是切实可行的。
您可以使用转换PDF服务完成以下任务：
- 将PDF文档转换为PostScript。
- 将PDF文档转换为图像格式。
将PDF文档转换为PostScript converting-pdf-documents-to-postscript
本主题介绍如何使用转换PDF服务API（Java和Web服务）以编程方式将PDF文档转换为PostScript文件。 转换为PostScript文件的PDF文档必须是非交互式PDF文档。 也就是说，如果尝试将交互式PDF文档转换为PostScript文件，则会引发异常。
步骤摘要 summary-of-steps
要将PDF文档转换为PostScript文件，请执行以下步骤：
- 包括项目文件。
- 创建转换PDF服务客户端。
- 引用要转换为PostScript文件的PDF文档。
- 设置转换运行时选项。
- 将PDF文档转换为PostScript文件。
- 保存PostScript文件。
包含项目文件
将必要的文件包含在开发项目中。 如果使用Java创建客户端应用程序，请包含必要的JAR文件。 如果您使用的是Web服务，请确保包含代理文件。
创建转换PDF客户端
您必须先创建转换PDF服务客户端，然后才能以编程方式执行转换PDF服务操作。 如果您使用的是Java API，请创建一个ConvertPdfServiceClient对象。 如果您使用的是Web服务API，请创建一个ConvertPDFServiceService对象。
本节使用AEM Forms中引入的Web服务功能。 要访问新功能，您必须使用lc_version属性构建代理对象。 (请参阅使用Web服务调用AEM Forms中的“使用Web服务访问新功能”。)
引用要转换为PostScript文件的PDF文档
引用要转换为PostScript文件的PDF文档。 如本主题前面所述，PDF文档必须是非交互式PDF文档。 如果尝试将交互式PDF文档转换为PostScript文件，则会引发异常。
设置转换运行时选项
将PDF文档转换为PostScript文件时，您可以定义运行时选项，以指定创建的PostScript类型。 例如，您可以定义一个级别3的PostScript文件。
通常，生成的PostScript文件将反映输入PDF文档的大小。 如果选择ShrinkToFit选项(收缩PostScript文件的输出以适合页面)，您将不会看到输入PDF文档与生成的PostScript文件之间的差异。 ShrinkToFit选项仅在您选择在比输入PDF文档小的页码上打印时才生效。 要选择较小的页面大小，请定义PageSize选项。 此外，建议将RotateAndCenter选项设置为true以获取正确的PostScript输出。
同样，如果选择ExpandToFit选项(该选项会扩展PostScript文件的输出以适合页面)，则只有在选择打印的页面大小大于输入PDF文档的大小时，它才会生效。 要选择更大的页面大小，请定义PageSize选项。 此外，建议将RotateAndCenter选项设置为true以获取正确的PostScript输出。
ToPSOptionsSpec类引用。将PDF文档转换为PostScript文件
创建服务客户端并设置运行时选项后，可以调用PostScript转换操作。 此操作将需要有关要转换的文档的信息，包括目标文档的首选PostScript级别。
保存PostScript文件
将PDF文档转换为PostScript后，可以将输出保存为PostScript文件。
另请参阅
使用Java API将PDF文档转换为PS convert-a-pdf-document-to-ps-using-the-java-api
使用转换PDF服务API (Java)将PDF文档转换为PostScript：
-
包括项目文件。
在您的Java项目的类路径中包含客户端JAR文件，例如adobe-convertpdf-client.jar。
-
创建转换PDF客户端。
- 创建包含连接属性的
ServiceClientFactory对象。 - 使用对象的构造函数创建
ConvertPdfServiceClient对象并传递ServiceClientFactory对象。
- 创建包含连接属性的
-
引用要转换为PostScript文件的PDF文档。
- 使用对象的构造函数创建
java.io.FileInputStream对象，并传递一个字符串值，该值指定要转换的PDF文档的位置。 - 使用
com.adobe.idp.Document构造函数创建存储PDF文档的com.adobe.idp.Document对象。 传递包含PDF文档的java.io.FileInputStream对象。
- 使用对象的构造函数创建
-
设置转换运行时选项。
- 通过调用其构造函数创建
ToPSOptionsSpec对象。 - 通过调用属于
ToPSOptionsSpec对象的适当方法来设置运行时选项。 例如，要定义创建的PostScript级别，请调用ToPSOptionsSpec对象的setPsLevel方法，并传递指定PostScript级别的PSLevel枚举值。 有关可设置的所有运行时值的信息，请参阅AEM Forms API引用中的ToPSOptionsSpec类引用。
- 通过调用其构造函数创建
-
将PDF文档转换为PostScript文件。
调用
ConvertPdfServiceClient对象的toPS2方法并传递以下值：- 表示要转换为PostScript文件的PDF文档的
com.adobe.idp.Document对象。 - 指定PostScript运行时选项的
ToPSOptionsSpec对象。
toPS2方法返回包含新PostScript文档的Document对象。 - 表示要转换为PostScript文件的PDF文档的
-
保存PostScript文件。
- 创建
java.io.File对象并确保文件扩展名为.ps。 - 调用
Document对象的copyToFile方法以将Document对象的内容复制到文件中（确保您使用toPS2方法返回的Document对象）。
- 创建
另请参阅
使用Web服务API将PDF文档转换为PS convert-a-pdf-document-to-ps-using-the-web-service-api
使用转换PDF服务API（Web服务）将PDF文档转换为PostScript：
-
包括项目文件。
创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义：
http://localhost:8080/soap/services/ConvertPDFService?WSDL&lc_version=9.0.1。note note NOTE 将 localhost替换为承载AEM Forms的服务器的IP地址。 -
创建转换PDF客户端。
-
使用默认构造函数创建
ConvertPdfServiceClient对象。 -
使用
System.ServiceModel.EndpointAddress构造函数创建ConvertPdfServiceClient.Endpoint.Address对象。 将指定WSDL的字符串值传递给AEM Forms服务（例如，http://localhost:8080/soap/services/ConvertPDFService?blob=mtom）。 您无需使用lc_version属性。 但是，请指定?blob=mtom。 -
通过获取
ConvertPdfServiceClient.Endpoint.Binding字段的值创建一个System.ServiceModel.BasicHttpBinding对象。 将返回值强制转换为BasicHttpBinding。 -
将
System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。 此值可确保使用MTOM。 -
通过执行以下任务启用基本HTTP身份验证：
- 将AEM表单用户名分配给字段
ConvertPdfServiceClient.ClientCredentials.UserName.UserName。 - 将相应的密码值分配给字段
ConvertPdfServiceClient.ClientCredentials.UserName.Password。 - 将常量值
HttpClientCredentialType.Basic分配给字段BasicHttpBindingSecurity.Transport.ClientCredentialType。 - 将常量值
BasicHttpSecurityMode.TransportCredentialOnly分配给字段BasicHttpBindingSecurity.Security.Mode。
- 将AEM表单用户名分配给字段
-
-
引用要转换为PostScript文件的PDF文档。
- 使用构造函数创建
BLOB对象。BLOB对象用于存储转换为PostScript文件的PDF文档。 - 通过调用其构造函数并传递一个字符串值来创建一个
System.IO.FileStream对象，该字符串值表示要转换的PDF文档的文件位置和要以何种模式打开文件。 - 创建用于存储
System.IO.FileStream对象的内容的字节数组。 您可以通过获取System.IO.FileStream对象的Length属性来确定字节数组的大小。 - 通过调用
System.IO.FileStream对象的Read方法并传递要读取的字节数组、起始位置和流长度，使用流数据填充字节数组。 - 使用字节数组的内容分配其
MTOM字段以填充BLOB对象。
- 使用构造函数创建
-
设置转换运行时选项。
- 通过调用其构造函数创建
ToPSOptionsSpec对象。 - 通过为
ToPSOptionsSpec对象的数据成员分配值来设置运行时选项。 例如，要定义创建的PostScript级别，请将PSLevel枚举值分配给ToPSOptionsSpec对象的psLevel数据成员。
- 通过调用其构造函数创建
-
将PDF文档转换为PostScript文件。
调用
GeneratePDFServiceService对象的toPS2方法并传递以下值：- 表示要转换为PostScript文件的PDF文档的
BLOB对象 - 指定运行时选项的
ToPSOptionsSpec对象
转换完成后，通过访问其
BLOB对象的MTOM属性来提取表示PostScript文档的二进制数据。 这会返回一个字节数组，您可以将该数组写出到PostScript文件中。 - 表示要转换为PostScript文件的PDF文档的
-
保存PostScript文件。
- 通过调用其构造函数创建
System.IO.FileStream对象。 传递一个表示PS文件位置的字符串值。 - 创建一个字节数组，用于存储
encryptPDFUsingPassword方法返回的BLOB对象的数据内容。 通过获取BLOB对象的MTOM字段的值填充字节数组。 - 通过调用其构造函数并传递
System.IO.FileStream对象来创建System.IO.BinaryWriter对象。 - 通过调用
System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PostScript文件。
- 通过调用其构造函数创建
另请参阅
将PDF文档转换为图像格式 converting-pdf-documents-to-image-formats
您可以使用转换PDF服务以编程方式将PDF文档转换为图像格式，包括JPEG、JPEG2000、TIFF和PNG。 通过将PDF文档转换为图像文件，可以将PDF文档用作图像文件。 例如，可以将映像放入企业内容管理系统进行存储。
将PDF文档转换为图像时，转换PDF服务会为文档中的每个页面创建单独的图像。 也就是说，如果文档有20页，则ConvertPDF服务将创建20个图像文件。 将PDF文档转换为图像格式时，您可以为PDF文档中的每个页面创建单个图像，或者为整个PDF文档创建单个图像文件。
步骤摘要 summary_of_steps-1
要将PDF文档转换为任何支持的类型，请执行以下步骤：
- 包括项目文件。
- 创建转换PDF服务客户端。
- 检索要转换的PDF文档。
- 设置运行时选项。
- 将PDF转换为图像。
- 从收藏集中检索图像文件。
包含项目文件
将必要的文件包含在开发项目中。 如果使用Java创建客户端应用程序，请包含必要的JAR文件。 如果您使用的是Web服务，请确保包含代理文件。
创建转换PDF客户端
您必须先创建转换PDF服务客户端，然后才能以编程方式执行转换PDF服务操作。 如果您使用的是Java API，请创建一个ConvertPdfServiceClient对象。 如果您使用的是Web服务API，请创建一个ConvertPDFServiceService对象。
检索要转换的PDF文档
检索要转换为图像的PDF文档。 无法将交互式PDF文档转换为图像。 如果尝试这样做，则会引发异常。 要将交互式PDF文档转换为图像文件，必须先拼合该PDF文档，然后才能将其转换。 (请参阅拼合PDF文档。)
设置运行时选项
设置运行时选项，如图像格式和分辨率值。 有关运行时值的信息，请参阅AEM Forms API引用中的ToImageOptionsSpec类引用。
将PDF转换为图像
创建服务客户端并设置运行时选项后，可以将PDF文档转换为图像。 将返回包含图像的收藏集对象。
从收藏集中检索图像文件
您可以从ConvertPDF服务返回的集合对象中检索图像文件。 集合中的每个元素都是可另存为图像文件(如JPG文件)的com.adobe.idp.Document实例（如果您使用的是Web服务，则是BLOB实例）。
图像文件的格式依赖于ImageConvertFormat运行时选项。 也就是说，如果将ImageConvertFormat运行时选项设置为ImageConvertFormat.JPEG，则可以将图像文件另存为JPG文件。
另请参阅
使用Java API将PDF文档转换为图像文件 convert-a-pdf-document-to-image-files-using-the-java-api
使用转换PDF服务API (Java)将PDF文档转换为图像格式：
-
包括项目文件。
在您的Java项目的类路径中包含客户端JAR文件，例如adobe-convertpdf-client.jar。
-
创建转换PDF客户端。
- 创建包含连接属性的
ServiceClientFactory对象。 - 使用对象的构造函数创建
ConvertPdfServiceClient对象并传递ServiceClientFactory对象。
- 创建包含连接属性的
-
检索要转换的PDF文档。
- 创建一个
java.io.FileInputStream对象，该对象表示要使用其构造函数转换的PDF文档，并传递一个指定PDF文档位置的字符串值。 - 使用对象的构造函数创建
com.adobe.idp.Document对象并传递java.io.FileInputStream对象。
- 创建一个
-
设置运行时选项。
- 使用构造函数创建
ToImageOptionsSpec对象。 - 根据需要调用属于此对象的方法。 例如，通过调用
setImageConvertFormat方法并传递指定格式类型的ImageConvertFormat枚举值来设置图像类型。
note note NOTE 必须设置 ImageConvertFormat枚举值。 - 使用构造函数创建
-
将PDF转换为图像。
调用
ConvertPdfServiceClient对象的toImage2方法并传递以下值：- 表示要转换的PDF文件的
com.adobe.idp.Document对象。 - 包含有关目标图像格式的各种首选项的
com.adobe.livecycle.converpdfservice.client.ToImageOptionsSpec对象。
toImage2方法返回包含图像的java.util.List对象。 集合中的每个元素都是一个com.adobe.idp.Document实例。 - 表示要转换的PDF文件的
-
从收藏集中检索图像文件。
对
java.util.List对象进行迭代，以确定图像是否存在。 每个元素都是一个com.adobe.idp.Document实例。 通过调用com.adobe.idp.Document对象的copyToFile方法并传递java.io.File对象来保存图像。
另请参阅
使用Web服务API将PDF文档转换为图像文件 convert-a-pdf-document-to-image-files-using-the-web-service-api
使用转换PDF服务API（Web服务）将PDF文档转换为图像格式：
-
包括项目文件。
创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义：
http://localhost:8080/soap/services/ConvertPDFService?WSDL&lc_version=9.0.1。note note NOTE 将 localhost替换为承载AEM Forms的服务器的IP地址。 -
创建转换PDF客户端。
-
使用默认构造函数创建
ConvertPdfServiceClient对象。 -
使用
System.ServiceModel.EndpointAddress构造函数创建ConvertPdfServiceClient.Endpoint.Address对象。 将指定WSDL的字符串值传递给AEM Forms服务（例如，http://localhost:8080/soap/services/ConvertPDFService?blob=mtom）。 您无需使用lc_version属性。 但是，请指定?blob=mtom。 -
通过获取
ConvertPdfServiceClient.Endpoint.Binding字段的值创建一个System.ServiceModel.BasicHttpBinding对象。 将返回值强制转换为BasicHttpBinding。 -
将
System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。 此值可确保使用MTOM。 -
通过执行以下任务启用基本HTTP身份验证：
- 将AEM表单用户名分配给字段
ConvertPdfServiceClient.ClientCredentials.UserName.UserName。 - 将相应的密码值分配给字段
ConvertPdfServiceClient.ClientCredentials.UserName.Password。 - 将常量值
HttpClientCredentialType.Basic分配给字段BasicHttpBindingSecurity.Transport.ClientCredentialType。 - 将常量值
BasicHttpSecurityMode.TransportCredentialOnly分配给字段BasicHttpBindingSecurity.Security.Mode。
- 将AEM表单用户名分配给字段
-
-
检索要转换的PDF文档。
- 使用构造函数创建
BLOB对象。 此BLOB对象用于存储PDF表单。 - 通过调用其构造函数创建
System.IO.FileStream对象。 传递一个字符串值，该值指定PDF表单的位置和打开文件的模式。 - 创建用于存储
System.IO.FileStream对象的内容的字节数组。 通过获取System.IO.FileStream对象的Length属性确定字节数组的大小。 - 通过调用
System.IO.FileStream对象的Read方法，使用流数据填充字节数组。 传递字节数组、起始位置和要读取的流长度。 - 使用字节数组的内容分配其
MTOM字段以填充BLOB对象。
- 使用构造函数创建
-
设置运行时选项。
- 使用构造函数创建
ToImageOptionsSpec对象。 - 根据需要调用属于此对象的方法。 例如，通过调用
setImageConvertFormat方法并传递指定格式类型的ImageConvertFormat枚举值来设置图像类型。
note note NOTE 必须设置 ImageConvertFormat枚举值。 - 使用构造函数创建
-
将PDF转换为图像。
调用
ConvertPDFServiceService对象的toImage2方法并传递以下值：- 表示要转换的文件的
BLOB对象 - 包含有关目标图像格式的各种首选项的
ToImageOptionsSpec对象
toImage2方法返回包含新创建的图像文件的MyArrayOfBLOB对象。 - 表示要转换的文件的
-
从收藏集中检索图像文件。
- 通过获取其
Count字段的值确定MyArrayOfBLOB对象中的元素数。 每个元素都是包含图像的BLOB对象。 - 循环访问
MyArrayOfBLOB对象并保存每个图像文件。
- 通过获取其
另请参阅