LCCObject::setClipPrism

Çokgen prizma kırpma bölgesi ayarlar.

Aynı düzlemdeki bir çokgen köşe kümesini yüzey normali yönünde offsetMin / offsetMax ile uzatarak bir prizma hacmi tanımlar ve sahneyi buna göre kırpar. Dışbükey ve içbükey çokgenler desteklenir; kendi kendini kesen çokgenler desteklenmez.

Kırpmayı temizlemek için undefined geçirin veya parametreyi atlayın.

Sürüm Gereksinimi

SDK v0.6.4+

Motor Desteği

Three.js

API

LCCObject::setClipPrism(param?: LccClipPrismParams): void

Parametreler

LccClipPrismParams

Parametre	Tür	Gerekli	Varsayılan	Açıklama
`vertices`	`IPoint3[]`	Evet	-	Referans düzlem çokgeninin köşeleri (dünya koordinatları, aynı düzlemde, herhangi bir sarma sırası). En az 3, en fazla 200.
`offsetMax`	`number`	Evet	-	Yüzey normali yönündeki üst ofset (negatif olabilir, `offsetMin` değerinden büyük olmalıdır).
`offsetMin`	`number`	Evet	-	Yüzey normali yönündeki alt ofset (negatif olabilir, `offsetMax` değerinden küçük olmalıdır).
`normal`	`IPoint3`	Evet	-	Normal yönü.
`clipSide`	`number`	Hayır	`1`	Kırpma modu: `1` = içi tut (dışı kırp), `-1` = dışı tut (içi kırp).

IPoint3

interface IPoint3 {
    x: number;
    y: number;
    z: number;
}

Dönüş Değeri

void

Kullanım Örneği

// Set a rectangular prism clipping region (4 coplanar vertices)
lccObject.setClipPrism({
    vertices: [
        { x: 0, y: 0, z: 0 },
        { x: 10, y: 0, z: 0 },
        { x: 10, y: 10, z: 0 },
        { x: 0, y: 10, z: 0 }
    ],
    offsetMin: -5,
    offsetMax: 5,
    normal: { x: 0, y: 0, z: 1 },
    clipSide: 1
});

// Inverse clipping: keep the exterior of the prism
lccObject.setClipPrism({
    vertices: [
        { x: 0, y: 0, z: 0 },
        { x: 10, y: 0, z: 0 },
        { x: 10, y: 10, z: 0 },
        { x: 0, y: 10, z: 0 }
    ],
    offsetMin: -5,
    offsetMax: 5,
    normal: { x: 0, y: 0, z: 1 },
    clipSide: -1
});

// Clear clipping
lccObject.setClipPrism();

Notlar

Köşeler aynı düzlemde olmalıdır (tolerans: 0.01 dünya koordinat birimi). Aynı düzlemde olmayan köşeler, çağrının hata günlüğüyle başarısız olmasına neden olur.
Köşe sayısı 3 ile 200 arasında olmalıdır. Bu aralığın dışındaki değerler çağrının başarısız olmasına neden olur.
offsetMax değeri kesinlikle offsetMin değerinden büyük olmalıdır; aksi hâlde çağrı başarısız olur.
offsetMin / offsetMax / clipSide ayarı hafif bir işlemdir ve yüksek sıklıkta çağrılabilir.
Çokgen köşelerini değiştirmek dahili bir doku güncellemesini tetikler; bu nedenle köşelerin sık güncellenmesi önerilmez.
Kendi kendini kesen çokgenler desteklenmez; bunların kullanılması öngörülemeyen kırpma sonuçları üretir.

LCCObject::setClipBox() — Eksenlere hizalı sınırlayıcı kutu kırpma
LCCObject::setClipPlane() — Düzlem kırpma

Bu bölüm XGRIDS'in resmî kullanım kılavuzundan Türkçeye çevrildi; ekran görüntüleri ve arayüz adları özgün haliyle İngilizcedir. İngilizce aslı (yeni sekmede açılır) · Güncelleme: 02.11.2026