cmftStudio Documentation

To build the project from the source code, clone the repository with submodules and use make.

git clone --recurse-submodules http://github.com/dariomanesku/cmftStudio.git
cd cmftStudio
make

Platform Specific Build Instructions

Linux

Build the debug 64-bit version using:

make linux-debug64

To run the application, you must be in the runtime directory so it can find the configuration file:

cd runtime
./../_build/linux64_gcc/bin/cmftStudioDebug

OS X (Xcode)

1. Open the Xcode solution located in _projects/xcode4/.
2. Select your desired build configuration (debug/release, 32/64bit).
3. To ensure a 64-bit build, set Build Settings -> Architectures -> Standard Architectures (64-bit Intel) (x86_64).
4. Important: You must manually set the working directory to the runtime/ folder. Go to Product -> Scheme -> Edit Scheme... -> Run cmftDebug -> Options -> Working Directory (Use custom working directory) and specify the runtime/ directory from the cmft root folder.

OS X (Makefile)

Build from the root directory using:

make osx-release64

(or similar release commands).

TinyDir provides two primary methods for reading directory contents: an iterative approach using tinydir_next and a sorted index-based approach using tinydir_open_sorted.

Iterative Method

Use tinydir_open to initialize the directory and a while loop checking dir.has_next to traverse files. Use tinydir_readfile to populate a tinydir_file structure with the current entry's metadata, then call tinydir_next to advance the iterator.

Sorted Index Method

Use tinydir_open_sorted to load the directory contents into a sorted list. You can then iterate through the directory using a standard for loop up to dir.n_files, accessing specific entries via tinydir_readfile_n using the index i.

// Iterative Method
tinydir_dir dir;
tinydir_open(&dir, "/path/to/dir");

while (dir.has_next)
{
	tinydir_file file;
	tinydir_readfile(&dir, &file);

	printf("%s", file.name);
	if (file.is_dir)
	{
		printf("/");
	}
	printf("\n");

	tinydir_next(&dir);
}

tinydir_close(&dir);

TinyDir is a lightweight C directory and file reader that wraps dirent for POSIX and FindFirstFile for Windows.

Core API

• tinydir_open(dir, path): Opens a directory for iterative reading.
• tinydir_open_sorted(dir, path): Opens a directory and sorts the contents.
• tinydir_readfile(dir, file): Reads the next file in the current iteration.
• tinydir_readfile_n(dir, file, index): Reads a specific file by its index.
• tinydir_next(dir): Advances the iterator.
• tinydir_close(dir): Closes the directory handle.

Data Structures

• tinydir_dir: Represents the directory handle. Contains has_next (bool) and n_files (int).
• tinydir_file: Represents a file entry. Contains name (string) and is_dir (bool).

Known Limitations

• Not threadsafe: Do not use the same tinydir_dir handle across multiple threads without external synchronization.
• Limited path and filename sizes: Be aware of buffer constraints for long paths.
• No wide char support: Does not support Unicode/wide characters (e.g., wchar_t).