buuing/lucky-canvas
Lucky Canvas
Lucky Canvas is a canvas-based lottery component library that enables developers to build interactive prize wheels, grid-based lottery games, and slot machines for web and mobile applications. The project provides a rendering engine that draws directly on HTML Canvas elements, with automatic device pixel ratio scaling to ensure crisp displays on high-DPI mobile screens.
The library packages each lottery type as a self-contained plugin with its own configuration and rendering logic, and wraps the core canvas functionality in framework-specific bindings for Vue, React, Taro, and UniApp without duplicating game logic. Developers can assign configurable probability weights to each prize, control spin speed and acceleration through animation physics parameters, and attach callback functions that fire before a draw starts and after a prize is awarded.
The project supports creating configurable prize wheels with customizable segments, grid-based lottery games with custom cell positions and appearances, and slot machine games with configurable reels and spin direction. Each widget type offers programmatic draw triggers, prize odds configuration, and styling options for text and images within prize segments. The library can be installed via package managers and embedded into projects built with Vue, React, or Taro-based mobile apps.
Features
- Lottery Widgets - Provides interactive prize wheels, grids, and slot machines as embeddable canvas components for web and mobile apps.
- Lottery Game Widgets - Provides the core canvas-based lottery game creation for wheels, grids, and slot machines.
- Grid Prize Configurations - Provides configurable grid cells with custom positions, sizes, text, images, and win probabilities.
- Prize Odds Configuration - Sets weighted odds for each prize item to control win likelihood in frontend or backend lottery logic.
- Prize Odds Configurations - Assigns configurable probability weights to each prize for controlling win likelihood.
- Weighted Prize Odds - Assigns configurable probability weights to each prize for controlled random selection during draws.
- Prize Grids - Provides configurable grid lotteries where prize cells have custom positions, appearances, and win odds.
- Slot Machine Games - Provides slot-machine games with configurable reels, spin speed, direction, and prize order.
- Prize Grid Renderers - Renders configurable grid lottery games on Canvas for interactive prize selection.
- Lottery Game Widgets - Provides interactive lottery games built on Canvas that support wheel, grid, and slot-machine prize draws.
- Canvas Rendering Engines - Renders lottery games by drawing directly on an HTML Canvas element using TypeScript.
- Canvas Components - Provides a Canvas-based component for animated lottery draws with DPR-aware rendering for mobile devices.
- Draw Lifecycle Hooks - Ships callback hooks that fire before and after each lottery draw animation completes.
- Multi-Framework Adapters - Wraps core Canvas logic in framework-specific bindings for Vue, React, Taro, and UniApp.
- Lottery Draw Triggers - Starts lottery spins and stops at specified prize indices via scripted method calls.
- Slot Machine Widgets - Builds configurable slot-machine lottery games with Canvas for animated reel-based prize draws.
- Prize Wheel Renderers - Draws interactive lottery wheels on Canvas and spins them to select random prizes.
- Prize Wheel Animations - Provides configurable spin animation physics for lottery wheels, controlling speed and acceleration during draws.
- Prize Wheel Creators - Creates configurable spinning wheel lotteries with customizable prizes and backgrounds.
- Prize Wheel Drawers - Draws configurable spinning wheel lottery games on Canvas for web and mobile.
- Prize Wheels - Provides spinning wheel lotteries with customizable prizes, colors, images, and probability weights.
- React Prize Wheel Components - Ships a React component for configurable spinning-wheel lottery games with spin animations.
- Vue Prize Wheel Components - Ships a Vue component for configuring prize blocks and buttons on a canvas-based wheel.
- Taro Lottery Widget Embeddings - Embeds wheel, grid, or slot-machine lottery components into Taro-based mobile apps.
- Device Pixel Ratio Management - Automatically adjusts Canvas resolution based on device pixel ratio for crisp rendering on high-DPI screens.
- Slot Machine Prize Configurations - Defines prize items, text, images, and visual styling for each slot in a spinning game.
- Cross-Platform Plugin Implementations - Integrates a single lottery canvas component across multiple frameworks including Vue, React, and WeChat Mini Programs.
- Canvas Rendering - Automatically adjusts canvas clarity based on device pixel ratio for crisp lottery displays on mobile screens.
- Lifecycle Callbacks - Fires user-defined callbacks at the start and end of each lottery draw lifecycle.
- Plugin-Based Architectures - Packages each lottery type as a self-contained plugin with its own configuration and rendering logic.
- Canvas Animations - Manages spin speed, acceleration, and deceleration for wheel and slot machine animations with programmatic control.
- Animation Physics - Controls spin speed, acceleration, and deceleration via parameters for realistic wheel and slot-machine motion.
- Prize Segment Stylings - Sets font properties, colors, and images for each prize segment on the lottery wheel.
- Async Prize Draw Triggers - Starts wheel animations programmatically and stops at specified prize indices after async results.
- Slot Machine Spin Controllers - Sets rotation speed, direction, and prize order for each reel in a slot machine.
- Slot Spin Triggers - Triggers slot machines to begin spinning and stop at specified prize indices.
- Slot Machine Layout Configurations - Configures global row and column spacing, spin mode, acceleration, and deceleration for slot machine games.
- JavaScript 框架汇总 - Listed in the “JavaScript 项目” section of the Great Open Source Project awesome list.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
