Skip to content
CGRU - AFANASY
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.spelling rules.php - changed constant vars to defined constants Nov 25, 2017
afanasy afwatch: left panel buttons improvements Jun 7, 2019
bin openterminal and openfolder commands Apr 29, 2019
docs sphincs documentation started, that will be hosted on readthedocs Apr 21, 2019
examples example job: --os flag to specify needed OS. May 28, 2019
icons opensuse depends Jan 30, 2019
lib pools: services info and manipulation Jun 3, 2019
plugins houdini: max run time in hours, min mem in GB Mar 13, 2019
rules
rules_root rules: some paths Oct 4, 2016
software_setup
start keeper terminal commands for windows Apr 29, 2019
utilities dailies: gray text annotaions instead of white Jun 7, 2019
.clang-format refactored lib/js/cgru.js Nov 12, 2017
.gitignore rules execute Nov 26, 2018
README.md added information about file header description to README.md Nov 16, 2017
config_default.json openterminal and openfolder commands Apr 29, 2019
favicon.ico js: software icons images preload Sep 10, 2012
htaccess_example rules: example Feb 20, 2019
index.html rules flags in navig folders Apr 9, 2019
player.html rules: broken player fix Nov 1, 2018
rules.php rules: all fwrite()-s are replaced by fileWrite()-s Dec 18, 2018
setup.cmd windows release issues Apr 25, 2016
setup.sh mrproper on setup scripts Dec 1, 2015
setup_README.cmd project from sourceforge subversion added Mar 13, 2012
setup_README.sh project from sourceforge subversion added Mar 13, 2012
setup_afanasy.cmd config default mistake, cmake project clear keeps .gitignore Mar 19, 2012
setup_afanasy.sh libafapi and libpyaf projects removed Apr 14, 2012
setup_python.cmd Fixed compatibility with a new Qt.py, PySide2 and Qt-11 May 4, 2018
setup_python.sh cgru: POSIX way for equality (work for zsh and bash) Jan 17, 2017
start.cmd project from sourceforge subversion added Mar 13, 2012
start.command project from sourceforge subversion added Mar 13, 2012
start.sh project from sourceforge subversion added Mar 13, 2012
version.txt afanasy: This is a new version, not compatible with any previous. May 29, 2019

README.md

CGRU

CGRU is the Computer Graphics Tools Pack.

It consists of the main tools Afanasy and Rules. Other tools are arranged as satellites around these two, like dailies encoding scripts and software submission plug-ins.

Afanasy is a render farm manager.

Rules is a Web based CG projects tracker.

Documentation

Forum

You can ask any questions on the CGRU forum.

GitHub issues are used for code development and bug tracking.

Coding rules:

  • Indentation - TABS. You can vary tab length, default 4 spaces length is normal.
    • Python Indentation - SPACES(4). It is not a problem to tune any modern text editor for each file type.
  • Code alignment - SPACES, it should not break on various tab length.
  • Variable names: variable_name.
  • Function names: functionName.
  • Class names: ClassName.
  • Use prefixes to make code more readable:
    • i_ - Input variables.
    • o_ - Output variables.
    • m_ - Class members.
    • ms_ - Static class members.
    • g_ - External variables.
    • v_ - Virtual functions.
  • Do not use "!" as NOT, since it is not noticeable for doing code review. It is much more easy to notice false == .
  • Use false == var and NULL == val instead of var == false or var == NULL. As if you miss one '=' character, it will not be an error, it will be assignment, not comparison.
  • Use const & to pass complex types as function parameters to not to copy class instance.

Example:

// Function with long parameters list:
bool someFunction(std::string &o_status, const std::string &i_param1, const std::string &i_param2,
	const std::string &i_param3, const std::string &i_param4)
{
	...

	if (false == variable_name)
	{
		o_status = "error";
		return false;
	}
	return true;
}

You will notice, that some parts of the code are not following these rules. This is mostly because such code has been written before these rules were created or changed.

The typical file header and code style for C++ and JS files can automatically be applied with the script utilities/maintenance/codeStyleCheck.php see the file for instructions of setup and usage.

The file header shall contain as much information as possible about the file, you can find a good example here: afanasy/browser/monitor.js

Some names:

CGRU - came from CG - Rules. It has two meanings: computer graphics principles and computer graphics is a cool thing.

Afanasy - came from a Greek name meaning immortal.

Rules - simple came from rules! This project tracker is based on defined rules. Mostly project structure rules, where to store sources, references, dailies, outputs. As Rules does not have its own database, it walks file-server folders structure.

You can’t perform that action at this time.