forked from bartvdbraak/blender
Start simple intros for intern and extern libs.
Some reorg of modules/pages, start makesdna and makesrna. In many places license block needs to be changed to not start with /**, because otherwise documentation will go weird.
This commit is contained in:
parent
8a63ee46ba
commit
f697247f0e
@ -2,23 +2,17 @@
|
|||||||
*
|
*
|
||||||
* \section intro Introduction
|
* \section intro Introduction
|
||||||
*
|
*
|
||||||
* Blender is an integrated 3d package, which features:
|
* Blender is an integrated 3d package.
|
||||||
* - modeling
|
|
||||||
* - animation
|
|
||||||
* - texturing
|
|
||||||
* - compositing
|
|
||||||
* - rendering
|
|
||||||
* - scripting
|
|
||||||
* - game creation
|
|
||||||
*
|
*
|
||||||
* These pages document the source code of blender.
|
* These pages document the source code of blender.
|
||||||
*
|
*
|
||||||
|
* For more information on using Blender browse to http://www.blender.org
|
||||||
|
*
|
||||||
* \section sects Main sections of the blender code
|
* \section sects Main sections of the blender code
|
||||||
*
|
*
|
||||||
* The following sections are the broad categories into which the various modules
|
* The following sections are the broad categories into which the various modules
|
||||||
* belong.
|
* belong.
|
||||||
*
|
*
|
||||||
* - \ref mainmodule
|
|
||||||
* - \ref render
|
* - \ref render
|
||||||
* - \ref meshedit
|
* - \ref meshedit
|
||||||
* - \ref texture
|
* - \ref texture
|
||||||
@ -41,22 +35,47 @@
|
|||||||
* - \ref undoc
|
* - \ref undoc
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/** \defgroup mainmodule Main Module */
|
/** \defgroup intern Internal libraries
|
||||||
/** \defgroup defaultconfig Default and Configuration
|
* \section internabout Internal libraries
|
||||||
* \ingroup mainmodule
|
* Blender comes with some of its dependencies
|
||||||
|
* directly included in the codebase. Libraries
|
||||||
|
* that are in the \c intern/ folder are maintained
|
||||||
|
* as part of the normal development process.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
/** \defgroup extern External libraries
|
||||||
|
* \section externabout External libraries
|
||||||
|
* As with \ref intern these libraries are
|
||||||
|
* provided in the Blender codebase. This is
|
||||||
|
* to make building Blender easier. The main
|
||||||
|
* development of these libraries is \b not part
|
||||||
|
* of the normal Blender development process, but
|
||||||
|
* each of the library is developed separately.
|
||||||
|
* Whenever deemed necessary libraries in \c extern/
|
||||||
|
* folder are updated.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
/** \defgroup editors Editor modules */
|
||||||
|
/** \defgroup blenderplayer Blender Player */
|
||||||
|
|
||||||
/** \defgroup render Rendering Module */
|
/** \defgroup render Rendering Module */
|
||||||
/** \defgroup meshedit Mesh Editing Module */
|
/** \defgroup meshedit Mesh Editing Module */
|
||||||
/** \defgroup texture Texturing */
|
/** \defgroup texture Texturing */
|
||||||
/** \defgroup compositor Compositing */
|
/** \defgroup compositor Compositing */
|
||||||
|
|
||||||
/** \defgroup scripts Scripting */
|
/** \defgroup scripts Scripting */
|
||||||
|
|
||||||
/** \defgroup gameengine Game Engine */
|
/** \defgroup gameengine Game Engine */
|
||||||
/** \defgroup audaspace Audaspace */
|
|
||||||
|
/** \defgroup audaspace Audaspace
|
||||||
|
* \ingroup intern undoc
|
||||||
|
* \todo add to doxygen
|
||||||
|
*/
|
||||||
|
|
||||||
/** \defgroup data DNA and RNA */
|
/** \defgroup data DNA and RNA */
|
||||||
|
|
||||||
/** \defgroup GHOST GHOST API */
|
/** \defgroup GHOST GHOST API */
|
||||||
|
|
||||||
/** \defgroup DNA sDNA
|
/** \defgroup DNA sDNA
|
||||||
* \ingroup data
|
* \ingroup data
|
||||||
*/
|
*/
|
||||||
@ -65,15 +84,12 @@
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
/** \defgroup gui GUI */
|
/** \defgroup gui GUI */
|
||||||
/** \defgroup hotkeys Hotkeys
|
|
||||||
* \ingroup gui
|
|
||||||
*/
|
|
||||||
/** \defgroup toolbox Toolbox
|
|
||||||
* \ingroup gui
|
|
||||||
*/
|
|
||||||
/** \defgroup wm windowmanager
|
/** \defgroup wm windowmanager
|
||||||
* \ingroup gui
|
* \ingroup gui
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/** \defgroup imbuf IMage Buffer */
|
/** \defgroup imbuf IMage Buffer */
|
||||||
/** \defgroup undoc Undocumented */
|
|
||||||
|
/** \defgroup undoc Undocumented
|
||||||
|
* \brief Modules and libraries that are still undocumented, or lacking proper integration into the doxygen system, are marked in this group. */
|
||||||
|
@ -25,6 +25,7 @@
|
|||||||
*
|
*
|
||||||
* ***** END GPL LICENSE BLOCK *****
|
* ***** END GPL LICENSE BLOCK *****
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/*! \ingroup GHOST
|
/*! \ingroup GHOST
|
||||||
* \file GHOST_ISystem.h
|
* \file GHOST_ISystem.h
|
||||||
* %Main interface file for C++ Api with declaration of GHOST_ISystem interface
|
* %Main interface file for C++ Api with declaration of GHOST_ISystem interface
|
||||||
@ -88,8 +89,6 @@ class GHOST_IEventConsumer;
|
|||||||
* <ul>
|
* <ul>
|
||||||
* <li>GHOST_IEvent.h</li>
|
* <li>GHOST_IEvent.h</li>
|
||||||
* <li>GHOST_IEventConsumer.h</li>
|
* <li>GHOST_IEventConsumer.h</li>
|
||||||
* <li>GHOST_IMenu.h (in progress)</li>
|
|
||||||
* <li>GHOST_IMenuBar.h (in progress)</li>
|
|
||||||
* <li>GHOST_ISystem.h</li>
|
* <li>GHOST_ISystem.h</li>
|
||||||
* <li>GHOST_ITimerTask.h</li>
|
* <li>GHOST_ITimerTask.h</li>
|
||||||
* <li>GHOST_IWindow.h</li>
|
* <li>GHOST_IWindow.h</li>
|
||||||
@ -108,11 +107,7 @@ class GHOST_IEventConsumer;
|
|||||||
* in the ?/ghost/test/gears/ directory.
|
* in the ?/ghost/test/gears/ directory.
|
||||||
*
|
*
|
||||||
* \section work Work in progress
|
* \section work Work in progress
|
||||||
*
|
* \todo write WIP section
|
||||||
* \subsection menus Menu functionality
|
|
||||||
* Menu bars with pull-down menu's for windows are in development in the
|
|
||||||
* current version of GHOST. The file GHOST_MenuDependKludge.h contains a
|
|
||||||
* setting to turn menu functionality on or off.
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/** \interface GHOST_ISystem
|
/** \interface GHOST_ISystem
|
||||||
|
@ -27,11 +27,11 @@
|
|||||||
* ***** END GPL LICENSE BLOCK *****
|
* ***** END GPL LICENSE BLOCK *****
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/*!
|
/**
|
||||||
* \ingroup DNA
|
|
||||||
* \page makesdna makesdna
|
* \page makesdna makesdna
|
||||||
|
* \ingroup DNA
|
||||||
*
|
*
|
||||||
* @section aboutdna About the DNA module
|
* \section aboutdna About the DNA module
|
||||||
*
|
*
|
||||||
* The DNA module holds all type definitions that are serialized in a
|
* The DNA module holds all type definitions that are serialized in a
|
||||||
* blender file. There is an executable that scans all files, looking
|
* blender file. There is an executable that scans all files, looking
|
||||||
@ -39,7 +39,7 @@
|
|||||||
* information, it builds a file with numbers that encode the format,
|
* information, it builds a file with numbers that encode the format,
|
||||||
* the names of variables, and the plce to look for them.
|
* the names of variables, and the plce to look for them.
|
||||||
*
|
*
|
||||||
* @section dnaissues Known issues with DNA
|
* \section dnaissues Known issues with DNA
|
||||||
*
|
*
|
||||||
* - Function pointers:
|
* - Function pointers:
|
||||||
*
|
*
|
||||||
@ -58,19 +58,19 @@
|
|||||||
* have to change this (Not very flexible, but it is hardly ever
|
* have to change this (Not very flexible, but it is hardly ever
|
||||||
* changed. Sorry.).
|
* changed. Sorry.).
|
||||||
*
|
*
|
||||||
* @section dnadependencies Dependencies
|
* \section dnadependencies Dependencies
|
||||||
*
|
*
|
||||||
* DNA has no external dependencies (except for a few system
|
* DNA has no external dependencies (except for a few system
|
||||||
* includes).
|
* includes).
|
||||||
|
|
||||||
* @section dnanote NOTE
|
* \section dnanote NOTE
|
||||||
|
|
||||||
PLEASE READ INSTRUCTIONS ABOUT ADDING VARIABLES IN 'DNA' STRUCTS IN
|
PLEASE READ INSTRUCTIONS ABOUT ADDING VARIABLES IN 'DNA' STRUCTS IN
|
||||||
|
|
||||||
intern/dna_genfile.c
|
intern/dna_genfile.c
|
||||||
(ton)
|
(ton)
|
||||||
|
|
||||||
**/
|
*/
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
@ -1,6 +1,4 @@
|
|||||||
/**
|
/*
|
||||||
* blenlib/DNA_sdna.h (mar-2001 nzc)
|
|
||||||
*
|
|
||||||
* $Id$
|
* $Id$
|
||||||
*
|
*
|
||||||
* ***** BEGIN GPL LICENSE BLOCK *****
|
* ***** BEGIN GPL LICENSE BLOCK *****
|
||||||
@ -30,6 +28,10 @@
|
|||||||
*/
|
*/
|
||||||
#ifndef DNA_SDNA_H
|
#ifndef DNA_SDNA_H
|
||||||
#define DNA_SDNA_H
|
#define DNA_SDNA_H
|
||||||
|
/**
|
||||||
|
* \file DNA_sdna_types.h
|
||||||
|
* \ingroup DNA
|
||||||
|
*/
|
||||||
|
|
||||||
#
|
#
|
||||||
#
|
#
|
||||||
|
@ -27,8 +27,11 @@
|
|||||||
* ***** END GPL LICENSE BLOCK *****
|
* ***** END GPL LICENSE BLOCK *****
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/** Struct muncher for making SDNA
|
/** \file makesdna.c
|
||||||
|
* \brief Struct muncher for making SDNA.
|
||||||
|
* \ingroup DNA
|
||||||
*
|
*
|
||||||
|
* \section aboutmakesdnac About makesdna tool
|
||||||
* Originally by Ton, some mods by Frank, and some cleaning and
|
* Originally by Ton, some mods by Frank, and some cleaning and
|
||||||
* extension by Nzc.
|
* extension by Nzc.
|
||||||
*
|
*
|
||||||
@ -43,7 +46,7 @@
|
|||||||
* and the offsets for reaching a particular one.
|
* and the offsets for reaching a particular one.
|
||||||
*
|
*
|
||||||
* There is a facility to get verbose output from sdna. Search for
|
* There is a facility to get verbose output from sdna. Search for
|
||||||
* debugSDNA. This int can be set to 0 (no output) to some int. Higher
|
* \ref debugSDNA. This int can be set to 0 (no output) to some int. Higher
|
||||||
* numbers give more output.
|
* numbers give more output.
|
||||||
* */
|
* */
|
||||||
|
|
||||||
@ -146,7 +149,8 @@ short **structs, *structdata; /* at sp= structs[a] is the first address of a str
|
|||||||
sp[0] is type number
|
sp[0] is type number
|
||||||
sp[1] is amount of elements
|
sp[1] is amount of elements
|
||||||
sp[2] sp[3] is typenr, namenr (etc) */
|
sp[2] sp[3] is typenr, namenr (etc) */
|
||||||
/*
|
/**
|
||||||
|
* Variable to control debug output of makesdna.
|
||||||
* debugSDNA:
|
* debugSDNA:
|
||||||
* - 0 = no output, except errors
|
* - 0 = no output, except errors
|
||||||
* - 1 = detail actions
|
* - 1 = detail actions
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
/*! \page makesrna makesrna
|
/** \page makesrna makesrna
|
||||||
* \ingroup RNA
|
* \ingroup RNA
|
||||||
* \section aboutmakesrna About RNA
|
* \section aboutmakesrna About RNA
|
||||||
* The \ref RNA module defines and provides the access API to the data, thus encapsulating \ref DNA
|
* The \ref RNA module defines and provides the access API to the data, thus encapsulating \ref DNA
|
||||||
|
Loading…
Reference in New Issue
Block a user