Scripting: Query

  • Tutorial

Tutorial

Questo capitolo presenta il sistema di Query, che ti permette di indirizzare con precisione gli oggetti correlati alle apparecchiature per manipolare e personalizzare il loro display nel gemello digitale 3D.

Il sistema Query consente di recuperare alcuni degli oggetti associati a un apparecchio in modo mirato per poi chiamare metodi per manipolare e personalizzare il loro display nel gemello digitale 3D.

Principio generale

L'attrezzatura può essere composta da diversi oggetti.

Ad esempio, un Portale può consistere in Due porte : una porta a sinistra e una porta a destra.

Grazie al sistema di Query, è possibile recuperare solo la porta di sinistra o la porta di destra, anche se entrambi sono associati allo stesso equipaggiamento del portale.

Il risultato di una Query è un oggetto JavaScript su cui possono essere chiamati diversi metodi.

Principio generale del sistema di Query applicato agli oggetti su un apparecchiatura.

Recupera gli oggetti per tipo

È possibile filtrare gli oggetti in base al loro tipo, ad esempio modelli 3D. Per farlo, devi specificare il . seguito dal tipo da filtrare.

L'elenco dei possibili tipi è il seguente:

  • model : Qualsiasi modello 3D
  • icon : Icone (marcatori dell'equipaggiamento)
  • zone : una zona (suoli)
  • structure : una struttura (muro)
  • polyline : una riga

Script JS:

// Query des objets de type Modèle 3D
equipment.Query(".model");

Risultato:

Questa Query restituisce tutti gli oggetti del Modello 3D associati all'apparecchiatura.

Recupera gli oggetti per nome

È anche possibile recuperare oggetti dai loro nomi. Per farlo, devi specificare il # seguito dal nome dell'oggetto che stai cercando.

La configurazione del nome di un oggetto viene fatta direttamente da Forge. Quando selezioni un oggetto, puoi associarlo al nome che vuoi. Ecco Camion.

Script JS:

// Query des objets portant l’ID "Camion"
equipment.Query("#Camion");

Risultato:

Questa Query restituisce tutti gli oggetti con il nome Left.

Combina più regole in una Query

Il sistema di Query permette di combinare diversi criteri per affinare la selezione degli oggetti.

Operatore AND (ET)

Per creare una Query che debba soddisfare tutti i parametri, devi separare i criteri con uno spazio.

Script JS:

// Query des objets de type Modèle 3D et portant l’ID "Gauche"
equipment.Query(".model #Gauche");

Risultato:

Questa Query restituisce il modello 3D con il nome Left.

Operatore OR (OR)

Per creare una Query che debba soddisfare almeno uno dei parametri, devi separare i criteri con una virgola.

Script JS:

// Query des objets portant l’ID "Gauche" ou l’ID "Droite"
equipment.Query("#Gauche, #Droite");

Risultato:

Questa Query restituisce oggetti con il nome Sinistra o Destra.

Sviluppatori