reversi-app/pt.isel.reversi.app.pages.menu

Package-level declarations

Overview

Main menu screen where users can start a new game, load saved games, access settings, or exit the application.

Components

MainMenu — Main menu page composable
MainMenuBg — Background rendering for the menu
MainMenuViewModel — State management for menu interactions

Responsibilities

Displaying main menu options
Handling user navigation to other pages
Managing menu state and animations

Types

MainMenuUIState

data class MainMenuUIState(val screenState: ScreenState = ScreenState()) : UiState

UI state for the main menu screen.

MainMenuViewModel

class MainMenuViewModel(val appState: AppStateImpl, val globalError: ReversiException? = null, val setGlobalError: (Exception?, ErrorType?) -> Unit, val setPage: (Page) -> Unit) : ViewModel<MainMenuUIState>

ViewModel for the main menu screen. Manages menu interactions, audio playback, and navigation state.

MovingPiece

data class MovingPiece(val id: Long, val xPercent: Float, val yPercent: Float, val radiusDp: Float, val speed: Float, val phase: Float, val waveAmplitude: Float, val isWhite: Boolean, val spawnTime: Long, val isSpecial: Boolean = false)

Represents an individual animated piece in the background.

Properties

BASE_ALPHA

private const val BASE_ALPHA: Float = 0.3f

FADE_EDGE_WIDTH

private const val FADE_EDGE_WIDTH: Float = 0.7f

MAIN_MENU_AUTO_SIZE_BUTTON_TEXT

val MAIN_MENU_AUTO_SIZE_BUTTON_TEXT: TextAutoSize

MAX_PIECES

private const val MAX_PIECES: Int = 50

SPAWN_DELAY_MS

private const val SPAWN_DELAY_MS: Long = 250

SPECIAL_PIECE_CHANCE

private const val SPECIAL_PIECE_CHANCE: Float = 0.1f

SPECIAL_PIECES_MAX

private const val SPECIAL_PIECES_MAX: Float = 2.0f

WAVE_DURATION_MS

private const val WAVE_DURATION_MS: Int = 3000

Functions

AnimatedBackground

@Composable

fun ReversiScope.AnimatedBackground()

calculateEdgeFade

private fun calculateEdgeFade(xPercent: Float): Float

calculateWaveOffset

private fun calculateWaveOffset(waveOffset: Float, phase: Float, amplitude: Float): Float

createNewPiece

private fun createNewPiece(canAddSpecial: Boolean): MovingPiece

drawCrown

fun DrawScope.drawCrown(x: Float, y: Float, radiusPx: Float, alpha: Float)

drawEyes

fun DrawScope.drawEyes(isWhite: Boolean, theme: AppTheme, x: Float, y: Float, radiusPx: Float, alpha: Float)

drawPiece

fun DrawScope.drawPiece(piece: MovingPiece, theme: AppTheme, x: Float, y: Float, radiusPx: Float, edgeFade: Float, baseAlpha: Float = BASE_ALPHA)

drawSpecialFeatures

fun DrawScope.drawSpecialFeatures(isWhite: Boolean, theme: AppTheme, x: Float, y: Float, radiusPx: Float, edgeFade: Float, baseAlpha: Float = BASE_ALPHA)

MainMenu

@Composable

fun ReversiScope.MainMenu(viewModel: MainMenuViewModel, modifier: Modifier = Modifier, onLeave: () -> Unit, isTestMode: Boolean = false)

Main menu screen showing navigation options. Handles menu audio playback and navigation callbacks to other pages.

testTagAboutButton

fun testTagAboutButton(): String

testTagLobbyButton

fun testTagLobbyButton(): String

testTagMainMenu

fun testTagMainMenu(): String

testTagNewGameButton

fun testTagNewGameButton(): String

testTagSettingsButton

fun testTagSettingsButton(): String