Nhóm của chúng tôi bao gồm ba thành viên:
| Họ và Tên | MSSV | |
|---|---|---|
| Trưởng nhóm | Hồ Chung Đức Khánh | 19520624 |
| Thành viên | Nguyễn Thị Minh Phương | 19522065 |
| Thành viên | Võ Minh Hiếu | 19520084 |
Dưới đây là đồ án môn học CS105.L21.KHTN (Đồ họa Máy tính) và CS231.L21.KHTN (Nhập môn Thị giác Máy tính). Đồ án này bao gồm hai nội dung chính:
- Trò chơi Billiards lỗ (8-ball) cho phép người dùng tương tác và điều khiển.
- Tái hiện lại trạng thái của một ván Billiards bất kỳ thông qua một bức ảnh đầu vào.
Yêu cầu kỹ thuật:
- Windows 32-bit hoặc 64-bit.
- Trình biên dịch GNU dành cho Windows: MinGW, MinGW-w64, hoặc TDM-GCC.
- GCC >= 5.1.0.
- OpenGL >= 3.3.
- Python3 + pip.
Tiến hành cài đặt:
Đối với người dùng cuối: Để thực hiện quy trình cài đặt hoàn chỉnh, thực thi lệnh make install. Sau khi thực thi thành công, tệp tin Game Client BilliardsGame.exe sẽ được tạo. Để khởi động Billiards Server, vui lòng đến bước tiếp theo.
Đối với các nhà phát triển: Để giữ lại các tệp tin mã máy sau khi biên dịch, sử dụng lệnh make.
Ngoài ra, nhằm tăng tính tiện dụng cho quá trình phát triển và kiểm thử chương trình, có thể thực hiện lệnh make run để biên dịch và lập tức khởi động GameClient.
Sau khi hoàn tất việc lập trình và kiểm thử mã nguồn, thực hiện lệnh make clean để dọn dẹp những tệp tin không cần thiết.
Khởi động Billiards Server
Cài đặt các thư viện Python cần thiết thông qua lệnh pip:
pip install -r requirements.txt
Khởi động Billiards Server bằng lệnh: python3 server/src/server.py.
Yêu cầu kỹ thuật:
Sử dụng Docker Image có sẵn: TBA.
Tự xây dựng Docker Image:
Để xây dựng lại Docker Image, di chuyển đến thư mục chứa chương trình và thực hiện lệnh sau:
docker-compose build
Khởi động trò chơi:
Để khởi động cả Game Client và Billiards Server, di chuyển đến thư mục chứa chương trình và thực hiện lệnh
docker-compose up
Sau khi đã khởi động được Billiards Server và Game Client, có thể bắt đầu chơi game theo hướng dẫn dưới đây:
- Khi mới bắt đầu game, người chơi có thể sử dụng các phím WASD và chuột để có thể di chuyển tùy ý trong không gian game.
- Người chơi có thể sử dụng lăn chuột để phóng to, thu nhỏ.
- Sau khi sử dụng Camera, người chơi có thể nhấn nút C để khóa vị trí nhìn tại bi trắng cũng là viên bi mà chúng ta sẽ tác động lực vào.
- Có các mức lực là các số từ 1 tới 5 tương ứng lực tác động từ nhẹ tới mạnh.
- Sau khi xác định được mức lực, xác định hướng bắn và nhấn Space.
- Để chơi lại từ đầu, nhấn phím P.
TBD
Để mô phỏng trạng thái game từ một ảnh đầu vào, thực hiện thao tác kéo thả ảnh từ ngoài giao diện Desktop máy tính vào cửa sổ trò chơi. Tọa độ của các quả bóng sẽ được cập nhật thành trạng thái bạn mong muốn.
