Foxit PDF SDK

Public 类型 | Public 成员函数 | 所有成员列表
foxit.pdf.OutputPreview类 参考

此类可用于进行输出预览。输出预览是预览分色和测试不同色彩配置文件。 在使用此类之前，请确保函数 common.Library.SetDefaultICCProfilesPath 已被成功调用； 否则在使用此类进行输出预览时可能会出现意外错误或结果。 目前，此功能在Linux ARM和Mac ARM平台上不受支持。 更多...

类 foxit.pdf.OutputPreview 继承关系图:

## Public 类型
enum | ColorantType { ColorantType.e_ColorantTypeProcess = 0, ColorantType.e_ColorantTypeSpot = 1 }
| 着色剂类型的枚举。 更多...
enum | ShowType { ShowType.e_ShowAll = 0, ShowType.e_ShowDeviceCMYK = 1, ShowType.e_ShowNotDeviceCMYK = 2, ShowType.e_ShowICCBasedCMYK = 3, ShowType.e_ShowSpotColor = 4, ShowType.e_ShowDeviceCMYKAndSpot = 5, ShowType.e_ShowNotDeviceCMYKOrSpot = 6, ShowType.e_ShowDeviceN = 7, ShowType.e_ShowCMYK = 8, ShowType.e_ShowRGB = 9, ShowType.e_ShowDeviceRGB = 10, ShowType.e_ShowICCBasedRGB = 11, ShowType.e_ShowGray = 12, ShowType.e_ShowDeviceGray = 13, ShowType.e_ShowCalGray = 14, ShowType.e_ShowCalibrated = 15, ShowType.e_ShowLab = 16, ShowType.e_ShowDevice = 17, ShowType.e_ShowImages = 18, ShowType.e_ShowSolidColor = 19, ShowType.e_ShowSmoothShades = 20, ShowType.e_ShowRegistrationColor = 21, ShowType.e_ShowText = 22, ShowType.e_ShowLineArt = 23 }
| 显示类型的枚举。 更多...

## Public 成员函数
| OutputPreview (foxit.pdf.PDFDoc pdf_doc)
| 构造函数，带参数。 更多...
| OutputPreview (OutputPreview other)
| 构造函数，通过另一个输出预览对象。 更多...
void | EnableSimulateOverprint (bool is_to_simulate_overprint)
| 设置是否启用仿真叠印的标志。 更多...
Bitmap | GeneratePreviewBitmap (PDFPage page, Matrix2D matrix, Renderer renderer)
| 为PDF页面生成输出预览位图。 更多...
StringArray | GetPlates (OutputPreview.ColorantType colorant_type)
| 获取分色版。 更多...
int | GetSpotPlateColor (string plate_name)
| 获取版的颜色值。 更多...
bool | IsChecked (string plate_name)
| 检查版是否被选中。 更多...
bool | IsEmpty ()
| 检查当前对象是否为空。 更多...
void | SetCheckStatus (string plate_name, bool to_check)
| 设置版的检查状态。 更多...
void | SetShowType (OutputPreview.ShowType show_type)
| 设置显示类型。 更多...
void | SetSimulationProfile (string icc_profile_path)
| 设置仿真ICC配置文件路径。 更多...

## 详细描述

此类可用于进行输出预览。输出预览是预览分色和测试不同色彩配置文件。 在使用此类之前，请确保函数 common.Library.SetDefaultICCProfilesPath 已被成功调用； 否则在使用此类进行输出预览时可能会出现意外错误或结果。 目前，此功能在Linux ARM和Mac ARM平台上不受支持。

## 成员枚举类型说明

## ◆ ColorantType

enum foxit.pdf.OutputPreview.ColorantType
| strong

着色剂类型的枚举。

此枚举的值应单独使用。

枚举值
e_ColorantTypeProcess | 着色剂类型：印刷色。
e_ColorantTypeSpot | 着色剂类型：专色。

## ◆ ShowType

enum foxit.pdf.OutputPreview.ShowType
| strong

显示类型的枚举。

此枚举的值应单独使用。

枚举值
e_ShowAll | 如果设置，显示全部。
e_ShowDeviceCMYK | 如果设置，仅显示DeviceCMYK。
e_ShowNotDeviceCMYK | 如果设置，仅显示非DeviceCMYK。
e_ShowICCBasedCMYK | 如果设置，仅显示ICCBased CMYK。
e_ShowSpotColor | 如果设置，仅显示专色。
e_ShowDeviceCMYKAndSpot | 如果设置，仅显示DeviceCMYK和专色。
e_ShowNotDeviceCMYKOrSpot | 如果设置，仅显示DeviceCMYK或专色。
e_ShowDeviceN | 如果设置，仅显示DeviceN。
e_ShowCMYK | 如果设置，仅显示CMYK。
e_ShowRGB | 如果设置，仅显示RGB。
e_ShowDeviceRGB | 如果设置，仅显示DeviceRGB。
e_ShowICCBasedRGB | 如果设置，仅显示ICCBased RGB。
e_ShowGray | 如果设置，仅显示灰度。
e_ShowDeviceGray | 如果设置，仅显示DeviceGray。
e_ShowCalGray | 如果设置，仅显示CalGray。
e_ShowCalibrated | 如果设置，仅显示校准色彩。
e_ShowLab | 如果设置，仅显示Lab。
e_ShowDevice | 如果设置，仅显示设备色彩。
e_ShowImages | 如果设置，仅显示图像。
e_ShowSolidColor | 如果设置，仅显示纯色。
e_ShowSmoothShades | 如果设置，仅显示平滑渐变。
e_ShowRegistrationColor | 如果设置，仅显示套版色。
e_ShowText | 如果设置，仅显示文本。
e_ShowLineArt | 如果设置，仅显示线条艺术。

## 构造及析构函数说明

## ◆ OutputPreview() [1/2]

foxit.pdf.OutputPreview.OutputPreview | ( | foxit.pdf.PDFDoc | pdf_doc | ) |
| inline

构造函数，带参数。

参数

  [in] | pdf_doc | 有效的PDF文档对象。

## ◆ OutputPreview() [2/2]

foxit.pdf.OutputPreview.OutputPreview | ( | OutputPreview | other | ) |
| inline

构造函数，通过另一个输出预览对象。

参数

  [in] | other | 另一个输出预览对象。

## 成员函数说明

## ◆ EnableSimulateOverprint()

void foxit.pdf.OutputPreview.EnableSimulateOverprint | ( | bool | is_to_simulate_overprint | ) |
| inline

设置是否启用仿真叠印的标志。

如果不调用此函数，将使用默认值 true。

参数

  [in] | is_to_simulate_overprint | true 表示仿真叠印。 false 表示不仿真叠印。

返回
  无。

## ◆ GeneratePreviewBitmap()

Bitmap foxit.pdf.OutputPreview.GeneratePreviewBitmap | ( | PDFPage | page,
|  | Matrix2D | matrix,
|  | Renderer | renderer
| ) |  |
| inline

为PDF页面生成输出预览位图。

此函数将使用输入的 renderer 中指定的标志和选项以及当前输出预览对象的设置来渲染目标PDF页面， 然后返回最终的输出预览位图。此函数中的渲染过程不会影响输入的 renderer。
请确保函数 OutputPreview.SetSimulationProfile 已被成功调用；否则此函数将抛出 foxit.common.ErrorCode.e_ErrUnsupported 。

参数

  [in] | page | 有效的PDF页面对象。此PDF页面应该已被解析。
  [in] | matrix | 用于渲染的变换矩阵，通常由函数 PDFPage.GetDisplayMatrix 返回。
  [in] | renderer | 有效的渲染器对象。

返回
  代表输出预览结果的位图。

## ◆ GetPlates()

StringArray foxit.pdf.OutputPreview.GetPlates | ( | OutputPreview.ColorantType | colorant_type | ) |
| inline

获取分色版。

如果要获取印刷色着色剂类型的版，请确保函数 OutputPreview.SetSimulationProfile 已被成功调用； 否则不会检索到印刷色着色剂类型的版。

参数

  [in] | colorant_type | 着色剂类型。请参考从 foxit.pdf.OutputPreview.ColorantType.e_ColorantTypeProcess 开始的值，这应该是其中的一个值。

返回
  代表版名称的字符串数组。

## ◆ GetSpotPlateColor()

int foxit.pdf.OutputPreview.GetSpotPlateColor | ( | string | plate_name | ) |
| inline

获取版的颜色值。

此函数仅对专色着色剂类型的版有用。

参数

  [in] | plate_name | 版名称。这可以从函数 OutputPreview.GetPlates 返回的字符串数组中检索。

返回
  指定版的RGB颜色。

## ◆ IsChecked()

bool foxit.pdf.OutputPreview.IsChecked | ( | string | plate_name | ) |
| inline

检查版是否被选中。

对于新构造的输出预览对象，所有版都不被选中。

参数

  [in] | plate_name | 版名称。这可以从函数 OutputPreview.GetPlates 返回的字符串数组中检索。

返回
  true 表示该版被选中，false 表示该版未被选中。

## ◆ IsEmpty()

bool foxit.pdf.OutputPreview.IsEmpty | ( |  | ) |
| inline

检查当前对象是否为空。

当前对象为空时，表示当前对象是无用的。

返回
  true 表示当前对象为空，false 表示不为空。

## ◆ SetCheckStatus()

void foxit.pdf.OutputPreview.SetCheckStatus | ( | string | plate_name,
|  | bool | to_check
| ) |  |
| inline

设置版的检查状态。

参数

  [in] | plate_name | 版名称。这可以从函数 OutputPreview.GetPlates 返回的字符串数组中检索。
  [in] | to_check | 检查状态：true 表示检查该版，false 表示不检查该版。

返回
  无。

## ◆ SetShowType()

void foxit.pdf.OutputPreview.SetShowType | ( | OutputPreview.ShowType | show_type | ) |
| inline

设置显示类型。

如果没有为当前对象设置显示类型，在调用函数 OutputPreview.GeneratePreviewBitmap 时， 默认将使用值 foxit.pdf.OutputPreview.ShowType.e_ShowAll 。

参数

  [in] | show_type | 显示类型。请参考从 foxit.pdf.OutputPreview.ShowType.e_ShowAll 开始的值，这应该是其中的一个值。

返回
  无。

## ◆ SetSimulationProfile()

void foxit.pdf.OutputPreview.SetSimulationProfile | ( | string | icc_profile_path | ) |
| inline

设置仿真ICC配置文件路径。

如果输入ICC配置文件的色彩空间不是RGB/Gray/CMYK之一，此函数将抛出 foxit.common.ErrorCode.e_ErrUnsupported 。
在调用函数 OutputPreview.GeneratePreviewBitmap 之前，应成功调用此函数。

参数

  [in] | icc_profile_path | 用于输出预览仿真配置文件的ICC配置文件的文件路径。

返回
  无。