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] | pBarCode | Pointer to barcode structure. |
| [in] | dValue | Reduction in given unit (0 ... reset to default ==> no reduction). |
| [in] | eUnit | Reduction unit (valid values are: eMUMM, eMUMils, eMUInch, and eMUPercent). |
- Return values:
-
| ERRCODE | ErrOk (0) in case of success. Non-zero if error occurred. |
