assimp/samples
Marc-Antoine Lortie d9042e4609 Fixed SimpleTexturedOpenGL sample.
Several places in the sample's code were calling Unicode versions of Win32 functions with "multibyte" strings. A few changes were required to fix it.

I added a class "UTFConverter", which handles calls to unicode/multibyte string conversions. This should help minimize the impacts on code change in case C++'s codecvt_utf8 ever changes.

In addition, seveal memory leaks have been found, but these fixes will come in another PR because it goes beyond the scope of this PR.

DevIL.lib was removed in CMakeFiles.txt, as it is unused in the sample.

Here is a list of the changes:

- Fixed MB string calls to Unicode functions.
- Added class UTFConverter to handle string conversions.
- Removed reference to DevIL.lib.
- Fixed compile warnings.
2020-02-15 18:02:12 -05:00
..
SimpleAssimpViewX header paths adjusted for unit tests and samples 2018-01-05 23:12:40 -08:00
SimpleOpenGL Update CMakeLists.txt 2019-09-09 23:00:04 +02:00
SimpleTexturedDirectx11 disable samples per default. 2019-11-15 21:46:09 +01:00
SimpleTexturedOpenGL Fixed SimpleTexturedOpenGL sample. 2020-02-15 18:02:12 -05:00
README Update README 2019-02-07 19:22:47 +01:00

README


ASSIMP SAMPLES README
=====================


1. General
----------

This directory contains various samples to illustrate Assimp's
use in various real-world environments. Workspaces to build the
samples can be found in the respective directories. The VC workspaces
copy the created executables to the ./bin directory.

All GL-based samples depend on FreeGLUT, the image loading will be done 
by a header-only library. For convenience, these libraries are included
in the repository in their respective Windows/x86 prebuilt versions.
To build on linux, install freeglut using the package manager of your 
choice. For instance on Ubuntu to install freeglut you can use the following
command:

> sudo apt install freeglut

All samples will be placed at 

Win32: <assimp_repo>/<config>/bin

or Linux : <assimp_repo>/bin


2. List of samples
------------------

SimpleOpenGL

  A very simple and straightforward OpenGL sample. It loads a
  model (gets the path to it on the command line, default is dwarf.x)
  and displays the model as wireframe. Animations and materials are
  not evaluated at all. This samples uses the C interface to Assimp.
  Basic materials are displayed, but no textures.

  This sample should work virtually everywhere, provided glut
  is available.


SimpleTexturedOpenGL

  An extended OpenGL sample, featuring texturing using the DevIL 
  library. Based on SimpleOpenGL and the NeHe GL tutorial style.

  This is a Windows-only sample.

  This sample was kindly provided by SamHayne (http://sf.net/users/samhayne/)
  See http://sourceforge.net/projects/assimp/forums/forum/817654/topic/3736373


SimpleAssimpViewX

  A Mac OSX-based viewer app. This sample was kindly provided by drparallax. 
  See http://sourceforge.net/projects/assimp/forums/forum/817654/topic/3917829