<commit_before>Building
========

Dependencies
------------

https://github.com/bkaradzic/bx

https://github.com/bkaradzic/bimg

Getting Source
--------------

::

    git clone https://github.com/bkaradzic/bx.git
    git clone https://github.com/bkaradzic/bimg.git
    git clone https://github.com/bkaradzic/bgfx.git

Quick Start
-----------

These are step for users who use Windows with Visual Studio.

Enter bgfx directory:

::

    cd bgfx

Generate Visual Studio 2017 project files:

::

    ..\bx\tools\bin\windows\genie --with-examples vs2017

Open bgfx solution in Visual Studio 2017:

::

    start .build\projects\vs2017\bgfx.sln

.. note:: For more detailed prerequisites and build steps on other platforms see below.

Prerequisites
-------------

Android
~~~~~~~

Download Android NDK (r23 or newer):

 - https://developer.android.com/tools/sdk/ndk/index.html

Set following environment variables:

::

    setx ANDROID_NDK_ROOT <path to AndroidNDK directory>


To deploy on Android you can use bgfx android activity:

 - https://github.com/Nodrev/bgfx-android-activity#bgfx-android-activity---android-glue-for-bgfx

Linux
~~~~~

::

    sudo apt-get install libgl1-mesa-dev x11proto-core-dev libx11-dev

Windows
~~~~~~~

Windows users download GnuWin32 utilities:

 - http://gnuwin32.sourceforge.net/packages/make.htm
 - http://gnuwin32.sourceforge.net/packages/coreutils.htm
 - http://gnuwin32.sourceforge.net/packages/libiconv.htm
 - http://gnuwin32.sourceforge.net/packages/libintl.htm

.. note:: **MSYS**, **Cygwin**, etc. shells are not supported!
   You must use use **cmd.exe** with provided makefiles.

Build
-----

bgfx uses `GENie - Project generator tool <https://github.com/bkaradzic/genie#genie---project-generator-tool>`__
to generate project files for various platform. Binaries for Linux, OSX, and Windows are included in<commit_msg>Removed bgfx-android-activity info from docs.<commit_after>Building
========

Dependencies
------------

https://github.com/bkaradzic/bx

https://github.com/bkaradzic/bimg

Getting Source
--------------

::

    git clone https://github.com/bkaradzic/bx.git
    git clone https://github.com/bkaradzic/bimg.git
    git clone https://github.com/bkaradzic/bgfx.git

Quick Start
-----------

These are step for users who use Windows with Visual Studio.

Enter bgfx directory:

::

    cd bgfx

Generate Visual Studio 2017 project files:

::

    ..\bx\tools\bin\windows\genie --with-examples vs2017

Open bgfx solution in Visual Studio 2017:

::

    start .build\projects\vs2017\bgfx.sln

.. note:: For more detailed prerequisites and build steps on other platforms see below.

Prerequisites
-------------

Android
~~~~~~~

Download Android NDK (r23 or newer):

 - https://developer.android.com/tools/sdk/ndk/index.html

Set following environment variables:

::

    setx ANDROID_NDK_ROOT <path to AndroidNDK directory>


Linux
~~~~~

::

    sudo apt-get install libgl1-mesa-dev x11proto-core-dev libx11-dev

Windows
~~~~~~~

Windows users download GnuWin32 utilities:

 - http://gnuwin32.sourceforge.net/packages/make.htm
 - http://gnuwin32.sourceforge.net/packages/coreutils.htm
 - http://gnuwin32.sourceforge.net/packages/libiconv.htm
 - http://gnuwin32.sourceforge.net/packages/libintl.htm

.. note:: **MSYS**, **Cygwin**, etc. shells are not supported!
   You must use use **cmd.exe** with provided makefiles.

Build
-----

bgfx uses `GENie - Project generator tool <https://github.com/bkaradzic/genie#genie---project-generator-tool>`__
to generate project files for various platform. Binaries for Linux, OSX, and Windows are included in
{'fraction_non_alphanumeric': 0.1482098251457119, 'fraction_numerical': 0.018318068276436304, 'mean_word_length': 3.2550177095631643, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 15, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2917783', 'n_tokens_mistral': 1258, 'n_tokens_neox': 1133, 'n_words': 294}