PDF转PNG工具使用指南

注意：在学习使用不同函数之前，建议先阅读请求描述，了解基本的PDF处理流程。使用不同函数时，可以在上传文件时设置各自特殊的参数。其他基本步骤一致。

PDF 转 PNG：

java

{
  "pageRanges": "1,2,3-5",
  "imageColorMode": "e_Color",
  "imageScaling": "1.0"
}

所需参数

pageRanges：指定页码转换，从1开始。默认空。

imageColorMode：指定图像文件的图像颜色模式。e_Color：彩色模式; e_Gray：灰度模式; e_Binary：黑白模式。默认 e_Color。

imageScaling：指定图像文件的图像缩放比例。默认 1.0。

设置图片色彩模式

在 ComPDFKit Conversion SDK 中，支持的图片色彩模式包括：

Color：彩色模式，图片效果与原始 PDF 页面效果一致。

Gray：灰度模式，灰度图效果。

Binary：黑白模式，在原始效果的基础上进行二值化之后的效果。

设置图片缩放比例

在 ComPDFKit Conversion SDK 中，支持设置图片缩放比例，默认图片缩放比例为1.0，即保持原始 PDF 页面尺寸。如果您希望将图像放大一倍则可以将 ImageScaling 设置为2.0，同理如果您希望将图像缩小一倍可以将 ImageScaling 设置为0.5。

请求示例：

您需要将 apiKey 替换为您从控制台获取的 publicKey，将 file 替换为您要转换的文件，language 替换为您想要的接口错误提示语言类型。

curljava

curl

curl --location --request POST 'https://api-server.compdf.com/server/v2/process/pdf/png' \
--header 'x-api-key: apiKey' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--header 'Content-Type: multipart/form-data' \
--form 'file=@"file"' \
--form 'password="" \
--form 'parameter="{  \"pageRanges\": \"1,2,3-5\",  \"imageColorMode\": \"e_Color\", \"imageScaling\": \"1.0\"}"' \
--form 'language="1"'

java

import java.io.*;
import okhttp3.*;
public class main {
  public static void main(String []args) throws IOException{
    OkHttpClient client = new OkHttpClient().newBuilder()
      .build();
    MediaType mediaType = MediaType.parse("text/plain");
    RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
      .addFormDataPart("file","{{file}}",
 RequestBody.create(MediaType.parse("application/octet-stream"),
                                          new File("<file>")))
      .addFormDataPart("language","{{language}}")
      .addFormDataPart("password","")
      .addFormDataPart("parameter","{  \"imageScaling\": \"1.0\"}")
            .build();
    Request request = new Request.Builder()
      .url("https://api-server.compdf.com/server/v2/process/pdf/png")
      .method("POST", body)
      .addHeader("x-api-key", "{{apiKey}}")
      .build();
    Response response = client.newCall(request).execute();
  }
}

响应信息：

请求的成功响应返回 HTTP 200 OK 状态代码以及显示订单详细信息的 JSON 响应主体。

响应模式：application/json

响应参数	数据类型	描述
code	String	HTTP请求状态，"200"代表成功
message	String	请求信息
data	Object	返回结果
+taskId	String	任务ID
+taskFileNum	int	任务处理文件数量
+taskSuccessNum	int	任务处理文件成功数量
+taskFailNum	int	任务处理文件失败数量
+taskStatus	String	任务状态
+assetTypeId	int	使用资产类型ID
+taskCost	int	任务费用
+taskTime	int	任务持续时间
+sourceType	String	原格式
+targetType	String	目标格式
+fileInfoDTOList	Array	任务文件信息
++fileKey	String	文件key
++taskId	String	任务ID
++fileName	String	原文件名
++downFileName	String	下载文件名
++fileUrl	String	原文件地址
++downloadUrl	String	处理结果文件下载地址
++sourceType	String	原格式
++targetType	String	目标格式
++fileSize	int	文件大小
++convertSize	int	处理结果文件大小
++convertTime	int	处理消耗时间
++status	String	文件处理状态
++failureCode	String	文件处理失败错误码
++failureReason	String	文件处理失败说明
++fileParameter	String	处理参数

响应示例：

json

"code": "200",
"msg": "success",
"data": {
    "taskId": "f416dbcf-0c10-4f93-ab9e-a835c1f5dba1",
    "taskFileNum": 1,
    "taskSuccessNum": 1,
    "taskFailNum": 0,
    "taskStatus": "<taskStatus>",
    "assetTypeId": 0,
    "taskCost": 1,
    "taskTime": 1,
    "sourceType": "<sourceType>",
    "targetType": "<targetType>",
    "fileInfoDTOList": [
      {
        "fileKey": "<fileKey>",
        "taskId": "<taskId>",
        "fileName": "<fileName>",
        "downFileName": "<downFileName>",
        "fileUrl": "<fileUrl>",
        "downloadUrl": "<downloadUrl>",
        "sourceType": "<sourceType>",
        "targetType": "<targetType>",
        "fileSize": 24475,
        "convertSize": 6922,
        "convertTime": 8,
        "status": "<status>",
        "failureCode": "",
        "failureReason": "",
        "fileParameter": "<fileParameter>"
      }
    ]
}

结果：

文件类型	说明
.zip	传输过程完成后的图像文件 zip

异步请求

如果您需要使用文件异步处理流程，请阅读异步请求说明。

PDF转PNG工具使用指南 ​

PDF转PNG工具使用指南