リファレンス / 3ds Max / Pencil+ 4 リファレンス

Pencil+ 4 Material リファレンス

更新: 2026年9月17日

• 3ds Max
• MaxScript
• Pencil+ 4

3ds Max 2022 / Pencil+ 4 マテリアル プロパティ・メソッド一覧
プロパティなどをInspectして少し加筆しました。

1. Pencil__4_Material（material）

Pencil+ 4 マテリアル本体。オブジェクトに割り当てるトップレベルマテリアル。

クラス名の注意
MaxScript上のクラス名は Pencil__4_Material（アンダースコア 2つ）。
「Pencil+ 4 Material」の + と空白がそれぞれ _ に変換されるため。

classOf $.material  -- => Pencil__4_Material

プロパティ

.basicMaterialについて

大まかな設定はbasicMaterial依存のようです。

Standard Legacyの設定を両面にすればPencil側も両面表示（両面が外れていると裏面はアルファになってしまいます。）

不透明度が0なら不透明度も0などなど

またPencilラインのエフェクトをかけている場合、マテリアル側の不透明度が0やモディファイア側でレンダリング表示をオフにしたシェイプなどオブジェクトのレンダリングはPencilラインだけ出たりします。

ハイライト設定

バンプ・反射

ストロークアニメーション

インターフェイス: Pcl4StaticInterface

2. Zone（ReferenceTarget / Pencil_4_Zone）

ゾーン設定。material.zones[i] で取得。デフォルトで4ゾーン。

ゾーンの制約

プロパティ

デフォルトゾーン構成

ゾーンの動的操作

Pencil_4_Zone() コンストラクタで新規ゾーンを作成し、.zones 配列に対して追加・削除ができる。

ゾーンの追加

-- 空のゾーンを新規作成
local newZone = Pencil_4_Zone()
newZone.posMin = 100.0
newZone.posMax = 100.0
newZone.color = color 0 0 0
newZone.colorMap = undefined
newZone.id = 5

-- マテリアルのゾーン配列の末尾に追加（copyで独立コピーとして追加）
append pencilMat.zones (copy newZone)

ゾーンの削減

残したいゾーンだけを集めた配列を .zones に直接代入する。

-- ゾーンを3つに減らす（先頭3つを残す）
local newZones = #()
for i = 1 to 3 do
    append newZones pencilMat.zones[i]
pencilMat.zones = newZones

3. Advanced_Settings（material）

高度な設定。material.advancedMaterial で取得。

グラデーションオフセット

シャドウブレンド

ライトカラー

ハイライトデザイン

ゾーンアンチエイリアシング

特定ライト

特定透過

特定透過の配列操作

specificTranspMaterials と specificTranspMaterialsValue は インデックスが1:1で対応するペア配列。操作時は両方を同時に変更しないとペアが崩れる。

操作の基本方針は「残すものだけ新配列に収集 → ペアで一括代入」。同じループの同じ分岐で append するため、長さとインデックスの対応が構造的に保証される。

削除（名前にマッチするマテリアルを除去）

local adv = pencilMat.advancedMaterial
if not adv.specificTranspEnable do return false

local oldMats = adv.specificTranspMaterials
local oldVals = adv.specificTranspMaterialsValue

local newMats = #()
local newVals = #()

for k = 1 to oldMats.count do
(
    if oldMats[k] != undefined and
       matchPattern oldMats[k].name pattern:"*target_name*" then
    (
        -- 除去対象 → スキップ
        format "Removed: %\n" oldMats[k].name
    )
    else
    (
        -- 残す
        append newMats oldMats[k]
        append newVals oldVals[k]
    )
)

-- ペアで一括代入（常に同じ長さが保証される）
adv.specificTranspMaterials      = newMats
adv.specificTranspMaterialsValue = newVals

追加（マテリアルと透過値のペアを追加）

local adv = pencilMat.advancedMaterial

local mats = adv.specificTranspMaterials
local vals = adv.specificTranspMaterialsValue

-- ペアで追加
append mats someMaterial   -- 追加するマテリアル参照
append vals 100.0          -- 対応する透過値

-- ペアで一括代入
adv.specificTranspMaterials      = mats
adv.specificTranspMaterialsValue = vals

-- 特定透過を有効化（まだ無効の場合）
adv.specificTranspEnable = true

注意点

• 各要素 mats[k] はマテリアルへの参照であり、.name でマテリアル名を取得可能。
• 追加・削除いずれの場合も mats と vals を必ずペアで操作・代入すること。

TKPolygonCtrl（内部カーブ）

Advanced_Settings 内の無名プロパティ . で参照される内部カーブコントローラ。ハイライトデザインのポリゴン形状制御に使用。

4. Line_Related_Functions（material）

ライン関連機能。material.lineFunctionsMaterial で取得。

エッジ制御

ライン色置換（エッジタイプ別）

各エッジタイプに対し Enable / Color / Amount の3プロパティセット。

デフォルト: 全 Enable = false、全 Color = (0,0,0)、全 Amount = 100.0

マスキング対象

5. マテリアル階層の走査パターン

実際のプロダクションでは、Pencil+ 4 マテリアルは Shell_Material や Multi/Sub-Object マテリアルの下にネストされていることが多い。スクリプトから Pencil+ 4 マテリアルにアクセスするには、親マテリアルの種類に応じて再帰的に走査する必要がある。

対応すべき親マテリアルの種類

走査コード例

-- マテリアルを再帰的に走査して Pencil__4_Material を処理する
fn processPencilMaterials mat callback =
(
    local matClass = classOf mat
    
    if matClass == Pencil__4_Material then
    (
        -- Pencil+4マテリアルに到達 → コールバックで処理
        callback mat
    )
    else if matClass == Shell_Material then
    (
        -- Shell: レンダリング用とビューポート用の両方を走査
        if mat.originalMaterial != undefined then
            processPencilMaterials mat.originalMaterial callback
        if mat.bakedMaterial != undefined then
            processPencilMaterials mat.bakedMaterial callback
    )
    else if matClass == Multimaterial then
    (
        -- Multi/Sub: 全サブマテリアルを走査
        local idList = mat.materialIDList
        for i = 1 to idList.count do
        (
            if mat[idList[i]] != undefined then
                processPencilMaterials mat[idList[i]] callback
        )
    )
    else if matClass == doubleSided then
    (
        -- 両面: 表面と裏面を走査
        if mat.material1 != undefined then
            processPencilMaterials mat.material1 callback
        if mat.material2 != undefined then
            processPencilMaterials mat.material2 callback
    )
)

-- 使用例: 全ゾーンの色を赤に変更
processPencilMaterials $.material (fn callback pencilMat = (
    for i = 1 to pencilMat.zones.count do
        pencilMat.zones[i].color = color 255 0 0
))

注意点

• Shell_Material は .originalMaterial と .bakedMaterial の 両方 にPencilマテリアルが入っている場合がある。片方だけ処理すると表示と描画で不一致が生じる。
• Multimaterial のサブマテリアルは mat[idList[i]] でアクセスする。mat[i] だとインデックスとIDの不一致でスキップが発生する。
• これらの親マテリアルは入れ子になり得る（例: Multi/Sub → Shell → 両面 → Pencil+4）。

6. アクセスパス早見表

-- Pencil+ 4 Material を取得
mat = $.material  -- 選択オブジェクトから（直接割り当ての場合）
-- または
mat = meditmaterials[1]  -- マテリアルエディタから

-- ベースマテリアル
mat.basicMaterial               -- Standardmaterial (Legacy)
mat.basicMaterial.Diffuse       -- ディフューズ色

-- ゾーン
mat.zones.count                 -- ゾーン数（デフォルト4、最大8）
mat.zones[1].color              -- ゾーン1のカラー
mat.zones[1].posMin             -- グラデーション位置 下限
mat.zones[1].posMax             -- グラデーション位置 上限
mat.zones[1].ColorMap           -- カラーマップ

-- ゾーンの動的操作
local z = Pencil_4_Zone()       -- 新規ゾーン作成
append mat.zones (copy z)       -- ゾーン追加
mat.zones = #(mat.zones[1], mat.zones[2])  -- ゾーン2つに縮小

-- ハイライト
mat.hiColor                     -- (color 255 255 255)
mat.hiLevel                     -- 0
mat.hiGloss                     -- 10

-- バンプ・反射
mat.bumpEnable                  -- false
mat.bumpMap                     -- undefined
mat.reflecEnable                -- false
mat.reflecMap                   -- undefined

-- 高度な設定
adv = mat.advancedMaterial
adv.gradOffsetEnable            -- グラデーションオフセット
adv.sblendEnable                -- シャドウブレンド
adv.lightColEnable              -- ライトカラー
adv.specificLightsEnable        -- 特定ライト
adv.specificLights              -- ライト配列
adv.specificTranspEnable        -- 特定透過
adv.specificTranspMaterials     -- 透過マテリアル配列（ペア配列、後述）
adv.specificTranspMaterialsValue -- 透過値配列（ペア配列）

-- ライン関連機能
lf = mat.lineFunctionsMaterial
lf.isectDisable                 -- 交差線無効化
lf.replaceEnableOutline         -- アウトライン色置換
lf.replaceColorOutline          -- 置換色
lf.maskingOffObjects            -- マスキングオフ対象

-- ストローク
mat.strokeAnimationEnable       -- false
mat.strokeOnly                  -- false
mat.strokeScale                 -- 100.0

7. 注意事項

• クラス名: Pencil__4_Material（アンダースコア2つ）が正式名。Pencil+ の + と空白がそれぞれ _ に変換される。classOf での比較時に注意。
• .strokeRemoveHiddenSurfce は Pencil+ 4 側のtypo（Surface → Surfce）。スクリプトでもそのまま使用する。
• .lightColRelpaceEnable / .lightColRelpaceColor も同様にtypo（Replace → Relpace）。
• Zone.strokesEnable と Zone.Strokes はデフォルト空配列。ストロークをゾーンに割り当てると要素が増える。
• basicMaterial には Standard (Legacy) 以外のマテリアルも割り当て可能（Physical Material 等）。ダンプの Standardmaterial プロパティは basicMaterial の種類に依存する。
• ゾーンの制約: 最小1ゾーン、最大8ゾーン。先頭ゾーンの posMin は 0.0、末尾ゾーンの posMax は 100.0 で強制される。
• 特定透過のペア配列: specificTranspMaterials と specificTranspMaterialsValue はインデックス1:1対応。片方だけ操作するとペアが崩れるため、常にセットで操作すること。
• マテリアル階層: 実プロダクションでは Shell_Material / Multimaterial / doubleSided の下にネストされることが多い。再帰走査パターン（セクション5参照）の実装が必要。