Use this skill when creating Sprites or Images in Phaser 4. Covers factory methods, texture/frame selection, position, scale, rotation, tint, flip, alpha, origin, depth, and the component mixin system. Triggers on: Sprite, Image, this.add.sprite, this.add.image, texture, setTint, setAlpha.

Sprites and Images Creating and manipulating Sprite and Image game objects in Phaser 4 factory methods, texture/frame selection, the component mixin system, and common visual operations (position, scale, rotation, tint, flip, alpha, origin, depth). Key source paths: src/gameobjects/sprite/ , src/gameobjects/image/ , src/gameobjects/GameObject.js , src/gameobjects/components/ Related skills: ../loading assets/SKILL.md, ../animations/SKILL.md, ../physics arcade/SKILL.md, ../game object components/SKILL.md Quick Start Core Concepts Sprite vs Image Both extend GameObject and share the same set of component mixins . The only difference is that Sprite includes an AnimationState instance ( sprite.anims ) and animation convenience methods ( play , stop , chain , etc.). Feature Image Sprite Static texture display Yes Yes Tint, alpha, flip, scale, rotate Yes Yes Physics body Yes Yes Input / hit area Yes Yes Animation ( play , stop , chain ) No Yes preUpdate called each frame No Yes (updates animation) Added to Scene updateList No Yes Rule of thumb: Use Image for anything that does not need frame by frame animation. It skips the per frame preUpdate cost and has a smaller API surface. Use Sprite only when you need the Animation component. The Component Mixin System Phaser builds Game Object classes by mixing component objects into the prototype. Both Sprite and Image share this identical Mixins array (sourced from src/gameobjects/sprite/Sprite.js and src/gameobjects/image/Image.js ): The base GameObject class itself mixes in: Each component adds specific properties and methods to every instance. For example, Components.Transform adds x , y , scale , rotation , setPosition() , etc. The full list of available components is in src/gameobjects/components/index.js . Key point for agents: When you see a method like setAlpha() on a Sprite, it comes from Components.Alpha , not from the Sprite class itself. The component source file is the authoritative reference for that method's signature and behavior. Texture and Frame Both Sprite and Image use the TextureCrop component which provides: texture the Phaser.Textures.Texture instance frame the current Phaser.Textures.Frame instance setTexture(key, frame) change the texture (and optionally the frame) setFrame(frame, updateSize, updateOrigin) change only the frame setCrop(x, y, width, height) crop a rectangular region of the texture isCropped boolean, toggle cropping on/off after setCrop The texture parameter in factory methods and constructors accepts either a string key (as registered in the Texture Manager) or a Phaser.Textures.Texture instance. The frame parameter accepts a string name or numeric index into the texture's frame collection. If omitted, the base frame (frame 0 / ' BASE' ) is used. Common Patterns Creating and Positioning Transform component ( src/gameobjects/components/Transform.js ): Size component ( src/gameobjects/components/Size.js ): Scaling and Rotation Transform component (continued): Tinting and Alpha Tint component ( src/gameobjects/components/Tint.js ) WebGL only: Phaser 4 change: setTintFill() is removed. Use setTint(color).setTintMode(Phaser.TintModes.FILL) instead. Alpha component ( src/gameobjects/components/Alpha.js ): Setting alpha to 0 clears the render flag so the object is not drawn. Setting it back to any non zero value restores it. Flipping Flip component ( src/gameobjects/components/Flip.js ): Flipping is a rendering toggle only. It does not affect physics bodies or hit areas. Flip occurs from the middle of the texture and does not change the scale value. Origin and Depth Origin component ( src/gameobjects/components/Origin.js ): Depth component ( src/gameobjects/components/Depth.js ): Setting depth queues a depth sort in the Scene. The setToTop / setToBack / setAbove / setBelow methods change display list position without modifying the depth value. Destroying Game Objects For Sprites, destroy() also calls this.anims.destroy() to clean up the AnimationState. Additional Components Visible ( src/gameobjects/components/Visible.js ): ScrollFactor ( src/gameobjects/components/ScrollFactor.js ): BlendMode ( src/gameobjects/components/BlendMode.js ): Performance note: Changing blend mode breaks WebGL batches. Group objects by blend mode when possible (e.g., render all ADD mode sprites together) to minimize draw calls. Factory Methods this.add.sprite Source: src/gameobjects/sprite/SpriteFactory.js Param Type Required Description x number Yes Horizontal position in world coordinates y number Yes Vertical position in world coordinates texture string \ Phaser.Textures.Texture Yes Texture key or Texture instance frame string \ number No Frame name or index within the texture Returns: Phaser.GameObjects.Sprite Internally does: this.displayList.add(new Sprite(this.scene, x, y, texture, frame)) The Sprite constructor calls: setTexture setPosition setSizeToFrame setOriginFromFrame initRenderNodes . this.add.image Source: src/gameobjects/image/ImageFactory.js Param Type Required Description x number Yes Horizontal position in world coordinates y number Yes Vertical position in world coordinates texture string \ Phaser.Textures.Texture Yes Texture key or Texture instance frame string \ number No Frame name or index within the texture Returns: Phaser.GameObjects.Image Internally does: this.displayList.add(new Image(this.scene, x, y, texture, frame)) The Image constructor calls the same init sequence as Sprite: setTexture setPosition setSizeToFrame setOriginFromFrame initRenderNodes . Specialized Game Objects NineSlice Scalable UI panels with fixed size corners and stretchable edges/center. Ideal for buttons, panels, and dialog boxes that need to resize without distorting borders. TileSprite Repeating texture that fills an area. Supports atlas frames in v4 and a new tileRotation property. Blitter High performance batched rendering for large numbers of static or semi static sprites. Blitter children (Bobs) have no rotation, scale, or physics, but render significantly faster than individual Sprites. Video Video playback as a game object with position, scale, and filter support. For detailed configuration options, API reference tables, and source file maps, see [the reference guide](references/REFERENCE..//SKILL.md).

sprites-and-images