A halftone representing an error diffusion screen. Allows the production of results containing a variable number of gray levels per channel using a range of error diffusion screens. More...

#include <jawsmako/renderspec.h>

Inheritance diagram for JawsMako::CEDSHalftone:

[legend]

Public Member Functions
	CEDSHalftone ()
Public Member Functions inherited from JawsMako::IHalftone
virtual	~IHalftone ()=default

Public Attributes
uint8	dropSizes
	The number of distinct drop sizes to produce (not including white). Please refer to the class description for details.
uint8	rows
	The number of rows in the error weighting matrix - 5 maximum.
uint8	columns
	The number of columns in the error weighting matrix - 4 maximum.
uint8	pixelColumn
	The pixel column.
uint32	denominator
	The denominator parameter, set to the sum of the weights.
uint8	weights [20]
	The weight matrix; maximum of 20 entries (5 x 4)
bool	useSerpentine
	If true, the algorithm reverses scanning direction with each alternate scanline to reduce pattern artifacts.
float	perturbation
	The weight of random perturbation to apply to each pre-screened pixel which may reduce pattern artifacts.

Detailed Description

A halftone representing an error diffusion screen. Allows the production of results containing a variable number of gray levels per channel using a range of error diffusion screens.

May be used for both monochrome and color rendering with renderScreened() and renderScreenedToFrameBuffers().

The dropSizes parameter defines the number of gray levels that will be produced:

1 specifies a monochrome result
2 specifies two different drop sizes, producing no ink, 50% ink, and 100% ink
3 specifies three different drop sizes, producing no ink, 33% ink, 66% ink and 100% ink and so forth up to a maximum dropSizes parameter of 8.

For a dropSizes parameter of 1, the renderScreened() and renderScreenedToFrameBuffers() will produce 1bpc output. For other dropSizes, these APIs will currently produce 4bpc results which may be post-processed as desired.

The default is a simple Atkinson monochrome error diffusion screen

The EDS Workbench application (see http://documentation.globalgraphics.com) can be used to explore the possibilities and generate parameters for this class.

Constructor & Destructor Documentation

◆ CEDSHalftone()

JawsMako::CEDSHalftone::CEDSHalftone ( )

inline

Member Data Documentation

◆ columns

uint8 JawsMako::CEDSHalftone::columns

The number of columns in the error weighting matrix - 4 maximum.

◆ denominator

uint32 JawsMako::CEDSHalftone::denominator

The denominator parameter, set to the sum of the weights.

◆ dropSizes

uint8 JawsMako::CEDSHalftone::dropSizes

The number of distinct drop sizes to produce (not including white). Please refer to the class description for details.

◆ perturbation

float JawsMako::CEDSHalftone::perturbation

The weight of random perturbation to apply to each pre-screened pixel which may reduce pattern artifacts.

◆ pixelColumn

uint8 JawsMako::CEDSHalftone::pixelColumn

The pixel column.

◆ rows

uint8 JawsMako::CEDSHalftone::rows

The number of rows in the error weighting matrix - 5 maximum.

◆ useSerpentine

bool JawsMako::CEDSHalftone::useSerpentine

If true, the algorithm reverses scanning direction with each alternate scanline to reduce pattern artifacts.

◆ weights

uint8 JawsMako::CEDSHalftone::weights[20]

The weight matrix; maximum of 20 entries (5 x 4)

The documentation for this class was generated from the following file:

jawsmako/renderspec.h

Public Member Functions

Public Attributes