Esta página descreve cada bloco Select By que você pode usar no sistema Dataprep visual para identificar elementos de cena nos quais deseja realizar operações.
Cada tipo de bloco Select By tem um conjunto diferente de critérios que você pode preencher. Quando o sistema Dataprep visual realiza cada ação no gráfico do Dataprep, presume que todas as operações definidas nessa ação devem ser aplicadas a todos os atores e ativos na cena importada. No entanto, se a ação contiver algum dos blocos Select By descritos nesta página, o sistema de Dataprep visual verificará cada um desses elementos de cena para ver se correspondem aos critérios configurados na etapa Select By. Se o elemento de cena não atender aos critérios, o sistema de Dataprep visual removerá esse elemento da lista de elementos de cena aos quais aplica operações para a ação atual. Para obter mais informações, consulte Personalização de importação do Dataprep.
Para obter mais informações sobre as operações que podem ser realizadas nos elementos de cena identificados pelo critério Select By, consulte a Referência de operação do Dataprep.
Select By Condition
Os blocos Select By Condition selecionam um elemento de cena somente se uma determinada condição for verdadeira para esse elemento.
Is Class Of
Use o bloco Is Class Of para selecionar um elemento de cena somente se sua classe corresponder ao nome da classe especificado na configuração Class após a importação para a Unreal Engine.
Esse filtro pode selecionar ativos, atores e componentes.
Clique na imagem para ampliá-la.
| Configuração | Descrição |
|---|---|
| Class | A classe à qual todos os elementos da cena devem corresponder para serem selecionados por este bloco. |
| Should Include Child Class | Determina se este bloco deve considerar que um elemento de cena corresponde com sucesso se sua classe da Unreal Engine for derivada da classe que você definiu na configuração Class.
Por exemplo, suponha que você definiu a configuração Class como Actor e um elemento de cena em questão tem a classe StaticMeshActor. Neste caso, StaticMeshActor herda da classe-base Actor. Por tanto, o bloco Is Class Of selecionará esse elemento de cena apenas se a configuração Should Include Child Class estiver habilitada. |
Jacketing/Select Hidden
Para usar esse filtro, você precisa habilitar o plugin Dataprep Geometry Operations.
Use o filtro Jacketing/Select Hidden para selecionar elementos que estão dentro de um ou vários atores que você selecionou anteriormente.
Clique na imagem para ampliá-la.
| Configuração | Descrição |
|---|---|
| Accuracy | Define a precisão da grade de voxel que o Datasmith usa para determinar quais elementos estão dentro ou fora dos limites de um ator. |
| Merge Distance | Define o tamanho máximo das lacunas nos volumes de oclusão que os testes de oclusão considerarão preenchidos. |
Select By Float
Os blocos Select By Float só selecionam elementos de cena se alguma propriedade numérica deles for Less Than, Greater Than ou Is Nearly Equal a um valor limite especificado.
Os blocos Select By Float consideram dois números como Is Nearly Equal se a diferença entre eles for menor que "0,0001".
Volume delimitador
Use o bloco Bounding Volume para selecionar um elemento de cena se ele tiver extensões no espaço 3D (e, portanto, uma caixa delimitadora) e somente se o volume total dessa caixa delimitadora corresponder à comparação especificada nas configurações.
Esse filtro pode selecionar ativos, atores e componentes.
Clique na imagem para ampliá-la.
| Configuração | Descrição |
|---|---|
| Dropdown Menu | O tipo de comparação matemática que você deseja realizar entre o volume delimitador do objeto e o volume que você especifica: Less Than, Greater Than ou Is Nearly Equal. |
| Float Value | O volume que você deseja comparar com o volume delimitador do objeto, em centímetros cúbicos. |
Por exemplo, suponha que uma malha estática tenha um volume delimitador de 100 centímetros por 100 centímetros. O volume da caixa delimitadora é 100x100, ou 10000 centímetros cúbicos. Portanto, esse bloco selecionará a malha estática se você definir como Less Than qualquer número maior que 10000, ou Greater Than qualquer número abaixo de 10000.
Select By Integer
Os blocos Select By Integer selecionam apenas elementos de cena se alguma propriedade numérica desses elementos for Less Than, Greater Than ou Is Nearly Equal a um determinado valor limite.
Triangle Count
Use o bloco Triangle Count para selecionar apenas os atores de malha estática cujo número de triângulos corresponda à comparação especificada nas configurações.
Esse filtro pode selecionar ativos, atores e componentes.
Clique na imagem para ampliá-la.
| Configuração | Descrição |
|---|---|
| Dropdown Menu | O tipo de comparação matemática que você deseja realizar entre o número de triângulos na malha e o número especificado: Less Than, Greater Than ou Is Nearly Equal. |
| Integer Value | O número com o qual você deseja comparar a contagem de triângulos do objeto. |
Por exemplo, se um ator de malha estática tiver 2.000 triângulos, o bloco selecionará esse objeto se você definir o bloco como Less Than qualquer número maior que 2.000, ou Greater Than qualquer número abaixo de 2.000.
Vertex Count
Use o bloco Vertex Count para selecionar apenas os atores de malha estática cujo número de vértices corresponda à comparação especificada nas configurações.
Esse filtro pode selecionar ativos, atores e componentes.
Clique na imagem para ampliá-la.
| Configuração | Descrição |
|---|---|
| Dropdown Menu | O tipo de comparação matemática que você deseja realizar entre o número de vértices na malha e o número especificado: Less Than, Greater Than ou Is Nearly Equal. |
| Integer Value | O número com o qual você deseja comparar a contagem de vértices do objeto. |
Por exemplo, se um ator de malha estática tiver 5.000 vértices, o bloco selecionará esse objeto se você definir o bloco como Less Than qualquer número maior que 5.000, ou Greater Than qualquer número abaixo de 5.000.
Select By String
Os blocos Select By String só selecionam elementos de cena se uma propriedade de string deles corresponder a um padrão de string especificado.
Todas as condições de string podem usar uma única string ou uma matriz de strings. Para alternar entre essas duas opções, clique no botão Switch to Single / Switch to Array. Para matrizes de strings, o filtro retornará objetos (atores, ativos e/ou componentes, dependendo das limitações do filtro) que corresponder a pelo menos um dos elementos da matriz .
Clique na imagem para ampliá-la.
Esses blocos oferecem três comparações de strings:
| Configuração | Descrição |
|---|---|
| Contains | A comparação será bem-sucedida se a string fornecida estiver contida em qualquer lugar dentro do valor da propriedade da string do elemento de cena considerado. Você não pode usar curingas nesse tipo de comparação. Os caracteres "*" e "?" são tratados ao pé da letra. |
| Matches Wildcard | A comparação será bem-sucedida se o comprimento total da string fornecida corresponder ao comprimento total da propriedade da string do elemento de cena considerado, usando os seguintes caracteres de curinga:
O padrão deve corresponder a todo o comprimento da string. Se quiser fornecer uma string parcial que pode ocorrer em qualquer ponto do valor da propriedade da string em questão, comece e termine o padrão da string com um asterisco ("*"). Por exemplo, se o valor da propriedade da string for "MyActorName", o padrão não corresponderá ao padrão "A*tor", mas "*A*tor*", sim. |
| Exact Match | A comparação só será bem-sucedida se a string fornecida for uma correspondência exata do valor da propriedade da string do elemento de cena considerado. Deve ter o mesmo comprimento e conter o mesmo conjunto de caracteres, na mesma ordem. |
Ator Label
Use o bloco Ator Label para selecionar atores na cena de pré-visualização de dados (ou seja, todos os itens mostrados no painel Outliner Preview) somente se a string especificada corresponder aos nomes atribuídos a esses atores na Visualização do Organizador.
Esse filtro só pode selecionar atores e ativos.
Clique na imagem para ampliá-la.
| Configuração | Descrição |
|---|---|
| Dropdown Menu | O tipo de comparação de string que você deseja realizar entre o rótulo do ator e a string que você fornece. Confira mais detalhes em Select By string acima. |
| Ator Label (String) Box | O padrão de string que você deseja testar no rótulo do ator. |
Valor de Metadados
Use o bloco Metadata Value para selecionar atores na cena de pré-visualização de dados, ou seja, qualquer item mostrado no painel Outliner Preview, se o Ator tiver metadados do Datasmith com a Tecla que você especificar nas configurações e o valor da chave de metadados do Datasmith corresponder ao valor da string que você fornecer nas configurações.
Esse filtro pode selecionar ativos, atores e componentes.
Clique na imagem para ampliá-la.
| Configuração | Descrição |
|---|---|
| Dropdown Menu | O tipo de comparação de string que você deseja realizar entre o valor de Metadados do Datasmith do ator e a string que você fornecer. Confira mais detalhes em Select By string acima. |
| Metadata (String) Box | O padrão de string que você deseja testar em relação ao valor de metadados do Datasmith do ator. |
| Key Box | O nome da chave que você deseja procurar nos metadados do Datasmith do ator. |
Por exemplo, suponha que você tenha um ator atribuído ao seguinte conjunto de metadados do Datasmith após a importação:
Clique na imagem para ampliá-la.
Se você definir o valor de Key como Category, poderá selecionar esse ator escolhendo a operação Contains e definindo o padrão de string na terceira coluna como "Floor" ou "Floors".
Para saber mais sobre os metadados do Datasmith, consulte Como usar metadados do Datasmith .
Nome do objeto
Use o bloco Objeto Name para selecionar ativos, ou seja, malhas estáticas, texturas, materiais e animações listados no painel Content Browser Preview, somente se a string especificada corresponder aos nomes atribuídos a esses ativos na Pré-visualização do Navegador de Conteúdo.
Esse filtro pode selecionar ativos, atores e componentes.
Clique na imagem para ampliá-la.
| Configuração | Descrição |
|---|---|
| Dropdown Menu | O tipo de comparação de strings que você deseja realizar entre o nome do elemento de cena e a string fornecida. Confira mais detalhes em Select By string acima. |
| Object Name (String) Box | O padrão de string que você deseja testar em relação ao nome do objeto. |
Camada de ator
Use o bloco Ator Layer para selecionar atores na cena de pré-visualização de dados, ou seja, itens exibidos no painel Outliner Preview, se o ator estiver na camada especificada.
Esse filtro só pode selecionar atores.
Clique na imagem para ampliá-la.
| Configuração | Descrição |
|---|---|
| Dropdown Menu | O tipo de comparação de string que você deseja realizar entre a camada do ator e a string que você fornece. Confira mais detalhes em Select By string acima. |
| Ator Label (String) Box | O padrão de string que você deseja testar na camada do ator. |
Valor de tag
Use o bloco Tag Value para selecionar um elemento de cena apenas se ele tiver a tag de ator especificada na configuração Tag.
Esse filtro pode selecionar ativos, atores e componentes.
Clique na imagem para ampliá-la.
| Configuração | Descrição |
|---|---|
| Dropdown Menu | O tipo de comparação de string que você deseja realizar entre o rótulo do ator e a string que você forneceu. Confira mais detalhes em Select By string acima. |
| Tag (String) Box | O nome da tag que você deseja procurar. |
Por exemplo, se o ator for importado com o seguinte conjunto de tags:
Clique na imagem para ampliá-la.
Você pode selecionar esse ator no bloco Actor Tag definindo o valor da configuração Key como "Max.superclassof": GeometryClass", "Max.classof: EditablePolyMesh", "Max.handle: 407", ou qualquer outro valor mostrado na lista acima.
Para obter mais informações sobre tags de ator importadas pelo Datasmith, consulte Sobre o processo de importação do Datasmith .