Lumberyard
Guía del usuario (Version 1.21)

Formas: cilindro, cápsula, cubo, esfera y compuesto

El sistema de entidades de componentes está en la versión preliminar y está sujeto a cambios.

Agregue componentes de forma a las entidades que tengan otros componentes que requieren formas.

Por ejemplo, agregue componentes de forma a sus entidades para crear volúmenes para lo siguiente:

  • Crear un volumen de activación mediante el componente Trigger Area. Las entidades que introduce el volumen activan una acción.

  • Crear un volumen de colisión mediante el componente PhysX Collider (Colisionador de PhysX). Las entidades que chocan con el volumen de colisión responden al impacto, como, por ejemplo, ralentizando o incluso rebotando.

  • Definir efectos de reverberación o eco mediante el componente Audio Environment.

  • Crear un área de audio mediante el componente Audio Trigger para que un sonido específico se reproduzca en esa área del nivel.

nota

Solo puede agregar un componente de forma a una entidad. Si necesita más de una forma en una entidad, cree entidades secundarias.

Cada componente de forma ofrece un ShapeService que expone una funcionalidad común para todas las formas. Cada forma también ofrece un servicio más específico, como son BoxShapeService o SphereShapeService.

El componente Shape (Forma) incluye las siguientes formas y propiedades:

Scaling Shapes (Escalado de formas)

Como práctica recomendada, al escalar una forma, ajuste las propiedades del componente de forma, como las siguientes: Dimensions (Dimensiones), Height (Altura) y Radius (Radio).


                Escale una Box Shape (Forma de cubo) ajustando los valores de Dimensions (Dimensiones). Escale una Cylinder Shape (Forma de cilindro) ajustando los valores correspondientes a Height (Altura) y Radius (Radio).

sugerencia

Modifique las propiedades del componente de la forma en lugar de utilizar la herramienta de escala, que cambia el componente Transform de la entidad.

ejemplo

Consulte los siguientes ejemplos para los diferentes escalados:

  1. En el escalado no uniforme, el ajuste de la escala de transformación de una entidad conduce a diferentes valores para X, Y y Z.

  2. En el escalado uniforme, X, Y y Z tienen el mismo valor.

  3. En escalado normalizado uniforme, todos los valores de la escala son 1.


                     Escalado no uniforme (1) donde X, Y y Z tienen valores diferentes. Escalado uniforme (2) donde los valores X, Y y Z son iguales (en este caso 4). Escalado normalizado uniforme (3) donde los valores X, Y y Z son todos 1.

Si se ha escalado una entidad de manera no uniforme, las pruebas de representación e intersección utilizan el componente mayor del vector de la escala. Si bien esto puede funcionar, la práctica recomendada consiste en mantener una escala de transformación uniforme e, idealmente, normalizada (1, 1, 1), tal y como se muestra en el tercer ejemplo.

Propiedades del componente Box Shape (Forma de cubo)


                Las propiedades del componente de forma de cubo en Lumberyard Editor.

El componente Box Shape (Forma de cubo) tiene las siguientes propiedades:

Nombre Descripción
Visible

El componente aparece siempre en la ventanilla, incluso aunque la entidad no se haya seleccionado.

Game View (Vista del juego)

Representa la forma de cubo en modo de juego en Lumberyard Editor.

Para entrar en el modo de juego, presione Ctrl + G.

Shape Color (Color de forma)

Especifica el color para representar la forma.

Dimensiones

Define las dimensiones de la forma a lo largo de los tres ejes en el espacio local.

Si el componente Transform aplica una escala, estas dimensiones se multiplican por el mismo valor.

Editar

Seleccione Edit (Editar) y el componente está bloqueado para edición. Para obtener más información, consulte Edición de componentes en la ventanilla.

El componente Box Shape (Forma de cubo) también tiene su propio Modo de componente con varios manipuladores lineales para cada eje.


                El componente Box Shape (Forma de cubo) en la ventanilla.

Propiedades del componente Capsule Shape (Forma de cápsula)


                 Las propiedades del componente Capsule Shape (Forma de cápsula) en Lumberyard Editor.

El componente Capsule Shape (Forma de cápsula) tiene las propiedades siguientes.

Nombre Descripción
Visible

El componente aparece siempre en la ventanilla, incluso aunque la entidad no se haya seleccionado.

Game View (Vista del juego)

Representa la forma en modo de juego.

Para entrar en el modo de juego, presione Ctrl + G.

Shape Color (Color de forma)

Especifica el color para representar la forma.

Altura

La altura de principio a fin de la cápsula, incluidos el cilindro y los dos extremos.

Si el componente Transform aplica una escala, estas dimensiones se multiplican por el mismo valor.

Radius (Radio)

El radio de la cápsula.

Si el componente Transform aplica una escala, estas dimensiones se multiplican por el mismo valor.

Propiedades del componente Compound Shape (Forma compuesta)


                Las propiedades del componente Compound Shape (Forma compuesta) en Lumberyard Editor.

Con el componente Compound Shape (Forma compuesta) puede combinar formas para crear un objeto complejo para generar un choque con propiedades físicas, una forma de desencadenador, o bien, cualquier otra aplicación de formas. Las formas individuales podrán ser o no elementos secundarios de una entidad con el componente Compound Shape (Forma compuesta).

nota

  • Para mover las formas a la vez con la forma compuesta, establézcalas como entidades secundarias.

  • Para mover las formas de manera independiente de la entidad con la forma compuesta, no las defina como entidades secundarias.

  • Para solicitudes de EBus (bus de eventos), las formas compuestas suministran activos al bus de componentes de formas completas. Sin embargo, cada forma individual que agregue aumenta el costo de las solicitudes, como por ejemplo IsPointInside.

A continuación se muestran las propiedades de Compound Shape.

Nombre Descripción
Child Shape Entities (Entidades de formas secundarias)

Especifica las entidades y sus formas que componen la forma compuesta. Estas entidades podrán ser o no elementos secundarios de una entidad con la forma compuesta.

Propiedades del componente Cylinder Shape (Forma cilíndrica)


                Las propiedades del componente Cylinder Shape (Forma del cilindro) en Lumberyard Editor.

El componente Cylinder Shape (Forma cilíndrica) tiene las propiedades siguientes.

Nombre Descripción
Visible

El componente aparece siempre en la ventanilla, incluso aunque la entidad no se haya seleccionado.

Game View (Vista del juego)

Representa la forma en el modo de juego en Lumberyard Editor.

Para entrar en el modo de juego, presione Ctrl + G.

Shape Color (Color de forma)

Especifica el color para representar la forma.

Altura

La altura del cilindro. Si el componente Transform aplica una escala, estas dimensiones se multiplican por el mismo valor.

Radius (Radio)

El radio del cilindro. Si el componente Transform aplica una escala, estas dimensiones se multiplican por el mismo valor.

Propiedades del componente Sphere Shape (Forma de esfera)


                Consulte las propiedades del componente de forma de esfera en Lumberyard Editor.

A continuación se muestran las propiedades de Sphere Shape (Forma de esfera).

Nombre Descripción
Visible

El componente aparece siempre en la ventanilla, incluso aunque la entidad no se haya seleccionado.

Game View (Vista del juego)

Representa la forma en el modo de juego en Lumberyard Editor.

Para entrar en el modo de juego, presione Ctrl + G.

Shape Color (Color de forma)

Especifica el color para representar la forma.

Radius (Radio)

El radio de la esfera.

Si el componente Transform aplica una escala, estas dimensiones se multiplican por el mismo valor.

Interfaz de EBus de solicitudes

Todos los componentes de forma proporcionan acceso a dos buses de solicitud distintos. El primer bus es ShapeComponentRequestsBus que devuelve información general sobre el componente de forma. El segundo bus es ShapeNameComponentRequestsBus que devuelve configuraciones de propiedad de la forma especificada.

Utilice las siguientes funciones de solicitud con la interfaz de bus de eventos para comunicarse con otros componentes del juego.

Para obtener más información, consulte Trabajo con el sistema de bus de eventos (EBus).

ShapeComponentRequestsBus

En la tabla siguiente se describe el ShapeComponentRequestsBus.

Nombre Descripción Parámetro Devolución Capacidad de ejecución de script
DistanceFromPoint

Devuelve la distancia mínima entre un punto especificado y la forma.

point: punto de Vector3 desde el que calcular la distancia.

Distancia desde el punto a la forma.

Tipo: Flotante

DistanceSquaredFromPoint

Devuelve la distancia mínima cuadrada entre un punto especificado y la forma.

point: punto Vector3 desde el que calcular la distancia cuadrada.

Distancia cuadrada desde el punto a la forma.

Tipo: Flotante

GetEncompassingAabb

Devuelve AABB que abarca la totalidad de esta forma.

Ninguno AZ::Aabb que abarca la forma. No
GetShapeType Devuelve el tipo de forma determinada para el componente. Ninguno

AZ::Crc32(shape_name)

Por ejemplo:

AZ::Crc32("Box") | AZ::Crc32("Sphere") | AZ::Crc32("Capsule") | AZ::Crc32("Cylinder")

IsPointInside

Comprueba si un punto especificado se encuentra o no en una forma.

point: punto de Vector3 que se debe comprobar.

Indica si el punto está dentro o fuera de la forma.

Tipo: booleano

ComponentRequestsBus

Cada componente de forma tiene su propio bus de eventos específico para acceder a esta forma particular,. Los buses tienen funciones similares y solo difieren para el tipo de forma solicitado.

BoxShapeComponentRequestsBus

Nombre de la solicitud Descripción Parámetro Devolución Capacidad de ejecución de script
GetBoxConfiguration Devuelve la configuración de la BoxShape. Ninguno BoxShapeConfiguration objeto que contiene la configuración de la forma de cuadro.

CapsuleShapeComponentRequestsBus

Nombre de la solicitud Descripción Parámetro Devolución Capacidad de ejecución de script
GetCapsuleConfiguration

Devuelve la configuración de la CapsuleShape.

Ninguno

CapsuleShapeConfiguration objeto que contiene la configuración de la forma de cápsula.

CompoundShapeComponentRequestsBus

Nombre de la solicitud Descripción Parámetro Devolución Capacidad de ejecución de script
GetCompoundShapeConfiguration

Devuelve la configuración de la CompoundShape.

Ninguno

CompoundShapeConfiguration objeto que contiene la configuración de la forma de compuesto.

CylinderShapeComponentRequestsBus

Nombre de la solicitud Descripción Parámetro Devolución Capacidad de ejecución de script
GetCylinderConfiguration

Devuelve la configuración de la CylinderShape.

Ninguno CylinderShapeConfiguration objeto que contiene la configuración de la forma de cilindro.

SphereShapeComponentRequestsBus

Nombre Descripción Parámetro Devolución Capacidad de ejecución de script
GetSphereConfiguration

Devuelve la configuración de la SphereShape.

Ninguno

SphereShapeConfiguration objeto que contiene la configuración de la forma de esfera.

ShapeComponentNotificationsBus

Todas las formas comparten un único bus de notificación llamado ShapeComponentNotificationsBus.

Nombre de la notificación Descripción Parámetro Devolución Capacidad de ejecución de script
OnShapeChanged Notifica a los oyentes que el componente de forma se ha actualizado.

ShapeChangeReasons: indica si la forma se ha actualizado debido a un cambio de transformación o al cambio de parámetros de la forma.

Vacío