4. 전체 소스 코드와 사용한 도구

이 글의 목적

3×3 큐브 앱에 쓴 소스 코드를 공개합니다. 파일을 펼칠 때만 코드를 불러옵니다.

사용한 도구

• Qt6(Core, Gui, Widgets, OpenGL, Network)와 OpenGL: 3D 큐브, 사진 불러오기 화면
• Kociemba 2단계 탐색: muodov/kociemba의 C 코드를 그대로 넣었습니다. GPL-2.0입니다.
• Qwen3-VL-8B-Instruct(transformers, 맥 MPS): VLM 스캔 서버. 앱과 TCP로 붙습니다.

폴더 구성

• src/CubeModel: 큐브 상태, 회전, 색 분류
• src/CubeWidget, MainWindow: OpenGL 화면과 마우스 회전, 섞기·이전·다음·오라클 버튼
• src/CubePhotoReconstructor: 사진 두 장에서 54칸 읽기, 규칙 검사, 자동 교정
• src/PhotoImportDialog: 사진 불러오기, 일반·VLM 스캔, 칸 누르면 뜨는 6색 링
• src/KociembaSolver, Oracle, BeginnerSolver, MoveSolver: 풀이. Kociemba → 짧은 탐색 → 초보자 층별 순서로 씁니다.
• src/TcpCubeVlmClient, vlm_server: VLM 스캔 클라이언트와 서버
• tools/face_scan_cli.py: 면 하나씩 색을 확인하던 명령줄 도구
• third_party/ckociemba: Kociemba C 코드

빌드는 README대로 cmake로 합니다. 빌드 결과, 가상환경, Kociemba 표 파일(cache), 시험 사진은 싣지 않았습니다. 시험 프로그램 82개는 시험 사진 경로가 코드에 들어 있어 뺐습니다.

전체 소스