Às vezes, durante jogos de plataforma, você encontrará obstáculos que mudam de tamanho. Podem ser plataformas que aumentam e diminuem de tamanho, ou que ficam mais altas e mais baixas em determinado eixo. Quando as dimensões de um objeto são modificadas dessa forma, isso é chamado de modificar sua escala.

A escala de um objeto informa por que valor multiplicar cada uma de suas dimensões, em relação a ele próprio. Normalmente, os objetos tem uma escala de {X := 1.0, Y := 1.0, Z := 1.0}. Se você duplicar o valor de Z da escala de um objeto, ele fica duas vezes mais alto. Se reduzir pela metade, fica com metade da altura.

A escala é a parte final do quebra-cabeças do transformar. Nesta seção, você aprenderá a manipular a escala para criar objetos que crescem e encolhem a diferentes tamanhos.

Como criar adereços que escalam

Siga os passos abaixo para criar o código que escala seus adereços:

1. Crie uma nova classe Verse chamada scaling_prop que herda de movable_prop usando o Explorador do Verse. Adicione o especificador <concrete> a essa classe para expor suas propriedades ao UEFN.

   ~~~(verse) # Um adereço que escala em direção a uma determinada escala ou à escala de um adereço de Modo Criativo. scaling_prop := class(movable_prop): ~~~

2. Adicione as declarações using { /Fortnite.com/Devices/CreativeAnimation } e using { /UnrealEngine.com/Temporary/SpatialMath } ao topo do arquivo para importar esses módulos. Você precisará delas para animar seu adereço. Todas as dicas usadas nesta seção estão inclusas abaixo.

   ~~~(verse) using { /Fortnite.com/Devices } using { /Fortnite.com/Devices/CreativeAnimation } using { /Verse.org/Simulation } using { /UnrealEngine.com/Temporary/SpatialMath }

   MatchScaleTargetTip:message = "A posição opcional para se mover no Espaço do Mundo. Use isto se não quiser definir um MoveTarget."

   # Um adereço que escala em direção a uma determinada escala ou à escala de um adereço de Modo Criativo. scaling_prop := class(movable_prop): ~~~

3. No topo da definição de classe scaling_prop, adicione os seguintes campos:

   1. Uma matriz vector3 editável chamada ScaleTargets. Estas são as escalas que o seu adereço alcançará crescendo e encolhendo. Após a conclusão de Move(), a escala do adereço será multiplicada por este valor.

      ~~~(verse) # A matriz de alvos vector3 para os quais o RootProp escala. @editable {ToolTip := MoveTargetsTip} var ScaleTargets:[]vector3= array{} ~~~

   2. Um creative_prop editável opcional chamado MatchScaleTarget. Se você quiser que seu adereço escale para se alinhar à escala de outro adereço, você pode definir este valor em vez de usar ScaleTargets. Por exemplo, você poderia usar isto se quisesse criar uma série de plataformas que crescem até o mesmo tamanho antes de serem restauradas.

      ~~~(verse) # O adereço de Modo Criativo opcional para o RootProp corresponder a escala. @editable {ToolTip := MatchScaleTargetTip} var MatchScaleTarget:?creative_prop = false ~~~

   3. Uma variável rotation chamada TargetScale. Esta é a escala para a qual o adereço está atualmente escalando para chegar.

      ~~~(verse) # A escala para a qual o adereço está atualmente indo. var TargetScale:vector3 = vector3{} ~~~

4. A sua definição de classe final deve ficar assim:

    using { /Fortnite.com/Devices }
    using { /Fortnite.com/Devices/CreativeAnimation }
    using { /Verse.org/Simulation }
    using { /UnrealEngine.com/Temporary/SpatialMath }
   
    MatchScaleTargetTip<localizes>:message = "A posição opcional para se mover no Espaço do Mundo. Use isto se não quiser definir um MoveTarget."
   
    # Um adereço que escala em direção a uma determinada escala ou à escala de um adereço de Modo Criativo.
    scaling_prop<public> := class<concrete>(movable_prop):
   
        # A matriz de alvos vector3 para os quais o RootProp escala.
        @editable {ToolTip := MoveTargetsTip}
        var ScaleTargets:[]vector3= array{}
   
        # O adereço de Modo Criativo opcional para o RootProp corresponder a escala.
        @editable {ToolTip := MatchScaleTargetTip}
        var MatchScaleTarget:?creative_prop = false
   
        # A escala para a qual o adereço está atualmente indo.
        var TargetScale:vector3 = vector3{}
   Copy full snippet

   using { /Fortnite.com/Devices } using { /Fortnite.com/Devices/CreativeAnimation } using { /Verse.org/Simulation } using { /UnrealEngine.com/Temporary/SpatialMath } MatchScaleTargetTip<localizes>:message = "A posição opcional para se mover no Espaço do Mundo. Use isto se não quiser definir um MoveTarget." # Um adereço que escala em direção a uma determinada escala ou à escala de um adereço de Modo Criativo. scaling_prop<public> := class<concrete>(movable_prop): # A matriz de alvos vector3 para os quais o RootProp escala. @editable {ToolTip := MoveTargetsTip} var ScaleTargets:[]vector3= array{} # O adereço de Modo Criativo opcional para o RootProp corresponder a escala. @editable {ToolTip := MatchScaleTargetTip} var MatchScaleTarget:?creative_prop = false # A escala para a qual o adereço está atualmente indo. var TargetScale:vector3 = vector3{}

5. Como você á definiu a função Move() que move o seu adereço em movable_prop, você pode sobrescrevê-la nesta classe. Sobrescreva a função Move() na sua classe scaling_prop. Em Move(), verifique se o MatchScaleTarget está definido e salve-o em uma variável ScaleToMatch. Caso esteja, defina TargetScale como a ScaleToMatch, em seguida, chame MoveToEase(), passando TargetScale, MoveDuration, MoveEaseType e animation_mode.OneShot. Esta é a função MoveToEase() que você sobrecarregou anteriormente que modifica apenas a escala.

   ~~~(verse) # Escale o RootProp em direção a ScaleTarget, ou MatchScaleTarget se um estiver definido. Move():void= # Defina a TargetScale como o MatchScaleTarget se um estiver definido. if: ScaleToMatch := MatchScaleTarget?.GetTransform().Scale then: set TargetScale = ScaleToMatch

   # Chame MoveToEase para começar a escalar o adereço. O modo de animação OneShot reproduzirá a animação uma vez. RootProp.MoveToEase(MoveDuration, TargetScale, MoveEaseType, animation_mode.OneShot) ~~~

6. Se você não definiu um MatchScaleTarget, então precisa iterar por cada elemento da sua matriz ScaleTargets. Em uma expressão for, itere por cadaScaleTarget na matriz ScaleTargets e defina a TargetScale como o ScaleTarget. Em seguida, chame MoveToEase(), passando os mesmos valores que anteriormente. Sua função Move() completa deve ficar assim:

   ~~~(verse) # Escale o RootProp em direção a ScaleTarget, ou MatchScaleTarget se um estiver definido. Move():void=

   # Defina a TargetScale como o MatchScaleTarget se um estiver definido. if: ScaleToMatch := MatchScaleTarget?.GetTransform().Scale then: set TargetScale = ScaleToMatch

   # Chame MoveToEase para começar a escalar o adereço. O modo de animação OneShot reproduzirá a animação uma vez. RootProp.MoveToEase(MoveDuration, TargetScale, MoveEaseType, animation_mode.OneShot) else: # Caso contrário, escale até cada alvo na matriz ScaleTargets. for: ScaleTarget:ScaleTargets do: set TargetScale = ScaleTarget

   # Chame MoveToEase para começar a escalar o adereço. O modo de animação OneShot reproduzirá a animação uma vez. RootProp.MoveToEase(MoveDuration, TargetScale, MoveEaseType, animation_mode.OneShot) ~~~

7. Em sua classe de dispositivo prop_animator, adicione uma nova matriz editável de scaling_prop chamada ScalingProps. Adicione outra expressão for a OnBegin() que faz um loop que percorre todos os adereços de escala e chama Setup() neles. Sua classe prop_animator atualizada deve ficar assim:

   ~~~(verse) using { /Fortnite.com/Devices } using { /Verse.org/Simulation } using { /UnrealEngine.com/Temporary/Diagnostics }

   TranslatingPropsTip:message = "Os adereços que transladam (se movem) usando animação." RotatingPropsTip:message = "Os adereços que giram usando animação." RotatingPropsTip:message = "Os adereços que escalam usando animação."

   # Coordena a movimentação de adereços por meio de animação chamando o método Setup() de cada adereço. prop_animator := class(creative_device):

   # Matriz dos movable_props que transladam usando animação. @editable {ToolTip := TranslatingPropsTip} TranslatingProps:[]translating_prop = array{}

   # Matriz dos movable_props que giram usando animação. @editable {ToolTip := RotatingPropsTip} RotatingProps:[]rotating_prop = array{}

   # Matriz dos movable_props que escalam usando animação. @editable {ToolTip := ScalingPropsTip} ScalingProps:[]scaling_prop = array{}

   # É executado quando o dispositivo é iniciado em um jogo em execução OnBegin():void=

   # Para cada adereço, chame Setup() para começar a animar. for: Prop:TranslatingProps do: Prop.Setup() for: Prop:RotatingProps do: Prop.Setup() for: Prop:ScalingProps do: Prop.Setup() ~~~

8. Salve o código e compile-o.

Como vincular adereços a dispositivos

De volta ao editor, exclua alguns dos adereços que estão depois da seção de adereços de rotação, mas antes dos blocos elevados, para criar outro espaço vazio. Adicione uma FG01 Luva de Boxe ao seu nível. Chame a luva de ScalingGlove. Posicione a luva no meio do espaço vazio e a gire para que fique virada para cima.

Configuração da luva de boxe. A luva aumenta de tamanho para criar um elevador que leva os jogadores para cima.

Selecione o seu animador de adereços no Organizador e adicione um elemento de matriz a ScalingProps para sua luva. Atribua ao adereço os seguintes valores:

Submeta suas alterações e, em seguida, confira seus adereços! Experimente variar as diferentes escalas para obter dimensões variadas e experimente escalar outros adereços para criar cenários distintos!

Próximo passo

Na próxima seção, você combinará movimento, rotação e escala para criar adereços que podem fazer os três!

%animating-prop-movement-6-combining-movement-rotation-and-scale-in-verse:topic%

Código completo

Aqui está o código completo feito nesta seção:

scaling_prop.verse

~~~(verse) using { /Fortnite.com/Devices } using { /Fortnite.com/Devices/CreativeAnimation } using { /Verse.org/Simulation } using { /UnrealEngine.com/Temporary/SpatialMath }

MatchScaleTargetTip:message = "A posição opcional para se mover no Espaço do Mundo. Use isto se não quiser definir um MoveTarget."

Um adereço que escala em direção a uma determinada escala ou à escala de um adereço de Modo Criativo.

scaling_prop := class(movable_prop):

# A matriz de alvos vector3 para os quais o RootProp escala. @editable {ToolTip := MoveTargetsTip} var ScaleTargets:[]vector3= array{}

# O adereço de Modo Criativo opcional para o RootProp corresponder a escala. @editable {ToolTip := MatchScaleTargetTip} var MatchScaleTarget:?creative_prop = false

# A escala para a qual o adereço está atualmente indo. var TargetScale:vector3 = vector3{}

# Escale o RootProp em direção a ScaleTarget, ou MatchScaleTarget se um estiver definido. Move():void=

# Defina a TargetScale como o MatchScaleTarget se um estiver definido. if: ScaleToMatch := MatchScaleTarget?.GetTransform().Scale then: set TargetScale = ScaleToMatch

# Chame MoveToEase para começar a escalar o adereço. O modo de animação OneShot reproduzirá a animação uma vez. RootProp.MoveToEase(MoveDuration, TargetScale, MoveEaseType, animation_mode.OneShot) else: # Caso contrário, escale até cada alvo na matriz ScaleTargets. for: ScaleTarget:ScaleTargets do: set TargetScale = ScaleTarget

# Chame MoveToEase para começar a escalar o adereço. O modo de animação OneShot reproduzirá a animação uma vez. RootProp.MoveToEase(MoveDuration, TargetScale, MoveEaseType, animation_mode.OneShot)

### prop_animator.verse

~~~(verse)
using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

TranslatingPropsTip<localizes>:message = "Os adereços que transladam (se movem) usando animação."
RotatingPropsTip<localizes>:message = "Os adereços que giram usando animação."
RotatingPropsTip<localizes>:message = "Os adereços que escalam usando animação."

# Coordena a movimentação de adereços por meio de animação chamando o método Setup() de cada adereço.
prop_animator := class(creative_device):

    # Matriz dos movable_props que transladam usando animação.
    @editable {ToolTip := TranslatingPropsTip}
    TranslatingProps:[]translating_prop = array{}

    # Matriz dos movable_props que giram usando animação.
    @editable {ToolTip := RotatingPropsTip}
    RotatingProps:[]rotating_prop = array{}

    # Matriz dos movable_props que escalam usando animação.
    @editable {ToolTip := ScalingPropsTip}
    ScalingProps:[]scaling_prop = array{}

    # É executado quando o dispositivo é iniciado em um jogo em execução
    OnBegin<override>()<suspends>:void=

        # Para cada adereço, chame Setup() para começar a animar.
        for:
            Prop:TranslatingProps
        do:
            Prop.Setup()
        for:
            Prop:RotatingProps
        do:
            Prop.Setup()
        for:
            Prop:ScalingProps
        do:
            Prop.Setup()
Copy full snippet

### prop_animator.verse ~~~(verse) using { /Fortnite.com/Devices } using { /Verse.org/Simulation } using { /UnrealEngine.com/Temporary/Diagnostics } TranslatingPropsTip<localizes>:message = "Os adereços que transladam (se movem) usando animação." RotatingPropsTip<localizes>:message = "Os adereços que giram usando animação." RotatingPropsTip<localizes>:message = "Os adereços que escalam usando animação." # Coordena a movimentação de adereços por meio de animação chamando o método Setup() de cada adereço. prop_animator := class(creative_device): # Matriz dos movable_props que transladam usando animação. @editable {ToolTip := TranslatingPropsTip} TranslatingProps:[]translating_prop = array{} # Matriz dos movable_props que giram usando animação. @editable {ToolTip := RotatingPropsTip} RotatingProps:[]rotating_prop = array{} # Matriz dos movable_props que escalam usando animação. @editable {ToolTip := ScalingPropsTip} ScalingProps:[]scaling_prop = array{} # É executado quando o dispositivo é iniciado em um jogo em execução OnBegin<override>()<suspends>:void= # Para cada adereço, chame Setup() para começar a animar. for: Prop:TranslatingProps do: Prop.Setup() for: Prop:RotatingProps do: Prop.Setup() for: Prop:ScalingProps do: Prop.Setup()