com.datalogics.PDFL

Enum SmoothFlags

java.lang.Object

java.lang.Enum<SmoothFlags>

com.datalogics.PDFL.SmoothFlags

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<SmoothFlags>

public enum SmoothFlags
extends java.lang.Enum<SmoothFlags>

Enum Constant Summary

Enum Constants

Enum Constant and Description
IMAGE Draw smooth image.
IMAGE_ANTI_ALIAS_ONLY Antialias (smooth) images at low resolutions, but do not resample images when they do not match the target imaging resolution.
IMAGE_BICUBIC_RESAMPLE Resample images using bicubic resampling, but do not antialias images.
IMAGE_BICUBIC_RESAMPLE_AND_ANTI_ALIAS Enhanced image smoothing controls: Draw smooth image and resample using bicubic resampling.
IMAGE_LINEAR_RESAMPLE Resample images using linear average subsampling, but do not antialias images.
LINE_ART Draw smooth line art.
NONE Do not smooth any drawn elements
TEXT Draw smooth text.
TEXT_ANTI_ALIAS_ENABLE_DDR Enhanced text antialiasing controls: Antialias (smooth) text using the DDR sub-pixel antialiasing algorithm.
TEXT_ANTI_ALIAS_ENABLE_PREVIEW Enable special text "preview" rendering and antialiasing for better visual results when generating images at lower resolutions intended for on-screen viewing.

Method Summary

Modifier and Type	Method and Description
static SmoothFlags	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static SmoothFlags[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

NONE

public static final SmoothFlags NONE

Do not smooth any drawn elements

TEXT

public static final SmoothFlags TEXT

Draw smooth text. This will cause text to be antialiased when drawn. Recommended for lower-resolution applications such as on-screen viewing at low zoom levels. Equivalent to the Smooth Text: for Monitor option in PDF Viewer rendering preferences.

LINE_ART

public static final SmoothFlags LINE_ART

Draw smooth line art. This will cause paths (vector line art elements) to be antialiased. Recommended for lower-resolution applications such as on-screen viewing at low zoom levels.

IMAGE

public static final SmoothFlags IMAGE

Draw smooth image. This will cause raster images to be resampled to match the target imaging resolution using an averaged subsampling algorithm, and will cause images to be antialiased when drawn. Recommended for general PDF viewing applications.

IMAGE_BICUBIC_RESAMPLE_AND_ANTI_ALIAS

public static final SmoothFlags IMAGE_BICUBIC_RESAMPLE_AND_ANTI_ALIAS

Enhanced image smoothing controls: Draw smooth image and resample using bicubic resampling. This will cause raster images to be resampled to match the target imaging resolution using a bicubic subsampling algorithm, and will cause images to be antialiased when drawn. Recommended for general imaging applications. Rendering with this option takes longer than with the Image smoothing option, but generates higher quality output.

IMAGE_BICUBIC_RESAMPLE

public static final SmoothFlags IMAGE_BICUBIC_RESAMPLE

Resample images using bicubic resampling, but do not antialias images. This will cause raster images to be resampled to match the target imaging resolution using a bicubic subsampling algorithm. Recommended for conversion of PDF pages to high-resolution (>= 300dpi) images. Rendering with this option takes longer than with the ImageLinearResample smoothing option, but generates higher quality output.

IMAGE_LINEAR_RESAMPLE

public static final SmoothFlags IMAGE_LINEAR_RESAMPLE

Resample images using linear average subsampling, but do not antialias images. This will cause raster images to be resampled to match the target imaging resolution using a linear average subsampling algorithm. Recommended for conversion of PDF pages to high-resolution (>= 300dpi) images. Rendering with this option is faster than with the ImageBicubicResample smoothing option, but generates lower quality output.

IMAGE_ANTI_ALIAS_ONLY

public static final SmoothFlags IMAGE_ANTI_ALIAS_ONLY

Antialias (smooth) images at low resolutions, but do not resample images when they do not match the target imaging resolution.

This is not recommended for most callers.

TEXT_ANTI_ALIAS_ENABLE_DDR

public static final SmoothFlags TEXT_ANTI_ALIAS_ENABLE_DDR

Enhanced text antialiasing controls: Antialias (smooth) text using the DDR sub-pixel antialiasing algorithm. Equivalent to the Smooth Text: for Laptop/LCD Screen option in PDF Viewer rendering preferences. Recommended for zoom factors of 150% or more.

TEXT_ANTI_ALIAS_ENABLE_PREVIEW

public static final SmoothFlags TEXT_ANTI_ALIAS_ENABLE_PREVIEW

Enable special text "preview" rendering and antialiasing for better visual results when generating images at lower resolutions intended for on-screen viewing. This prevents text from looking badly kerned or looking to have poor inter-character spacing.

We recommend this for use for viewing applications at zoom levels of 150% or less, though you will want to experiment and decide for yourself.

Do not use this for non-viewing applications. Do not scale up or down the rendered image that is generated from drawing a page using this flag - it will look very blurry and unfocused.

Method Detail

values

public static SmoothFlags[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (SmoothFlags c : SmoothFlags.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static SmoothFlags valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null