Package edu.ntnu.idi.idatt.view.ludo

Class LudoGameBoardStackPane

java.lang.Object
javafx.scene.Node
javafx.scene.Parent
javafx.scene.layout.Region
javafx.scene.layout.Pane
javafx.scene.layout.StackPane
edu.ntnu.idi.idatt.view.common.BoardStackPane
edu.ntnu.idi.idatt.view.ludo.LudoGameBoardStackPane
All Implemented Interfaces:
javafx.css.Styleable, javafx.event.EventTarget
public class LudoGameBoardStackPane extends BoardStackPane
LudoGameBoardStackPane.

This class extends BoardStackPane to provide a specialized visual representation for a LudoGameBoard. It is responsible for rendering the Ludo board's grid, cells, background, and decorative patterns such as start areas and the central finish area.

Key functionalities include:

  • Initializing the board display with a LudoGameBoard instance and a background image.
  • Updating the grid layout based on the Ludo board's size.
  • Creating individual cells (createRowCell(double, double, int, int)) and styling them based on their type (e.g., track, start, finish path) and associated player color from the LudoGameBoard.
  • Applying a decorative pattern (applyPattern()) which draws the four colored start areas with their token placeholders (circles) and the central colored triangles representing the finish zone.

Methods like addComponent, updateBoardVisuals, loadComponents, and getImagePath are inherited from BoardStackPane but are not currently utilized or are placeholders in this Ludo-specific implementation.

See Also:

  • Property Summary

    Properties inherited from class javafx.scene.layout.StackPane

    alignment

    Properties inherited from class javafx.scene.layout.Region

    background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width

    Properties inherited from class javafx.scene.Parent

    needsLayout

    Properties inherited from class javafx.scene.Node

    accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, focusVisible, focusWithin, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, viewOrder, visible

  • Field Summary

    Fields inherited from class edu.ntnu.idi.idatt.view.common.BoardStackPane

    backgroundImageView, board, boardDimensions, cellToCoordinatesMap, components, componentsPane, gridContainer, logger, onComponentDropped, onRemoveComponentsOutsideGrid

    Fields inherited from class javafx.scene.layout.Region

    USE_COMPUTED_SIZE, USE_PREF_SIZE

    Fields inherited from class javafx.scene.Node

    BASELINE_OFFSET_SAME_AS_HEIGHT

  • Constructor Summary

    Constructors
    Constructor
    Description
    LudoGameBoardStackPane()
    Constructs a new LudoGameBoardStackPane.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    addComponent(String componentIdentifier, TileCoordinates coordinates)
    Placeholder method.
    void
    applyPattern()
    Applies a decorative pattern to the Ludo board, drawing the start areas and the central finish area.
    javafx.scene.layout.StackPane
    createRowCell(double cellWidth, double cellHeight, int row, int col)
    Creates a single cell StackPane for the Ludo board grid.
    String
    getImagePath(String componentIdentifier)
    Placeholder method.
    void
    initialize(Board board, String backgroundImagePath)
    Initializes the Ludo game board display.
    void
    loadComponents()
    Placeholder method.
    void
    updateBoardVisuals()
    Placeholder method.
    void
    updateGrid()
    Updates the grid display for the Ludo board.

    Methods inherited from class edu.ntnu.idi.idatt.view.common.BoardStackPane

    findCellByCoordinates, getBackgroundImageView, getBoard, getBoardDimensions, getCellToCoordinatesMap, getComponents, getComponentsPane, getGridContainer, removeComponent, reset, setBackground, setBoard, setBoardDimensions, setNodeListeners, setOnComponentDropped, setOnRemoveComponentsOutsideGrid

    Methods inherited from class javafx.scene.layout.StackPane

    alignmentProperty, clearConstraints, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, getAlignment, getAlignment, getClassCssMetaData, getContentBias, getCssMetaData, getMargin, layoutChildren, requestLayout, setAlignment, setAlignment, setMargin

    Methods inherited from class javafx.scene.layout.Pane

    getChildren

    Methods inherited from class javafx.scene.layout.Region

    backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computeMaxHeight, computeMaxWidth, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isResizable, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, snapToPixelProperty, widthProperty

    Methods inherited from class javafx.scene.Parent

    getBaselineOffset, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, queryAccessibleAttribute, requestParentLayout, setNeedsLayout, updateBounds

    Methods inherited from class javafx.scene.Node

    accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, focusVisibleProperty, focusWithinProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInitialFocusTraversable, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

    Methods inherited from interface javafx.css.Styleable

    getStyleableNode

  • Constructor Details

    • LudoGameBoardStackPane

      public LudoGameBoardStackPane()
      Constructs a new LudoGameBoardStackPane. Initializes the pattern stack pane that will hold decorative elements like start areas.

  • Method Details

    • initialize

      public void initialize(Board board, String backgroundImagePath)
      Initializes the Ludo game board display. Calls the superclass initialization and then updates the grid and loads components on the JavaFX application thread.
      Overrides:
      initialize in class BoardStackPane
      Parameters:
      board - The Board (expected to be a LudoGameBoard) to display.
      backgroundImagePath - The path to the background image for the board.

    • updateGrid

      public void updateGrid()
      Updates the grid display for the Ludo board. Clears existing children, recalculates cell dimensions based on the background image view's size and the board's size, and recreates the grid cells. After creating the grid, it applies the Ludo-specific pattern and updates board visuals.
      Specified by:
      updateGrid in class BoardStackPane

    • createRowCell

      public javafx.scene.layout.StackPane createRowCell(double cellWidth, double cellHeight, int row, int col)
      Creates a single cell StackPane for the Ludo board grid. The cell is styled based on the LudoTile type (e.g., track, start, finish) and the player color associated with specific track or finish tiles.
      Specified by:
      createRowCell in class BoardStackPane
      Parameters:
      cellWidth - The calculated width for the cell.
      cellHeight - The calculated height for the cell.
      row - The row index of the cell in the grid.
      col - The column index of the cell in the grid.
      Returns:
      A StackPane representing the styled grid cell.

    • applyPattern

      public void applyPattern()
      Applies a decorative pattern to the Ludo board, drawing the start areas and the central finish area. This pattern is overlaid on top of the grid.

      The start areas are colored rectangles with inner white rectangles and four circles (placeholders for tokens). The central area consists of four colored triangles pointing inwards.

      Specified by:
      applyPattern in class BoardStackPane

    • addComponent

      public void addComponent(String componentIdentifier, TileCoordinates coordinates)
      Placeholder method. Currently not used for Ludo game board components.
      Specified by:
      addComponent in class BoardStackPane
      Parameters:
      componentIdentifier - The identifier of the component to add.
      coordinates - The TileCoordinates where the component should be added.

    • updateBoardVisuals

      public void updateBoardVisuals()
      Placeholder method. Currently not used for updating Ludo board visuals directly through here.
      Specified by:
      updateBoardVisuals in class BoardStackPane

    • loadComponents

      public void loadComponents()
      Placeholder method. Currently not used for loading Ludo game components through here.
      Specified by:
      loadComponents in class BoardStackPane

    • getImagePath

      public String getImagePath(String componentIdentifier)
      Placeholder method. Currently not used for getting image paths for Ludo components.
      Specified by:
      getImagePath in class BoardStackPane
      Parameters:
      componentIdentifier - The identifier of the component.
      Returns:
      null as it's not implemented.