How to spawn a sprite/animated sprite using code?

I want to spawn a small-vfx sprite by coding, and I have tried to code something to realize the target, but the small-vfx sprite doesn’t appear during the game. I don’t know why and how to use sprite in coding correctly.

Here is the code I tried to realize the target (It is under the ‘pawn.js’, I want to spawn sprite when the player is moving):

    var small_vfx = new pc.Entity();
    var sprite01 ='small-vfx-01','sprite');
    var sprite02 ='small-vfx-02','sprite');
    var sprite03 ='small-vfx-03','sprite');
    // var sprite_material = this.entity.sprite._material.clone();
    small_vfx.script.create('smallVfx', {});
    small_vfx.addComponent("sprite", {
        clips: {sprite01,sprite02,sprite03},
        autoPlayClip: 'small-vfx-01',
    small_vfx.sprite._colorUniform = new Float32Array(([1, 1, 1]));

And here is the link of my project. Can someone help me?

1 Like

Hi @kprimo,

Not sure what’s wrong here, I think the way you set the clips may be the problem. Normally I would use the addClip() method on the component, since it requires a number of properties to be passed per clip.

Though two questions:

  1. Why are you creating a new entity each time you move your pawn? This will have a serious performance issue eventually.

  2. Instead of fully creating the sprite in code, why not have a disabled “template” entity and clone that instead? This way you can easily customize/tweak it in editor as well.

1 Like

yes, you’re right. I have tried this plan, it works. :smiley_cat:

but anyway I want to find out why we cannot create a new sprite by coding.


this small-vfx will be destroyed when it’s animation over, so I think it will not cost too much performace.

You may be able to get away with it if you a very simple game with a small number of objects. But as a rule of thumb when you are doing live rendering, avoid as much as possible spawning objects on runtime.

Instead try to reuse objects, pooling is a great concept on how to do that.

1 Like

Learned, thank you, master. [Orz]

Another question, when I try to use function ‘addClip’ to add a new clip into the entity I created, it reports errors like this:

here is my code:

    var small_vfx = new pc.Entity();
    var sprite01 ='small-vfx-01','sprite');
    var sprite02 ='small-vfx-02','sprite');
    var sprite03 ='small-vfx-03','sprite');;


I can’t figure out where I made a mistake :sob:.

1 Like

This is supposed to pc.SpriteAnimationClip, not assets.

1 Like

You haven’t added the sprite component yet so sprite is undefined.

Emma, yeah, yeah. I’m a fool. When I uncomment this code, no error occurs.

but also there are no entities spawned :sob:. I’ve got really confused.

How to transform an asset to a pc.SpriteAnimationClip ?

    var clip = new SpriteAnimationClip(this, {
        fps: 0,
        loop: false,
        spriteAsset: null

Where this is the sprite component. See:

1 Like

you mean ‘new pc.SpriteAnimationClip()’? I’ve tried this way, no error report, but still nothing appeared.

I made a branch called ’Test to create clip by coding‘, I would appreciate it if you could help me find out what’s wrong. Thanks anyway!

Hi @kprimo,

Branches/version control are only visible for users added to the project. Could you try creating a second, smaller, project that reproduces this issue again?

Many thanks,

Sure! Here is the link.

Hey there, I’m having the same issue. I was able to get no errors when creating the animated sprite, but it is still not appearing. The thing is, I think there may be a bug here. The reason being that I tried in the editor to create a normal sprite then turn it from simple to animated. After adding a new clip and giving it a sprite, nothing shows up. If you create an animated sprite instead in the editor, everything works fine. So I have a feeling it has something to do with that. Or I’m just messing up on my part, but any help would be appreciated. Oh and before I forget, here’s my code to create the animated sprite:

var animSpriteEntity = new pc.Entity(); // Create an Entity
    animSpriteEntity.addComponent("sprite", { type: 'SPRITETYPE_ANIMATED', autoPlayClip: 'clip1' });
    var addedClip = new pc.SpriteAnimationClip(animSpriteEntity.sprite, { name: 'clip1', fps: 4, loop: true, spriteAsset: this.testAnimSprite.resource });
    animSpriteEntity.sprite.addClip(addedClip);; // Add it to the Entity hierarchy"clip1");

@oxters168 Here is the way to do it without using the asset directly:

    var animSpriteEntity = new pc.Entity(); // Create an Entity
    animSpriteEntity.addComponent("sprite", { 
        type: pc.SPRITETYPE_ANIMATED, autoPlayClip: 'clip1' 
    var addedClip = animSpriteEntity.sprite.addClip({
        name: 'clip1',
        fps: 4,
        loop: true
    addedClip.sprite = this.spriteAsset.resource;"clip1");

Also, see: How to create an Animation Sprite Clip with programmatically created Sprite?


I don’t know how you created this elf image

I also have a Sprite image. How can I create a sprite image like yours

@Guohao6666 study the Sprite Editor manual pages here:

Thank you very much