Skip to content

Latest commit

 

History

History
211 lines (142 loc) · 9.8 KB

README.md

File metadata and controls

211 lines (142 loc) · 9.8 KB
Raw

cmftStudio - cubemap filtering tool

GUI counterpart of cmft - cross-platform open-source cubemap filtering tool.

It reaches very fast processing speeds by utilizing both multi-core CPU and OpenCL GPU at the same time!

Download

cmftStudio - Windows 64bit (updated: 02. May 2015)
cmftStudio - Linux 64bit (updated: 02. May 2015)
cmftStudio - OSX 64bit (updated: 02. May 2015)
In case you need 32bit binaries, compile from source.


  • Latest changes:
    • Major allocator changes. (30. Apr 2015)
    • Material textures can now be loaded from: dds, ktx, tga, hdr, bmp, gif, jpg, png, pvr, tiff. (8. Apr 2015)
    • Gui now scales down on lower resolution screens! Even if you are on a laptop with screen resolution as low as 1366x768, you should be fine. (24. Mar 2015)
    • Added full screen support.


cmftStudioCover

Controls

  • Ctrl/Meta + F == Toggle fullscreen (where supported).
  • Ctrl/Meta + Q == Quit application.
  • On OSX, in case you don't have middle mouse click, use Command + Left click istead.

Supported formats

  • Environment map:
    • Input and output formats: *.dds, *.ktx, *.hdr, *.tga.
    • Input and output types: cubemap, cube cross, latlong, face list, horizontal and vertical strip.
  • Texture:
    • Input formats: *.dds, *.ktx, *.pvr.
  • Mesh:
    • Input formats: *.obj, *.bin (bgfx binary format).

Known issues

  • Windows
    • There seem to be some rendering problems when using OpenGL backend with a Radeon GPU. For now, on Windows, use DirectX9 or DirectX11 rendering backends until the problem gets fixed, More details here.

Installing

  • Windows: No installation available. Put the cmftStudio.exe along with cmftStudio.conf in a desired folder and use it from there
  • Linux: Use make install and make uninstall. This will create /usr/local/bin/cmftStudio and a desktop shortcut.

Building

git clone --recurse-submodules http://github.com/dariomanesku/cmftStudio.git
cd cmftStudio
make
  • After calling make, _projects folder will be created with all supported project files. Deleting _projects folder is safe at any time.<br >
  • All compiler generated files will be in _build folder. Again, deleting _build folder is safe at any time.<br >

Windows

  • Visual Studio solutions can be found in _projects/vs20XX/.<br >

Linux

  • From root directory call make linux-debug64 to build the application. Application should be run from the runtime directory where the config file is:<br > cd runtime<br > ./../_build/linux64_gcc/bin/cmftStudioDebug <br >
  • Application can be installed or removed from the system by calling sudo make linux-install and sudo make linux-uninstall.`

OS X

  • XCode
    • XCode solution can be found in _projects/xcode4/.<br >
    • XCode project contains one scheme with 4 build configurations (debug/release 32/64bit). Select desired build configuration manually and/or setup schemes manually as desired. In case you need 64bit build, it is possible to just set Build Settings -> Architectures -> Standard Architectures (64-bit Intel) (x86_64).<br >
    • Also it is probably necessary to manually set runtime directory (it is not picking it from genie for some reason). This is done by going to "Product -> Scheme -> Edit Scheme... -> Run cmftDebug -> Options -> Working Directory (Use custom working directory)" and specifying runtime/ directory from cmft root folder.<br >
  • Makefile
    • Makefile can be found in _projects/gmake-osx/.<br >
    • Project can be build from the root directory by running make osx-release64 (or similar).<br > <br >

Screenshots

cmftStudioAplha1 cmftStudioSpheres0 cmftStudioWin5 cmftStudioOsx1 cmftStudioWin4 cmftStudioOsx0 cmftStudioWin3 cmftStudioSpheres1

Planned features

  • Add full screen support.
  • Add support for rendering transparent materials.
  • Add GGX specular filter and shading model.

Discussion

Environment maps

Recommended tools

Similar projects

  • CubeMapGen - A well known tool for cubemap filtering from AMD.<br >
  • IblBaker - A similar open-source project.
  • Marmoset Skyshop - Commercial plugin for Unity3D Game engine.
  • Knald Lys - Commercial tool from KnaldTech.

Contribution

Everyone is welcome to contribute to cmftStudio by submitting code, bug reports, feature requests, testing on different platforms, profiling, etc.

When contributing to the cmftStudio project you must agree to the BSD 2-clause licensing terms.

Resources

Thanks to

  • Marko Radak - Initial cover photo design and realization.
  • Dorian Cioban - Additional cover photo improvements.
  • All authors of used assets in the project.

Contact

Reach me via Twitter: @dariomanesku.

License (BSD 2-clause)

Copyright 2014-2015 Dario Manesku. All rights reserved.

https://github.com/dariomanesku/cmftStudio

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

   1. Redistributions of source code must retain the above copyright notice,
      this list of conditions and the following disclaimer.

   2. Redistributions in binary form must reproduce the above copyright notice,
      this list of conditions and the following disclaimer in the documentation
      and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY COPYRIGHT HOLDER ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
EVENT SHALL COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Disclaimer

Licence applies only to cmftStudio project, NOT including the assets supplied in the sample projects. If you wish to use available third party resources, for any purpose, you must contact their respected authors/companies personally.