Home / 1.2.0.0
Name Modified Size Downloads / Week Status
Parent folder
Totals: 2 Items   14.9 MB 2
procedural_generator-src-v1_2_0_0.zip 2011-08-05 173.1 kB 11 weekly downloads
procedural_generator-w32-v1_2_0_0.zip 2011-08-05 14.7 MB 11 weekly downloads
# # **-----------------------------------------------------------------------** # ** Procedural Generator ** # **-----------------------------------------------------------------------** # ** Cellular automat and image processing application ** # **-----------------------------------------------------------------------** # ** First version of this file: may 10th 2012 ** # **-----------------------------------------------------------------------** # Overview : I. Description II. Building Procedural Generator III. Options IV. Running Procedural Generator V. General Questions # **-----------------------------------------------------------------------** # ** I. Description ** # **-----------------------------------------------------------------------** Procedural Generator is an application that can load various image treatment pluggins. The main application loads the pluggins, allows pluggin selection, displays computation results. The pluggins' job is made in 2 steps : - 1st step : CPU step : image computing using CPU computations. - 2nd step : GPU step : image post-processing using GPU through GLSL shaders. Some pluggins only use CPU step, such as Perlin Noise, Life Game, Diffusion Limited aggregation. Some others use only the GPU step, such as Shader Effects, Text Effects. The GPU step uses OpenGL and allows the use of GLSL shaders. The CPU step is multithreaded in order to fasten the computations. # **-----------------------------------------------------------------------** # ** II. Building Procedural Generator ** # **-----------------------------------------------------------------------** Procedural Generator uses CMake to build project files. You just need to launch cmake to build your preferential projet file. Tested compilers are : - Visual Studio 2010 - gcc 4.6.2 - gcc 4.7.0 - clang 2.7-3 The main application and the pluggins are based upon wxWidgets (from 2.8.11, runs on 2.9.3) so on GNU/Linux it also depends on GTK. ShaderWebcam also depends on OpenCV (at least 2.1.0) but doesn't compile with clang, because of OpenCV (which is not clang compliant). Documentation can be generated using Doxygen. # **-----------------------------------------------------------------------** # ** III. Options ** # **-----------------------------------------------------------------------** On GNU/linux the default install directory is in /usr/local. You can change this directory by changing the CMAKE_INSTALL_PREFIX value. The main application is installed in <install_dir>/bin/ The library LibGenerator (used to build your own plugins) is installed in <install_dir>/lib/. The plugins are installed in <install_dir>/shared/ProceduralGenerator/ # **-----------------------------------------------------------------------** # ** IV. Running Procedural Generator ** # **-----------------------------------------------------------------------** To run Procedural Generator, simply type 'ProceduralGenerator' in your preferred command-line. # **-----------------------------------------------------------------------** # ** V. General Questions ** # **-----------------------------------------------------------------------** 1. I need a feature that ProceduralGenerator doesn't implement, what can I do ? There are two ways. First, Procedural Generator is a GPL software and library, so you are welcome to improve it yourself ;-) ! Second, just ask the author :-) ! 2. I implemented a cool feature, can I commit it ? Obviously you are welcome to send the author any improvement. But obviously the author is quite careful with readability, correctness and stability, and will read and check any contribution before including it. Thus, it can take time... There are few basic rules to write contributions: - (1) Do never change the indentation of any part of the code that is not yours. - (2) Do never send codes without a lot of comments in (bad or good) english. - (3) Do never send codes with obscure and/or non-english variable names. 3. I implemented a great pluggin, can I commit it ? I will be really proud to be proposed new pluggins for Procedural Generator. But as for any improvement, I will check and test it before integrating it to Procedural Generator. 4. Is Procedural Generator bug free ? No, who can ? I do not pretend it to be bug free. Nevertheless because it has been tested, I am fairly sure that Procedural Generator results with default options has good chances to be satisfactory. If you encounter trouble, send the most exhaustive description of what you did and what happened. I will try to explain the result or to fix the problem as soon as possible. 5. How can I ask the author ? Just send a mail to dragonjoker59@hotmail.com !
Source: README, updated 2012-06-20