Eklentiler, Sınıflar ve Kategoriler API’si

Python ve Node.js’de “simetrik” eklentiler, sınıflar ve kategoriler API’si. #

Uyarı: Bu, türlerin, yöntemlerinin, özelliklerinin vb. tam bir açıklaması değildir. Burada yalnızca genel kavramlar açıklanmıştır. Somut türlerin ve yöntemlerinin tam açıklaması için API Referans Kılavuzlarına bakın.

Python #

Konteyner nesneleri #

Şimdi bir VRayRenderer örneği oluşturalım :

import vray<br />
renderer = vray.VRayRenderer()

Daha sonra

`renderer.plugins`, bu renderer içindeki tüm eklenti örneklerinin bulunduğu bir kapsayıcıdır.

`renderer.classes`, bu oluşturucuya yüklenen ve dolayısıyla bu oluşturucu tarafından desteklenen tüm eklenti sınıflarının (veya türlerinin) bir kapsayıcısıdır.

`renderer.categories`, eklentilerin ait olabileceği tüm eklenti kategorilerini içeren bir kapsayıcıdır. Bu kapsayıcı diğer ikisi kadar önemli olmasa da bazı durumlarda oldukça faydalı olabilir.

`renderer.plugins` , `renderer.classes` ve `renderer.categories` , sözlük benzeri bazı özelliklere sahip özel nesnelerdir ancak sözlük değillerdir:

1. Bunlar eşleme protokolünü (sözlükler gibi) destekler – eklentilerdeki anahtarlar eklenti adlarıdır , sınıflardaki anahtarlar sınıf adlarıdır ve kategorilerdeki anahtarlar kategori adlarıdır , örneğin renderer.plugins[‘settingsColorMapping’] , renderer.classes[‘SettingsColorMapping’] , renderer.categories [ ‘ Settings’] .

2. Bunlar yinelenebilir yapıdadır , ancak yineleme, içerdikleri eklenti / sınıf / kategori nesneleri üzerinde (kümeler gibi) gerçekleştirilir , adları üzerinde (sözlükler gibi) değil .

3. Bunlar, öznitelik adına göre erişimi destekler; örneğin, `renderer.plugins.settingsColorMapping` , `renderer.plugins[‘settingsColorMapping’]` ile aynı nesneyi döndürür , `renderer.classes.SettingsColorMapping`, `renderer.classes[‘SettingsColorMapping’]` ile aynı nesneyi döndürür ve `renderer.categories.Settings`, `renderer.categories[‘Settings’]` ile aynı nesneyi döndürür .

4. `len()` fonksiyonu , içerdikleri eklenti / sınıf / kategori nesnelerinin sayısını döndürür .

Bu 3 kapsayıcı ( eklentiler , sınıflar ve kategoriler ) arasında yalnızca eklentiler silme (öğeleri kaldırma) işlemini destekler . Yineleme sırasında eklenti örneklerinin silinmesi ve oluşturulmasının desteklendiğini belirtmek önemlidir :

for plugin in renderer.plugins: # This is preferred<br />
if someCondition:<br />
# Delete the plugin in plugins. Its reference then becomes invalid and 'plugin' is removed from renderer.plugins<br />
plugin.deleteThis() # plugin.isValid() will return False after this call<br />
# Alternative way to delete plugin instances<br />
# del renderer.plugins[plugin] # use the plugin name or the plugin instance as the key<br />
if otherCondition:<br />
# Create a new plugin (with an auto-generated name) inside renderer.plugins<br />
renderer.classes.Node()

Şununla tamamen aynı şekilde çalışır:

</p>
<div class="cm-activeLine cm-line"><span class="ͼb">for</span> plugin <span class="ͼb">in</span> list(renderer.plugins): <span class="ͼm"># This is redundant and slower</span></div>
<div class="cm-line">  ...</div>
<p data-v-97f42bc7="" data-v-9f7b400c="">

veya

for plugin in vray.PluginList(source = renderer.plugins): # This is redundant and slower<br />
...

Ancak bu daha verimli olurdu. Yeni oluşturulan eklenti örnekleri döngüye dahil edilmezken, silinen eklentiler geçersiz referanslar olarak dahil edilirdi (bkz. plugin.isValid() yöntemi).

Konteyner nesneleri ayrıca yöntemler de içerebilir, örneğin

renderer.categories.getInstances((renderer.categories.GeometricObject, renderer.categories.Light))

Bu, ışık olan tüm geometrik nesneleri (veya bakış açınıza bağlı olarak, aynı zamanda geometrik nesne olan tüm ışıkları) döndürür; ancak sonuç tamamen aynıdır.

Eklenti nesneleri, sınıf nesneleri ve kategori nesneleri #

Bu üçü de benzer özellikler paylaşıyor (ancak kategori nesneleri yukarıda açıklanan kapsayıcı nesnelere daha yakındır, açıklamalarına aşağıda bakabilirsiniz).

Eklenti nesneleri #

Eklenti nesneleri, bir VRayRenderer örneği içindeki eklenti örneklerine referanslardır (veya tanıtıcılardır). Eklenti parametreleri , eklenti nesnelerinde hem öznitelikler hem de anahtarlar olarak sunulur. Bunlar her zaman değer olarak okunur ve yazılır; yani onları okuduğunuzda , içerdikleri tüm değerin bir kopyasını alırsınız (liste gibi karmaşık bir değer olsa bile) ve onlara yazdığınızda, değerlerinin bir kopyasını ilgili eklenti parametresine yerleştirirsiniz.

Eklenti nesneleri, hem eklenti parametrelerini ( nitelikleri , anahtarları veya getter / setter yöntemleri aracılığıyla) değiştirmek için kullanılan eklenti tanıtıcıları hem de diğer eklenti parametrelerine değer olarak ayarlanabilen eklenti referansları olarak işlev görür.

Eklenti nesneleri, sözlük benzeri özel tiplerdir . Bir eklenti nesnesi üzerinde yineleme, sözlüklerde olduğu gibi parametre adları üzerinde yineleme yapar . Bu davranışın, yinelemenin anahtarlar yerine içerdikleri değerler (yani eklenti , sınıf veya kategori nesneleri) üzerinde gerçekleştirildiği renderer.plugins , renderer.classes ve renderer.categories kapsayıcılarının davranışından farklı olduğunu unutmayın.

Bir eklenti nesnesi , anahtarlar ve niteliklerin yanı sıra, temel alınan eklenti örneği üzerinde çeşitli işlemler gerçekleştirmek veya onun hakkında bazı bilgileri sorgulamak için yöntemlere de sahiptir.

Eklenti nesneleri, temel eklenti örneği silindiğinde geçersiz hale gelebilir (veya silinme anında geçersiz olabilir) .

PluginRef nesneleri #

PluginRef türü , Plugin sınıfının bir uzantısıdır . Amacı, alternatif eklenti çıktılarına referans vermektir . Bazı eklentiler (örneğin dokular), diğer eklentilere girdi olarak kullanıldığında belirli bir türde (örneğin AColor ) veri üretir, ancak diğer türlerde (örneğin float , int , vb.) ek çıktılara ( çıktı parametreleri olarak adlandırılır ve .vrscene dosyalarında pluginName::outputParamName ile belirtilir) sahip olabilirler . Bir PluginRef nesnesi, bir eklenti nesnesinden ve o eklentinin alternatif bir çıktı parametresinden oluşur . PluginRef’ler , altta yatan eklentinin parametrelerini değiştirmek için kullanılabilse de, asıl amaçları diğer eklenti girdi parametrelerinin değerleri olarak kullanılmaktır .

Unutmayın ki, bir eklenti ve bir pluginRef nesnesi bir VRayRenderer içindeki aynı eklenti örneğine referans verse bile, plugin == pluginRef karşılaştırması False olacaktır . (Ancak plugin == pluginRef.getPlugin() ve plugin.getPlugin() == pluginRef.getPlugin() karşılaştırmaları True olacaktır .)

Sınıf nesneleri #

Sınıf nesneleri eklenti türlerini temsil eder. Çoğunlukla eklenti örnekleri oluşturmak ve eklenti örneği oluşturmadan eklenti ve/veya parametreleri hakkında bazı bilgileri sorgulamak için kullanılırlar.

</p>
<div># Create a plugin of type Node with the name 'myNode1' and assign a reference to it to variable node</div>
<div>node = renderer.classes.Node('myNode1')</div>
<div></div>
<div># Create a plugin of type Node with the name 'myNode2'</div>
<div>renderer.classes.Node('myNode2')</div>
<div></div>
<div># In both cases the new plugin becomes available in renderer.plugins</div>
<div>node1 = renderer.plugins.myNode1</div>
<div>node2 = renderer.plugins.myNode2</div>
<div></div>
<div># Comparisons</div>
<div>node == node1 # Compare plugin instances. This would be True</div>
<div>node == node2 # Compare plugin instances. This would be False</div>
<div>node.getClass() == node2.getClass() # Compare plugin classes. This would be True</div>
<div>node.getClass() == renderer.classes.Node # Compare plugin classes. This would be True</div>
<p data-v-97f42bc7="" data-v-9f7b400c="">

Sınıf nesneleri, temsil ettikleri eklenti türünün parametre adları üzerinde yinelenebilir (eklenti nesnelerine benzer şekilde). Şu anda, parametre adlarını kullanarak sınıf özniteliklerine veya anahtarlarına erişmek, class.getMeta(paramName) yöntemini çağırmakla aynı veriyi döndürür. Ancak bu davranışa güvenmemeli ve her zaman getMeta() yöntemini açıkça çağırmalısınız çünkü davranış gelecekte değişebilir.

Sınıf nesneleri ayrıca kendi türlerindeki eklenti nesnelerini oluşturmak veya almak ya da bunlar veya parametreleri hakkında bazı bilgileri sorgulamak için yöntemlere de sahiptir.

Kategori nesneleri #

Kategori nesneleri, benzer özelliklere sahip benzer eklenti türlerini gruplandırır. Bunlar renderer.categories içerisinde yer alır . Bir eklenti (örnek veya sınıf) hiçbirine, bir veya birden fazla eklenti kategorisine ait olabilir.

Kategori nesneleri, kendilerine ait eklenti sınıflarını gruplandırdıkları için renderer.classes kapsayıcısına daha çok benzerler .

Kategori nesneleri:

1. Eşleme protokolünü (sözlükler gibi) destekleyin – anahtarları sınıf adlarıdır , örneğin renderer.categories.GeometricObject[‘Node’] .

2. Yineleme yapılabilir ancak yineleme, sınıf adları üzerinde değil (sözlükler gibi ) içerdikleri sınıf nesneleri üzerinde (kümeler gibi) gerçekleştirilir .

3. Öznitelik adına göre erişimi destekleyin, örneğin `renderer.categories.GeometricObject.Node` , `renderer.categories.GeometricObject[‘Node’]` ile aynı nesneyi döndürür .

4. Dizinlenebilirler , bu da sıralı protokolü desteklemeye benzer. len(category) o kategoriye ait sınıf sayısını döndürür.

5. Bunlara ait eklenti nesnelerini döndüren yöntemlere ( category.getInstances() ) veya bir eklenti örneğinin veya bir sınıfın bunlara ait olup olmadığını kontrol eden yöntemlere ( category.belongs(object) ) sahip olun.

Node.js #

Konteyner nesneleri #

Şimdi bir VRayRenderer örneği oluşturalım :

const vray = require('./node/vray');<br />
let renderer = new vray.VRayRenderer;

for (let plugin of renderer.plugins) { // This is preferred<br />
if (someCondition {<br />
// Delete the plugin in plugins. Its reference then becomes invalid and 'plugin' is removed from renderer.plugins<br />
plugin.deleteThis(); // plugin.isValid() will return false after this call<br />
// Alternative way to delete plugin instances<br />
// delete renderer.plugins[plugin]; // use the plugin name or the plugin instance as the key<br />
}<br />
if (otherCondition) {<br />
// Create a new plugin (with an auto-generated name) inside renderer.plugins<br />
renderer.classes.Node();<br />
}<br />
}

for (let plugin of Array.from(renderer.plugins)) // This is redundant and slower<br />
...

</p>
<div>// Create a plugin of type Node with the name 'myNode1' and assign a reference to it to variable node</div>
<div>var node = renderer.classes.Node('myNode1')</div>
<div></div>
<div>// Create a plugin of type Node with the name 'myNode2'</div>
<div>renderer.classes.Node('myNode2')</div>
<div></div>
<div>// In both cases the new plugin becomes available in renderer.plugins</div>
<div>var node1 = renderer.plugins.myNode1</div>
<div>var node2 = renderer.plugins.myNode2</div>
<div></div>
<div>// Comparisons</div>
<div>node == node1 // Compare plugin instances. This would be true</div>
<div>node == node2 // Compare plugin instances. This would be false</div>
<div>node.getClass() == node2.getClass() // Compare plugin classes. This would be true</div>
<div>node.getClass() == renderer.classes.Node // Compare plugin classes. This would be true</div>
<p data-v-97f42bc7="" data-v-9f7b400c="">