API reference
API reference
Select your platform
No SDKs available
No versions available

Quad Class

Extends ComponentBase
Modifiers: final
Defines a single-sided 2D rectangular shape in 3D space by specifying minimum and maximum coordinates. This is to be used with the mesh://quad URI on Mesh component. Material can be customized with the Material component.
Quads are commonly used for flat surfaces like panels, screens, or simple rectangular objects.
Example:
Entity.create(
    listOf(
        Mesh(Quad.URI),
        Quad(Vector2(0.1f, 0.1f), Vector2(0.8f, 0.4f)), // Min and max coordinates
        Material().apply {
          baseColor = Color4(red = 1.0f, green = 0.0f, blue = 0.1f, alpha = 1.0f)
        },
        Transform(Pose(Vector3(x = 0f, y = 1.0f, z = -1.0f)))
    )
)

Signature

class Quad(min: Vector2 = Vector2(0.0f, 0.0f), max: Vector2 = Vector2(1.0f, 1.0f)) : ComponentBase

Constructors

Quad ( min , max )
Signature
constructor(min: Vector2 = Vector2(0.0f, 0.0f), max: Vector2 = Vector2(1.0f, 1.0f))
Parameters
min: Vector2
  The minimum coordinates (bottom-left) of the quad
max: Vector2
  The maximum coordinates (top-right) of the quad
Returns

Properties

cachable : BuildConfig.COMPONENTCACHE_LEVEL >= 1
[Get][Set]
Signature
open override var cachable: BuildConfig.COMPONENTCACHE_LEVEL >= 1
entID : Long
[Get][Set]
Signature
var entID: Long
isDirty : Boolean
[Get][Set]
Signature
var isDirty: Boolean
max : Vector2
[Get][Set]
The maximum coordinates (top-right) in meters of the quad
Signature
var max: Vector2
min : Vector2
[Get][Set]
The minimum coordinates (bottom-left) in meters of the quad
Signature
var min: Vector2
recycled : Boolean
[Get][Set]
Signature
var recycled: Boolean
timeStamp : Long
[Get][Set]
Signature
var timeStamp: Long

Functions

companion ()
Gets the companion object for this component.
The companion object provides metadata about the component.
Signature
open override fun companion(): ComponentCompanion
Returns
  The component's companion object
Throws
RuntimeException
  If the companion is not implemented
getComponentDataAttributeType ( key )
Gets the attribute type for the specified key.
Signature
fun getComponentDataAttributeType(key: Int): AttributePrimitive?
Parameters
key: Int
  The integer key to look up
Returns
  The attribute primitive type, or null if the key doesn't exist
getComponentDataAttributeType ( keyString )
Gets the attribute type for the specified string key.
Signature
fun getComponentDataAttributeType(keyString: String): AttributePrimitive?
Parameters
keyString: String
  The string key to look up
Returns
  The attribute primitive type
Throws
IllegalArgumentException
  If the key doesn't exist
getComponentDataKey ( key )
Gets the integer key associated with the specified string key.
Signature
fun getComponentDataKey(key: String): Int?
Parameters
key: String
  The string key to look up
Returns
Int?
  The integer key, or null if the string key doesn't exist
getComponentDataValue ( key )
Gets the value for the specified key.
Signature
fun getComponentDataValue(key: Int): Any?
Parameters
key: Int
  The integer key to look up
Returns
Any?
  The value associated with the key, or null if the key doesn't exist
getComponentDataValue ( keyString )
Gets the value for the specified string key.
Signature
fun getComponentDataValue(keyString: String): Any?
Parameters
keyString: String
  The string key to look up
Returns
Any?
  The value associated with the key, or null if the key doesn't exist
Throws
IllegalArgumentException
  If the key doesn't exist
getEnumClass ( key )
Gets the enum class associated with the specified string key.
Signature
fun getEnumClass(key: String): Class<out Enum<*>>?
Parameters
key: String
  The string key to look up
Returns
Class?
  The enum class, or null if the key doesn't exist or is not an enum
hasComponentData ( key )
Checks if this component has data for the specified key.
Signature
fun hasComponentData(key: Int): Boolean
Parameters
key: Int
  The integer key to check
Returns
Boolean
  True if the component has data for the key, false otherwise
hasComponentData ( keyString )
Checks if this component has data for the specified string key.
Signature
fun hasComponentData(keyString: String): Boolean
Parameters
keyString: String
  The string key to check
Returns
Boolean
  True if the component has data for the key, false otherwise
read ( e , cachable )
Reads component data from the specified entity.
Signature
fun read(e: Entity, cachable: Boolean)
Parameters
e: Entity
  The entity to read data from
cachable: Boolean
  Whether the component's data should be cached
recycle ()
Recycles this component by returning it to its pool.
If the component has a pool assigned, it will be returned to that pool for reuse.
Signature
fun recycle()
reset ()
Resets the component to its default state.
This method is called when a component is recycled to clear any state. Subclasses should override this method to reset their specific state.
Signature
open fun reset()
setComponentDataValue ( key , value )
Sets the value for the specified key.
Signature
fun setComponentDataValue(key: Int, value: Any): Boolean
Parameters
key: Int
  The integer key to set
value: Any
  The value to set
Returns
Boolean
  True if the value was set successfully, false otherwise
setComponentDataValue ( keyString , value )
Sets the value for the specified string key.
Signature
fun setComponentDataValue(keyString: String, value: Any): Boolean
Parameters
keyString: String
  The string key to set
value: Any
  The value to set
Returns
Boolean
  True if the key exists and the value was set, false otherwise
setPool ( pool , entID )
Sets the component pool and entity ID for this component.
This is used for component recycling to track which pool the component belongs to and which entity it was associated with.
Signature
fun setPool(pool: ComponentPool<*>, entID: Long)
Parameters
pool: ComponentPool
  The component pool this component belongs to
entID: Long
  The ID of the entity this component is associated with
toString ()
Signature
open override fun toString(): String
Returns
String
typeID ()
Returns the unique type ID of this component.
Each component type must have a unique ID for identification in the entity-component system.
Signature
open override fun typeID(): Int
Returns
Int
  The unique type ID for this component
write ( e )
Writes this component's data to the specified entity.
Signature
fun write(e: Entity)
Parameters
e: Entity
  The entity to write this component's data to

Companion Object

Companion Object Properties

attributeKeys_ : IntArray
[Get]
Signature
val attributeKeys_: IntArray
attributeTypeCounts_ : IntArray
[Get]
Signature
val attributeTypeCounts_: IntArray
attributeTypes_ : IntArray
[Get]
Signature
val attributeTypes_: IntArray
attrMetaData_ : Map
[Get]
Signature
val attrMetaData_: Map
createDefaultInstance : Function0
[Get]
Signature
open override val createDefaultInstance: () -> Quad
enumClassesMap_ : Map
[Get]
Signature
val enumClassesMap_: Map<Int, Class<out Enum<*>>>
id
[Get]
Signature
open override val id: 
keyStringToKeyIntMap_ : Map
[Get]
Signature
val keyStringToKeyIntMap_: Map<String, Int>
[Get]
Signature
val maxData: Vector2AttributeData
maxId
[Get]
Signature
val maxId: 
[Get]
Signature
val minData: Vector2AttributeData
minId
[Get]
Signature
val minId: 
URI : Uri
[Get]
URI for the procedural quad mesh. Use with Mesh component.
Signature
val URI: Uri

Companion Object Functions

attributeKeys ()
Signature
open override fun attributeKeys(): IntArray
Returns
IntArray
attributeMetaData ()
Returns
Map
attributeTypeCountAvailable ()
Signature
open override fun attributeTypeCountAvailable(): Boolean
Returns
Boolean
attributeTypeCounts ()
Signature
open override fun attributeTypeCounts(): IntArray
Returns
IntArray
attributeTypes ()
Signature
open override fun attributeTypes(): IntArray
Returns
IntArray
dependents ()
Signature
open override fun dependents(): IntArray
Returns
IntArray
enumClassesMap ()
Signature
open override fun enumClassesMap(): Map<Int, Class<out Enum<*>>>
Returns
Map
keyStringToKeyIntMap ( keyString )
Signature
open override fun keyStringToKeyIntMap(keyString: String): Int?
Parameters
keyString: String
Returns
Int?
Did you find this page helpful?