Skip to content

Conversation

@levyry
Copy link
Collaborator

@levyry levyry commented Feb 10, 2025

This PR aims to rewrite the current computer graphics notes to follow a more conventional, textbook like style, similar to the official BSz1 and BSz2 notes, while also adding some quality of life features, such as:

  • a preamble
  • improved quizzes
  • extra information and trivia
  • references to the official youtube channel

Guidelines

  • Use more admonitions
  • Use inline mode less, or at least use \displaymode
  • Use less lists and enumerations, use paragraphs instead

Progress

  • rewrite notes
    • all chapters done (11/12)
    • improved images
    • improved quizzes
  • add preamble
    • add youtube playlist link
  • add common math terms page
  • add custom admonitions
    • for definitions
    • for extra knowledge

@levyry
Copy link
Collaborator Author

levyry commented Feb 10, 2025

In this first commit, I left a few comments about some stylistic choices. I plan on doing the rest of the files in a similar style, but this first commit mixes a few styles on purpose, to see which one the maintainers like more. After discussing which way to move forward, I will revise the first chapter to be stylistically homogeneous.

@Kristof-me
Copy link
Member

Cool idea!
The guidelines are great but should be executed carefully. For example paragraphs are great, but enumerations may help with memorizing the content.

In 1.md the admonitions are a bit too much for me personally. But these might actually help some people, so feel free to keep it as it is.

Copy link
Collaborator

@Gilgames32 Gilgames32 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Jó az ötlet és tetszik az irány, viszont a honlapon breakel a formázás. A vscodeos extensionnel lehet jól néz ki, de az másik engine. Kérlek buildeld le és nézd meg, hogy élesben is jól néz-e ki!

- Ezeknek az axiómáknak a megváltoztatása különböző eredményekhez vezethet. Például a háromszög szögeinek összege mindig:
A geometriák különböző axiómákra épülnek. Például az Euklidészi síkgeometriában az egyik legfontosabb, hogy egy egyenesre egy külső pontból legfeljebb egy olyan egyenes húzható, ami nem metszi (ez a párhuzamossági posztulátum)

Ezeknek az axiómáknak a megváltoztatása különböző eredményekhez vezethet. Például a háromszög belső szögeinek összege
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ilyen helyekre tegyél egy extra entert, mert egybe fogja rakni a bekezdéssel

- $T = (\alpha + \beta + \gamma - \pi) / \kappa$

- A kör kerülete
![A kör kerülete](./img/1_kerulet.png)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ide szintúgy, mert egy sorba fog kerülni a kép és a szöveg, nem néz ki jól


<!-- Ez egy eléggé részletes példa egy olyan fogalomról, amit valószínűleg a legtöbb hallgató már ismer. Nem muszáj meghagyni ennyire részletesre, de úgy gondoltam, hogy akinek szüksége van magyarázatra, és direkt rákattint a kinyíló emlékeztetőre, annak nagy eséllyel szüksége is van egy ennyire részletes magyarázatra. -->
??? info Emlékeztető (asszociativitás fogalma)
Egy (kétváltozós) műveletre (legyen most $*$) akkor mondjuk, hogy asszociatív, ha nem számít az elvégzésének sorrendje, azaz $$(u * v) * w = u * (v * w) = u * v * w.$$ Ha egy művelet _nem_ asszociatív, akkor az azt jelenti, hogy $(u * v) * w \neq u * (v * w)$. Egy példa egy nem asszociatív műveletre az osztás: $$\frac{1}{6} = \frac{\frac{1}{2}}{3} = \underbrace{(1/2)/3 \neq 1/(2/3)}_{
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

itt szintúgy

ha inline raksz nem inline matekos dolgot, akkor breakelni fog, mert inline rakja, de körülveszi \( \)-ekkel


!!! question De mégis miért jobb ez?
Azért, mert ez magától kezeli a végtelen pontokat a Descartes koordinátákkal szemben:
$$
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ide is kell +1 extra üres sor mert breakel

> 8-9\. Mi igaz a geometriákra
!!! question 8-9\. Mi igaz a geometriákra

| | Gömbi | Hiperbolikus |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ezt nem akartad szintén dropdown megcsinálni? nagyon tetszik hogy a megoldás alapból nincs mutatva, de ez így kicsit inkonzisztens

ha csak azért van így mert táblázat és a admonition miatt breakelne akkor megértem de így fura


Ezt valamennyire láttuk, a fontos különbség, hogy a $w$ a távolság jelölést is segíti nekünk:

<!-- Nem tudom, hogy direkt használunk-e ilyen négyzetes sorvektorokat, ezért ebben a fejezetben direkt oszloposan írtam fel őket, hogy meglássuk, hogy milyen, és döntsük el, hogy melyiket preferálnánk. -->
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ezzel óvatosan, később még lesz jelentősége hogy row vagy column major mátrixokat használunk-e, most így hirtelen viszont nem tudom ez vezetne-e inkonzisztenciához, ezért meghagynám ahogy volt

@levyry
Copy link
Collaborator Author

levyry commented Feb 11, 2025

For example paragraphs are great, but enumerations may help with memorizing the content.

This is something I have considered, and in my opinion, the main studying notes should be kept at least a bit separate from the "I already studied the material and I just want a quick refresher to cram stuff" type of notes. I don't have a really good solution to this, one idea I had was to include a "Review" section at the end, which would be a bullet point list of the most important topics of that chapter. I am open to other ideas though.

In 1.md the admonitions are a bit too much for me personally. But these might actually help some people, so feel free to keep it as it is.

I might tone them down a bit, this first commit was more about putting stuff out there and seeing what works and what doesn't. In the future I'll try to keep admonitions to mainly definitions and the like.

restructure img paths

(docs): 2.md

(docs): fix 1.md
initial notes

felületek jegyzet
docs: 3.md done
docs: 4.md fix
8.md notes

8.md 2

9.md notes

9.md notes wow such more notes

more notes

notes for 6.md
@levyry
Copy link
Collaborator Author

levyry commented Jun 21, 2025

After this rewrite I was planning on opening a second PR in which I'd implement general QoL changes to the notes, such as:

  • adding a preamble chapter, with general information about the course (mainly related to studying it, not administrative info), with a place for anyone to add their opinions in PR's
  • adding a link to the official computer graphics video from the lecturer at the beginning of each chapter, so it's available to anyone easily
  • adding higher quality pictures in some chapters
  • adding a TL;DR at the end of each chapter before the quiz, which would contain the most important formulas and ideas from the chapter
  • with permission, adding my own grafika-hf-template to the preamble, which I plan to maintain if the framework were to change again, and make platform independent
  • adding a "common math terms" chapter, in which I would provide definitions, explanations and examples for certain terminology used in the material, such as: associative, commutative, algebra, orthogonal, normalized, unit vector, position vector, etc.

As these changes aren't strictly relevant to this PR, I won't include them here, but I would still appreciate some early feedback on these ideas, so they will have already been discussed a bit before opening the second PR.

@levyry levyry requested a review from Gilgames32 July 13, 2025 13:37
levyry added 13 commits July 14, 2025 22:24
This commit aims to clarify and add "NOTE:" blocks for future maintainers
to have more context when changing certain chapters.

It also fixes some math block rendering issues introduced by the previous
merge conflict fix commit.

It also rewords some of the quizzes and material, but only in minor amounts.
refactor quiz of chapter 1

refactor quiz of chapter 6

refactor quiz of chapter 9

refactor quiz of chapter 12
This commit adds additional context to some parts of the written notes.

It also adds some quotes.
This commit fixes some inconsistencies between certain LaTeX and code
blocks.
@Gilgames32
Copy link
Collaborator

gg

@levyry levyry changed the title Rewrite computer graphics notes to follow a more conventional note style Rewrite and extend computer graphics notes to follow a more conventional style Oct 6, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants