﻿=================================================
[Software     name]  Cube Capture Ver.2.1
[Registered   name]  CubeCapture.zip
[Copyright  holder]  A.MORICHIKA m_akira@ka2.so-net.ne.jp
[Compatible models]  Windows 11/10
[Required      DLL]  .NET Framework 4.8.1
[Software     type]  Free software
=================================================
[Software introduction]

+ Overview.

 This software scans cubic puzzles with a camera and displays the solution.


+ Description of the file.

    <Unzip folder>
    .\ReadMe.txt        : Japanese file.
    .\ReadMe_en.txt     : This file.
    .\CubeCapture.exe   : Installer.


+ How to install.

 Please unblock the decompressed file from the file properties.

 Confirm that the extracted configuration is in the above state, and run CubeCapture.exe to start installation.

 To uninstall, go to "Add or Remove Programs" in the Control Panel.
 The program name is "CubeCapture".

 ".NET Framework 4.8.1" is required for operation.
 https://dotnet.microsoft.com/en-us/download/dotnet-framework/thank-you/net481-web-installer


+ Precautions.

 The scanner function using the camera may take some time to start depending on the computer environment.


+ Simple usage instructions.

 - You can scan the cube pattern and display the solution by following the steps below.

  1. Switch the mode with the Calibration button.
  2. Photograph the center color of the 6 face. (*1)
                    + ----- +
                    |       |
                    |   Up  |
                    | ( U ) |
            + ----- + ----- + ----- + ----- +
            |       |       |       |       |
            | Left  | Front | Right | Back  |
            | ( L ) | ( F ) | ( R ) | ( B ) |
            + ----- + ----- + ----- + ----- +
                    |       |
                    | Down  |
                    | ( D ) |
                    + ----- +
  3. Once recognized, a green frame will appear, so press the Constent button.
  4. After setting the 6 colors, press the Calibration button to exit the mode.
  5. Recognize the 6 sides in order and press the Constent button.
  6. Press the Check button to exit. (*2,*3,*4)
  7. A message will be displayed if the scan was successful.

  Note 1. Please scan to match the expanded view on 6 face.
  Note 2. If the color does not match the developed view, please change it in the settings mode. (*5)
  Note 3. The recognition sensitivity changes depending on the surrounding brightness and distance.
  Note 4. If text is printed on a colored surface, it cannot be recognized, so cover it with tape of the same color.

 The following functions are assigned to the keyboard.

  S    : Scan record.
  E    : Scan completed.
  R    : Data restoration.
  C    : Color calibration.
  X    : Initialization.
  Enter: Omit colors during calibration.
  Back : Color return during calibration.

 (*1) The acquired color is recorded, so you can omit it next time.
 (*2) For analysis using the BH method, press the Ctrl key at the same time.
 (*3) To find the shortest solution, press the Shift key at the same time.
 (*4) If you want to answer by text, press the Yes button and the Shift key at the same time.
 (*5) Click the icon on the top left and select "Settings" from the menu.


+ Version history.

    Ver.2.1   2026.1.27

    - The library has been changed from .NET Framework 4.8 to 4.8.1.
    - Rebuilt using Microsoft Visual Studio 2026 Community.

    Ver.2.0   2025.6.14

    - Added a function to predict the remaining 1 side from 5 sides.
    - Added a function to predict the remaining 2 side from 4 sides.

    Ver.1.9   2025.5.17

    - Improved matching accuracy in calibration mode.
    - Supports file changes for Cubic Puzzle (Ver.3.7).

    Ver.1.8   2025.5.10

    - Adjusted the HTML display of the solution.
    - Support for updating controls.

    Ver.1.7   2024.6.23

    - Improved file history management.
    - Updated the OpenCvSharp library.

    Ver.1.6   2023.12.12

    - Improved camera startup time.

    Ver.1.5   2023.11.25

    - Added a button to initialize the color scheme.
    - Supported loading of ".cube" files.
    - Added ".txt" and ".html" to the file saving types.

    Ver.1.4   2023.11.18

    - Changed the default color scheme.

    Ver.1.3   2023.11.11

    - Fixed a bug that caused the app to not close when started multiple times.
    - Added the shortest solution using Two-Phase-Algorithm.
    - Added file save/restore and history to the menu.
    - Added deletion function by right-clicking on the file history.

    Ver.1.2   2023.11.1

    - Added color name registration.
    - Added analysis using BH method.
    - Added solution output by color name.

    Ver.1.1   2023.10.20

    - Improved verification of same color surfaces.
    - Supports multi-monitor environments with different DPI.

    Ver.1.0   2023.10.14

    - First edition released.

-----------------------------------------------------------------

+ Copyright and Disclaimer, etc.

 This software is free software.
 I have the copyright of this program.
 The author assumes no responsibility for any damages or disabilities resulting from the use of this program.
 The author is not obligated to fix bugs or upgrade.
 There are no restrictions on reprinting and distribution by communication and personal handing as long as there are no changes to the contents.

+ Contact information.

    m_akira@ka2.so-net.ne.jp


+ Reference document.

    https://www.rubiksplace.com/

    https://github.com/kkoomen/qbr#solve-mode

    https://github.com/SmitOanea/Rubik-s-Cube-Solver

    https://qiita.com/7y2n/items/a840e44dba77b1859352

-----------------------------------------------------------------

Windows 10/11 is a registered trademark or trademark of Microsoft Corporation in the United States and other countries.

