fix: CI/CD

.github/workflows/deploy.yml

@@ -0,0 +1,31 @@
+name: Deploy to GitHub Pages
+on:
+  push:
+    branches:
+      - main
+permissions:
+  contents: write
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+      - name: Clone fonts repository
+        run: git clone https://github.com/touying-typ/fonts.git fonts --depth=1
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - name: Install Touying Exporter
+        run: pip install touying
+      - name: Build HTML File
+        run: |
+          mkdir build
+          touying compile presentation.typ --output build/index.html --format html --font-paths fonts --font-paths assets/fonts
+      - name: Deploy to GitHub Pages
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: build

.github/workflows/typst.yml

@@ -41,5 +41,5 @@ jobs:
         with:
           name: "${{ github.ref_name }} — ${{ env.DATE }}"
           files: |
-            kval_darbs_kristians_cagulis_kc22015.pdf
-            documentary_page.pdf
+            Cagulis_Kristians.Francis_kc22015.pdf
+            reg_lapa_Cagulis_Kristians.Francis_kc22015.pdf

main.typ

@@ -154,10 +154,10 @@ ieteikumi turpmākai projekta attīstībai.
 == Esošā stāvokļa apraksts
 Pašreizējo spēļu izstrādes ainavu raksturo pieaugoša interese pēc neatkarīgajām
 spēlēm un modernu, efektīvu spēļu dzinēju izmantošana. Izstrādātāji arvien
-biežāk meklē rīkus, kas piedāvā elastību, veiktspēju un lietošanas ērtumu. Spēļu
-dzinējs Bevy ar savu moderno arhitektūru un Rust programmēšanas valodas
+biežāk meklē rīkus, kas piedāvā elastību, veiktspēju un lietošanas ērtumu.
+Spēļu dzinējs Bevy ar savu moderno arhitektūru un Rust programmēšanas valodas
 izmantošanu gūst arvien lielāku popularitāti izstrādātāju vidū, pateicoties tā
-drošām un vienlaicīgām (angl. concurrent) funkcijām.
+drošām, paralēlām sistēmām.
 
 == Pasūtītājs
 Sistēma nav izstrādāta pēc konkrēta pasūtītāja pieprasījuma, tā ir raksturota un
@@ -186,6 +186,9 @@ kvalitatīvu lietotāja pieredzi:
 
 - Līmeņu pārvaldība: Sistēma nodrošinās automātisku spēles līmeņu pārvaldību un
   vienmērīgu pāreju starp tiem, veidojot pakāpenisku grūtības pieaugumu.
+- Līmeņu ģenerēšana: Sistēma nodrošinās procedurālu līmeņu ģenerēšanu, radot
+  unikālus sešstūrainus labirintus katram spēles stāvam, garantējot, ka katrs
+  labirints ir pilnībā izejams.
 - Tieša piekļuve: Spēle būs pieejama bez lietotāja konta izveides vai
   autentifikācijas, nodrošinot tūlītēju piekļuvi spēles saturam.
 - Platformu atbalsts: Sistēma tiks izstrādāta ar daudzplatformu atbalstu,
@@ -1749,7 +1752,8 @@ Papildus noklusētajiem noteikumiem, tika aktivizēti stingrāki koda kvalitāte
 pārbaudes līmeņi: "pedantic" režīms nodrošina padziļinātu koda stila pārbaudi,
 "nursery" aktivizē eksperimentālās pārbaudes, un "unwrap_used" un "expect_used"
 brīdina par potenciāli nedrošu kļūdu apstrādi. Šie papildu noteikumi palīdz
-uzturēt augstāku koda kvalitāti un samazināt potenciālo kļūdu skaitu @clippy.
+uzturēt augstāku koda kvalitāti un samazināt potenciālo kļūdu skaitu
+(sk. @clippy-hexlab[] un @clippy-maze-ascension[pielikumus]) @clippy.
 
 == Dinamiskā testēšana
 

presentation.typ

@@ -0,0 +1,283 @@
+#import "@preview/touying:0.5.5": *
+#import themes.university: *
+#import "@preview/cetz:0.3.1"
+#import "@preview/fletcher:0.5.3" as fletcher: node, edge
+#import "@preview/ctheorems:1.1.3": *
+#import "@preview/numbly:0.1.0": numbly
+#import "src/diagrams.typ": *
+
+#set text(
+  font: (
+    "Times New Roman",
+    "New Computer Modern",
+  ),
+  size: 12pt,
+  hyphenate: auto,
+  lang: "lv",
+  region: "lv",
+)
+#show raw: set text(
+  font: (
+    "JetBrainsMono NF",
+    "JetBrains Mono",
+    "Fira Code",
+  ),
+  features: (calt: 0),
+)
+
+// cetz and fletcher bindings for touying
+#let cetz-canvas = touying-reducer.with(
+  reduce: cetz.canvas,
+  cover: cetz.draw.hide.with(bounds: true),
+)
+#let fletcher-diagram = touying-reducer.with(
+  reduce: fletcher.diagram,
+  cover: fletcher.hide,
+)
+
+#set figure(supplement: none)
+
+// Theorems configuration by ctheorems
+#show: thmrules.with(qed-symbol: $square$)
+#let theorem = thmbox("theorem", "Theorem", fill: rgb("#eeffee"))
+#let corollary = thmplain(
+  "corollary",
+  "Corollary",
+  base: "theorem",
+  titlefmt: strong,
+)
+#let definition = thmbox(
+  "definition",
+  "Definition",
+  inset: (x: 1.2em, top: 1em),
+)
+#let example = thmplain("example", "Example").with(numbering: none)
+#let proof = thmproof("proof", "Proof")
+
+#show: university-theme.with(
+  aspect-ratio: "16-9",
+  config-info(
+    title: [Spēles izstrāde, izmantojot Bevy spēļu dzinēju],
+    subtitle: [Kvalifikācijas darbs],
+    author: [Kristiāns Francis Cagulis kc22015],
+    date: [2025],
+    institution: [Latvijas Universitāte],
+  ),
+  config-colors(
+    primary: rgb("#575279"),
+    secondary: rgb("#797593"),
+    tertiary: rgb("#286983"),
+    neutral-lightest: rgb("#faf4ed"),
+    neutral-darkest: rgb("#575279"),
+  ),
+)
+
+#title-slide()
+
+#slide[
+  = Pārskats
+  - Entitāšu komponenšu sistēma (ECS)
+  - Maze Ascension
+  - Hexlab bibliotēka
+  - Sešstūru implementācija
+  - Saskarne
+  - Rezultāti un secinājumi
+]
+
+= Entitāšu komponenšu sistēma (ECS)
+
+== Kas ir ECS?
+
+- Koncentrējas uz kompozīciju, nevis mantošanu.
+- Datu orientēta arhitektūra.
+- Nodalīti dati (komponentes) un uzvedība (sistēmas).
+
+== Datu izkārtojums
+
+// Here is an illustration to help you visualize the logical structure. The
+// checkmarks show what component types are present on each entity. Empty cells
+// mean that the component is not present. In this example, we have a player, a
+// camera, and several enemies.
+#context {
+  show raw: set text(size: 16pt)
+  table(
+    columns: 7,
+    [*Entity (ID)*],
+    [*Transform*],
+    [*Player*],
+    [*Enemy*],
+    [*Camera*],
+    [*Health*],
+    [*...*],
+
+    `...`, "", "", "", "", "", "",
+    "107",
+    [#emoji.checkmark.heavy `<translation>`\ `<rotation>`\ `<scale>`],
+    emoji.checkmark.heavy,
+    "",
+    "",
+    [#emoji.checkmark.heavy `<50.0>`],
+    "",
+
+    "108",
+    [#emoji.checkmark.heavy `<translation>`\ `<rotation>`\ `<scale>`],
+    "",
+    emoji.checkmark.heavy,
+    "",
+    [#emoji.checkmark.heavy `<25.0>`],
+    "",
+
+    "109",
+    [#emoji.checkmark.heavy `<translation>`\ `<rotation>`\ `<scale>`],
+    "",
+    "",
+    [#emoji.checkmark.heavy `<camera data>`],
+    "",
+    "",
+
+    `...`,
+  )
+}
+
+== Piemērs
+#context {
+  show raw: set text(size: 16pt)
+  ```rust
+  #[derive(Component)]
+  struct Player;
+
+  #[derive(Component)]
+  struct Health {
+      current: u32,
+      max: u32
+  }
+
+  fn heal_player(
+      mut query: Query<&mut Health, With<Player>>,
+      time: Res<Time>,
+  ) {
+      for mut health in query.iter_mut() {
+        let new_health = health.current + 2. * time.delta_secs();
+        health.current = new_health.min(health.max);
+      }
+  }
+  ```
+}
+
+= Maze Ascension
+
+== 1. Līmeņa DPD
+
+#figure(image("assets/images/diagrams/dpd1.png"))
+
+== Stāva modulis
+
+#figure(image("assets/images/diagrams/floor.png", width: 50%))
+
+
+= Hexlab bibliotēka
+
+#pagebreak()
+
+#figure(
+  caption: link("https://crates.io/crates/hexlab"),
+  image("assets/images/crates/hexlab.png", height: 92%),
+)
+
+== Labirinta ģenerēšanas funkcijas projektējums
+#grid(
+  columns: (1fr, 1fr),
+  figure(image("assets/images/diagrams/maze-gen.png")),
+  figure(image("assets/images/diagrams/recursive.png")),
+)
+
+== Ģenerēšanas algoritms
+// recursive backtracking
+#figure(
+  caption: link("https://en.wikipedia.org/wiki/Maze_generation_algorithm"),
+  image("assets/videos/hexmaze/hexmaze.gif", height: 92%),
+)
+
+= Sešstūru implementācija
+== Attēlošana
+
+#grid(
+  columns: 2,
+  figure(image("assets/images/game/tile-spreadout.png", height: 100%)),
+  figure(image("assets/images/game/tile.png", height: 100%)),
+)
+
+#figure(image("assets/images/game/grid.png", height: 100%))
+
+= Saskarne
+#pagebreak()
+
+#grid(
+  columns: 2,
+  figure(image("assets/images/game/main-menu.png")),
+)
+
+#figure(image("assets/videos/game/maze-game.gif"))
+
+#grid(
+  columns: (1fr, 1fr),
+  figure(image("assets/images/game/debug.png")),
+  figure(image("assets/images/game/dev-tools.png")),
+)
+
+
+#figure(image("assets/videos/game/big-maze.gif"))
+
+= Secinājumi
+== Rezultāti
+
+- 3D spēle izmantojot Bevy un Rust:
+  - Procedurāla sešstūraina labirints ģenerēšana, izmantojot DFS.
+  - Izveidota atkārtoti lietojama atvērtā pirmkoda bibliotēka "hexlab".
+- Efektīva līmeņa pārvaldība:
+  - Vienmērīga pāreja starp labirinta līmeņiem.
+
+== Turpmākie darbi
+
+- Īstenot vairāk labirintu ģenerēšanas paņēmienus/algoritmus.
+- Ieviest jaunas mehānikas un papildspējas.
+- Uzlabot vizuālo kvalitāti un spēlētāja izskatu.
+- Izstrādāt daudzspēlētāju režīmu.
+
+= Paldies par uzmanību!
+
+Jautājumi?
+
+#show: appendix
+
+= Galavārds
+== ECS vs OOP
+#grid(
+  columns: (1fr, 1fr),
+  gutter: 1em,
+  [
+    *ECS*
+    - Plakana hierarhija
+    - Datu orientēta
+    - Kešatmiņai piemērots
+    - Paralēla apstrāde
+  ],
+  [
+    *OOP*
+    - Dziļa mantojamība (inheritance)
+    - Objektorientēta
+    - Kešatmiņa izkliedēts
+    - Secīga apstrāde
+  ],
+)
+
+== Iedvesma
+#figure(
+  caption: link("https://www.redblobgames.com/grids/hexagons/"),
+  grid(
+    columns: 2,
+    figure(image("assets/images/redblogmages/axial-coords.png", height: 92%)),
+    figure(image("assets/videos/coords/coords.gif", height: 92%)),
+  ),
+)
+

requirements.typ

@@ -3,4 +3,5 @@
 #import "@preview/headcount:0.1.0"
 #import "@preview/i-figured:0.2.4"
 #import "@preview/tablex:0.0.9"
+#import "@preview/touying:0.5.5"
 #import "@preview/wordometer:0.1.3"

src/abstract.typ

@@ -46,16 +46,7 @@ papildspējas.
       numbering: none,
       "Abstract",
     )
-    #align(
-      center,
-      heading(
-        level: 2,
-        outlined: false,
-        numbering: none,
-        text(13pt, "Game development using Bevy game engine"),
-      ),
-    )
-    The qualification work includes the game "Maze Ascension", which offers
+    The qualification work "Game development using Bevy game engine" includes the game "Maze Ascension", which offers
     players the challenge to pass through procedurally generated hexagons
     mazes. The game is built using the Rust programming language and Bevy
     game engine.

src/attachments.typ

@@ -5,10 +5,14 @@
 #set figure(kind: "attachment", supplement: "pielikums")
 
 #figure(
-  caption: [Pilns "hexlab" bibliotēkas testu rezultāts],
-  image("../assets/images/tests/hexlab-full.png", height: 90%),
-) <tests-hexlab-full>
+  caption: [Clippy rīka rezultāts "hexlab" bibliotēkai],
+  image("../assets/images/clippy/hexlab.png"),
+) <clippy-hexlab>
 
+#figure(
+  caption: [Clippy rīka rezultāts "Maze Ascension" spēlei],
+  image("../assets/images/clippy/maze-ascension.png"),
+) <clippy-maze-ascension>
 
 #figure(
   caption: [Tarpaulin rīka rezultāts "hexlab" bibliotēkai],
@@ -25,3 +29,8 @@
   caption: [Tokei rīka rezultāts "hexlab" bibliotēkai],
   image("../assets/images/tokei/hexlab.png"),
 ) <tokei-hexlab>
+
+#figure(
+  caption: [Pilns "hexlab" bibliotēkas testu rezultāts],
+  image("../assets/images/tests/hexlab-full.png", height: 90%),
+) <tests-hexlab-full>