TBarCode Library 11  TBarCode Library 11

◆ BCSetBarWidthReduction()

ERRCODE TECIT_STDCALL BCSetBarWidthReduction ( t_BarCode pBarCode,
DOUBLE  dValue,
e_MUnit  eUnit 
)

Sets bar-width reduction (Pixel-Shaving) in given unit.

Specifies the reduction of the bar-widths. The width of a bar in the barcode is reduced by the given value in the given unit. This property is useful when you have to deal with dot gain in the printing process. Example: On inkjet printers the bars appear wider than specified because the ink spreads a little bit. Same with (high) toner saturation on laser printers. You can compensate this effect by setting a bar-width reduction (also called BWR or "Pixel Shaving") to a suitable value. You have to make tests to find optimal settings because the dot gain depends on the printing method and printing surface (paper). The printed module-width is equal to the theoretically optimal module-width reduced by the reduction value.

Note
With a 2D matrix code, the BWR is applied horizontally and vertically to the modules (or matrix points). A single point or chain of points is reduced by 50% of the BWR on each side. By default connected modules (dots) are only reduced in their outer boundaries. With the 'DRAW_BarWidthReduction_Legacy' option you can specify how connected modules should be treated.
See also
BCGetBarWidthReduction(), BCGetBarWidthReductionUnit(), BCSetOptions()
Parameters
[in]pBarCodePointer to barcode structure.
[in]dValueReduction in given unit (0 ... reset to default ==> no reduction).
[in]eUnitReduction unit (valid values are: eMUMM, eMUMils, eMUInch, and eMUPercent).
Return values
ERRCODEErrOk (0) in case of success. Non-zero if error occurred.

© 2022 All rights reserved by TEC-IT Datenverarbeitung GmbH
Generated on Wed May 18 2022 11:16:25 for TBarCode Library 11 with doxygen 1.8.17