pymel.core.windows.mayaDpiSetting¶

mayaDpiSetting(*args, **kwargs)¶

Provide Maya interface scaling based on system DPI or custom scale setting or no scaling. Please note that the change will only take effect after relaunching Maya.

Flags:

Long Name / Short Name		Argument Types	Properties
mode / m		int
	Specifies the interface scaling mode: 0 - System Dpi Based Scaling1 - Custom Scaling (Must provide the custom scale value with flag -scaleValue2 - No Scaling
realScaleValue / rsv		bool
	This is a query mode only flag which returns the real scale value depending on current scaling mode and defined scale value: mode 0 - Return the current real scale value which is the ratio of current system dpi to default system dpimode 1 - Return the current real scale value which is the product of the defined scale value and the ratio of current system dpi to default system dpimode 2 - Always return 1.0 which indicates real scale is 100% when the scaling mode is no scaling.
scaleValue / sv		float
	Specifies the custom scale of the interface if scaling mode is 1. The allowed values are [1.0, 1.25, 1.5, 2.0]. In query mode, return the scale value depend on current scaling mode: mode 0 - Always return 1.0 which indicates 100% scalingmode 1 - Return the custom scale value usedmode 2 - Always return 1.0 which indicates no custom scaling
systemDpi / sd		bool
	This is a query mode only flag which returns the current system dpi value. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.mayaDpiSetting

Example:

::

import pymel.core as pm

# Set the scale mode to system dpi based scaling. pm.mayaDpiSetting( mode=0 )

# Set the interface scaling to 150% custom scaling. pm.mayaDpiSetting( mode=1, scaleValue=1.5 )

# Disable the interface scaling. pm.mayaDpiSetting( mode=2 )

# Query the current scaling mode. pm.mayaDpiSetting( query=True, mode=True ) # Result: 0 #

# Query the current scale value. pm.mayaDpiSetting( query=True, scaleValue=True ) # Result: 1.0 #

# Query the system dpi value. pm.mayaDpiSetting( query=True, systemDpi=True ) # Result: 192 #

# Query the current real scale value. pm.mayaDpiSetting( query=True, realScaleValue=True ) # Result: 2.0 #