wxWidgets/utils/screenshotgen
Vadim Zeitlin f69dbaa1ae Introduce MSW ARM64 support
This is a preliminary ARM64 platform support for wxWidgets at "it
compiles" stage. This will allow building and testing wxWidgets based
apps for oncoming Windows 10 ARM64.

Requirements:
- Visual Studio 2017 Update 4 or later with Visual C++ compilers and
  libraries for ARM64 component installed

Building:
1. Open command prompt.
2. Change directory to build\msw subfolder.
3. Run "C:\Program Files (x86)\Microsoft Visual
   Studio\2017\Community\VC\Auxiliary\Build\vcvarsamd64_arm64.bat" once.
4. Use `nmake TARGET_CPU=ARM64 ...` to build required flavor of wxWidget
   libraries.

Notes:
1. Building of *.sln/*.vcxproj files does not support ARM64 yet. This
   requires to hardcode Windows SDK to 10.0.15063.0 or later in
   *.vcxproj files, which would render them non-compilable in older
   Visual Studio versions. Microsoft is aware of this issue and is
   planning a fix in the next version of Visual Studio.
2. wxmsw31ud_gl.dll does not build yet. Awaiting Microsoft to deliver
   missing opengl32.lib for ARM64. Please, specify USE_OPENGL=0.

Closes https://github.com/wxWidgets/wxWidgets/pull/923
2018-09-17 22:34:32 +02:00
..
src Introduce MSW ARM64 support 2018-09-17 22:34:32 +02:00
Makefile.in
README.txt

 wxWidgets Controls Screenshot Generator
 =======================================

 Author: Utensil Candel (Email: UtensilCandel at GMail dot com)
 Licence: wxWindows licence

 Thanks: Francesco Montorsi, Bryan Petty, Auria, Jorg and wxForum

 This utility is developed to automatically generate screenshots of the wxWidgets
 controls for use in wxWidgets documentation.

 The main part of the GUI (guiframe.h/guiframe.cpp) was generated with wxFormBuilder
 (http://wxformbuilder.org/), a powerful cross-platform open-source RAD tool. Now its
 trace is removed so we can maintain the code without using it.


===User Guide: How To Use==

The screenshots will be generated under sub-directory "screenshots" silently.
Please monitor this folder before taking screenshots using "File->Open screenshots folder".

1) The menu "Capture->Full screen" can take a screeshot for the fullscreen. It's designed
for testing purpose only.

2) The menu "Capture->Regions<Begin>" and "Capture->Regions<End>" was the semi-auto part,
and now it's deprecated and will be removed soon.

3) Finally the full-auto mode: "Capture->Capture All" or Ctrl+Alt+A, follow the instructions
 and all the screenshots will be generated correctly under the subdirectory "screenshots".

 ==Developer Guide: How To Add More Controls==

 (Coming soon)

 ==To-do List==

 1) Remove wxAuiNoteBook related lagacy codes, which is no longer useful;

 2) Refactor the GUI code, which was generated by wxFormBuilder, but it's messy for human to
 maintain;

 3) Remove the class CtrlMaskOut since semi-auto part of this utility is no longer needed.

 4) Clearify the interface of class AutoCaptureMechanism and document how to add a new control
 that needs to take screenshots, and how to adjust it to avoid bugs in wxRTTI system and
 wxWindow::GetScreenRect();

 5) Make this utility easier to configure;

 6) Add test functionality to confirm bugs in wxRTTI system and wxWindow::GetScreenRect().