﻿=================================================
[Software     name]  Cubic puzzle Ver.3.8
[Registered   name]  Cubicpuzzle.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 is a screen saver add-in software.
 Repeated display of cubic puzzles. Operation as a puzzle is also possible with the startup option.


+ Description of the file.

    <Unzip folder>
    .\ReadMe.txt        : Japanese file.
    .\ReadMe_en.txt     : This file.
    .\Cubicpuzzle.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 Cubicpuzzle.exe to start installation.

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

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


+ Precautions.

 If the graphics performance is low, it may not work smoothly or may not display properly.

 When a transparent color is set for the background, the drawing of the background is different between "frameless mode" and "framed mode".

 Since the background image is acquired at startup, it may not match the image after startup.
 Also, since the background of the screen saver becomes a single color in Windows 8 or later, an image started in another mode is used.
 This image can be registered by pressing the keyboard 'B' in any mode other than the screen saver.

 When using multiple monitors, the display will be limited depending on the video card environment.


+ Simple usage instructions.

 When you start it up, a 3D cube will be displayed.

 Click the icon in the upper left corner, select "Settings" from the menu, specify the background color and speed, and press the "OK" button.

 In addition, the following operations are possible.

  - When rotating the cube surface, click the blocks.
  - You can rotate the mouse by clicking (or touching if the touch is valid) outside or the center of the whole cube. (*1)
  - The size can be changed by grabbing the border of the window with the mouse. (*1)
  - Enable voice recognition (press the 'W' key) to operate the device by voice.

  - Press the "☆" button to move the surface appropriately.
  - Press the "△" button to display one operation up to completion.
  - Press the "◇" button to display the steps for aligning the entire surface.
  - Press the "□" button to switch the background between transparent and non-transparent. (*2)
  - Press the "○" button to You can set the color for each block. (*3,*4)
  - Press the "★" button to display the setting dialog.

 You can set the startup time for "Screensaver".

 The following functions are assigned to the keyboard.

  A  : automatic alignment.
  X  : mixing. (*24)
  N  : step.
  P  : Redo.
  V  : show / hide the buttons.
  C  : Setting dialog is displayed. (*5)

  G  : Register the current background image. (*6,*21)
  K  : Delete the current background image.
  M  : Update the current background image. (*7)

  O  : Restore the previous state. (*8)
  S  : Save the current state. (*8,*9)

  F  : The front rotates 90 degrees. (*10,*11)
  B  : The back rotates 90 degrees. (*10,*11)
  L  : The left rotates 90 degrees. (*10,*11)
  R  : The right rotates 90 degrees. (*10,*11)
  U  : The up rotates 90 degrees. (*10,*11)
  D  : The down rotates 90 degrees. (*10,*11)

  ←, →: Rotate. (*12)
  ↑, ↓: Rotate. (*12)
  Home  : Rotate to the right position.
  End   : Rotate 180 degrees.

  0     : Reset the surface pattern.
  +, -  : Pattern is switched. (*13)
  *     : The surface pattern is switched at random. (*14)
  .     : Switch to custom surface. (*15)
  @     : Test mode.
  Z     : Return to the initial state.
  T     : Temporary cancellation of transparent background. (*16)
  Y     : Background color transparency level adjustment. (*16,*17)
  Q     : Data transfer to Cube Capture. (*22)
  J     : Display solution in HTML. (*23)
  W     : Edit voice command.

  E, Esc: Exit.

 You can set the pattern from the clipboard in the block surface setting dialog. (*18)

 You can specify an external image file by pressing the "+" or "A" key when selecting a pattern. (*19,*20)

 To specify the color with the color picker, click the title on the left of the combo box.

 Added images can be deleted from the right-click menu on the list.

 The BH command is a command that manipulates the faces represented in the unfolded diagram below using symbols.
                    + ----- +
                    |       |
                    |   Up  |
                    | ( U ) |
            + ----- + ----- + ----- + ----- +
            |       |       |       |       |
            | Left  | Front | Right | Back  |
            | ( L ) | ( F ) | ( R ) | ( B ) |
            + ----- + ----- + ----- + ----- +
                    |       |
                    | Down  |
                    | ( D ) |
                    + ----- +
 Specify F to rotate the front face (F) 90 degrees to the right, F2 to rotate 180 degrees to the right, or F' to rotate 90 degrees to the left.


 (*1) If the background is transparent in the frameless mode, you can temporarily cancel it with the'T'key.
 (*2) This is a workaround because the entire cube cannot be rotated when the background is transparent in the frameless mode.
 (*3) When the setting is completed, press the ○ button again.
 (*4) When scanning from the camera, press the Shift key at the same time.(requires installation of cube capture.)
 (*5) You can select or add images.
 (*6) The app disappears temporarily while saving the background.
 (*7) The app is temporarily minimized while the background is updated.
 (*8) The file can be specified by pressing the Ctrl key at the same time.
 (*9) If you select the text by file type, you can save the solving procedure.
 (*10) Pressing the Ctrl key simultaneously reverses the rotation direction.
 (*11) You can move the surface to the front by pressing Shift at the same time.
 (*12) The reference for rotation is in the cube.
 (*13) Other than the numeric keypad, the "+" key corresponds to the "^" key.
 (*14) Other than the numeric keypad, the "*" key corresponds to the "|" key.
 (*15) Effective when the image of the surface is changed in the settings.
 (*16) Limited to frameless mode.
 (*17) Press the Shift key at the same time to return, and press the Ctrl key at the same time to reset.
 (*18) It can be specified by pressing the Ctrl key and the "V" key at the same time.
 (*19) Specify a square (about 200x200) PNG file. The transparent color part is replaced with the set color.
 (*20) You can specify the transparent area by pressing the Ctrl key at the same time, but if the number of the same color is small, the transparent area will be narrowed.
 (*21) You can specify the image file by pressing the Ctrl or Shift keys at the same time. (Ctrl: Set for each monitor, Shift: Same for all monitors)
 (*22) The shortest solution is displayed in Cube Capture.
 (*23) Press the Ctrl key simultaneously to display the shortest solution.
 (*24) You can specify commands in BH notation by pressing the Ctrl key at the same time.


+ Version history.

    Ver.3.8   2026.7.14

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

    Ver.3.7   2025.6.20

    - Added operation using the BH command.
    - Added a function to display the shortest solution.
    - Six new names have been added to the voice commands.
    - Some data related to file saving has been changed.

    Ver.3.6   2025.5.10

    - Adjusted the HTML display of the solution.
    - Added voice command function.
    - Adjusted display synchronization by updating reference images.
    - Fixed a bug that caused afterimages in background transparent mode.
    - Screensaver background images can now be set for each monitor.

    Ver.3.5   2025.3.30

    - Improved background image settings.
    - Support for updating controls.

    Ver.3.4   2024.6.24

    - Organized the installed shortcuts.
    - Fixed the cube capture web page error.

    Ver.3.3   2023.11.25

    - Changed the default color scheme.
    - Added the ability to read scan data files.
    - Added file save/restore and history to the menu.
    - Added deletion function by right-clicking on the file history.
    - Changed the key assignments (U,D,F,B,L,R,1～6) for keyboard operations.

    Ver.3.2   2023.11.1

    - Added HTML format to solution method.
    - You can now specify an image file as the background.
    - Separated scan input from the camera as a separate app.

    Ver.3.1   2023.10.5

    - Supports scan input from the camera.

    Ver.3.0   2023.9.16

    - Fixed an issue where the screen saver did not work on Windows 10.

    Ver.2.9   2023.2.26

    - Removed Windows 8 from supported models.
    - Changed the version of .NET Framework to 4.8.
    - The transparency of the background color can be adjusted with the'Y'key in the frameless mode.

    Ver.2.8   2022.12.17

    - Added support for dark mode switching on Windows 10 and later.

    Ver.2.7   2022.6.25

    - Added support for multi-monitor screen savers. (Video memory: 4GB or more)

    Ver.2.6   2022.6.5

    - Improved the resizing of the transparent background in the frameless mode. (Temporarily cancel with the'T'key)

    Ver.2.5   2022.2.14

    - Added an OFF button to the screen saver settings.

    Ver.2.4   2021.11.11

    - We have confirmed the operation on Windows 11 product version.
    - Changed the eyedropper cursor of the color picker.
    - Added image information to save and restore files.
    - Added support for associating applications with extensions (*.cube).
    - Rebuilt with the latest version of Microsoft Visual Studio 2022 Community.
    - Up to 20 image file histories can be saved / restored.

    Ver.2.3   2021.9.4

    - A color picker has been added to the color specification.
    - Supports keyboards without a ten keyboard.
    - Added image settings from the clipboard.
    - Added JPEG, BMP, GIF to the image file.
    - The transparent color of the image file can be specified.

    Ver.2.2   2021.8.28

    - It is now possible to select 6 images from PNG files.

    Ver.2.1   2021.5.22

    - Fixed a bug that some areas were not drawn in environments other than 100% DPI.

    Ver.2.0   2020.9.24

    - A screen saver has been added to the "Framed mode" menu.
    - Fixed a bug where the backgrounds did not match in a multi-monitor environment with different DPI.
    - Fixed a bug that the size of "frameless mode" cannot be changed on multiple monitors.

    Ver.1.9   2020.3.1

    - Japanese and English resources are separated.
    - Changed the version of .NET Framework to 4.7.
    - Rebuilt with the latest version of Microsoft Visual Studio 2019 Community.

    Ver.1.8   2019.3.10

    - The version of the .NET Framework has been changed to 4.6.1.
    - The rotation direction mark is displayed in the mode with and without the frame.

    Ver.1.7   2019.2.10

    - Fixed the bug that the system menu (Alt + Space) is displayed in the frameless mode.

    Ver.1.6   2018.6.2

    - Windows 7 has been excluded from the supported models.
    - Changed the version of .NET Framework to 4.5.
    - Corresponding to a bug that the latest version cannot be confirmed from the version information.

    Ver.1.5   2018.5.20

    - The name of the installer has been changed from setup.exe to Cubicpuzzle.exe.
    - In the screen saver, the primary display has been given priority.

    Ver.1.4   2017.12.11

    - The command key 'M' of the mixing button has been changed to 'X'.
    - Added the command key 'M' to update the background of the transparent color.
    - Fixed a bug where the background was not displayed correctly in a multiple display environment.
    - When the background is transparent color in "frame mode", it is updated by moving and resizing.

    Ver.1.3   2017.12.4

    - Added a setting button.
    - Buttons can be displayed / hidden with keyboard 'V'.
    - The title of the screen saver has been changed to "Cubic puzzle".

    Ver.1.2   2017.10.15

    - You can now register custom faces.
    - The procedure of how to solve has been saved.
    - Separated resources and modules.
    - Fixed a bug where the data to be restored was missing.
    - Fixed the bug that the background of transparent color was not displayed correctly.
    - Fixed a bug where the orientation of the image was not maintained correctly.
    - 6 images can be selected from patterns.

    Ver.1.1   2017.10.1

    - The pattern of the surface has been added.
    - Adjusted the text size.
    - Added a redo button.
    - 6 colors can be set.
    - Added keyboard 'R' to restore the initial state.
    - The color of each block can be specified.
    - Added keyboard 'L' to restore the previous state.
    - Added keyboard 'S' to record the current state.

    Ver.1.0   2017.9.12

    - 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://ruwix.com/

    https://www.rubiksplace.com/

    https://www.codeproject.com

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

    https://developer.microsoft.com/ja-jp/

    https://docs.microsoft.com/ja-jp/dotnet/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application

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

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

