SettingKey — Complete Reference
evolis.SettingKey is an enum that identifies every configurable print setting.
Settings are divided by prefix:
F— Front faceB— Back faceG— Global (applies to both faces or entire job)I— Image / internal configurationW— WiseCube scanner settingsU— UI / driver-level settings
Front Face Settings
| Key | Type | Values | Description |
|---|---|---|---|
FBlackManagement | LIST | NOBLACKPOINT, ALLBLACKPOINT, TEXTINBLACK, BMPBLACK | How the K panel is used on the front |
FBlackPrinting | LIST | ON, OFF | Enable/disable front K panel |
FColorBrightness | INT | 1–20 | Front color brightness |
FColorContrast | INT | 1–20 | Front color contrast |
FDualDeposite | LIST | ON, OFF | Front dual deposit |
FHalftoning | LIST | THRESHOLD, FLOYD, DITHERING, CLUSTERED_DITHERING | Front halftoning algorithm |
FMonochromeContrast | INT | 1–20 | Front monochrome contrast |
FOverlayContrast | INT | 1–20 | Front overlay contrast |
FOverlayManagement | LIST | NOVARNISH, FULLVARNISH, BMPVARNISH | Front overlay (O panel) mode |
FOverlaySecondManagement | LIST | NOVARNISH, FULLVARNISH, BMPVARNISH | Front second overlay mode |
FPageRotate180 | LIST | ON, OFF | Rotate front image 180° |
FRwErasingSpeed | INT | 1–10 | Front RW erasing speed |
FRwErasingTemperature | INT | 1–20 | Front RW erasing temperature |
FRwManagement | LIST | WRITEONLY, FULLREWRITE, BMPREWRITE | Front RW mode |
FRwPrintingSpeed | INT | 1–10 | Front RW printing speed |
FRwPrintingTemperature | INT | 1–20 | Front RW printing temperature |
FUvBrightness | INT | 1–20 | Front UV panel brightness |
FUvContrast | INT | 1–20 | Front UV panel contrast |
FUvManagement | LIST | NOUV, BMPUV | Front UV panel mode |
FSilverManagement | LIST | NOSILVER | Front silver panel (Avansia) |
FGamma | LIST | ON, OFF | Front gamma correction |
FGammaFactor | INT | 0–100 | Front gamma factor |
Back Face Settings
| Key | Type | Values | Description |
|---|---|---|---|
BBlackManagement | LIST | NOBLACKPOINT, ALLBLACKPOINT, TEXTINBLACK, BMPBLACK | How the K panel is used on the back |
BBlackPrinting | LIST | ON, OFF | Enable/disable back K panel |
BColorBrightness | INT | 1–20 | Back color brightness |
BColorContrast | INT | 1–20 | Back color contrast |
BDualDeposite | LIST | ON, OFF | Back dual deposit |
BHalftoning | LIST | THRESHOLD, FLOYD, DITHERING, CLUSTERED_DITHERING | Back halftoning algorithm |
BMonochromeContrast | INT | 1–20 | Back monochrome contrast |
BOverlayContrast | INT | 1–20 | Back overlay contrast |
BOverlayManagement | LIST | NOVARNISH, FULLVARNISH, BMPVARNISH | Back overlay mode |
BOverlaySecondManagement | LIST | NOVARNISH, FULLVARNISH, BMPVARNISH | Back second overlay mode |
BPageRotate180 | LIST | ON, OFF | Rotate back image 180° |
BRwErasingSpeed | INT | 1–10 | Back RW erasing speed |
BRwErasingTemperature | INT | 1–20 | Back RW erasing temperature |
BRwManagement | LIST | WRITEONLY, FULLREWRITE, BMPREWRITE | Back RW mode |
BRwPrintingSpeed | INT | 1–10 | Back RW printing speed |
BRwPrintingTemperature | INT | 1–20 | Back RW printing temperature |
BUvBrightness | INT | 1–20 | Back UV brightness |
BUvContrast | INT | 1–20 | Back UV contrast |
BUvManagement | LIST | NOUV, BMPUV | Back UV mode |
BSilverManagement | LIST | NOSILVER | Back silver panel (Avansia) |
BGamma | LIST | ON, OFF | Back gamma correction |
BGammaFactor | INT | 0–100 | Back gamma factor |
Global Settings
| Key | Type | Values | Description |
|---|---|---|---|
GCardPreloading | LIST | ON, OFF | Card pre-loading |
GDigitalScrambling | LIST | ON, OFF | Digital scrambling |
GDuplexType | LIST | DUPLEX_CC, DUPLEX_CM, DUPLEX_MC, DUPLEX_MM | Duplex flip type |
GFeederCfg | LIST | PRINTER, AUTO, FEEDERA…FEEDERD, ALTERNATE, FEEDER1…FEEDER4, NONE | Feeder selection |
GFeederPos | LIST | PRINTER, FEEDERA…FEEDERD, MIDDLE, OFF | Feeder position |
GHighQualityMode | LIST | ON, OFF | High quality print mode |
GInputTray | LIST | PRINTER, FEEDER, AUTO, MANUAL, HOPPER, BEZEL | Input card source |
GMagCoercivity | LIST | OFF, LOCO, HICO | Magnetic encoding coercivity |
GMagT1Encoding | LIST | ISO1, ISO2, ISO3, SIPASS, C2, JIS2, C4, NONE | Track 1 encoding format |
GMagT2Encoding | LIST | same | Track 2 encoding format |
GMagT3Encoding | LIST | same | Track 3 encoding format |
GOutputTray | LIST | PRINTER, HOPPER, REAR, MANUAL, REJECT, BEZEL | Output destination |
GPipeDetection | LIST | OFF, DEFAULT, CUSTOM | Pipe detection mode |
GRejectBox | LIST | PRINTER, DEFAULTREJECT, HOPPER, MANUAL, REJECT, BEZEL | Error card destination |
GRibbonType | LIST | RC_YMCKI, RC_YMCK, RM_KBLACK, … (see RibbonType) | Active ribbon type |
GRwCard | LIST | MBLACK, MBLUE, CUSTOM_FRONT, CUSTOM_DUPLEX | RW card type |
GPrintingMode | LIST | D2T2, RW_2IN1 | Print technology mode |
GShortPanelManagement | LIST | AUTO, CUSTOM, OFF | Short panel handling |
GSmoothing | LIST | STDSMOOTH, ADVSMOOTH, NOSMOOTH | Image smoothing |
GUvPremium | LIST | ON, OFF | UV premium mode |
GColorProfileMode | LIST | NOPROFILE, DRIVERPROFILE, CUSTOM | Color profile mode |
GColorProfile | LIST | STDPROFILE | Active color profile |
GColorProfileRendering | LIST | PERCEPTUAL, SATURATION | Color rendering intent |
Job-Level Settings
| Key | Type | Values | Description |
|---|---|---|---|
Duplex | LIST | NONE, HORIZONTAL | Enable duplex printing |
Orientation | LIST | LANDSCAPE_CC90, PORTRAIT | Card orientation |
PaperSize | LIST | CR80, ISOCR80, CR120X50, CR150X50, AVANSIACR80 | Card size |
Resolution | LIST | DPI300260, DPI300, DPI600300, DPI600, DPI1200300 | Print resolution |
Image / Internal Settings
| Key | Type | Description |
|---|---|---|
IBBlackCustom / IFBlackCustom | TEXT | Custom black region definition |
IBBlackLevelValue / IFBlackLevelValue | INT 1–255 | Black level threshold |
IBDarkLevelValue / IFDarkLevelValue | INT 0–255 | Dark level value |
IBNoTransferAreas / IFNoTransferAreas | TEXT | No-transfer zone definition |
IBOverlayCustom / IFOverlayCustom | TEXT | Custom overlay region |
IBRegionPrintingMode / IFRegionPrintingMode | LIST RESIN, BLACK_COMPOSITE | Region printing mode |
IBRwCustom / IFRwCustom | TEXT | Custom RW region |
IBTextRegion / IFTextRegion | TEXT | Text region definition |
IBThresholdValue / IFThresholdValue | INT 1–255 | Image threshold value |
IBUvCustom / IFUvCustom | TEXT | Custom UV region |
IGBlackSub | TEXT | Black sub-region definition |
IGMonochromeSpeed | INT 1–10 | Monochrome printing speed |
IGRegionOrientation | LIST LANDSCAPE, PORTRAIT | Region orientation |
IGSendIQLA | LIST ON, OFF | Send IQLA data |
IGDisableAutoEject | LIST ON, OFF | Disable auto-eject |
IGColorProfileCustom | TEXT | Path to custom ICC profile |
IPostSmoothing | LIST STDSMOOTH, ADVSMOOTH, NOSMOOTH | Post-processing smoothing |
ISendBlankPanel | LIST ON, OFF | Send a blank panel |
IShortPanelShift | INT 0–9999 | Short panel shift in units |
Scanner Settings (WiseCube)
| Key | Type | Values | Description |
|---|---|---|---|
WIScanImageDepth | LIST | BPP8, BPP16, BPP24, BPP32 | Scan color depth |
WIScanImageResolution | LIST | DPI300, DPI600 | Scan resolution |
WIScanImageFileFormat | LIST | JPG, BMP, PNG | Scan image file format |
WIScanSpeed | INT | 0–40 | Scan speed |
WIScanOffset | INT | 0–40 | Scan offset |
WIScanCardSides | LIST | FRONT_BACK, FRONT_ONLY, BACK_ONLY | Sides to scan |
Usage Example
import evolis
with evolis.Connection("Evolis Primacy") as co:
ps = evolis.PrintSession(co, evolis.RibbonType.YMCKO)
# Print at 600 DPI
ps.set_setting(evolis.SettingKey.Resolution, "DPI600")
# Use bitmap-defined black (explicit K panel)
ps.set_setting(evolis.SettingKey.FBlackManagement, "BMPBLACK")
# Full varnish overlay
ps.set_setting(evolis.SettingKey.FOverlayManagement, "FULLVARNISH")
ps.set_image(evolis.CardFace.FRONT, "/path/to/color.bmp")
ps.set_black(evolis.CardFace.FRONT, "/path/to/black.bmp")
rc = ps.print()
print("Result:", rc)