インタフェース: CustomControlsOptions

3ds Max 2017 の新機能 : このコアインタフェースは、Qt アイコンやテキストクリッピングなどのカスタムコントロールをデバッグする場合に使用できます。

プロパティ:

CustomControlsOptions.PrintIconPaths : bool : Read|Write

アイコンパスの出力機能の状態を取得/設定します。

True に設定されている場合に、アイコンを含むカスタムコントロールの上でマウスホイールを回転させると、そのパスに関する情報が MAXScript リスナーに出力されます。

False (既定値)に設定すると、アイコンパスの情報は出力されません。

例:

CustomControlsOptions.PrintIconPaths = true --enable the printing of icon paths
true

--Roll over the Render icon in the Main Toolbar.
Path of this control's QIcon: [C:\Program Files\Autodesk\3ds Max 2017\UI_LN\IconsDark.rcc] MainToolbar\RenderProduction
IconSize: 24x24 (native) IconState: off
Available Files: RenderProduction_24.png, RenderProduction_30.png, RenderProduction_36.png, RenderProduction_48.png

--Then roll over the “Box” button in the Create tab of the Modifier Panel which does not have an icon.
Icon does not exist (no icon on this CustButton)

CustomControlsOptions.PrintTextClippingIssues : bool : Read|Write

文字クリッピング問題の出力機能の状態を取得/設定します。

True に設定すると、X 軸または Y 軸方向のコントロールサイズを超える文字を含むカスタムコントロールが MAXScript リスナーに報告されます。

False (既定値)に設定すると、問題は報告されません。

CustomControlsOptions.TextClippingIssuesSensitivityX : integer : Read|Write

文字クリッピング問題の出力機能の X 感度値を取得/設定します。

この値は、X 軸方向のクリッピングの問題が報告される上限しきい値を定義します。

既定値は 1 です。

CustomControlsOptions.TextClippingIssuesSensitivityY : integer : Read|Write

文字クリッピング問題の出力機能の Y 感度値を取得/設定します。

この値は、Y 軸方向のクリッピングの問題が報告される上限しきい値を定義します。

既定値は 1 です。

例:

CustomControlsOptions.PrintTextClippingIssues = true --enable the clipping issues printing
true
--Then open Material Editor and expand the Maps rollout of any Standard Material:
UI CLIPPING ERROR: hwnd: 0x60DAE - Static text clipped: 'Map Type' (22 px missing in x )
UI CLIPPING ERROR: hwnd: 0x50E8E - Checkbox text clipped: 'Ambient Color . . . . . . . . . . . . . . . . .' (98 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60CEE - Checkbox text clipped: 'Diffuse Color . . . . . . . . . . . . . . . . .' (93 px missing in x )
UI CLIPPING ERROR: hwnd: 0x50E4E - Checkbox text clipped: 'Specular Color  . . . . . . . . . . . . . . . .' (96 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60C80 - Checkbox text clipped: 'Specular Level  . . . . . . . . . . . . . . . .' (96 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60D5A - Checkbox text clipped: 'Glossiness  . . . . . . . . . . . . . . . . . .' (90 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60D40 - Checkbox text clipped: 'Self-Illumination . . . . . . . . . . . . . . .' (93 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60D38 - Checkbox text clipped: 'Opacity . . . . . . . . . . . . . . . . . . . .' (89 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60CE8 - Checkbox text clipped: 'Filter Color  . . . . . . . . . . . . . . . . .' (86 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60D60 - Checkbox text clipped: 'Bump  . . . . . . . . . . . . . . . . . . . . .' (88 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60D1E - Checkbox text clipped: 'Reflection  . . . . . . . . . . . . . . . . . .' (89 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60D82 - Checkbox text clipped: 'Refraction  . . . . . . . . . . . . . . . . . .' (91 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60CD6 - Checkbox text clipped: 'Displacement  . . . . . . . . . . . . . . . . .' (97 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60D16 - Checkbox text clipped: '. . . . . . . . . . . . . . . . . . . . . . . .' (77 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60CDA - Checkbox text clipped: '. . . . . . . . . . . . . . . . . . . . . . . .' (77 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60CD2 - Checkbox text clipped: '. . . . . . . . . . . . . . . . . . . . . . . .' (77 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60CBA - Checkbox text clipped: '. . . . . . . . . . . . . . . . . . . . . . . .' (77 px missing in x )

CustomControlsOptions.TextClippingIssuesSensitivityX  = 90 --set the threshold to 90 px
90
--Collapse and expand the Maps rollout of a Standard Material again –
--only controls whose text is clipped above 90 pixels will be reported:
UI CLIPPING ERROR: hwnd: 0x50E8E - Checkbox text clipped: 'Ambient Color . . . . . . . . . . . . . . . . .' (98 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60CEE - Checkbox text clipped: 'Diffuse Color . . . . . . . . . . . . . . . . .' (93 px missing in x )
UI CLIPPING ERROR: hwnd: 0x50E4E - Checkbox text clipped: 'Specular Color  . . . . . . . . . . . . . . . .' (96 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60C80 - Checkbox text clipped: 'Specular Level  . . . . . . . . . . . . . . . .' (96 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60D40 - Checkbox text clipped: 'Self-Illumination . . . . . . . . . . . . . . .' (93 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60D82 - Checkbox text clipped: 'Refraction  . . . . . . . . . . . . . . . . . .' (91 px missing in x )
UI CLIPPING ERROR: hwnd: 0x60CD6 - Checkbox text clipped: 'Displacement  . . . . . . . . . . . . . . . . .' (97 px missing in x )

CustomControlsOptions.UIUserScaleFactor : float : Read|Write

ユーザインタフェースのユーザ定義スケール係数を取得/設定します。

既定値は 0.0 です(カスタムスケールなし、1.0 と同等)。

値が 1.0 の場合はスケールを実行しません。

値が 2.0 の場合は、すべてのカスタムコントロールが 2 倍の大きさになります(以下、同様)。

メソッド:

<void>CustomControlsOptions.SetPrintIconPathsPersist <bool>print_paths <bool>persist

アイコンパスの出力機能の状態および持続性を設定します。

1 番目の引数は状態を設定します。True の場合はアイコンパスを出力し、False の場合は出力を無効にします。

2 番目の引数は持続性を設定します。True の場合は 3ds Max セッション間で持続され、False の場合は現在のセッションに対してのみ設定されます。

<void>CustomControlsOptions.SetPrintTextClippingIssuesPersist <bool>print_issues <bool>persist

文字クリッピング問題の出力機能の状態および持続性を設定します。

1 番目の引数は状態を設定します。True の場合は問題を出力し、False の場合は出力を無効にします。

2 番目の引数は持続性を設定します。True の場合は 3ds Max セッション間で持続され、False の場合は現在のセッションに対してのみ設定されます。

<void>CustomControlsOptions.SetTextClippingIssuesSensitivityXPersist <integer>sensitivity <bool>persist

文字クリッピング問題の出力の X 感度しきい値およびその持続性を設定します。

1 番目の引数は、感度の値を定義します。

2 番目の引数は持続性を設定します。True の場合は 3ds Max セッション間で値が持続され、False の場合は現在のセッションに対してのみ設定されます。

<void>CustomControlsOptions.SetTextClippingIssuesSensitivityYPersist <integer>sensitivity <bool>persist

文字クリッピング問題の出力の Y 感度しきい値およびその持続性を設定します。

1 番目の引数は、感度の値を定義します。

2 番目の引数は持続性を設定します。True の場合は 3ds Max セッション間で値が持続し、False の場合は現在のセッションに対してのみ設定されます。

アクション:

関連関数:

<bitMap>getIconAsBitmap <string>iconPath

指定されたアイコンを含む MAXScript ビットマップ値を返します。

<Point2 Array>getIconSizes <string>iconPath

使用可能なアイコンサイズを表す Point2 値の配列を返します。

<Point2>getQtTextExtent <string>UItext

指定された文字列の Qt 文字サイズをピクセルで表す Point2 値を返します。

カスタム UI スケール係数は考慮されません。

<float>GetUIScaleFactor <int>monitorID

指定したモニタの高 DPI モニタ用スケール係数を取得します。指定しない場合は、既定のモニタ(-1)が照会されます。

UI スケールの取得および設定については、CustomControlsOptions.UIUserScaleFactor インタフェースプロパティも参照してください。

例:

b = getIconAsBitmap @"MainToolbar\RenderSetup" --get the Render Setup icon as bitmap
display b --display the bitmap

getIconSizes @"MainToolbar\RenderSetup" --get the Render Setup icon as bitmap
#([24,24], [30,30], [36,36], [48,48])

getQtTextExtent "MAXScript"
[48,13]