KX_VehicleWrapper

Classe base: EXP_PyObjectPlus

Veja também

KX_GameObject, Range.constraints, KX_CharacterWrapper

KX_VehicleWrapper

TODO - descrição

addWheel(wheel, attachPos, downDir, axleDir, suspensionRestLength, wheelRadius, hasSteering)

Adiciona uma roda ao veículo

• wheel: O objeto a usar como roda.
  • tipo: KX_GameObject or a KX_GameObject name
• attachPos: A posição onde prender a roda, relativa ao centro do objeto chassi.
  • tipo: vector of 3 floats
• downDir: O vetor de direção apontando para baixo, até onde o veículo deve colidir com o chão.
  • tipo: vector of 3 floats
• axleDir: O eixo em torno do qual a roda gira, relativo ao chassi.
  • tipo: vector of 3 floats
• suspensionRestLength: O comprimento da suspensão quando nenhuma força está sendo aplicada.
  • tipo: float
• wheelRadius: O raio da roda (metade do diâmetro).
  • tipo: float
• hasSteering: True se a roda deve virar com o volante; em geral usado nas rodas da frente.
  • tipo: boolean

applyBraking(force, wheelIndex)

Aplica uma força de freio à roda indicada

• force: a força de freio
  • tipo: float
• wheelIndex: índice da roda em que a força deve ser aplicada
  • tipo: integer

applyEngineForce(force, wheelIndex)

Aplica uma força de motor à roda indicada

• force: a força do motor
  • tipo: float
• wheelIndex: índice da roda em que a força deve ser aplicada
  • tipo: integer

getConstraintId()

Pega o ID da constraint

Retorna: o id da constraint

Tipo do retorno: integer

getConstraintType()

Devolve o tipo da constraint.

Retorna: tipo da constraint

Tipo do retorno: integer

getNumWheels()

Devolve o número de rodas.

Retorna: o número de rodas deste veículo

Tipo do retorno: integer

getWheelOrientationQuaternion(wheelIndex)

Devolve a orientação da roda como quaternion.

• wheelIndex: o índice da roda
  • tipo: integer

Retorna: TODO Descrição

Tipo do retorno: TODO - type should be quat as per method name but from the code it looks like a matrix

getWheelPosition(wheelIndex)

Devolve a posição da roda indicada

• wheelIndex: o índice da roda
  • tipo: integer

Retorna: vetor de posição

Tipo do retorno: list[x, y, z]

getWheelRotation(wheelIndex)

Devolve a rotação da roda indicada

• wheelIndex: o índice da roda
  • tipo: integer

Retorna: a rotação da roda

Tipo do retorno: float

setRollInfluence(rollInfluece, wheelIndex)

Define a influência de rolagem da roda indicada. Quanto maior a influência, mais o veículo tende a capotar nas curvas.

• rollInfluece: a influência de rolagem da roda
  • tipo: float
• wheelIndex: o índice da roda
  • tipo: integer

setSteeringValue(steering, wheelIndex)

Define o esterço da roda indicada

• steering: o esterço da roda
  • tipo: float
• wheelIndex: o índice da roda
  • tipo: integer

setSuspensionCompression(compression, wheelIndex)

Define a compressão da roda indicada

• compression: a compressão da roda
  • tipo: float
• wheelIndex: o índice da roda
  • tipo: integer

setSuspensionDamping(damping, wheelIndex)

Define o amortecimento da roda indicada

• damping: o amortecimento da roda
  • tipo: float
• wheelIndex: o índice da roda
  • tipo: integer

setSuspensionStiffness(stiffness, wheelIndex)

Define a rigidez da roda indicada

• stiffness: a rigidez da roda
  • tipo: float
• wheelIndex: o índice da roda
  • tipo: integer

setTyreFriction(friction, wheelIndex)

Define o atrito do pneu da roda indicada

• friction: o atrito do pneu
  • tipo: float
• wheelIndex: o índice da roda
  • tipo: integer

rayMask

Define a máscara do ray cast.

Tipo: bitfield

Sem documentação da Range

Estes itens existem na engine mas não estavam na documentação da Range. Os marcados novo na Anastacio foram adicionados pela Anastacio Engine.

getCoordinateSystem()

método

Eixos (direita, cima, frente) do veículo (0=X, 1=Y, 2=Z).

Retorna: tuple

getCurrentSpeedKmh()

método

Velocidade atual em km/h.

Retorna: float

getCurrentSpeedMps()

método

Velocidade atual em metros por segundo.

Retorna: float

getForwardVector()

método

Direção da frente do veículo, no mundo.

Retorna: Vector

getWheelConfig(wheelIndex)

método

Configuração da roda: connectionPoint, downDirection, axleDirection, suspensionRestLength, wheelRadius, hasSteering e isDriveWheel.

Retorna: dict

getWheelState(wheelIndex)

método

Estado da roda neste tick: posição e orientação no mundo, rotation, isInContact, ponto e normal do contato, suspensionForce e mais.

Retorna: dict

loadPreset(path)

método

Carrega um preset de veículo (arquivo) e aplica neste veículo.

rebuildPreset(path, wheelObjects)

método

Recria as rodas a partir do preset, usando os objetos dados (um por roda). Use Empties com física No Collision como rodas.

resetSuspension()

método

Volta a suspensão ao estado de repouso (útil depois de teleportar o carro).

savePreset(path)

método

Salva a configuração atual do veículo num arquivo de preset.

setCoordinateSystem(right, up, forward)

método

Define quais eixos (0=X, 1=Y, 2=Z) são direita, cima e frente. Precisa usar os três eixos sem repetir.

setWheelIsDriveWheel(wheelIndex, isDriveWheel)

método

Define se a roda recebe tração do motor.

constraint_id

atributo · só leitura

Id da restrição (constraint) física do veículo.

constraint_type

atributo · só leitura

Tipo da restrição física do veículo.