WebAssembly-游戏开发实用指南(三)

139 阅读54分钟

WebAssembly 游戏开发实用指南(三)

原文:annas-archive.org/md5/2bc11e3fb2b816b3a221f95dafc6aa63

译者:飞龙

协议:CC BY-NC-SA 4.0

碰撞检测

目前,我们的太空飞船可以四处飞行并互相射击,但没有发生任何事情。

碰撞检测在绝大多数视频游戏中用于确定游戏对象是否相交。有许多方法可以检测不同游戏对象之间的碰撞。不同的方法在不同情况下可能效果更好。在计算时间和我们的碰撞检测的准确性之间也存在权衡。

您需要在构建中包含几个图像才能使此项目工作。确保您包含了项目的 GitHub 中的/Chapter07/sprites/文件夹。如果您还没有下载 GitHub 项目,可以在这里在线获取:github.com/PacktPublishing/Hands-On-Game-Development-with-WebAssembly

在本章中,我们将讨论以下内容:

  • 碰撞检测

  • 碰撞器对象

  • 碰撞器的类型

  • 向我们的游戏对象添加碰撞器

2D 碰撞检测类型

我可以写一本关于我们可以使用的各种 2D 碰撞检测方法的书,更不用说 3D 碰撞检测的数量了。我已经在www.embed.com/typescript-games/basic-collision-detection.html上写了几篇 TypeScript 教程,介绍了如何使用不同的检测技术,包括基本的和复杂的,但在这本书中,我们将坚持使用一些更基本的碰撞技术的组合。

圆形碰撞检测

最基本的碰撞检测是圆形距离碰撞检测。如果我们把所有的碰撞器都看作是带有半径和位置的小圆圈,我们可以计算两个位置之间的距离,并查看该距离是否小于我们半径的总和。这种形式的碰撞检测速度很快,但精度有限。如果你看看我们游戏中的抛射物,这种方法效果还不错。另一方面,我们的太空飞船并不完全适合圆形。我们可以调整任何给定飞船的圆形碰撞器的半径,以获得略有不同的结果。当圆形碰撞检测有效时,它可以非常高效:

[圆形碰撞检测]

矩形碰撞检测

矩形碰撞检测是另一种快速的碰撞检测方法。在许多情况下,它可能比圆形碰撞检测更快。矩形碰撞器由* x y 坐标定义,这是我们矩形左上角的位置,以及宽度和高度。检测矩形碰撞非常简单。我们在 x 轴上寻找两个矩形之间的重叠。如果在 x 轴上有重叠,然后我们在 y *轴上寻找重叠。如果两个轴上都有重叠,就会发生碰撞。这种技术对许多老式视频游戏非常有效。在任天堂娱乐系统上发布的几款经典游戏使用了这种碰撞检测方法。在我们编写的游戏中,我们正在旋转我们的精灵,因此使用传统的非定向碰撞检测对我们来说没有用处。

三角函数的简短复习

在这一点上,我们的碰撞检测算法开始变得更加复杂。你可能还记得一些高中三角学课程的概念,但一些基本的三角学对于许多碰撞检测算法非常重要。即使我们之前讨论的圆形碰撞检测也依赖于毕达哥拉斯定理,所以,实际上,除非你在进行简单的非定向矩形碰撞检测,至少需要一点三角学。三角学是数学中三角形的研究。大多数游戏使用所谓的笛卡尔坐标系。如果你对这个词不熟悉,笛卡尔坐标系意味着我们有一个带有xy坐标的网格(对于 2D 游戏)。

笛卡尔这个词是由勒内·笛卡尔发明的——那个“我思故我在”的家伙,在数学上有很多伟大的想法,在哲学上有很多愚蠢的想法(机器中的幽灵…呸!)。

我们必须从高中的三角学课程中记住一些关键概念,它们都与直角三角形有关。直角三角形是一个内含 90 度角的三角形。当你使用笛卡尔坐标系时,这是一个方便的事情,因为你的xy轴恰好形成一个直角,所以任何两点之间不共享xy坐标的线都可以被视为直角三角形的斜边(长边)。我们还需要记住一些比率;它们如下:

  • 正弦 - Y / 斜边

  • 余弦 - X / 斜边

  • 正切 - Y / X

你还记得 SOHCAHTOA 吗?(发音为“Sock-Ah-Toe-Ah”)

这是为了提醒你记住三角比率的以下版本:

  • 正弦 - 对边 / 斜边

  • 余弦 - 邻边 / 斜边

  • 正切 - 对边 / 邻边

在这个公式中,三角形的对边y轴,三角形的邻边是x轴。如果你记得 SOHCAHTOA,你可能更容易记住这些比率。如果不记得,就重新翻开这本书或使用谷歌:

[SOHCAHTOA]

有些人被教导使用短语“Some Old Horse Came A-Hoppin' Through Our Alley.”我不确定这是否有帮助。我觉得比 SOHCAHTOA 更难记住,但这是一个观点问题。所以,如果想象一匹像兔子一样在某个城市的后巷里跳跃的马是你的菜,那么尽管使用那个。

你可能还记得在本书的前面,我们使用了船舶旋转的角度和sincos数学库函数来计算我们的船在x轴和y轴上的移动速度。这些函数返回给定角度的比率。

我们需要知道的另一个概念是两个单位向量之间的点积。单位向量是长度为 1 的向量。两个单位向量之间的点积就是这两个单位向量之间的角的余弦。点积越接近 1,两个向量之间的角度就越接近 0 度。如果点积接近 0,两个向量之间的角度接近 90 度,如果两个角之间的点积接近-1,两个向量之间的角度接近 180 度。不同向量之间的点积在碰撞检测和游戏物理中非常有用。参考以下图表:

[两个归一化向量的点积]

线碰撞检测

因此,我们需要做的第一件事是讨论线和线段之间的区别。我们使用两点来定义一条线。该线在点之后延伸到无穷大。线段在两点处终止,并且不会无限期地继续。不平行的两条线总会在某个地方相交。两条不平行的线段可能会相交,也可能不会相交。

在大多数情况下,在游戏中,我们都对两条线段是否相交感兴趣:

[线与线段]

确定一条线是否与线段相交相对容易。你所要做的就是看看线段的两个点是否在你的线的两侧。由于一条线是无限的,这意味着你的线段必须在某个地方与你的线相交。如果你想要找出两条线段是否相交,你可以分两个阶段来做。首先,找出线段 A 是否与无限线 B 相交。如果它们相交,那么找出线段 B 是否与无限线 A 相交。如果在这两种情况下都成立,那么线段相交。

那么,下一个问题是,我们如何在数学上知道两点是否在一条线的对立面?为了做到这一点,我们将使用先前讨论过的点积和称为向量法线的东西。向量法线只是你的向量的一个 90 度旋转版本。请参阅以下图表:

一个向量及该向量的法线

我们还需要一个向量,它的起点与同一点相同,但方向指向我们线段的第一个点。如果这两个向量的点积是一个正值,那么这意味着该点与归一化向量在同一侧。如果点积是一个负值,那么这意味着该点在与我们的法向量相反的一侧。如果线段相交,那么意味着一个点有一个正的点积,另一侧有一个负的点积。由于两个负数相乘和两个正数相乘都会得到一个正的结果,而一个负数和一个正数相乘会得到一个负的结果,将这两个点积相乘,看看结果值是否为负数。如果是,那么线段与线相交:

[确定两点是否在线的对立面]

复合碰撞器

复合碰撞器是指游戏对象使用多个碰撞器来确定是否发生了碰撞。我们将在我们的飞船上使用复合圆形碰撞器,以提高我们飞船碰撞检测的准确性,同时仍然提供使用圆形碰撞器的增加速度。我们将用三个圆覆盖我们的玩家飞船和敌人飞船。我们的抛射物是圆形的,因此对于它们使用圆形是非常自然的。没有理由限制复合碰撞器只使用一种形状的碰撞器。在内部,复合碰撞器可以混合圆形碰撞器和矩形碰撞器,或者任何其他你喜欢的类型。

下面的图表显示了一个由圆和两个矩形碰撞器组成的假想化复合碰撞器:

[由三个基本碰撞器组成的复合碰撞器]

在下一节中,我们将学习如何实现基本的圆形碰撞检测算法。

实现圆形碰撞检测

我们将从实现圆形碰撞检测开始,因为这是最快的碰撞检测方法。它也很适合我们的抛射物,这将是我们游戏中最常见的碰撞器。它对我们的飞船的效果不是很好,但是以后,我们可以通过实现一个复合碰撞器来改善这种情况,该碰撞器将为每艘飞船使用多个圆形碰撞器,而不仅仅是一个。因为我们只有两艘飞船,这将为我们的碰撞检测带来最佳的效果:圆形碰撞检测的速度,以及一些更好的碰撞检测方法的准确性。

让我们首先在game.hpp文件中添加一个Collider类定义,并创建一个新的collider.cpp文件,在其中我们可以定义Collider类使用的函数。以下是我们在game.hpp文件中新Collider类的样子:

class Collider {
    public:
        double m_X;
        double m_Y;
        double m_Radius;

        Collider(double radius);

        bool HitTest( Collider *collider );
};

这是我们放在collider.cpp文件中的代码:

#include "game.hpp"
Collider::Collider(double radius) {
    m_Radius = radius;
}

bool Collider::HitTest( Collider *collider ) {
    double dist_x = m_X - collider->m_X;
    double dist_y = m_Y - collider->m_Y;
    double radius = m_Radius + collider->m_Radius;

    if( dist_x * dist_x + dist_y * dist_y <= radius * radius ) {
        return true;
    }
    return false;
}

Collider类是一个相当简单的圆形碰撞器。正如我们之前讨论的,圆形碰撞器有一个xy坐标以及一个半径。HitTest函数进行了一个相当简单的距离测试,以确定两个圆是否足够接近以触碰彼此。我们通过平方两个碰撞器之间的x距离和y距离来实现这一点,这给了我们两点之间的距离的平方。我们可以取平方根来确定实际距离,但平方根是一个相对较慢的函数,而平方两个半径的和进行比较要快得多。

我们还需要简要讨论类继承。如果你回顾一下我们之前的代码,我们有一个PlayerShip类和一个EnemyShip类。这些类共享大部分属性。它们都有xy坐标,xy速度,以及许多其他相同的属性。许多函数使用相同的复制粘贴的代码。我们不想重复定义这些代码,让我们回过头来创建一个Ship类,它包含了PlayerShipEnemyShip类共有的所有特性。然后,我们可以重构我们的EnemyShipPlayerShip类,让它们继承自我们的Ship类。这是我们在game.hpp中添加的新Ship类定义:

class Ship: public Collider {
    public:
        Uint32 m_LastLaunchTime;
        const int c_Width = 16;
        const int c_Height = 16;
        SDL_Texture *m_SpriteTexture;
        Ship();
        float m_Rotation;
        float m_DX;
        float m_DY;
        float m_VX;
        float m_VY;

        void RotateLeft();
        void RotateRight();
        void Accelerate();
        void Decelerate();
        void CapVelocity();

        virtual void Move() = 0;
        void Render();
};

第一行Ship class: public Collider告诉我们Ship将继承Collider类的所有公共和受保护成员。我们这样做是因为我们希望能够执行碰撞检测。Collider类现在也定义了m_Xm_Y属性变量,用于跟踪对象的xy坐标。我们已经将EnemyShipPlayerShip类的共同部分移到了Ship类中。你会注意到我们有一个虚函数virtual void Move() = 0;。这一行告诉我们,所有继承自Ship的类都将有一个Move函数,但我们需要在这些类中定义Move,而不是直接在Ship类中定义。这使Ship成为一个抽象类,这意味着我们不能创建Ship的实例,而是它是其他类将继承的类。

类继承、抽象类和虚函数都是一种被称为面向对象编程OOP)的编程风格的一部分。C++是由 Bjarne Stroustrup 于 1979 年创建的,用于将 OOP 添加到 C 编程语言中。如果你对 OOP 不熟悉,有数百本书详细介绍了这个主题。我只能在本书中粗略地介绍它。

接下来,我们将修改game.hpp文件中的PlayerShipEnemyShip类,删除我们移动到父类Ship中的所有方法和属性。我们还将修改这些类,使它们继承自Ship。以下是类定义的新版本:

class PlayerShip: public Ship {
    public:
        const char* c_SpriteFile = "sprites/Franchise.png";
        const Uint32 c_MinLaunchTime = 300;
        PlayerShip();
        void Move();
};

class EnemyShip: public Ship {
    public:
        const char* c_SpriteFile = "sprites/BirdOfAnger.png";
        const Uint32 c_MinLaunchTime = 300;
        const int c_AIStateTime = 2000;
        FSM_STUB m_AIState;
        int m_AIStateTTL;

        EnemyShip();
        void AIStub();
        void Move();
};

现在,我们需要添加一个ship.cpp文件,并定义所有EnemyShipPlayerShip共有的方法。这些方法之前都在PlayerShipEnemyShip中,但现在我们可以将它们都放在一个地方。以下是ship.cpp文件的样子:

#include "game.hpp"

Ship::Ship() : Collider(8.0) {
    m_Rotation = PI;
    m_DX = 0.0;
    m_DY = 1.0;
    m_VX = 0.0;
    m_VY = 0.0;
    m_LastLaunchTime = current_time;
}

void Ship::RotateLeft() {
    m_Rotation -= delta_time;

    if( m_Rotation < 0.0 ) {
        m_Rotation += TWO_PI;
    }
    m_DX = sin(m_Rotation);
    m_DY = -cos(m_Rotation);
}

void Ship::RotateRight() {
    m_Rotation += delta_time;

    if( m_Rotation >= TWO_PI ) {
        m_Rotation -= TWO_PI;
    }
    m_DX = sin(m_Rotation);
    m_DY = -cos(m_Rotation);
}

void Ship::Accelerate() {
    m_VX += m_DX * delta_time;
    m_VY += m_DY * delta_time;
}

void Ship::Decelerate() {
    m_VX -= (m_DX * delta_time) / 2.0;
    m_VY -= (m_DY * delta_time) / 2.0;
}
void Ship::CapVelocity() {
    double vel = sqrt( m_VX * m_VX + m_VY * m_VY );

    if( vel > MAX_VELOCITY ) {
        m_VX /= vel;
        m_VY /= vel;

        m_VX *= MAX_VELOCITY;
        m_VY *= MAX_VELOCITY;
    }
}
void Ship::Render() {
    dest.x = (int)m_X;
    dest.y = (int)m_Y;
    dest.w = c_Width;
    dest.h = c_Height;

    double degrees = (m_Rotation / PI) * 180.0;

    int return_code = SDL_RenderCopyEx( renderer, m_SpriteTexture,
                                        NULL, &dest,
                                        degrees, NULL, SDL_FLIP_NONE );

    if( return_code != 0 ) {
        printf("failed to render image: %s\n", IMG_GetError() );
    }
}

这些类的版本之间唯一真正的区别是,在player_ship.cppenemy_ship.cpp文件中,每个函数定义前面不再是PlayerShip::EnemyShip::,而是Ship::

接下来,我们需要修改player_ship.cppenemy_ship.cpp,删除现在在ship.cpp文件中定义的所有函数。让我们看看enemy_ship.cpp文件分成两部分的样子。第一部分是我们的game.hpp文件的#includeEnemyShip构造函数:

#include "game.hpp"

EnemyShip::EnemyShip() {
    m_X = 60.0;
    m_Y = 50.0;
    m_Rotation = PI;
    m_DX = 0.0;
    m_DY = 1.0;
    m_VX = 0.0;
    m_VY = 0.0;
    m_LastLaunchTime = current_time;

    SDL_Surface *temp_surface = IMG_Load( c_SpriteFile );

    if( !temp_surface ) {
        printf("failed to load image: %s\n", IMG_GetError() );
        return;
    }
    else {
        printf("success creating enemy ship surface\n");
    }
    m_SpriteTexture = SDL_CreateTextureFromSurface( renderer, 
    temp_surface );

    if( !m_SpriteTexture ) {
        printf("failed to create texture: %s\n", IMG_GetError() );
        return;
    }
    else {
        printf("success creating enemy ship texture\n");
    }

    SDL_FreeSurface( temp_surface );
}

enemy_ship.cpp文件的第二部分中,我们有MoveAIStub函数:

void EnemyShip::Move() {
    AIStub();

    if( m_AIState == TURN_LEFT ) {
        RotateLeft();
    }

    if( m_AIState == TURN_RIGHT ) {
        RotateRight();
    }

    if( m_AIState == ACCELERATE ) {
        Accelerate();
    }

    if( m_AIState == DECELERATE ) {
        Decelerate();
    }

    CapVelocity();
    m_X += m_VX;

    if( m_X > 320 ) {
        m_X = -16;
    }
    else if( m_X < -16 ) {
        m_X = 320;
    }

    m_Y += m_VY;

    if( m_Y > 200 ) {
        m_Y = -16;
    }
    else if( m_Y < -16 ) {
        m_Y = 200;
    }

    if( m_AIState == SHOOT ) {
        Projectile* projectile;

        if( current_time - m_LastLaunchTime >= c_MinLaunchTime ) {
            m_LastLaunchTime = current_time;
            projectile = projectile_pool->GetFreeProjectile();

            if( projectile != NULL ) {
                projectile->Launch( m_X, m_Y, m_DX, m_DY );
            }
        }
    }
}

void EnemyShip::AIStub() {
    m_AIStateTTL -= diff_time;

    if( m_AIStateTTL <= 0 ) {
        // for now get a random AI state.
        m_AIState = (FSM_STUB)(rand() % 5);
        m_AIStateTTL = c_AIStateTime;
    }
}

现在我们已经看到了enemy_ship.cpp文件中的内容,让我们看看新的player_ship.cpp文件的样子:

#include "game.hpp"
PlayerShip::PlayerShip() {
    m_X = 160.0;
    m_Y = 100.0;
    SDL_Surface *temp_surface = IMG_Load( c_SpriteFile );

    if( !temp_surface ) {
        printf("failed to load image: %s\n", IMG_GetError() );
        return;
    }

    m_SpriteTexture = SDL_CreateTextureFromSurface( renderer, 
    temp_surface );

    if( !m_SpriteTexture ) {
        printf("failed to create texture: %s\n", IMG_GetError() );
        return;
    }

    SDL_FreeSurface( temp_surface );
}

void PlayerShip::Move() {
    current_time = SDL_GetTicks();
    diff_time = current_time - last_time;
    delta_time = (double)diff_time / 1000.0;
    last_time = current_time;

    if( left_key_down ) {
        RotateLeft();
    }

    if( right_key_down ) {
        RotateRight();
    }

    if( up_key_down ) {
        Accelerate();
    }

    if( down_key_down ) {
        Decelerate();
    }

    CapVelocity();
    m_X += m_VX;

    if( m_X > 320 ) {
        m_X = -16;
    }
    else if( m_X < -16 ) {
        m_X = 320;
    }

    m_Y += m_VY;

    if( m_Y > 200 ) {
        m_Y = -16;
    }
    else if( m_Y < -16 ) {
        m_Y = 200;
    }

    if( space_key_down ) {
        Projectile* projectile;

        if( current_time - m_LastLaunchTime >= c_MinLaunchTime ) {
            m_LastLaunchTime = current_time;
            projectile = projectile_pool->GetFreeProjectile();
            if( projectile != NULL ) {
                projectile->Launch( m_X, m_Y, m_DX, m_DY );
            }
        }
    }
}

接下来,让我们修改ProjectilePool类中的Move函数,以便每次移动Projectile时,它也测试是否击中了我们的飞船之一:

void ProjectilePool::MoveProjectiles() {
    Projectile* projectile;
    std::vector<Projectile*>::iterator it;
    for( it = m_ProjectileList.begin(); it != m_ProjectileList.end(); 
        it++ ) {
        projectile = *it;
        if( projectile->m_Active ) {
            projectile->Move();
            if( projectile->HitTest( player ) ) {
                printf("hit player\n");
            }
            if( projectile->HitTest( enemy ) ) {
                printf("hit enemy\n");
            }
        }
    }
}

现在,我们只会在玩家或敌人与抛射物发生碰撞时在控制台上打印。这将告诉我们我们的碰撞检测是否正确。在后面的部分中,我们将添加动画来摧毁我们的飞船当它们与抛射物碰撞时。

我们需要对Projectile类的Launch函数进行最后一个更改。当我们从飞船发射抛射物时,我们给抛射物一个基于飞船面向的方向的 x 和 y 位置和xy速度。我们需要根据这个方向移动抛射物的起点。这是为了防止抛射物通过移动出碰撞检测圈而击中发射它的飞船:

void Projectile::Launch(double x, double y, double dx, double dy) {
    m_X = x + dx * 9;
    m_Y = y + dy * 9;
    m_VX = velocity * dx;
    m_VY = velocity * dy;
    m_TTL = alive_time;
    m_Active = true;
}

在接下来的部分中,我们将检测当我们的飞船与抛射物碰撞时,并运行一个爆炸动画。

在碰撞时摧毁飞船

现在我们正在检测抛射物和飞船之间的碰撞,做一些比在控制台打印一行更有趣的事情会很好。当抛射物和飞船碰到东西时,能有一点爆炸动画会很好。当这些对象被摧毁时,我们可以为每个对象添加一个关联的动画。

我将介绍精灵表的概念,而不是像在之前的章节中那样为动画的每一帧加载多个精灵。我们将为每个飞船加载一个精灵表,其中不仅包括每个未受损版本,还包括我们在这些对象被摧毁时要播放的摧毁序列。

在这个示例中使用三个不同的精灵表只是为了方便。当您决定如何打包精灵表以供生产时,有几个考虑因素。您很可能希望根据需要打包精灵表。您可能会选择根据游戏的级别来打包精灵表。您还需要考虑到,出于性能原因,WebGL 需要大小为 2 的幂的精灵文件。这可能会影响您关于将哪些精灵打包到哪些精灵表中的决定。您还可以考虑购买一个像 Texture Packer 这样的工具,以便比手工更快地为您打包精灵。

我们已经创建了三个精灵表来替换我们之前使用的三个精灵。这些Sprites分别是FranchiseExp.png替换Franchise.pngBirdOfAngerExp.png替换BirdOfAnger.png,以及ProjectileExp.png替换Projectile.png。我们需要对Projectile类、Ship类、EnemyShip类、PlayerShip类以及ProjectilePool类,以及game_loop函数进行一些调整。

我们将从修改游戏循环开始,以跟踪游戏的时间数据。我们必须从player_ship.cpp文件中的PlayerShip::Move函数中删除一些代码。这段代码存在于第四章中,使用 SDL 在 WebAssembly 中进行精灵动画,我们讨论了通过对PlayerShip进行动画化来实现精灵动画的基础知识。我们必须从PlayerShip::Move的前几行中删除以下代码:

current_time = SDL_GetTicks();
diff_time = current_time - last_time;
delta_time = (double)diff_time / 1000.0;
last_time = current_time;

这段代码获取当前时间并计算我们用于速度调整和动画定时的所有时间相关信息。我们可能应该在几章前将这段代码移到游戏循环中,但迟做总比不做好。以下是main.cpp中新的game_loop函数的代码:

void game_loop() {
    current_time = SDL_GetTicks();
    diff_time = current_time - last_time;
    delta_time = (double)diff_time / 1000.0;
    last_time = current_time;
    input();
    move();
    render();
}

严格来说,我们不必进行这种更改,但将游戏时间代码放在游戏循环中更合理。现在我们已经改变了游戏循环,我们将修改Projectile类。以下是我们必须在game.hpp文件中进行的类定义更改:

class Projectile: public Collider {
    public:
        const char* c_SpriteFile = "sprites/ProjectileExp.png";
        const int c_Width = 16;
        const int c_Height = 16;
        const double velocity = 6.0;
        const double alive_time = 2000;
        SDL_Texture *m_SpriteTexture;
        SDL_Rect src = {.x = 0, .y = 0, .w = 16, .h = 16 };
        Uint32 m_CurrentFrame = 0;
        int m_NextFrameTime;
        bool m_Active;

        float m_TTL;
        float m_VX;
        float m_VY;

        Projectile();
        void Move();
        void Render();
        void Launch(float x, float y, float dx, float dy);
};

我们需要修改c_SpriteFile变量,使其指向新的精灵表 PNG 文件,而不是单个精灵文件。我们需要增加宽度和高度。为了为爆炸腾出空间,我们将使精灵表中的所有帧都变为 16 x 16,而不是 8 x 8。我们还需要一个源矩形。当每个精灵使用整个文件时,我们可以将null传递给SDL_RenderCopy,函数将渲染精灵文件的全部内容。现在我们只想渲染一帧,所以我们需要一个从 0,0 开始并渲染宽度和高度为 16 的矩形。我们创建的精灵表是水平条形精灵表,这意味着每一帧都按顺序排列并水平放置。要渲染动画的不同帧,我们只需要修改源矩形中的.x值。我们添加的最后一个属性是公共部分的m_CurrentFrame属性。它跟踪我们当前所处动画的帧。当我们不渲染爆炸动画时,我们将保持当前帧为 0。

接下来,我们需要修改Projectile类上的几个函数。这些函数是projectile.cpp文件中的Projectile::Move函数和Projectile::Render函数。这是Projectile::Move函数的新版本:

void Projectile::Move() {
    if( m_CurrentFrame > 0 ) {
        m_NextFrameTime -= diff_time;
        if( m_NextFrameTime <= 0 ) {
            ++m_CurrentFrame;
            m_NextFrameTime = ms_per_frame;
            if( m_CurrentFrame >= 4 ) {
                m_Active = false;
                m_CurrentFrame = 0;
                return;
            }
        }
        return;
    }
    m_X += m_VX;
    m_Y += m_VY;
    m_TTL -= diff_time;
    if( m_TTL < 0 ) {
        m_Active = false;
        m_TTL = 0;
    }
}

Move函数的顶部部分都是新的。如果当前帧不是0,我们将运行动画直到结束,然后停用我们的抛射物,将其发送回抛射物池。我们通过减去自上次应用程序运行游戏循环以来的时间来实现这一点。这是存储在diff_time全局变量中的值。m_NextFrameTime属性变量存储了切换到我们系列中下一帧的毫秒数。一旦值低于 0,我们就会增加当前帧并将m_NextFrameTime重置为我们希望在动画的每一帧之间的毫秒数。现在我们已经增加了当前动画帧,我们可以检查它是否大于或等于此动画中最后一帧的帧数(在本例中为 4)。如果是,我们需要停用抛射物并将当前帧重置为 0。

现在,我们已经对Move()函数进行了所需的更改,接下来我们需要对Projectile::Render()函数进行以下更改:

void Projectile::Render() {
    dest.x = m_X + 8;
    dest.y = m_Y + 8;
    dest.w = c_Width;
    dest.h = c_Height;
    src.x = 16 * m_CurrentFrame;
    int return_val = SDL_RenderCopy( renderer, m_SpriteTexture,
                                    &src, &dest );
    if( return_val != 0 ) {
        printf("SDL_Init failed: %s\n", SDL_GetError());
    }
}

Render函数的第一个更改是在SDL_RenderCopy调用中添加了src矩形,并在该调用的上方立即设置了它的x值。我们的精灵表中的每一帧都是 16 像素宽,所以将x值设置为16 * m_CurrentFrame将从精灵表中选择一个不同的 16 x 16 精灵。该矩形的宽度和高度将始终为 16,y值将始终为 0,因为我们将精灵放入这个精灵表中作为水平条带。

现在我们要对game.hpp文件中的Ship类定义进行一些修改:

class Ship: public Collider {
    public:
        Uint32 m_LastLaunchTime;
        const int c_Width = 32;
        const int c_Height = 32;

        SDL_Texture *m_SpriteTexture;
        SDL_Rect src = {.x = 0, .y = 0, .w = 32, .h = 32 };
        bool m_Alive = true;
        Uint32 m_CurrentFrame = 0;
        int m_NextFrameTime;

        float m_Rotation;
        float m_DX;
        float m_DY;
        float m_VX;
        float m_VY;

        void RotateLeft();
        void RotateRight();
        void Accelerate();
        void Decelerate();
        void CapVelocity();

        virtual void Move() = 0;
        Ship();
        void Render();
};

我们修改了宽度和高度常量以反映精灵表中新的精灵大小为 32 x 32 像素。我们还必须为Projectile类添加一个源矩形。在我们的公共属性部分,我们添加了一些变量来跟踪飞船的存活或死亡状态(m_Alive);游戏正在渲染的当前帧(m_CurrentFrame);以及直到渲染下一帧的毫秒数(m_NextFrameTime)。接下来,我们将对ship.cpp文件进行必要的修改。我们需要修改Ship::Render函数:

void Ship::Render() {
    if( m_Alive == false ) {
        return;
    }
    dest.x = (int)m_X;
    dest.y = (int)m_Y;
    dest.w = c_Width;
    dest.h = c_Height;

    src.x = 32 * m_CurrentFrame;
    float degrees = (m_Rotation / PI) * 180.0;
    int return_code = SDL_RenderCopyEx( renderer, m_SpriteTexture,
                                    &src, &dest,
                                    degrees, NULL, SDL_FLIP_NONE );
    if( return_code != 0 ) {
        printf("failed to render image: %s\n", IMG_GetError() );
    }
}

在函数顶部,我们添加了代码来检查飞船当前是否存活。如果不是,我们就不想渲染飞船,所以我们返回。稍后,我们将源矩形x值设置为当前帧的 32 倍,代码如下:src.x = 32 * m_CurrentFrame;。这样我们的渲染就会根据我们想要渲染的帧来渲染来自精灵表的不同的 32 x 32 像素块。最后,我们必须将src矩形传递给SDL_RenderCopyEx调用。

现在我们已经修改了Ship类,我们将改变EnemyShip类定义和PlayerShip类定义,以使用我们的精灵表 PNG 文件,而不是旧的单个精灵文件。以下是game.hpp文件中这两个类定义的修改:

class PlayerShip: public Ship {
    public:
        const char* c_SpriteFile = "sprites/FranchiseExp.png";
        const Uint32 c_MinLaunchTime = 300;
        PlayerShip();
        void Move();
};

class EnemyShip: public Ship {
    public:
        const char* c_SpriteFile = "sprites/BirdOfAngerExp.png";
        const Uint32 c_MinLaunchTime = 300;
        const int c_AIStateTime = 2000;

        FSM_STUB m_AIState;
        int m_AIStateTTL;

        EnemyShip();
        void AIStub();
        void Move();
};

对这些类定义的唯一更改是在每个类中的c_SpriteFile常量的值。PlayerShip类中的c_SpriteFile常量从"sprites/Franchise.png"修改为"sprites/FranchiseExp.png"EnemyShip中的c_SpriteFile常量从"sprites/BirdOfAnger.png"修改为"sprites/BirdOfAngerExp.png"。现在我们已经做出了这个改变,这些类将使用精灵表.png文件而不是原始精灵文件。

现在我们已经修改了这些类的定义,我们必须改变它们的Move函数。首先,我们将修改enemy_ship.cpp文件中的EnemyShip::Move函数:

void EnemyShip::Move() {
    if( m_Alive == false ) {
        return;
    }
    AIStub();

    if( m_AIState == TURN_LEFT ) {
        RotateLeft();
    }
    if( m_AIState == TURN_RIGHT ) {
        RotateRight();
    }
    if( m_AIState == ACCELERATE ) {
        Accelerate();
    }
    if( m_AIState == DECELERATE ) {
        Decelerate();
    }

    if( m_CurrentFrame > 0 ) {
        m_NextFrameTime -= diff_time;

        if( m_NextFrameTime <= 0 ) {
            m_NextFrameTime = ms_per_frame;
            if( ++m_CurrentFrame >= 8 ) {
                m_Alive = false;
                return;
            }
        }
    }
    CapVelocity();

    m_X += m_VX;

    if( m_X > 320 ) {
        m_X = -16;
    }
    else if( m_X < -16 ) {
        m_X = 320;
    }

    m_Y += m_VY;

    if( m_Y > 200 ) {
        m_Y = -16;
    }
    else if( m_Y < -16 ) {
        m_Y = 200;
    }

    if( m_AIState == SHOOT ) {
        Projectile* projectile;
        if( current_time - m_LastLaunchTime >= c_MinLaunchTime ) {
            m_LastLaunchTime = current_time;
            projectile = projectile_pool->GetFreeProjectile();

            if( projectile != NULL ) {
                projectile->Launch( m_X, m_Y, m_DX, m_DY );
            }
        }
    }
}

有两个地方需要更改代码。首先,如果敌方飞船不再存活,我们不想执行任何Move函数的工作,所以我们在函数开头添加了这个检查来返回,如果飞船不再存活:

if( m_Alive == false ) {
    return;
}

接下来,我们需要添加代码来检查是否需要运行死亡动画。如果当前帧大于 0,我们就会这样做。这一部分的代码与我们为抛射物运行死亡动画所做的类似。我们从下一帧时间(m_NextFrameTime)中减去帧之间的时间(diff_time),以确定是否需要增加帧数。当这个值低于 0 时,帧数准备好改变,通过增加m_CurrentFrame,然后我们通过将其设置为每帧之间的毫秒数(ms_per_frame)来重置m_NextFrameTime倒计时器。如果我们当前的帧达到了我们帧精灵表的末尾,(++m_CurrentFrame >= 8),那么我们将敌方飞船设置为不再存活,(m_Alive = false)。如下所示:

if( m_CurrentFrame > 0 ) {
    m_NextFrameTime -= diff_time;
    if( m_NextFrameTime <= 0 ) {
        m_NextFrameTime = ms_per_frame;
        if( ++m_CurrentFrame >= 8 ) {
            m_Alive = false;
            return;
        }
    }
}

现在,我们将对player_ship.cpp文件中的PlayerShip::Move函数进行相同的更改:

void PlayerShip::Move() {
    if( m_Alive == false ) {
        return;
    }
    if( left_key_down ) {
        RotateLeft();
    }
    if( right_key_down ) {
        RotateRight();
    }
    if( up_key_down ) {
        Accelerate();
    }
    if( down_key_down ) {
        Decelerate();
    }
    if( m_CurrentFrame > 0 ) {
        m_NextFrameTime -= diff_time;
        if( m_NextFrameTime <= 0 ) {
            m_NextFrameTime = ms_per_frame;
            if( ++m_CurrentFrame >= 8 ) {
                m_Alive = false;
                return;
            }
        }
    }
    CapVelocity();
    m_X += m_VX;

    if( m_X > 320 ) {
        m_X = -16;
    }
    else if( m_X < -16 ) {
        m_X = 320;
    }

    m_Y += m_VY;

    if( m_Y > 200 ) {
        m_Y = -16;
    }
    else if( m_Y < -16 ) {
        m_Y = 200;
    }

    if( space_key_down ) {
        Projectile* projectile;
        if( current_time - m_LastLaunchTime >= c_MinLaunchTime ) {
            m_LastLaunchTime = current_time;
            projectile = projectile_pool->GetFreeProjectile();
            if( projectile != NULL ) {
                projectile->Launch( m_X, m_Y, m_DX, m_DY );
            }
        }
    }
}

就像在我们的EnemyShip::Move函数中一样,我们添加了一个检查,看玩家是否还活着,代码如下:

if( m_Alive == false ) {
    return;
}

我们还添加了一些代码,如果当前帧大于 0,就运行死亡动画:

if( m_CurrentFrame > 0 ) {
    m_NextFrameTime -= diff_time;
    if( m_NextFrameTime <= 0 ) {
        m_NextFrameTime = ms_per_frame;
        if( ++m_CurrentFrame >= 8 ) {
            m_Alive = false;
            return;
        }
    }
}

我们需要做的最后一件事是修改我们之前添加到ProjectilePool::MoveProjectiles函数中的碰撞检测代码,以便在两者碰撞时运行飞船和抛射物的死亡动画。这是projectile_pool.cpp文件中ProjectilePool::MoveProjectiles的新版本:

void ProjectilePool::MoveProjectiles() {
    Projectile* projectile;
    std::vector<Projectile*>::iterator it;
    for( it = m_ProjectileList.begin(); it != m_ProjectileList.end(); it++ ) {
        projectile = *it;
        if( projectile->m_Active ) {
            projectile->Move();
            if( projectile->m_CurrentFrame == 0 &&
                player->m_CurrentFrame == 0 &&
                projectile->HitTest( player ) ) {

                player->m_CurrentFrame = 1;
                player->m_NextFrameTime = ms_per_frame;
                projectile->m_CurrentFrame = 1;
                projectile->m_NextFrameTime = ms_per_frame;
            }
            if( projectile->m_CurrentFrame == 0 &&
                enemy->m_CurrentFrame == 0 &&
                projectile->HitTest( enemy ) ) {

                enemy->m_CurrentFrame = 1;
                enemy->m_NextFrameTime = ms_per_frame;
                projectile->m_CurrentFrame = 1;
                projectile->m_NextFrameTime = ms_per_frame;
            }
        }
    }
}

在这段代码中,每次移动抛射物时,我们都会对该抛射物和玩家进行碰撞测试,以及对该抛射物和敌人进行碰撞测试。如果飞船或抛射物正在运行死亡动画(m_CurrentFrame == 0为 false),那么我们就不需要运行碰撞测试,因为飞船或抛射物已经被摧毁。如果碰撞测试返回 true,那么我们需要将抛射物和飞船的当前帧都设置为 1,开始摧毁动画。我们还需要将下一帧时间设置为直到帧变化的毫秒数。

现在我们已经添加了所有这些新代码,飞船和敌人飞船将运行一个爆炸动画,当被击中时摧毁飞船。抛射物也会爆炸而不是只是消失。圆形碰撞器速度很快,但不太精确。在实现复合圆形碰撞器部分,我们将学习需要进行的修改,以便在单个飞船上使用多个圆形碰撞器。这将使我们的碰撞看起来比简单的圆更准确。

内存中的指针

WebAssembly 的内存模型基于 asm.js 内存模型,后者使用一个大型的类型化ArrayBuffer来保存模块要操作的所有原始字节。JavaScript 调用WebAssembly.Memory设置模块的内存缓冲区为 64KB 的页面

页面是线性数据块,是操作系统或 WebAssembly 虚拟机分配的最小数据单元。有关内存页面的更多信息,请参阅维基百科页面:en.wikipedia.org/wiki/Page_%28computer_memory%29

WebAssembly 模块只能访问ArrayBuffer中的数据。这可以防止 WebAssembly 对浏览器沙盒之外的内存地址进行恶意攻击。由于这种设计,WebAssembly 的内存模型与 JavaScript 一样安全。

在下一节中,我们将在collider对象中使用 C++指针。如果您是 JavaScript 开发人员,您可能不熟悉指针。指针是一个保存内存位置而不是直接值的变量。让我们看一些代码:

int VAR1 = 1;
int* POINTER = &VAR1;

在这段代码中,我们创建了一个名为VAR1的变量,并给它赋了一个值 1。在第二行,我们使用int*创建了一个名为POINTER的指针。然后我们使用&字符将该指针初始化为VAR1的地址,这在 C++中被称为地址运算符。这个运算符给出了我们之前声明的VAR1的地址。如果我们想要改变VAR1,我们可以使用指针而不是直接改变,如下所示:

*POINTER = 2;
 printf("VAR1=%d\n", VAR1); // prints out "VAR1=2"

POINTER前面加上*告诉 C++设置内存地址中POINTER指向的值;在这种情况下使用的*被称为解引用运算符

如果您想了解有关 C++中指针及其工作原理的更多信息,以下文章详细介绍了这个主题:www.cplusplus.com/doc/tutorial/pointers/

在下一节中,我们将为太空飞船的碰撞检测实现复合圆形碰撞器。

实现复合圆形碰撞器

现在我们的碰撞检测已经起作用,我们的飞船和抛射物在碰撞时爆炸,让我们看看如何使我们的碰撞检测更好。我们选择圆形碰撞检测有两个原因:碰撞算法快速且简单。然而,我们可以通过简单地为每艘飞船添加更多的圆形来做得更好。这将使我们的碰撞检测时间增加n倍,其中n是我们每艘飞船上平均圆形的数量。这是因为我们只进行抛射物和飞船之间的碰撞检测。即使如此,我们也不希望在选择用于每艘飞船的圆形数量上过火。

对于玩家飞船,飞船的前部由基本圆形很好地覆盖。然而,通过在每一侧添加一个圆形,我们可以更好地覆盖玩家飞船的后部:

[我们的玩家飞船复合碰撞器]

敌方飞船则相反。飞船的后部被默认圆形很好地覆盖,但前部需要更好的覆盖,因此对于敌方飞船,我们将在前部添加一些额外的圆形:

[我们的敌方飞船复合碰撞器]

我们需要做的第一件事是改变Collider类,以包括来自我们碰撞器父级的信息。以下是我们game.hpp文件中Collider类定义的新版本:

class Collider {
    public:
        float* m_ParentRotation;
        float* m_ParentX;
        float* m_ParentY;
        float m_X;
        float m_Y;
        float m_Radius;

        bool CCHitTest( Collider* collider );
        void SetParentInformation( double* rotation, double* x, double* 
                                   y );
        Collider(double radius);
        bool HitTest( Collider *collider );
};

我们已经为我们的Collider类的父级属性添加了三个指针。这些指针将指向碰撞器的父级的xy坐标,以及Rotation,它可能是敌方飞船、玩家飞船或NULL。我们将在构造函数中将这些值初始化为NULL,如果该值为 null,我们将不修改碰撞器的行为。然而,如果这些值设置为其他值,我们将调用CCHitTest函数来确定是否有碰撞。这个碰撞测试的版本将在进行碰撞测试之前,调整碰撞器的位置,使其相对于其父级的位置和旋转。现在我们已经对碰撞器的定义进行了更改,我们将对collider.cpp文件中的函数进行更改,以支持新的复合碰撞器。

首先要做的是修改我们的构造函数,将新指针初始化为NULL

Collider::Collider(double radius) {
    m_ParentRotation = NULL;
    m_ParentX = NULL;
    m_ParentY = NULL;
    m_Radius = radius;
}

我们有一个新的函数要添加到我们的collider.cpp文件中,即CCHitTest函数,它将是我们的复合碰撞器碰撞测试。这个碰撞测试的版本将调整我们的碰撞器的xy坐标,使其相对于父级飞船的位置和旋转:

bool Collider::CCHitTest( Collider* collider ) {
    float sine = sin(*m_ParentRotation);
    float cosine = cos(*m_ParentRotation);
    float rx = m_X * cosine - m_Y * sine;
    float ry = m_X * sine + m_Y * cosine;
    float dist_x = (*m_ParentX + rx) - collider->m_X;
    float dist_y = (*m_ParentY + ry) - collider->m_Y;
    float radius = m_Radius + collider->m_Radius;

    if( dist_x * dist_x + dist_y * dist_y <= radius * radius ) {
        return true;
    }
    return false;
}

这个函数的第一件事是取父级旋转的正弦和余弦,并使用该旋转来得到变量rxryxy的旋转版本。然后我们调整旋转后的xy位置,通过父级的xy位置,然后计算两个碰撞器xy位置之间的距离。在我们添加了这个新的CCHitTest函数之后,我们需要修改HitTest函数,以便在设置了父级值时调用这个版本的碰撞测试。以下是HitTest的最新版本:

bool Collider::HitTest( Collider *collider ) {
    if( m_ParentRotation != NULL && m_ParentX != NULL && m_ParentY !=         NULL ) {
        return CCHitTest( collider );
    }

    float dist_x = m_X - collider->m_X;
    float dist_y = m_Y - collider->m_Y;
    float radius = m_Radius + collider->m_Radius;

    if( dist_x * dist_x + dist_y * dist_y <= radius * radius ) {
        return true;
    }
    return false;
}

我们创建了一个名为SetParentInformation的函数来设置所有这些值。以下是函数定义:

void Collider::SetParentInformation( float* rotation, float* x, float* y ) {
    m_ParentRotation = rotation;
    m_ParentX = x;
    m_ParentY = y;
}

为了利用这些新类型的碰撞器,我们需要在Ship类中添加一个新的碰撞器向量。以下是game.hpp文件中Ship的新类定义:

class Ship : public Collider {
    public:
        Uint32 m_LastLaunchTime;
        const int c_Width = 32;
        const int c_Height = 32;

        SDL_Texture *m_SpriteTexture;
        SDL_Rect src = {.x = 0, .y = 0, .w = 32, .h = 32 };
        std::vector<Collider*> m_Colliders;
        bool m_Alive = true;
        Uint32 m_CurrentFrame = 0;

        int m_NextFrameTime;
        float m_Rotation;
        float m_DX;
        float m_DY;
        float m_VX;
        float m_VY;

        void RotateLeft();
        void RotateRight();
        void Accelerate();
        void Decelerate();
        void CapVelocity();
        virtual void Move() = 0;
        Ship();
        void Render();
        bool CompoundHitTest( Collider* collider );
};

这个版本和Ship类的上一个版本之间有两个不同之处。第一个是添加了m_Colliders向量属性:

 std::vector<Collider*> m_Colliders;

第二个变化是在类底部添加的新的CompoundHitTest函数:

bool CompoundHitTest( Collider* collider );

对于我们的类的更改,我们需要在ship.cpp文件中添加一个新的函数:

bool Ship::CompoundHitTest( Collider* collider ) {
    Collider* col;
    std::vector<Collider*>::iterator it;
    for( it = m_Colliders.begin(); it != m_Colliders.end(); it++ ) {
        col = *it;
        if( col->HitTest(collider) ) {
            return true;
        }
    }
    return false;
}

这个CompoundHitTest函数是一个非常简单的函数,它循环遍历我们的额外碰撞器并对它们执行碰撞测试。这一行创建了一个碰撞器指针的向量。现在我们将修改EnemyShipPlayerShip构造函数,将一些碰撞器添加到这个向量中。首先,我们将在enemy_ship.cpp文件中的EnemyShip构造函数中添加一些新的行:

EnemyShip::EnemyShip() {
    m_X = 60.0;
    m_Y = 50.0;
    m_Rotation = PI;
    m_DX = 0.0;
    m_DY = 1.0;
    m_VX = 0.0;
    m_VY = 0.0;
    m_AIStateTTL = c_AIStateTime;
    m_Alive = true;
    m_LastLaunchTime = current_time;

    Collider* temp_collider = new Collider(2.0);
    temp_collider->SetParentInformation( &(this->m_Rotation),
                                         &(this->m_X), &(this->m_Y) );
    temp_collider->m_X = -6.0;
    temp_collider->m_Y = -6.0;
    m_Colliders.push_back( temp_collider );
    temp_collider = new Collider(2.0);
    temp_collider->SetParentInformation( &(this->m_Rotation),
                                         &(this->m_X), &(this->m_Y) );
    temp_collider->m_X = 6.0;
    temp_collider->m_Y = -6.0;
    m_Colliders.push_back( temp_collider );

    SDL_Surface *temp_surface = IMG_Load( c_SpriteFile );

    if( !temp_surface ) {
        printf("failed to load image: %s\n", IMG_GetError() );
        return;
    }
    else {
        printf("success creating enemy ship surface\n");
    }
    m_SpriteTexture = SDL_CreateTextureFromSurface( renderer, 
    temp_surface );
    if( !m_SpriteTexture ) {
        printf("failed to create texture: %s\n", IMG_GetError() );
        return;
    }
    else {
        printf("success creating enemy ship texture\n");
    }
    SDL_FreeSurface( temp_surface );
}

我们添加的代码创建了新的碰撞器,并将这些碰撞器的父级信息设置为指向该对象内部的xy坐标以及半径的地址。我们将这个碰撞器的m_Xm_Y值相对于该对象的位置进行设置,然后将新的碰撞器推入m_Colliders向量属性中。

Collider* temp_collider = new Collider(2.0);
temp_collider->SetParentInformation( &(this->m_Rotation),
                                     &(this->m_X), &(this->m_Y) );
temp_collider->m_X = -6.0;
temp_collider->m_Y = -6.0;
m_Colliders.push_back( temp_collider );
temp_collider = new Collider(2.0);
temp_collider->SetParentInformation( &(this->m_Rotation),
                                     &(this->m_X), &(this->m_Y) );
temp_collider->m_X = 6.0;
temp_collider->m_Y = -6.0;
m_Colliders.push_back( temp_collider );

现在我们将在player_ship.cpp文件中对PlayerShip构造函数做类似的事情:

PlayerShip::PlayerShip() {
    m_X = 160.0;
    m_Y = 100.0;
    SDL_Surface *temp_surface = IMG_Load( c_SpriteFile );

    Collider* temp_collider = new Collider(3.0);
    temp_collider->SetParentInformation( &(this->m_Rotation),
                                         &(this->m_X), &(this->m_Y) );
    temp_collider->m_X = -6.0;
    temp_collider->m_Y = 6.0;
    m_Colliders.push_back( temp_collider );
    temp_collider = new Collider(3.0);
    temp_collider->SetParentInformation( &(this->m_Rotation),
                                         &(this->m_X), &(this->m_Y) );
    temp_collider->m_X = 6.0;
    temp_collider->m_Y = 6.0;
    m_Colliders.push_back( temp_collider );

    if( !temp_surface ) {
        printf("failed to load image: %s\n", IMG_GetError() );
        return;
    }
    m_SpriteTexture = SDL_CreateTextureFromSurface( renderer, 
    temp_surface );

    if( !m_SpriteTexture ) {
        printf("failed to create texture: %s\n", IMG_GetError() );
        return;
    }
    SDL_FreeSurface( temp_surface );
}

现在,我们必须修改我们的抛射物池,以在我们的飞船中对这些新的复合碰撞器进行碰撞检测。以下是projectile_pool.cpp文件中MoveProjectiles函数的修改版本:

void ProjectilePool::MoveProjectiles() {
    Projectile* projectile;
    std::vector<Projectile*>::iterator it;

    for( it = m_ProjectileList.begin(); it != m_ProjectileList.end(); 
         it++ ) {
        projectile = *it;
        if( projectile->m_Active ) {
            projectile->Move();
            if( projectile->m_CurrentFrame == 0 &&
                player->m_CurrentFrame == 0 &&
                ( projectile->HitTest( player ) ||
                  player->CompoundHitTest( projectile ) ) ) {
                player->m_CurrentFrame = 1;
                player->m_NextFrameTime = ms_per_frame;
                projectile->m_CurrentFrame = 1;
                projectile->m_NextFrameTime = ms_per_frame;
            }
            if( projectile->m_CurrentFrame == 0 &&
                enemy->m_CurrentFrame == 0 &&
                ( projectile->HitTest( enemy ) ||
                  enemy->CompoundHitTest( projectile ) ) ) {
                enemy->m_CurrentFrame = 1;
                enemy->m_NextFrameTime = ms_per_frame;
                projectile->m_CurrentFrame = 1;
                projectile->m_NextFrameTime = ms_per_frame;
            }
        }
    }
}

因为我们在Ship类中继承了Collider,所以我们仍然会对玩家和敌人的飞船执行常规的碰撞测试。我们在Ship类中添加了对CompoundHitTest的调用,它循环遍历我们的m_Colliders向量,并对该向量中的每个碰撞器执行碰撞测试。

我们的复合碰撞器解决方案并不是通用的,大部分情况下,我们的碰撞检测也不是通用的。我们只检测飞船和抛射物之间的碰撞。我们目前没有执行任何飞船之间的碰撞检测。要实现通用的碰撞检测方法,我们需要实现空间分割。这将防止随着每个额外的碰撞器添加到我们的游戏中,碰撞检测数量呈指数级增长。

编译 collider.html

我们用来编译collider.html文件的命令与上一章中的编译命令类似。我们需要在命令行中添加一个新的collider.cpp文件,但除此之外应该是一样的。以下是编译collider.html所使用的命令:

em++ main.cpp collider.cpp ship.cpp enemy_ship.cpp player_ship.cpp projectile.cpp projectile_pool.cpp -std=c++17 --preload-file sprites -s USE_WEBGL2=1 -s USE_SDL=2 -s USE_SDL_IMAGE=2 -s SDL2_IMAGE_FORMATS=["png"] -o collider.html

现在我们已经编译了collider.html,我们可以从我们选择的 Web 服务器中提供它,或者使用emrun运行它,并将其加载到 Web 浏览器中。这是它的样子:

[当被抛射物击中时,敌方飞船会爆炸]

请记住,您必须使用 Web 服务器或emrun来运行 WebAssembly 应用程序。如果您想使用emrun运行 WebAssembly 应用程序,您必须使用--emrun标志进行编译。Web 浏览器需要一个 Web 服务器来流式传输 WebAssembly 模块。如果您尝试直接从硬盘驱动器在浏览器中打开使用 WebAssembly 的 HTML 页面,那么 WebAssembly 模块将无法加载。

我没有像之前游戏截图那样截取整个浏览器,因为我想放大玩家飞船摧毁敌方飞船的画面。正如你所看到的,我们现在有了可以检测抛射物何时与飞船碰撞并在碰撞发生时摧毁飞船的碰撞器,从而运行爆炸动画。

总结

圆形碰撞体是我们现在需要的。它们快速高效,对于这样一个简单的游戏,你可能可以不用做更复杂的事情就能逃脱。我们添加了一个复合碰撞体来演示这个简单修改如何显著增加碰撞体的准确性。我们将在本书的后面添加更多的碰撞检测方法。在未来,我们将在游戏中添加小行星和一颗星星,并创建一个AI人工智能)代理来导航我们的游戏并攻击我们的玩家。这个代理最终需要知道它是否与玩家有视线,因此线碰撞检测将变得更加重要。我们的代理还希望快速扫描其附近的区域,以查看是否有任何必须避开的小行星。对于这个功能,我们将使用矩形碰撞。

2D 游戏有许多种碰撞检测技术,在本章中我们只是触及了皮毛。我们学会了如何实现一些基本的圆形碰撞体和复合碰撞体,并添加了代码来检测游戏中抛射物与玩家和敌人飞船之间的碰撞。这些类型的碰撞体快速而相对容易实现,但它们并非没有缺点。

你可能会注意到我们实现的简单碰撞体的一个缺点是,如果两个对象以足够高的相对速度相互穿过,它们可能会在不发生碰撞的情况下相互穿过。这是因为我们的对象在每一帧都有一个新的位置计算,并且它们不是连续地从 A 点移动到 B 点。如果需要一帧的时间从 A 点移动到 B 点,那么对象在两个点之间有效地传送。如果在这两个点之间有第二个对象,但当在 A 点或 B 点时我们没有与该对象发生碰撞,那么对象碰撞就会被忽略。这在我们的游戏中不应该是一个问题,因为我们将保持我们的最大对象速度相对较低。然而,在编写游戏时要记住这一点。

在下一章中,我们将构建一个工具来帮助我们配置粒子系统

基本粒子系统

粒子系统是一种图形技术,我们从发射器中发射大量精灵,并使这些精灵经历一个生命周期,在这个过程中它们以各种方式改变。我们在精灵的生命周期中加入了一些随机性,以创建各种有趣的效果,如爆炸、火花、雪、灰尘、火、发动机排气等。一些粒子效果可以与它们的环境互动。在我们的游戏中,我们将使用粒子效果来创建漂亮的发动机排气和飞船爆炸效果。

在本章中,您需要在构建中包含几个图像,以使该项目正常工作。确保您从项目的 GitHub 中包含/Chapter08/sprites/文件夹。如果您还没有下载 GitHub 项目,可以在这里在线获取:github.com/PacktPublishing/Hands-On-Game-Develop

这一章和下一章的开始起初会感觉像是一个离题。在接下来的两章中,我们将花费大量时间来处理游戏之外的内容。如果您对粒子系统感兴趣,我保证这将是值得的。当您创建一个粒子系统时,您会花费大量时间来调整它们,并玩耍以使它们看起来正确。在游戏中直接进行这样的操作将导致大量的编译和测试。我们需要的是一个工具,可以在将粒子系统添加到游戏之前配置和测试粒子系统。这一章和下一章的前半部分致力于构建这个工具。如果您对学习如何构建这个工具不感兴趣,您可以略过本章的文本,并从 GitHub 下载并编译该工具。如果您对学习 JavaScript、HTML 和 WebAssembly 如何在应用程序中交互感兴趣,本章和第九章 改进的粒子系统的前半部分是一个很好的教程,可以教您如何编写一个应用程序,而不仅仅是一个带有 WebAssembly 的游戏。

在本章中,我们将涵盖以下主题:

  • SVG 简介

  • 再次三角函数?

  • 添加 JavaScript

  • 简单的粒子发射器工具

  • Point 类

  • 粒子类

  • 发射器类

  • WebAssembly 接口函数

  • 编译和测试粒子发射器

添加到虚拟文件系统

这一部分将是一个简短的离题,因为我想花时间创建一个粒子系统设计工具,这将需要我们向 WebAssembly 虚拟文件系统添加文件。我们将添加一个类型为文件的输入元素,我们可以使用它将图像加载到虚拟文件系统中。我们需要检查正在加载的文件,以验证它是否是.png文件,如果是,我们将使用 WebAssembly 和 SDL 在画布上绘制和移动图像。

Emscripten 默认不会创建虚拟文件系统。因为我们需要使用一个最初没有任何内容的虚拟文件系统,我们需要向 em++传递以下标志,以强制 Emscripten 构建虚拟文件系统:-s FORCE_FILESYSTEM=1

我们将首先从第二章 HTML5 和 WebAssembly中复制canvas_shell.html,并使用它创建一个名为upload_shell.html的新 shell 文件。我们需要在处理文件加载的 JavaScript 中添加一些代码,并将该文件插入到 WebAssembly 虚拟文件系统中。我们还需要添加一个 HTML input元素,类型为file,直到Module对象加载完成才会显示。在下面的代码中,我们有新的 shell 文件:

<!doctype html><html lang="en-us">
<head><meta charset="utf-8"><meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <title>Upload Shell</title>
    <link href="upload.css" rel="stylesheet" type="text/css">
</head>
<body>
    <canvas id="canvas" width="800" height="600" 
     oncontextmenu="event.preventDefault()"></canvas>
    <textarea class="em_textarea" id="output" rows="8"></textarea>
    <script type='text/javascript'>
        var canvas = null;
        var ctx = null;
        function ShowFileInput()         
            {document.getElementById("file_input_label")
            .style.display="block";}
        var Module = {
            preRun: [],
            postRun: [ShowFileInput],
            print: (function() {
                var element = document.getElementById('output');
                if (element) element.value = '';
                return function(text) {
                    if (arguments.length > 1)         
                    text=Array.prototype.slice.call(arguments).join('                     
                    ');
                    console.log(text);
                    if (element) {
                        element.value += text + "\n";
                        element.scrollTop = element.scrollHeight;
                } }; })(),
    printErr: function(text) {
        if (arguments.length > 1) 
        text=Array.prototype.slice.call(arguments).join(' ');
        if (0) { dump(text + '\n'); } 
        else { console.error(text); } },
    canvas: (function() {
        var canvas = document.getElementById('canvas');
        canvas.addEventListener("webglcontextlost", function(e) { 
        alert('WebGL context lost. You will need to reload the page.'); 
        e.preventDefault(); }, false);
        return canvas; })(),
    setStatus: function(text) {
        if (!Module.setStatus.last) Module.setStatus.last = { time: 
            Date.now(), text: '' };
        if (text === Module.setStatus.last.text) return;
        var m = text.match(/([^(]+)\((\d+(\.\d+)?)\/(\d+)\)/);
        var now = Date.now();
        if (m && now - Module.setStatus.last.time < 30) return;
        Module.setStatus.last.time = now;
        Module.setStatus.last.text = text;
        if (m) { text = m[1]; }
        console.log("status: " + text);
    },
    totalDependencies: 0,
    monitorRunDependencies: function(left) {
        this.totalDependencies = Math.max(this.totalDependencies,left);
        Module.setStatus(left ? 'Preparing... (' + 
        (this.totalDependencies-left) + '/' +
         this.totalDependencies + ')' : 'All downloads complete.'); }
};
Module.setStatus('Downloading...');
window.onerror = function() {
    Module.setStatus('Exception thrown, see JavaScript console');
    Module.setStatus = function(text) { if (text) Module.printErr('[post-exception status] ' + text); };
};
function handleFiles(files) {
    var file_count = 0;
    for (var i = 0; i < files.length; i++) {
        if (files[i].type.match(/image.png/)) {
            var file = files[i];
            console.log("file name=" + file.name);
            var file_name = file.name;
            var fr = new FileReader();
            fr.onload = function (file) {
                var data = new Uint8Array(fr.result);
                Module.FS_createDataFile('/', file_name, data, true, 
                true, true);
                Module.ccall('add_image', 'undefined', ["string"], 
                [file_name]);
            };
            fr.readAsArrayBuffer(files[i]);
        }
    }
}
</script>
<input type="file" id="file_input" onchange="handleFiles(this.files)" />
<label for="file_input" id="file_input_label">Upload .png</label>
{{{ SCRIPT }}}
</body></html>

在头部,我们唯一做的更改是标题和样式表:

<title>Upload Shell</title>
<link href="upload.css" rel="stylesheet" type="text/css">

body标签中,我们不会对canvastextarea元素进行更改,但是 JavaScript 部分有显著的变化。我们将要做的第一件事是向 JavaScript 添加一个ShowFileInput函数,以显示file_input_label元素,该元素在我们的 CSS 中是隐藏的。您可以在以下代码片段中看到它:

function ShowFileInput() {
    document.getElementById("file_input_label").style.display = "block";
}

var Module = {
    preRun: [],
    postRun: [ShowFileInput],

请注意,我们已经在postRun数组中添加了对此函数的调用,以便在模块加载后运行。这是为了确保在Module对象加载之前没有人加载图像文件,而我们的页面可以处理它。除了将ShowFileInput添加到postRun数组中,Module对象保持不变。在Module对象代码之后,我们添加了一个handleFiles函数,当用户选择要加载的新文件时,文件输入元素将调用该函数。以下是该函数的代码:

function handleFiles(files) {
    var file_count = 0;
    for (var i = 0; i < files.length; i++) {
        if (files[i].type.match(/image.png/)) {
            var file = files[i];
            var file_name = file.name;
            var fr = new FileReader();

            fr.onload = function (file) {
                var data = new Uint8Array(fr.result);
                Module.FS_createDataFile('/', file_name, data, true, 
                true, true);
                Module.ccall('add_image', 'undefined', ["string"], 
                [file_name]);
            };
            fr.readAsArrayBuffer(files[i]);
        }
    }
}

您会注意到,该函数设计为通过循环遍历传入handleFilesfiles参数来处理多个文件。我们将首先检查图像文件类型是否为 PNG。在编译 WebAssembly 时,我们需要告诉它 SDL 将处理哪些图像文件类型。PNG 格式应该就足够了,但是在这里添加其他类型并不困难。

如果您不想专门检查 PNG 文件,可以省略匹配字符串的.png部分,然后在编译命令行参数中添加其他文件类型。如果文件是image/png类型,我们将文件名放入其变量file_name中,并创建一个FileReader对象。然后我们定义了FileReader加载文件时运行的函数:

fr.onload = function (file) {
    var data = new Uint8Array(fr.result);
    Module.FS_createDataFile('/', file_name, data, true, true, true);
    Module.ccall('add_image', 'undefined', ["string"], [file_name]);
};

该函数将数据作为 8 位无符号整数数组输入,然后将其传递到Module函数FS_createDataFile中。此函数的参数是一个字符串,表示我们文件的父目录'/',文件名file_name,我们从文件中读取的数据,以及canReadcanWritecanOwn,这些都应设置为true,因为我们希望我们的 WebAssembly 能够读取、写入和拥有此文件。然后,我们使用Module.ccall调用在我们的 WebAssembly 中定义的名为add_image的函数,该函数将获取文件名,以便我们的 WebAssembly 可以使用 SDL 将此图像呈现到 HTML 画布上。在定义告诉FileReader在加载文件时要执行的函数之后,我们必须指示FileReader继续读取已加载的文件作为ArrayBuffer

fr.readAsArrayBuffer(files[i]);

在 JavaScript 之后,我们添加了一个文件input元素和一个相应的标签,如下所示:

<input type="file" id="file_input" onchange="handleFiles(this.files)" />
<label for="file_input" id="file_input_label">Upload .png</label>

标签纯粹是为了样式。在 CSS 中,样式化输入文件元素并不是一件简单的事情。我们稍后会讨论如何做到这一点。在讨论 CSS 之前,我想先讨论一下我们将使用的 WebAssembly C 代码,以使用 SDL 加载和呈现此图像。以下代码将放在我们命名为upload.c的文件中:

#include <emscripten.h>
#include <stdlib.h>
#include <SDL2/SDL.h>
#include <SDL2/SDL_image.h>

SDL_Window *window;
SDL_Renderer *renderer;
char* fileName;
SDL_Texture *sprite_texture = NULL;
SDL_Rect dest = {.x = 160, .y = 100, .w = 16, .h = 16 };

int sprite_x = 0;
int sprite_y = 0;

void add_image(char* file_name) {
    SDL_Surface *temp_surface = IMG_Load( file_name );

    if( !temp_surface ) {
        printf("failed to load image: %s\n", IMG_GetError() );
        return;
    }
    sprite_texture = SDL_CreateTextureFromSurface( renderer, 
    temp_surface );
    SDL_FreeSurface( temp_surface );
    SDL_QueryTexture( sprite_texture,
                        NULL, NULL,
                        &dest.w, &dest.h );
}

void show_animation() {
    if( sprite_texture == NULL ) {
        return;
    }

    SDL_SetRenderDrawColor( renderer, 0, 0, 0, 255 );
    SDL_RenderClear( renderer );

    sprite_x += 2;
    sprite_y++;

    if( sprite_x >= 800 ) {
        sprite_x = -dest.w;
    }

    if( sprite_y >= 600 ) {
        sprite_y = -dest.h;
    }
    dest.x = sprite_x;
    dest.y = sprite_y;

    SDL_RenderCopy( renderer, sprite_texture, NULL, &dest );
    SDL_RenderPresent( renderer );
}

int main() {
    printf("Enter Main\n");
    SDL_Init( SDL_INIT_VIDEO );

    int return_val = SDL_CreateWindowAndRenderer( 800, 600, 0, &window, 
    &renderer );

    if( return_val != 0 ) {
        printf("Error creating renderer %d: %s\n", return_val, 
        IMG_GetError() );
         return 0;
    }
    emscripten_set_main_loop(show_animation, 0, 0);
    printf("Exit Main\n");
    return 1;
}

在我们的新的upload.c文件中,我们定义了三个函数。第一个函数是add_image函数。此函数接受一个代表我们刚刚加载到 WebAssembly 虚拟文件系统中的文件的char*字符串。我们使用 SDL 将图像加载到表面中,然后使用该表面创建一个纹理,我们将使用它来呈现我们加载的图像。第二个函数是show_animation,我们用它来移动画布上的图像。第三个是main函数,它在模块加载时始终运行,因此我们用它来初始化我们的 SDL。

让我们快速看一下add_image函数:

void add_image(char* file_name) {
    SDL_Surface *temp_surface = IMG_Load( file_name );

    if( !temp_surface ) {
        printf("failed to load image: %s\n", IMG_GetError() );
        return;
    }
    sprite_texture = SDL_CreateTextureFromSurface( renderer, 
    temp_surface );
    SDL_FreeSurface( temp_surface );
    SDL_QueryTexture( sprite_texture,
                        NULL, NULL,
                        &dest.w, &dest.h );
}

add_image函数中,我们首先使用传入的file_name参数将图像加载到SDL_Surface对象指针中,使用IMG_Load函数,该函数是SDL_image库的一部分:

SDL_Surface *temp_surface = IMG_Load( file_name );

如果加载失败,我们会打印错误消息并从函数中返回:

if( !temp_surface ) {
    printf("failed to load image: %s\n", IMG_GetError() );
    return;
}

如果没有失败,我们使用表面创建一个纹理,我们将能够在帧动画中渲染它。然后,我们释放表面,因为我们不再需要它:

sprite_texture = SDL_CreateTextureFromSurface( renderer, temp_surface );
SDL_FreeSurface( temp_surface );

我们最后要做的是使用SDL_QueryTexture函数获取图像的宽度和高度,并将这些值加载到dest矩形中:

SDL_QueryTexture( sprite_texture,
                  NULL, NULL,
                  &dest.w, &dest.h );

show_animation函数类似于我们过去编写的其他游戏循环。它应该在每一帧中运行,只要加载了精灵纹理,它应该清除画布,增加精灵的xy值,然后将精灵渲染到画布上:

void show_animation() {
    if( sprite_texture == NULL ) {
        return;
    }

    SDL_SetRenderDrawColor( renderer, 0, 0, 0, 255 );
    SDL_RenderClear( renderer );
    sprite_x += 2;
    sprite_y++;

    if( sprite_x >= 800 ) {
        sprite_x = -dest.w;
    }
    if( sprite_y >= 600 ) {
        sprite_y = -dest.h;
    }

    dest.x = sprite_x;
    dest.y = sprite_y;
    SDL_RenderCopy( renderer, sprite_texture, NULL, &dest );
    SDL_RenderPresent( renderer );
}

show_animation中我们要做的第一件事是检查sprite_texture是否仍然为NULL。如果是,用户尚未加载 PNG 文件,因此我们无法渲染任何内容:

if( sprite_texture == NULL ) {
    return;
}

接下来我们要做的是用黑色清除画布:

SDL_SetRenderDrawColor( renderer, 0, 0, 0, 255 );
SDL_RenderClear( renderer );

然后,我们将增加精灵的xy坐标,并使用这些值来设置dest(目标)矩形:

sprite_x += 2;
sprite_y++;
if( sprite_x >= 800 ) {
    sprite_x = -dest.w;
}
if( sprite_y >= 600 ) {
    sprite_y = -dest.h;
}
dest.x = sprite_x;
dest.y = sprite_y;

最后,我们将精灵渲染到后备缓冲区,然后将后备缓冲区移动到画布上:

SDL_RenderCopy( renderer, sprite_texture, NULL, &dest );
SDL_RenderPresent( renderer );

upload.c中的最后一个函数是main函数,当模块加载时调用。此函数用于初始化目的,如下所示:

int main() {
    printf("Enter Main\n");
    SDL_Init( SDL_INIT_VIDEO );
    int return_val = SDL_CreateWindowAndRenderer( 800, 600, 0, &window, 
    &renderer );

    if( return_val != 0 ) {
        printf("Error creating renderer %d: %s\n", return_val, 
        IMG_GetError() );
        return 0;
    }

    emscripten_set_main_loop(show_animation, 0, 0);
    printf("Exit Main\n");
    return 1;
}

它调用了一些 SDL 函数来初始化我们的 SDL 渲染器:

SDL_Init( SDL_INIT_VIDEO );
int return_val = SDL_CreateWindowAndRenderer( 800, 600, 0, &window, &renderer );

if( return_val != 0 ) {
    printf("Error creating renderer %d: %s\n", return_val, 
    IMG_GetError() );
    return 0;
}

然后,它设置show_animation函数在每次渲染帧时运行:

emscripten_set_main_loop(show_animation, 0, 0);

我们最后要做的是设置一个 CSS 文件,以正确显示我们外壳文件中的 HTML。以下是新的upload.css文件的内容:

body {
    margin-top: 20px;
}
#output {
    background-color: darkslategray;
    color: white;
    font-size: 16px;
    padding: 10px;
    margin-left: auto;
    margin-right: auto;
    display: block;
    width: 780px;
}
#canvas {
    width: 800px;
    height: 600px;
    margin-left: auto;
    margin-right: auto;
    display: block;
    background-color: black;
    margin-bottom: 20px;
}
[type="file"] {
    height: 0;
    overflow: hidden;
    width: 0;
    display: none;
}

[type="file"] + label {
    background: orangered;
    border-radius: 5px;
    color: white;
    display: none;
    font-size: 20px;
    font-family: Verdana, Geneva, Tahoma, sans-serif;
    text-align: center;
    margin-top: 10px;
    margin-bottom: 10px;
    margin-left: auto;
    margin-right: auto;
    width: 130px;
    padding: 10px 50px;
    transition: all 0.2s;
    vertical-align: middle;
}
[type="file"] + label:hover {
    background-color: orange;
}

前几个类,body#output#canvas,与以前的 CSS 文件中的那些类并没有太大不同,所以我们不需要详细介绍。在这些类之后是一个看起来有点不同的 CSS 类:

[type="file"] {
 height: 0;
 overflow: hidden;
 width: 0;
 display: none;
 }

这定义了具有file类型的input元素的外观。由于使用 CSS 直接为文件输入元素设置样式并不是非常直接。我们将使用display: none;属性隐藏元素,然后创建一个样式化的标签,如下所示:

[type="file"] + label {
    background: orangered;
    border-radius: 5px;
    color: white;
    display: none;
    font-size: 20px;
    font-family: Verdana, Geneva, Tahoma, sans-serif;
    text-align: center;
    margin-top: 10px;
    margin-bottom: 10px;
    margin-left: auto;
    margin-right: auto;
    width: 130px;
    padding: 10px 50px;
    transition: all 0.2s;
    vertical-align: middle;
}
[type="file"] + label:hover {
    background-color: orange;
}

因此,在 HTML 中,我们在输入文件元素之后立即添加了一个标签元素。您可能会注意到,我们的标签也将display设置为none。这样用户就无法在Module对象加载之前使用该元素上传 PNG 文件。如果您回顾一下我们 HTML 外壳文件中的 JavaScript,我们在postRun上调用了以下代码,以便在Module加载后使标签可见:

function ShowFileInput() {
    document.getElementById("file_input_label").style.display = 
    "block";
}

现在,我们应该有一个可以将图像加载到 WebAssembly 虚拟文件系统中的应用程序。在接下来的几节中,我们将扩展此应用程序以配置和测试一个简单的粒子发射器。

对 SVG 的简要介绍

SVG 代表可缩放矢量图形,是 HTML 画布中进行即时模式栅格图形渲染的一种替代方案。SVG 是一种基于 XML 的图形渲染语言,对于熟悉 HTML 的人来说应该至少有些熟悉。SVG 标记可以直接放在 HTML 中,并像任何其他 DOM 节点一样访问。因为我们正在编写一个用于配置粒子发射器数据的工具,我们将在我们的应用程序中添加 SVG 以进行数据可视化。

矢量与栅格图形

作为游戏开发者,您可能不熟悉矢量图形。当我们渲染计算机图形时,无论我们使用什么格式,它们都需要在游戏在计算机屏幕上显示之前被栅格化为像素网格。使用栅格图形意味着在像素级别处理我们的图像。另一方面,矢量图形涉及以不同的抽象级别处理图形,我们处理线条、点和曲线。最终,基于矢量的图形引擎仍然必须弄清楚它正在处理的线条、点和曲线如何转换为像素,但处理矢量图形并非没有好处。它们如下:

  • 矢量图形可以被清晰地缩放

  • 矢量图形允许更小的下载

  • 矢量图形可以在运行时轻松修改

在网络上使用矢量图形的一个甜蜜点是数据可视化。这本书不是关于 SVG 或数据可视化的,而且 SVG 目前还不够快,不能用于大多数应用程序的游戏渲染。然而,当你想要在网站上呈现数据时,它是一个有用的工具。我们将在我们的粒子发射器配置工具中添加一些 SVG 作为视觉辅助,帮助用户看到发射器配置为发射粒子的方向。因为我们将使用它作为视觉辅助,所以没有必要将其放在我们的应用程序中。

我们要做的第一件事是在我们的 HTML 中添加一些标签。我们需要一个 SVG 标签来设置一个可以用来绘制矢量圆形图形的区域。我们还需要一些输入值,允许我们输入两个角度,角度的值以度为单位。这两个输入字段将取最小和最大角度来发射粒子。当这个工作起来时,它将给我们的粒子发射一些方向。这是我们需要添加到body标签的 HTML 代码:

<svg id="pie" width="200" height="200" viewBox="-1 -1 2 2"></svg>
 <br/>
 <div style="margin-left: auto; margin-right: auto">
 <span class="label">min angle:</span>
 <input type="number" id="min_angle" max="359" min="-90" step="1" 
  value="-20" class="em_input"><br/>
 <span class="label">max angle:</span>
 <input type="number" id="max_angle" max="360" min="0" step="1" 
  value="20" class="em_input"><br/>
 </div>

我们在svg标签中将id设置为 pie。这将允许我们稍后用线和弧修改这个标签内的值。我们给它设置了高度和宽度为200像素。

viewbox设置为-1 -1 2 2。这表示我们的 SVG 绘图区域的左上坐标设置为坐标-1,-1。接下来的两个数字2 2是 SVG 绘图区域中的宽度和高度。这意味着我们的绘图空间将从左上角的坐标-1,-1到右下角的坐标1,1。这将使我们在需要计算角度时更容易处理正弦和余弦值。

三角学又来了?

天啊,是的,还有更多的三角学。我已经在第七章中介绍了基本的三角学,碰撞检测,但信不信由你,三角学在游戏开发中真的很有用。三角学碰巧对粒子系统非常有用,我们将使用 SVG 和一些三角函数来构建一个小的饼图,以便可视化我们的粒子发射器的方向。所以,让我们花点时间快速复习一下:

  • 正弦=对边/斜边(SOH)

  • 余弦=邻边/斜边(CAH)

  • 正切=对边/邻边(TOA)

还记得 SOHCAHTOA 这个词吗?

如果我们使用的是 2D 笛卡尔坐标系(剧透警告,我们是),在我们的情况中对边就是Y坐标,邻边就是X坐标。因此,在 2D 笛卡尔坐标系中,我们的比率如下:

  • 正弦=Y/圆半径

  • 余弦=X/圆半径

  • 正切=Y/X

如果你在 JavaScript 数学库中调用cos(余弦)或sin(正弦)等函数,通常传入的是以弧度为单位的角度。你将得到一个比值,如果你处理的是单位圆(半径为 1 的圆),那么这个比值就是余弦的X值和正弦的Y值。所以大多数时候,你只需要记住这个:

  • 如果你想要Y坐标,使用正弦

  • 如果你想要X坐标,使用余弦

我们之前用它来计算飞船的方向和速度。我们将在以后使用它来获得给定角度的粒子的方向和速度。而且,我们现在将使用它来找出如何绘制 SVG 图表,显示我们将发射粒子的角度。

我们正在使用两个不同的角度来获得一系列角度来发射粒子。因为我们希望我们的角度与 0 度的角度重叠,我们必须允许min_angle为负数。我们的最小角度可以从-90 度到 359 度,最大角度可以从 0 度到 360 度。

我更喜欢用度量角度而不是弧度。数学函数通常使用弧度,所以如果您更喜欢在界面中使用弧度,您可以省去转换的麻烦。弧度是基于单位圆的角度测量。单位圆的周长为。如果您用弧度测量角度,您是根据绕单位圆走多远来确定您的角度的。因此,如果您从单位圆的一侧走到另一侧,您需要走π的距离。因此π(以弧度表示)= 180 度。如果您想要一个圆的四分之一角度,您需要绕您的圆走π / 2的距离,所以π / 2 = 90 度。我仍然觉得 360 度的圆更直观,因为在学校时我们花了更多的时间学习度数。弧度只是提及而已。如果情况不是这样,我肯定会觉得用单位圆来测量我的角度更有意义。

360 度圆的概念只是直观的,因为当我们在学校时他们把它灌输给我们。我们之所以有这个圆的模型,只是因为我们从古巴比伦人那里继承了一个 60 进制的数学系统,这也是我们一分钟有 60 秒,一小时有 60 分钟的原因。

稍后,我们将使用 SVG 和一些三角函数来绘制一个小的饼图,代表粒子将从我们的粒子系统中发射的方向。我们需要这种方向性来创建我们的引擎排气粒子发射器:

图 8.1:我们的 SVG 饼图

在下一节中,我们将使用 JavaScript 实现我们的 SVG 饼图。

添加 JavaScript

现在我们已经讨论了一些绘制 SVG 图表所需的三角学知识,让我逐步介绍我们需要添加的 JavaScript 代码,使我们的代码能够运行:


<script>
    document.getElementById("min_angle").onchange = function() {
        var min_angle = Number(this.value);
        var max_angle = Number(document.getElementById         
                        ("max_angle").value);

        if( min_angle >= max_angle ) {
            max_angle = min_angle + 1;
            document.getElementById("max_angle").value = max_angle;
        }

        if( min_angle < this.min ) {
            min_angle = this.min;
            this.value = min_angle;
        }
        SetPie( min_angle / 180 * Math.PI, max_angle / 180 * Math.PI );
    }

    document.getElementById("max_angle").onchange = function() {
        var min_angle = Number(document.getElementById         
                        ("min_angle").value);
        var max_angle = Number(this.value);

        if( min_angle >= max_angle ) {
            min_angle = max_angle - 1;
            document.getElementById("min_angle").value = min_angle;
        }

        if( max_angle > this.max ) {
            max_angle = this.max;
            this.value = max_angle;
        }

        SetPie( min_angle / 180 * Math.PI, max_angle / 180 * Math.PI );
    }

    function SetPie( start_angle, end_angle ) {
        const svg = document.getElementById('pie');
        const start_x = Math.cos( start_angle );
        const start_y = Math.sin( start_angle );

        const end_x = Math.cos( end_angle );
        const end_y = Math.sin( end_angle );
        var arc_flag_1 = 0;
        var arc_flag_2 = 0;

        if( end_angle - start_angle <= 3.14) {
            arc_flag_1 = 0;
            arc_flag_2 = 1;
        }
        else {
            arc_flag_1 = 1;
            arc_flag_2 = 0;
        }

        const path_data_1 = 
            `M 0 0 L ${start_x} ${start_y} A 1 1 0 ${arc_flag_1} 1 
            ${end_x} ${end_y} L 0 0`;

        const path_1 = document.createElementNS         
        ('http://www.w3.org/2000/svg', 'path');
        path_1.setAttribute('d', path_data_1);
        path_1.setAttribute('fill', 'red');
        svg.appendChild(path_1);

        const path_data_2 = 
            `M 0 0 L ${end_x} ${end_y} A 1 1 0 ${arc_flag_2} 1 
             ${start_x} ${start_y} L 0 0`;

        const path_2 = 
        document.createElementNS('http://www.w3.org/2000/svg', 'path');
        path_2.setAttribute('d', path_data_2);
        path_2.setAttribute('fill', 'blue');
        svg.appendChild(path_2);
    }

    SetPie( Number(document.getElementById("min_angle").value) / 180 *             
            Math.PI,
    Number(document.getElementById("max_angle").value) / 180 * Math.PI );
</script>

尽管这是代码中的最后一个函数,但我想首先解释SetPie函数,该函数用于设置显示用户输入的红色发射角范围的 SVG 饼图。很久以前,当我们设置 SVG 标签时,我们将viewport设置为从xy值为-11。这很好,因为使用Math.cosMath.sin将给我们单位圆XY坐标的值,单位圆的半径为1,所以这些值也将从-11运行。

我们使用document.getElementById('pie')从 DOM 中获取svg元素,以便根据角度值的变化对其进行修改。接下来,我们使用Math.cosMath.sin函数分别获取单位圆上的xy坐标。然后,我们使用end_angle来获取结束的xy坐标:

const end_x = Math.cos( end_angle );
const end_y = Math.sin( end_angle );

在 SVG 中,我们需要绘制两条路径。第一条路径将以红色绘制,表示粒子系统发射器发射粒子的角度。第二条路径将以蓝色绘制,表示我们不会发射粒子的发射圆的部分。当我们绘制 SVG 弧线时,我们给弧线两个点,并告诉它一个标志,如果我们需要绕圆走远的方式(钝角)或者走近的方式(锐角)。我们通过检查发射角是否小于π,并设置一个标志,将根据这个标志进入我们的 SVG 中:

if( end_angle - start_angle <= 3.14) {
    arc_flag_1 = 0;
    arc_flag_2 = 1;
}
else {
    arc_flag_1 = 1;
    arc_flag_2 = 0;
}

现在,我们需要定义路径数据并将其放入 SVG 路径对象中。以下代码设置了我们发射粒子的发射器部分的路径数据:

const path_data_1 = `M 0 0 L ${start_x} ${start_y} A 1 1 0 ${arc_flag_1} 1 ${end_x} ${end_y} L 0 0`;

const path_1 = document.createElementNS('http://www.w3.org/2000/svg',                                         
                                        'path');
path_1.setAttribute('d', path_data_1);
path_1.setAttribute('fill', 'red');
svg.appendChild(path_1);

一系列命令在 SVG 中定义路径数据。如果您查看path_data_1的定义,它以M 0 0开头,告诉 SVG 将光标移动到位置0, 0而不绘制。下一个命令是L ${start_x} ${start_y}。因为我们使用了字符串模板文字,${start_x}${start_y}会被start_xstart_y变量中的值替换。这个命令从我们在上一步移动到的当前位置(0,0)画一条线到坐标start_xstart_y。我们路径中的下一个命令是Arc命令,以A开头:A 1 1 0 ${arc_flag_1} 1 ${end_x} ${end_y}

前两个参数1 1是椭圆的xy半径。因为我们想要一个单位圆,这两个值都是1。之后的0是 SVG 在绘制椭圆时使用的X轴旋转。因为我们正在绘制一个圆,所以将其设置为0。之后的值是${arc_flag_1}。这用于设置大弧标志,告诉 SVG 我们是在绘制钝角弧(我们将值设置为 1)还是锐角弧(我们将值设置为 0)。之后的值是扫描标志。此标志确定我们是以顺时针(值为 1)还是逆时针(值为 0)方向绘制。我们总是希望以顺时针方向绘制,因此这个值将是 1。我们arc命令中的最后两个参数是${end_x} ${end_y}。这些值是我们弧的结束位置,我们之前通过获取结束角的余弦和正弦来确定这些值。完成弧后,我们通过使用L 0 0线命令画一条线回到0,0坐标来完成我们的形状。

在我们用红色绘制了发射角之后,我们通过从结束位置到起始位置绘制第二条路径,用蓝色覆盖了圆的其余部分。

在下一节中,我们将构建一个简单的粒子发射器配置工具。

简单的粒子发射器工具

现在我们已经创建了一个简单的 Web 应用程序,可以将 PNG 图像文件上传到 WebAssembly 虚拟文件系统,并且使用 SVG 图表显示粒子的发射方向,我们将添加一个简单的粒子系统配置工具。对于我们粒子系统配置工具的第一个版本,我们将保持可配置值的数量较少。稍后,我们将为我们的粒子系统工具添加更多功能,但目前这是我们将用来配置粒子发射器的参数列表:

  • 图像文件

  • 最小发射角度

  • 最大发射角度

  • 最大粒子

  • 粒子寿命(毫秒)

  • 粒子加速(或减速)

  • Alpha 淡出(粒子是否会随时间淡出?)

  • 发射速率(每秒发射的粒子数)

  • X 位置(发射器 x 坐标)

  • Y 位置(发射器 y 坐标)

  • 半径(离发射器位置有多远可以创建一个粒子?)

  • 最小起始速度

  • 最大起始速度

这将让我们创建一个非常基本的粒子发射器。我们将在下一节改进这个发射器,但我们需要从某个地方开始。我不打算讨论我们添加的任何 CSS 来增强这个工具的外观。我想要做的第一件事是覆盖将放入新外壳文件中的 HTML,我们称之为basic_particle_shell.html。我们需要添加一些 HTML input字段来接收我们之前讨论的所有可配置值。我们还需要一个按钮,在我们写入更改后更新发射器。

将以下代码添加到我们新外壳文件的<body>标签中:

<div class="container">
    <svg id="pie" width="200" height="200" viewBox="-1 -1 2 2"></svg>
    <br/>
    <div style="margin-left: auto; margin-right: auto">
        <span class="label">min angle:</span>
        <input type="number" id="min_angle" max="359" min="-90" 
         step="1" value="-20" class="em_input">
        <br/>
        <span class="label">max angle:</span>
        <input type="number" id="max_angle" max="360" min="0" step="1" 
         value="20" class="em_input">
        <br/>
    </div>
    <span class="label">max particles:</span>
    <input type="number" id="max_particles" max="10000" min="10" 
            step="10" value="100" class="em_input">    
    <br/>
    <span class="label">life time:</span>
    <input type="number" id="lifetime" max="10000" min="10"
            step="10" value="1000" class="em_input"><br/>
    <span class="label">acceleration:</span>

    <input type="number" id="acceleration" max="2.0" min="0.0"
                        step="0.1" value="1.0" class="em_input"><br/>
    <label class="ccontainer"><span class="label">alpha fade:</span>
        <input type="checkbox" checked="checked">
        <span class="checkmark"></span>
    </label>
    <br/>
    <span class="label">emission rate:</span>
    <input type="number" id="emission_rate" max="100" min="1" step="1" 
     value="20" class="em_input">
    <br/>

    <span class="label">x position:</span>
    <input type="number" id="x_pos" max="800" min="0" step="1" 
     value="400" class="em_input">
    <br/>
    <span class="label">y position:</span>
    <input type="number" id="y_pos" max="600" min="0" step="1" 
     value="300" class="em_input">
    <br/>
    <span class="label">radius:</span>
    <input type="number" id="radius" max="500" min="0" step="1" 
     value="20" class="em_input">
    <br/>

    <span class="label">min start vel:</span>
    <input type="number" id="min_starting_vel" max="9.9" min="0.0"
                        step="0.1" value="1.0" class="em_input"><br/>
    <span class="label">max start vel:</span>
    <input type="number" id="max_starting_vel" max="10.0" min="0.0"
                        step="0.1" value="2.0" class="em_input"><br/>

    <div class="input_box">
        <button id="update_btn" class="em_button" 
         onclick="UpdateClick()">Update Emitter</button>
    </div>
 </div>

CSS 文件将此容器样式设置为出现在网页的左侧。用户可以像以前一样将图像加载到虚拟文件系统中,但是这次所有这些输入字段中的值都用于创建一个粒子发射器。用户可以修改这些设置并单击“更新发射器”按钮以更新发射器使用的值。这将允许用户测试一些基本的发射器设置。

主函数中的代码需要添加以防止 SDL 事件处理程序拦截键盘事件并阻止这些输入元素内部的默认行为。我们稍后会介绍这段代码。

现在我已经向您展示了必须添加的 HTML 元素,以便我们能够配置一个粒子系统,让我们逐步了解一下能够将这些值传递到 WebAssembly 模块的 JavaScript 代码。以下是 JavaScript 代码的样子:

<script type='text/javascript'>
 var canvas = null;
 var ctx = null;
 var ready = false;
    var image_added = false;
    function ShowFileInput() {
        document.getElementById("file_input_label").style.display = 
        "block";
        ready = true;
    }
    function UpdateClick() {
        if( ready == false || image_added == false ) { return; }
        var max_particles = Number(document.getElementById         
                             ("max_particles").value);
        var min_angle = Number(document.getElementById         
                            ("min_angle").value) / 180 * Math.PI;
        var max_angle = Number(document.getElementById             
                              ("max_angle").value) / 180 * Math.PI
        var particle_lifetime = Number(document.getElementById         
                                    ("lifetime").value);
        var acceleration = Number(document.getElementById        
                               ("acceleration").value);
        var alpha_fade = Boolean(document.getElementById         
                               ("alpha_fade").checked);
        var emission_rate = Number(document.getElementById             
                                ("emission_rate").value);
        var x_pos = Number(document.getElementById("x_pos").value);
        var y_pos = Number(document.getElementById("y_pos").value);
        var radius = Number(document.getElementById("radius").value);
        var min_starting_velocity = Number(document.getElementById                                                                                                                                                         
                                    ("min_starting_vel").value);
        var max_starting_velocity = Number(document.getElementById                                                                                                                                                         
                                    ("max_starting_vel").value);
        Module.ccall('update_emitter', 'undefined',             
        ["number","number","number","number", "number","bool", 
        "number","number","number","number","number","number"],

        [max_particles,min_angle,max_angle,particle_lifetime,
         acceleration,alpha_fade,min_starting_velocity,
         max_starting_velocity,emission_rate,x_pos ,y_pos,radius]);
        }
        var Module = {
            preRun: [],
            postRun: [ShowFileInput],
            print: (function() {
                var element = document.getElementById('output');
                if (element) element.value = '';
                return function(text) {
                    if (arguments.length > 1) text =   
                    Array.prototype.slice.call(arguments).join(' ');
                    console.log(text);
                    if (element) {
                        element.value += text + "\n";
                        element.scrollTop = element.scrollHeight;
                    }
                }; })(),
        printErr: function(text) {
            if (arguments.length > 1) text = 
            Array.prototype.slice.call(arguments).join(' ');
            if (0) { dump(text + '\n'); } 
            else { console.error(text); }
        },
        canvas: (function() {
            var canvas = document.getElementById('canvas');
            canvas.addEventListener("webglcontextlost", function(e) {
                alert('WebGL context lost. You will need to reload the 
                       page.');
                e.preventDefault();},false);
            return canvas; })(),
        setStatus: function(text) {
            if (!Module.setStatus.last) Module.setStatus.last={ time: 
                Date.now(), text: '' };
            if (text === Module.setStatus.last.text) return;
            var m = text.match(/([^(]+)\((\d+(\.\d+)?)\/(\d+)\)/);
            var now = Date.now();
            if (m && now - Module.setStatus.last.time < 30) return;
            Module.setStatus.last.time = now;
            Module.setStatus.last.text = text;
            if(m) { text = m[1]; }
            console.log("status: " + text); },
        totalDependencies: 0,
        monitorRunDependencies: function(left) {
            this.totalDependencies = Math.max(this.totalDependencies, 
                                              left);
            Module.setStatus(left?'Preparing... (' + 
                            (this.totalDependencies-left) +
                '/' + this.totalDependencies + ')' : 
                'All downloads complete.');
        } };
    Module.setStatus('Downloading...');
    window.onerror = function() {
        Module.setStatus('Exception thrown, see JavaScript console');
        Module.setStatus = function(text) {
            if (text) Module.printErr('[post-exception status] ' + 
                                        text);
        }; };
    function handleFiles(files) {
      var file_count = 0;
      for (var i = 0; i < files.length; i++) {
          if (files[i].type.match(/image.png/)) {
              var file = files[i];
              var file_name = file.name;
              var fr = new FileReader();
              fr.onload = function(file) {
                var data = new Uint8Array(fr.result);
                Module.FS_createDataFile('/', file_name, data, 
                                          true, true, true);
                var max_particles = Number(document.getElementById                                         
                                    ("max_particles").value);
                var min_angle = Number(document.getElementById                                       
                                ("min_angle").value) / 180 * 
                                Math.PI;
                var max_angle = Number(document.getElementById                                     
                                ("max_angle").value) / 180 * 
                                 Math.PI
                var particle_lifetime = Number(document.getElementById                                                
                                        ("lifetime").value);
                var acceleration = Number(document.getElementById 
                                    ("acceleration").value);
                var alpha_fade = Boolean(document.getElementById 
                                 ("alpha_fade").checked);
                var emission_rate = Number(document.getElementById 
                                    ("emission_rate").value);
                var x_pos = Number(document.getElementById 
                            ("x_pos").value);
                var y_pos = Number(document.getElementById 
                            ("y_pos").value);
                var radius = Number(document.getElementById                                          
                            ("radius").value);
                var min_starting_velocity = Number(document.getElementById
                                            ("min_starting_vel").value);
                var max_starting_velocity = Number(document.getElementById                                             
                                            ("max_starting_vel").value);
                Module.ccall('add_emitter','undefined', 
                ["string","number", "number", "number", "number", 
                 "number", "bool",  "number", "number","number", 
                 "number", "number", "number"],
                [file_name, max_particles, min_angle, max_angle, 
                particle_lifetime, acceleration, alpha_fade, 
                min_starting_velocity, max_starting_velocity, 
                emission_rate, x_pos, y_pos, radius]);
                image_added = true; };
              fr.readAsArrayBuffer(files[i]);
} } }
</script>

大部分Module代码未经修改,但我们添加了几个函数和一些新变量。我们添加了一个全局的ready变量,当初始化时设置为false。当Module加载时,此标志将设置为true。与前一节一样,ShowFileInput在使用postRun数组之后运行。我们已调整此代码以设置我们之前提到的ready标志:

function ShowFileInput() {
    document.getElementById("file_input_label").style.display = "block";
    ready = true;
}

在较早的部分,我们创建了一个handleFiles函数,将文件加载到我们的 WebAssembly 虚拟文件系统中。现在我们需要修改该函数,以调用一个名为add_emitter的函数,我们需要在我们的 C++代码中定义该函数。我们将调用此函数,传入我们在 HTML 输入元素中定义的所有值。以下是该函数的样子:

function handleFiles(files) {
    var file_count = 0;
    for (var i = 0; i < files.length; i++) {
        if (files[i].type.match(/image.png/)) {
            var file = files[i];
            var file_name = file.name;
            var fr = new FileReader();
            fr.onload = function (file) {
                var data = new Uint8Array(fr.result);
                Module.FS_createDataFile('/', file_name, data, true, 
                                          true, true);
                var max_particles = Number(document.getElementById( 
                                    "max_particles").value);
                var min_angle = Number(document.getElementById         
                                ("min_angle").value) / 180 * Math.PI;
                var max_angle = Number(document.getElementById         
                                ("max_angle").value) / 180 * Math.PI
                var particle_lifetime = Number(document.getElementById                                         
                                        ("lifetime").value);
                var acceleration = Number(document.getElementById 
                                   ("acceleration").value);
                var alpha_fade = Boolean(document.getElementById 
                                 ("alpha_fade").checked);
                var emission_rate = Number(document.getElementById 
                                    ("emission_rate").value);
                var x_pos = Number(document.getElementById 
                            ("x_pos").value);
                var y_pos = Number(document.getElementById    
                            ("y_pos").value);
                var radius = Number(document.getElementById 
                             ("radius").value);
              var min_starting_velocity = Number(document.getElementById 
                                         ("min_starting_vel").value);
              var max_starting_velocity = Number(document.getElementById                                                        
                                          ("max_starting_vel").value);
                Module.ccall('add_emitter', 'undefined', ["string", 
                "number", "number", "number",
                "number", "number", "bool",
                "number", "number",
                "number", "number", "number", "number"],
                [file_name, max_particles,
                min_angle, max_angle,
                particle_lifetime, acceleration, alpha_fade,                                                      
                min_starting_velocity, max_starting_velocity,
                emission_rate, x_pos, y_pos, radius]);
                image_added = true;
            };
            fr.readAsArrayBuffer(files[i]);
        }
    }
}

FileReader代码和从此函数的先前迭代中调用Module.FS_createDataFile仍然存在。除此之外,我们使用document.getElementById来获取 HTML 元素,并将这些元素的值存储到一组变量中:

var max_particles = Number(document.getElementById    
                    ("max_particles").value);
var min_angle = Number(document.getElementById("min_angle").value) / 
                180 * Math.PI;
var max_angle = Number(document.getElementById("max_angle").value) / 
                180 * Math.PI
var particle_lifetime = Number(document.getElementById     
                        ("lifetime").value);
var acceleration = Number(document.getElementById         
                   ("acceleration").value);
var alpha_fade = Boolean(document.getElementById 
                 ("alpha_fade").checked);
var emission_rate = Number(document.getElementById 
                    ("emission_rate").value);
var x_pos = Number(document.getElementById("x_pos").value);
var y_pos = Number(document.getElementById("y_pos").value);
var radius = Number(document.getElementById("radius").value);
var min_starting_velocity = Number(document.getElementById 
                            ("min_starting_vel").value);
var max_starting_velocity = Number(document.getElementById   
                            ("max_starting_vel").value);

许多这些值需要使用Number强制转换函数明确转换为数字。alpha_fade变量必须被强制转换为Boolean值。现在我们已经将所有这些值放入变量中,我们可以使用Module.ccall调用 C++函数add_emitter,传入所有这些值:

Module.ccall('add_emitter', 'undefined', ["string", "number", "number", 
             "number",
             "number", "number", "bool",
             "number", "number",
             "number", "number", "number", "number"],
             [file_name, max_particles, min_angle, max_angle,
             particle_lifetime, acceleration, alpha_fade,
             min_starting_velocity, max_starting_velocity,
             emission_rate, x_pos, y_pos, radius]);

在最后,我们将image_added标志设置为true。除非调用add_emitter已创建发射器,否则我们将不允许用户更新发射器。我们还添加了一个新函数UpdateClick,每当有人点击“更新发射器”按钮时,我们将调用该函数,假设他们已经创建了一个发射器。以下是该函数中的代码样子:

function UpdateClick() {
    if( ready == false || image_added == false ) {
        return;
    }
    var max_particles = Number(document.getElementById    
                        ("max_particles").value);
    var min_angle = Number(document.getElementById("min_angle").value) 
                    / 180 * Math.PI;
    var max_angle = Number(document.getElementById("max_angle").value) 
                    / 180 * Math.PI
    var particle_lifetime = Number(document.getElementById 
                            ("lifetime").value);
    var acceleration = Number(document.getElementById     
                       ("acceleration").value);
    var alpha_fade = Boolean(document.getElementById 
                     ("alpha_fade").checked);
    var emission_rate = Number(document.getElementById 
                        ("emission_rate").value);
    var x_pos = Number(document.getElementById("x_pos").value);
    var y_pos = Number(document.getElementById("y_pos").value);
    var radius = Number(document.getElementById("radius").value);
    var min_starting_velocity = Number(document.getElementById     
                                ("min_starting_vel").value);
    var max_starting_velocity = Number(document.getElementById 
                                ("max_starting_vel").value);

    Module.ccall('update_emitter', 'undefined', ["number", "number", 
                 "number",
                 "number", "number", "bool",
                 "number", "number",
                 "number", "number", "number", "number"],
                 [max_particles, min_angle, max_angle,
                 particle_lifetime, acceleration, alpha_fade,
                 min_starting_velocity, max_starting_velocity,
                 emission_rate, x_pos, y_pos, radius]);
}

我们要做的第一件事是确保Module对象已加载,并且我们已创建了发射器。如果这两者中的任何一个尚未发生,我们不希望运行此代码,因此我们必须返回:

if( ready == false || image_added == false ) {
    return;
}

此代码的其余部分与我们添加到handleFiles的代码类似。首先,我们获取所有 HTML 元素,并将它们中的值强制转换为适当的数据类型,以传递给我们对 C++函数的调用:

var max_particles = Number(document.getElementById             
                    ("max_particles").value);
var min_angle = Number(document.getElementById("min_angle").value) / 
                180 * Math.PI;
var max_angle = Number(document.getElementById("max_angle").value) / 
                180 * Math.PI
var particle_lifetime = Number(document.getElementById     
                        ("lifetime").value);
var acceleration = Number(document.getElementById         
                   ("acceleration").value); 
var alpha_fade = Boolean(document.getElementById 
                 ("alpha_fade").checked);
var emission_rate = Number(document.getElementById     
                    ("emission_rate").value);
var x_pos = Number(document.getElementById("x_pos").value);
var y_pos = Number(document.getElementById("y_pos").value);
var radius = Number(document.getElementById("radius").value);
var min_starting_velocity = Number(document.getElementById 
                            ("min_starting_vel").value);
var max_starting_velocity = Number(document.getElementById 
                            ("max_starting_vel").value);

从输入元素中获取所有值后,我们使用这些值调用update_emitter C++函数,传入这些值:

Module.ccall('update_emitter', 'undefined', ["number", "number", 
             "number",
             "number", "number", "bool",
             "number", "number",
             "number", "number", "number", "number"],
             [max_particles, min_angle, max_angle,
             particle_lifetime, acceleration, alpha_fade,
             min_starting_velocity, max_starting_velocity,
             emission_rate, x_pos, y_pos, radius]);

在下一节中,我们将实现一个Point类来跟踪游戏对象的位置。

Point 类

在以前的章节中,我们直接处理了类中的 2D XY坐标。我想添加一些处理我们的XY坐标的功能。为此,我们需要定义一个名为Point的新类。最终,Point将做的不仅仅是我们在这里使用它。但是现在,我想能够创建一个Point对象并能够通过角度Rotate该点。以下是我们添加到game.hpp文件中的Point类定义:

class Point {
    public:
        float x;
        float y;
        Point();
        Point( float X, float Y );
        Point operator=(const Point& p);
        void Rotate( float radians );
};

前几个函数和operator=都很简单。它们通过构造函数或使用诸如point_1 = point_2;这样的代码行来设置 x 和 y 属性。最后一个函数Rotate是我们创建这个类的整个原因。它的工作是将XY坐标围绕点0,0旋转。以下是完成这项工作的代码:

void Point::Rotate( float radians ) {
    float sine = sin(radians);
    float cosine = cos(radians);
    float rx = x * cosine - y * sine;
    float ry = x * sine + y * cosine;
    x = rx;
    y = ry;
}

这个Rotate函数最终将在整个游戏中使用。目前,我们将使用它来根据发射角度定义粒子的速度。

粒子类

Particle类是我们将用来表示粒子系统发射的单个粒子的类。Particles类将需要通过构造函数进行创建,并且稍后通过Update函数进行更新,用于修改粒子的定义属性。将会有一个Spawn函数用于激活Particle,一个Move函数用于移动粒子通过其生命周期最终使其停用,以及一个Render函数,用于执行绘制粒子到画布所需的 SDL 渲染任务。以下是我们在game.hpp文件中Particle类的样子:

class Particle {
    public:
        bool m_active;
        bool m_alpha_fade;
        SDL_Texture *m_sprite_texture;
        int m_ttl;
        Uint32 m_life_time;
        float m_acceleration;
        float m_alpha;
        Point m_position;
        Point m_velocity;
        SDL_Rect m_dest = {.x = 0, .y = 0, .w = 0, .h = 0 };
        Particle( SDL_Texture *sprite, Uint32 life_time, float 
        acceleration, bool alpha_fade, int width, int height );
        void Update( Uint32 life_time, float acceleration,
                    bool alpha_fade );
        void Spawn( float x, float y, float velocity_x, float 
        velocity_y, float alpha );
        void Move();
        void Render();
};

我们将在particle.cpp文件中定义与Particle类相关的函数。在该文件的顶部,我们已经定义了一个构造函数和一个Update函数。当用户在网页上点击更新发射器按钮时,我们将调用Update函数。这将更新所有粒子以使用它们的寿命、加速度和透明度衰减的新值。以下是这两个函数的代码样子:

Particle::Particle( SDL_Texture *sprite_texture, Uint32 life_time, 
                    float acceleration, bool alpha_fade, 
                    int width, int height ) {
    m_sprite_texture = sprite_texture;
    m_life_time = life_time;
    m_acceleration = acceleration;
    m_alpha_fade = alpha_fade;
    m_dest.w = width;
    m_dest.h = height;
    m_active = false;
}
void Particle::Update( Uint32 life_time, float acceleration, bool 
                       alpha_fade ) {
    m_life_time = life_time;
    m_acceleration = acceleration;
    m_alpha_fade = alpha_fade;
    m_active = false;
}

Spawn函数在Emitter需要发射粒子时被调用。Emitter检查其正在发射的粒子是否具有设置为false的活动标志。传递给Spawn的值,如XY坐标、速度xy值以及起始透明度值,都是由Emitter在发射新粒子时计算的。以下是代码的样子:

void Particle::Spawn( float x, float y, float velocity_x, 
                      float velocity_y, float alpha ) {
    m_position.x = x;
    m_dest.x = (int)m_position.x;
    m_position.y = y;
    m_dest.y = (int)m_position.y;
    m_velocity.x = velocity_x;
    m_velocity.y = velocity_y;
    m_alpha = alpha;
    m_active = true;
    m_ttl = m_life_time;
}

每个活动粒子的Move函数由发射器每帧调用一次,粒子在其中计算其新位置、透明度,并根据其存在时间确定其是否仍处于活动状态。以下是代码的样子:

void Particle::Move() { 
    float acc_adjusted = 1.0f;
    if( m_acceleration < 1.0f ) {
        acc_adjusted = 1.0f - m_acceleration;
        acc_adjusted *= delta_time;
        acc_adjusted = 1.0f - acc_adjusted;
    }
    else if( m_acceleration > 1.0f ) {
        acc_adjusted = m_acceleration - 1.0f;
        acc_adjusted *= delta_time;
        acc_adjusted += 1.0f;
    }
    m_velocity.x *= acc_adjusted;
    m_velocity.y *= acc_adjusted;
    m_position.x += m_velocity.x;
    m_position.y += m_velocity.y;
    m_dest.x = (int)m_position.x;
    m_dest.y = (int)m_position.y;

    if( m_alpha_fade == true ) {
        m_alpha = 255.0 * (float)m_ttl / (float)m_life_time;
        if( m_alpha < 0 ) {
            m_alpha = 0;
        }
    }
    else {
        m_alpha = 255.0;
    }
    m_ttl -= diff_time;
    if( m_ttl <= 0 ) {
        m_active = false;
    }
}

最后,Render函数调用 SDL 函数设置粒子的透明度值,然后将该粒子复制到渲染器:

void Particle::Render() {
    SDL_SetTextureAlphaMod(m_sprite_texture, (Uint8)m_alpha );
    SDL_RenderCopy( renderer, m_sprite_texture, NULL, &m_dest );
}

在下一节中,我们将讨论Emitter类以及我们需要使该类工作的代码。

发射器类

Emitter类管理一个粒子池,并且粒子用于渲染自身的加载的精灵纹理位于其中。我们的发射器只会是圆形的。可以定义具有许多不同形状的发射器,但对于我们的游戏,圆形的发射器就可以了。目前,我们的Emitter类将会非常基础。在后面的部分,我们将添加一些新功能,但现在我想创建一个非常基本的粒子系统。以下是在game.hpp文件中类定义的样子:

class Emitter {
    public:
        SDL_Texture *m_sprite_texture;
        std::vector<Particle*> m_particle_pool;
        int m_sprite_width;
        int m_sprite_height;
        Uint32 m_max_particles;
        Uint32 m_emission_rate;
        Uint32 m_emission_time_ms;
        int m_next_emission;
        float m_max_angle;
        float m_min_angle;
        float m_radius;
        float m_min_starting_velocity;
        float m_max_starting_velocity;
        Point m_position;

        Emitter(char* sprite_file, int max_particles, float min_angle, 
                float max_angle,
                Uint32 particle_lifetime, float acceleration, bool 
                alpha_fade,
                float min_starting_velocity, float 
                max_starting_velocity,
                Uint32 emission_rate, int x_pos, int y_pos, float 
                radius );
        void Update(int max_particles, float min_angle, float 
        max_angle,
                    Uint32 particle_lifetime, float acceleration, bool 
                    alpha_fade,
                    float min_starting_velocity, float 
                    max_starting_velocity,
                    Uint32 emission_rate, int x_pos, int y_pos, float 
                    radius );
        void Move();
        Particle* GetFreeParticle();
};

该类内部的属性与本章前面创建的 HTML 输入元素相对应。这些值在Emitter使用构造函数创建时设置,或者当用户点击更新按钮时设置,该按钮调用Update函数。Move函数将每帧调用一次,并且将移动并渲染粒子池中所有活动的粒子。它还将通过调用Spawn函数确定是否应该发射新粒子。

我们将在emitter.cpp文件中定义所有这些函数。以下是emitter.cpp文件中Emitter构造函数和Update函数的样子:

Emitter::Emitter(char* sprite_file, int max_particles, float min_angle, 
float max_angle, Uint32 particle_lifetime, float acceleration, bool alpha_fade, float min_starting_velocity, float max_starting_velocity,
Uint32 emission_rate, int x_pos, int y_pos, float radius ) {

    if( min_starting_velocity > max_starting_velocity ) {
        m_min_starting_velocity = max_starting_velocity;
        m_max_starting_velocity = min_starting_velocity;
    }
    else {
        m_min_starting_velocity = min_starting_velocity;
        m_max_starting_velocity = max_starting_velocity;
    }
    SDL_Surface *temp_surface = IMG_Load( sprite_file );

    if( !temp_surface ) {
        printf("failed to load image: %s\n", IMG_GetError() );
        return;
    }
    m_sprite_texture = SDL_CreateTextureFromSurface( renderer, 
    temp_surface );
    SDL_FreeSurface( temp_surface );
    SDL_QueryTexture( m_sprite_texture,
                     NULL, NULL, &m_sprite_width, &m_sprite_height );
    m_max_particles = max_particles;

    for( int i = 0; i < m_max_particles; i++ ) {
        m_particle_pool.push_back(
            new Particle( m_sprite_texture, particle_lifetime, 
            acceleration, alpha_fade, m_sprite_width, m_sprite_height )
        );
    }
    m_max_angle = max_angle;
    m_min_angle = min_angle;
    m_radius = radius;
    m_position.x = (float)x_pos;
    m_position.y = (float)y_pos;
    m_emission_rate = emission_rate;
    m_emission_time_ms = 1000 / m_emission_rate;
    m_next_emission = 0;
}

void Emitter::Update(int max_particles, float min_angle, float 
                     max_angle, Uint32 particle_lifetime, float 
                     acceleration, bool alpha_fade,
                     float min_starting_velocity, float 
                     max_starting_velocity, Uint32 emission_rate, int 
                     x_pos, int y_pos, float radius ) {
    if( min_starting_velocity > max_starting_velocity ) {
        m_min_starting_velocity = max_starting_velocity;
        m_max_starting_velocity = min_starting_velocity;
    }
    else {
        m_min_starting_velocity = min_starting_velocity;
        m_max_starting_velocity = max_starting_velocity;
    }
    m_max_particles = max_particles;
    m_min_angle = min_angle;
    m_max_angle = max_angle;
    m_emission_rate = emission_rate;
    m_position.x = (float)x_pos;
    m_position.y = (float)y_pos;
    m_radius = radius;

    if( m_particle_pool.size() > m_max_particles ) {
        m_particle_pool.resize( m_max_particles );
    }
    else if( m_max_particles > m_particle_pool.size() ) {
        while( m_max_particles > m_particle_pool.size() ) {
            m_particle_pool.push_back(
                new Particle( m_sprite_texture, particle_lifetime, 
                acceleration, alpha_fade, m_sprite_width, 
                m_sprite_height )
            );
        }
    }

    Particle* particle;
    std::vector<Particle*>::iterator it;

    for( it = m_particle_pool.begin(); it != m_particle_pool.end(); 
         it++ ) {
        particle = *it;
        particle->Update( particle_lifetime, acceleration, alpha_fade );
    }
}

这两个函数都设置了Emitter类的属性,并根据传入这些函数的max_particles值设置了粒子池。GetFreeParticle函数被Move函数调用,以从当前未激活的粒子池中获取一个粒子。Move函数首先确定是否需要发射新的粒子,如果需要,就调用GetFreeParticle函数来获取一个未激活的粒子,然后使用Emitter的属性来设置生成粒子时要使用的值。它将循环遍历池中的所有粒子,如果粒子是活动的,它将Move然后Render该粒子:

Particle* Emitter::GetFreeParticle() {
    Particle* particle;
    std::vector<Particle*>::iterator it;
    for( it = m_particle_pool.begin(); it != m_particle_pool.end(); 
         it++ ) {
        particle = *it;
        if( particle->m_active == false ) {
            return particle;
        }
    }
    return NULL;
}

void Emitter::Move() {
    Particle* particle;
    std::vector<Particle*>::iterator it;
    static int count = 0;
    m_next_emission -= diff_time;
    if( m_next_emission <= 0 ) {
        m_next_emission = m_emission_time_ms;
        particle = GetFreeParticle();
        if( particle != NULL ) {
            float rand_vel = (rand() %
                (int)((m_max_starting_velocity - 
                       m_min_starting_velocity) * 1000)) / 1000.0f;
            Point spawn_point;
            spawn_point.x = (float)(rand() % (int)(m_radius * 1000)) / 
            1000.0;
            Point velocity_point;
            velocity_point.x = (float)(rand() %
                (int)((m_max_starting_velocity + rand_vel) * 1000)) / 
                 1000.0;
            int angle_int = (int)((m_max_angle - m_min_angle) * 
            1000.0);
            float add_angle = (float)(rand() % angle_int) /1000.0f;
            float angle = m_min_angle + add_angle;
            velocity_point.Rotate(angle);
            angle = (float)(rand() % 62832) / 10000.0;
            spawn_point.Rotate( angle );
            spawn_point.x += m_position.x;
            spawn_point.y += m_position.y;
            particle->Spawn(spawn_point.x, spawn_point.y, 
            velocity_point.x, velocity_point.y, 255.0f );
        }
    }
    for( it = m_particle_pool.begin(); it != m_particle_pool.end(); 
         it++ ) {
        particle = *it;
        if( particle->m_active ) {
            particle->Move();
            particle->Render();
        }
    }
}

我们将把这些类编译成我们的 WebAssembly 模块,但它们不会直接与我们之前定义的 JavaScript 进行交互。为此,我们需要在一个新文件中定义一些函数,我们将在下一节中讨论。

WebAssembly 接口函数

我们需要定义将与我们的 JavaScript 进行交互的函数。我们还需要定义一些将被我们的几个类使用的全局变量。以下是新的basic_particle.cpp文件中的代码:

#include "game.hpp"
#include <emscripten/bind.h>
SDL_Window *window;
SDL_Renderer *renderer;
char* fileName;
Emitter* emitter = NULL;
Uint32 last_time = 0;
Uint32 current_time = 0;
Uint32 diff_time = 0;
float delta_time = 0.0f;
extern "C"
    EMSCRIPTEN_KEEPALIVE
    void add_emitter(char* file_name, int max_particles, float 
    min_angle, float max_angle, Uint32 particle_lifetime, float 
    acceleration, bool alpha_fade, float min_starting_velocity, float 
    kmax_starting_velocity, Uint32 emission_rate, float x_pos, float 
    y_pos, float radius) {
        if( emitter != NULL ) {
            delete emitter;
        }
        emitter = new Emitter(file_name, max_particles, min_angle, 
                              max_angle, particle_lifetime, 
                              acceleration, alpha_fade,
                              min_starting_velocity, 
                              max_starting_velocity,
                              emission_rate, x_pos, y_pos, radius );
        }
extern "C"
    EMSCRIPTEN_KEEPALIVE
    void update_emitter(int max_particles, float min_angle, float   
    max_angle, Uint32 particle_lifetime, float acceleration, bool   
    alpha_fade, float min_starting_velocity, float 
    max_starting_velocity, Uint32 emission_rate, float x_pos, float 
    y_pos, float radius ) {
        if( emitter == NULL ) {
            return;
        }
        emitter->Update(max_particles, min_angle, max_angle,
                        particle_lifetime, acceleration, alpha_fade,
                        min_starting_velocity, max_starting_velocity,
                        emission_rate, x_pos, y_pos, radius );
    }
    void show_emission() {
        current_time = SDL_GetTicks();
        delta_time = (double)(current_time - last_time) / 1000.0;
        diff_time = current_time - last_time;
        last_time = current_time;
        if( emitter == NULL ) {
            return;
        }
        SDL_SetRenderDrawColor( renderer, 0, 0, 0, 255 );
        SDL_RenderClear( renderer );
        emitter->Move();
        SDL_RenderPresent( renderer );
    }
    int main() {
        printf("Enter Main\n");
        SDL_Init( SDL_INIT_VIDEO );
        int return_val = SDL_CreateWindowAndRenderer( 800, 600, 0, 
        &window, &renderer );
        SDL_EventState(SDL_TEXTINPUT, SDL_DISABLE);
        SDL_EventState(SDL_KEYDOWN, SDL_DISABLE);
        SDL_EventState(SDL_KEYUP, SDL_DISABLE);
        if( return_val != 0 ) {
            printf("Error creating renderer %d: %s\n", return_val, 
            IMG_GetError() );
            return 0;
        }
        last_time = SDL_GetTicks();
        emscripten_set_main_loop(show_emission, 0, 0);
        printf("Exit Main\n");
        return 1;
    }

前两个全局变量是SDL_WindowSDL_Renderer。我们需要这些作为全局对象(特别是渲染器),以便它们可以用来将我们的纹理渲染到画布上:

SDL_Window *window;
SDL_Renderer *renderer;

之后,我们有我们的发射器。现在,我们只支持单个发射器。在以后的版本中,我们将希望配置多个发射器。

Emitter* emitter = NULL;

其余的全局变量都与在毫秒(diff_time)和秒的分数(delta_time)之间跟踪时间有关。last_timecurrent_time变量主要用于计算这两个与时间相关的变量。以下是代码中这些定义的样子:

Uint32 last_time = 0;
Uint32 current_time = 0;
Uint32 diff_time = 0;
float delta_time = 0.0f;

在定义了全局变量之后,是时候定义将与我们的 JavaScript 进行交互的函数了。其中的第一个函数是add_emitter。这是一个简单的函数,它查看是否已定义了一个发射器,如果有,就删除它。然后,它使用从 JavaScript 传入此函数的值创建一个新的发射器,使用此时 HTML 输入元素中的值。以下是函数的样子:

extern "C"
    EMSCRIPTEN_KEEPALIVE
    void add_emitter(char* file_name, int max_particles, float 
    min_angle, float max_angle, Uint32 particle_lifetime, float   
    acceleration, bool alpha_fade, float min_starting_velocity, float 
    max_starting_velocity, Uint32 emission_rate, float x_pos, float 
    y_pos, float radius) {
        if( emitter != NULL ) {
            delete emitter;
        }
        emitter = new Emitter(file_name, max_particles, min_angle, 
        max_angle, particle_lifetime, acceleration, alpha_fade,
        min_starting_velocity, max_starting_velocity,
        emission_rate, x_pos, y_pos, radius );
    }

你可能已经注意到在add_emitter函数定义之前的这两行:

extern "C"
    EMSCRIPTEN_KEEPALIVE

我们需要这些行来防止名称混编死代码消除。如果你以前从未听说过这些术语,让我来解释一下。

C++名称混编

这些行中的第一行extern "C"告诉编译器这是一个 C 函数,并指示它不要在该函数上使用 C++ 名称混编。如果你不熟悉 C++名称混编,它的基本原理是:C++支持函数重载。换句话说,你可以有多个具有不同参数的相同名称的函数。C++将根据传递给该函数的参数调用正确的函数。由于这个功能,C++在编译时会对名称进行混编,在编译过程中为每个函数赋予不同的名称。因为我现在正在使用 C++,而不是使用 C,这些函数我希望从 JavaScript 中调用都会受到这个名称混编过程的影响。extern "C"指令告诉 C++编译器这些是 C 函数,并请不要混编名称,以便我可以从我的 JavaScript 中外部调用它们。

死代码消除

默认情况下,Emscripten 使用死代码消除来删除您在 C++代码内部没有调用的任何函数。在大多数情况下,这是一件好事。您不希望未使用的代码占据 WebAssembly 模块中的空间。当存在一个函数可供从 JavaScript 调用,但无法从 C++代码内部调用时,就会出现问题。Emscripten 编译器会看到没有任何东西调用此函数,并将其删除。EMSCRIPTEN_KEEPALIVE告诉 Emscripten 编译器不要删除此代码,因为您希望从外部源调用它。

更新发射器

add_emitter代码之后,为外部调用设置的下一个函数是update_emitter。此函数首先检查是否定义了发射器,如果是,则调用更新函数,该函数将更新发射器上的所有属性,以便与从 HTML 输入元素传入的值相匹配。代码如下:

extern "C"
    EMSCRIPTEN_KEEPALIVE
    void update_emitter(int max_particles, float min_angle, float   
    max_angle, Uint32 particle_lifetime, float acceleration, bool 
    alpha_fade, float min_starting_velocity, float 
    max_starting_velocity, Uint32 emission_rate, float x_pos, float 
    y_pos, float radius ) {
        if( emitter == NULL ) {
            return;
        }
        emitter->Update(max_particles, min_angle, max_angle,
                        particle_lifetime, acceleration, alpha_fade,
                        min_starting_velocity, max_starting_velocity,
                        emission_rate, x_pos, y_pos, radius );
    }

循环函数

下一个函数show_emission是如果此应用程序是游戏,则将成为我们的游戏循环的函数。此函数在每个渲染的帧上调用,并负责设置计时器值,准备我们的 SDL 进行渲染,并调用发射器的Move函数,该函数将移动和渲染粒子系统中的所有粒子:

void show_emission() {
    current_time = SDL_GetTicks();
    delta_time = (double)(current_time - last_time) / 1000.0;
    diff_time = current_time - last_time;
    last_time = current_time;

    if( emitter == NULL ) {
        return;
    }
    SDL_SetRenderDrawColor( renderer, 0, 0, 0, 255 );
    SDL_RenderClear( renderer );
    emitter->Move();
    SDL_RenderPresent( renderer );
}

前几行计算了delta_timediff_time全局变量,这些变量由粒子根据帧速率调整粒子的移动:

current_time = SDL_GetTicks();
delta_time = (double)(current_time - last_time) / 1000.0;
diff_time = current_time - last_time;
last_time = current_time;

如果发射器尚未设置,我们不希望渲染任何内容,因此我们返回:

if( emitter == NULL ) {
    return;
}

如果发射器存在,我们需要使用黑色清除渲染器:

SDL_SetRenderDrawColor( renderer, 0, 0, 0, 255 );
SDL_RenderClear( renderer );

之后,我们调用发射器的Move函数,该函数既移动所有粒子,又将精灵纹理复制到渲染器中的适当位置。然后,我们调用SDL_RenderPresent函数,将其渲染到 HTML 画布元素上:

emitter->Move();
SDL_RenderPresent( renderer );

初始化

最后一个函数是main函数,当加载 WebAssembly 模块时会自动调用:

int main() {
    SDL_Init( SDL_INIT_VIDEO );
    int return_val = SDL_CreateWindowAndRenderer( 800, 600, 0, &window, 
                                                  &renderer );
    if( return_val != 0 ) {
        printf("Error creating renderer %d: %s\n", return_val, 
                IMG_GetError() );
        return 0;
    }
    SDL_EventState(SDL_TEXTINPUT, SDL_DISABLE);
    SDL_EventState(SDL_KEYDOWN, SDL_DISABLE);
    SDL_EventState(SDL_KEYUP, SDL_DISABLE);
    last_time = SDL_GetTicks();
    emscripten_set_main_loop(show_emission, 0, 0);
    return 1;
}

前几行初始化了我们的 SDL:

SDL_Init( SDL_INIT_VIDEO );
int return_val = SDL_CreateWindowAndRenderer( 800, 600, 0, &window, 
                                              &renderer );

之后,接下来的几行用于禁用 SDL 文本输入和键盘事件。这些行防止 SDL 捕获我们需要在 HTML 元素内设置输入值的键盘输入。在大多数游戏中,我们不希望这些行存在,因为我们希望捕获这些事件,以便我们可以从我们的 WebAssembly 模块内管理游戏输入。但是,如果我们希望我们的应用程序正常工作,并且我们希望用户能够更改我们的 HTML 输入,我们必须在我们的代码中包含这些行:

SDL_EventState(SDL_TEXTINPUT, SDL_DISABLE);
SDL_EventState(SDL_KEYDOWN, SDL_DISABLE);
SDL_EventState(SDL_KEYUP, SDL_DISABLE);

下一行获取last_time全局变量的起始时钟值:

last_time = SDL_GetTicks();

在返回之前,此函数中的最后一行用于设置我们的循环函数。我们的循环函数将在每次渲染帧时调用:

emscripten_set_main_loop(show_emission, 0, 0);

在下一节中,我们将编译和测试发射器配置工具的早期版本。

编译和测试粒子发射器

哇,这是很多代码。好的,现在我们在粒子发射器配置工具中拥有了所有需要的东西,我们需要花时间编译和测试它。在测试此版本之后,我们可以使用相同的 em++调用来测试我们将在下一节开始构建的高级版本。

在命令行上运行此命令:

em++ emitter.cpp particle.cpp point.cpp basic_particle.cpp -o particle.html -std=c++17 --shell-file basic_particle_shell.html -s NO_EXIT_RUNTIME=1 -s USE_WEBGL2=1 -s USE_SDL=2 -s USE_SDL_IMAGE=2 -s SDL2_IMAGE_FORMATS=["png"] -s NO_EXIT_RUNTIME=1 -s EXPORTED_FUNCTIONS="['_add_emitter', '_update_emitter', '_main']" -s EXTRA_EXPORTED_RUNTIME_METHODS="['cwrap', 'ccall']" -s FORCE_FILESYSTEM=1

您的粒子发射器配置工具应如下所示:

图 8.2:粒子系统配置工具的屏幕截图

不要忘记,您必须使用 Web 服务器或emrun来运行 WebAssembly 应用程序。如果您想使用emrun运行 WebAssembly 应用程序,则必须使用--emrun标志进行编译。Web 浏览器需要 Web 服务器来流式传输 We1bAssembly 模块。如果您尝试直接从硬盘驱动器在浏览器中打开使用 WebAssembly 的 HTML 页面,那么该 WebAssembly 模块将无法加载。

使用这个界面上传一个.png图像文件,并在左侧的字段中玩一下。我们还没有足够的数值来制作一个出色的粒子发射器,但你可以通过目前的内容对基础知识有所了解。

总结

在本章中,我们学习了如何创建一个基本的粒子发射器配置工具。我们讨论了如何强制 Emscripten 在应用程序启动时没有加载文件时创建虚拟文件系统。我们学习了如何从用户的计算机加载图像到浏览器的虚拟文件系统,并添加了允许我们上传.png图像文件的功能。我们介绍了一些 SVG 的基础知识,讨论了矢量图形和光栅图形之间的区别,并学习了如何使用 SVG 来为我们的配置工具绘制饼状图。我们介绍了一些在本章中有用的基本三角学知识,在后面的章节中将变得更加有用。我们创建了一个新的 HTML 外壳文件,与我们的 WebAssembly 进行交互,帮助我们为游戏配置一个新的粒子系统。我们在一个 WebAssembly 模块中创建了PointParticleEmitter类,我们将最终在游戏中使用它们。最后,我们了解了 C++的名称修饰、死代码消除以及在编写 Emscripten 代码时必须避免它们的情况。

在下一章中,我们将改进我们的粒子发射器配置工具。在本章结束时,我们将使用它来配置游戏中的效果,如爆炸、太阳耀斑和飞船排气。这个工具可以用来尝试不同的效果,并在将该效果添加到游戏之前感受一下它们的外观。最后,我们将使用配置工具中使用的数值作为配置游戏中粒子效果的起点。