Doc

Utilities for documenting entities, components and systems. More...

Classes
struct	EcsDocDescription

Typedefs
typedef struct EcsDocDescription	EcsDocDescription

Functions
FLECS_API const ecs_entity_t	ecs_id (EcsDocDescription)
FLECS_API void	ecs_doc_set_name (ecs_world_t *world, ecs_entity_t entity, const char *name)
	Add human-readable name to entity. More...
FLECS_API void	ecs_doc_set_brief (ecs_world_t *world, ecs_entity_t entity, const char *description)
	Add brief description to entity. More...
FLECS_API void	ecs_doc_set_detail (ecs_world_t *world, ecs_entity_t entity, const char *description)
	Add detailed description to entity. More...
FLECS_API void	ecs_doc_set_link (ecs_world_t *world, ecs_entity_t entity, const char *link)
	Add link to external documentation to entity. More...
FLECS_API void	ecs_doc_set_color (ecs_world_t *world, ecs_entity_t entity, const char *color)
	Add color to entity. More...
FLECS_API const char *	ecs_doc_get_name (const ecs_world_t *world, ecs_entity_t entity)
	Get human readable name from entity. More...
FLECS_API const char *	ecs_doc_get_brief (const ecs_world_t *world, ecs_entity_t entity)
	Get brief description from entity. More...
FLECS_API const char *	ecs_doc_get_detail (const ecs_world_t *world, ecs_entity_t entity)
	Get detailed description from entity. More...
FLECS_API const char *	ecs_doc_get_link (const ecs_world_t *world, ecs_entity_t entity)
	Get link to external documentation from entity. More...
FLECS_API const char *	ecs_doc_get_color (const ecs_world_t *world, ecs_entity_t entity)
	Get color from entity. More...
FLECS_API void	FlecsDocImport (ecs_world_t *world)

Variables
FLECS_API const ecs_entity_t	EcsDocBrief
FLECS_API const ecs_entity_t	EcsDocDetail
FLECS_API const ecs_entity_t	EcsDocLink
FLECS_API const ecs_entity_t	EcsDocColor
char *	EcsDocDescription::value

Detailed Description

Utilities for documenting entities, components and systems.

Function Documentation

ecs_doc_get_brief()

FLECS_API const char * ecs_doc_get_brief	(	const ecs_world_t *	world,
		ecs_entity_t	entity
	)

Get brief description from entity.

Parameters

world	The world.
entity	The entity from which to get the description.

Returns

The description.

ecs_doc_get_color()

FLECS_API const char * ecs_doc_get_color	(	const ecs_world_t *	world,
		ecs_entity_t	entity
	)

Get color from entity.

Parameters

world	The world.
entity	The entity from which to get the link.

Returns

The color.

ecs_doc_get_detail()

FLECS_API const char * ecs_doc_get_detail	(	const ecs_world_t *	world,
		ecs_entity_t	entity
	)

Get detailed description from entity.

Parameters

world	The world.
entity	The entity from which to get the description.

Returns

The description.

ecs_doc_get_link()

FLECS_API const char * ecs_doc_get_link	(	const ecs_world_t *	world,
		ecs_entity_t	entity
	)

Get link to external documentation from entity.

Parameters

world	The world.
entity	The entity from which to get the link.

Returns

The link.

ecs_doc_get_name()

FLECS_API const char * ecs_doc_get_name	(	const ecs_world_t *	world,
		ecs_entity_t	entity
	)

Get human readable name from entity.

If entity does not have an explicit human readable name, this operation will return the entity name.

To test if an entity has a human readable name, use: ecs_has_pair(world, e, ecs_id(EcsDescription), EcsName); Or in C++: e.has<flecs::Description>(flecs::Name);

Parameters

world	The world.
entity	The entity from which to get the name.

Returns

The name.

ecs_doc_set_brief()

FLECS_API void ecs_doc_set_brief	(	ecs_world_t *	world,
		ecs_entity_t	entity,
		const char *	description
	)

Add brief description to entity.

Parameters

world	The world.
entity	The entity to which to add the description.
description	The description to add.

ecs_doc_set_color()

FLECS_API void ecs_doc_set_color	(	ecs_world_t *	world,
		ecs_entity_t	entity,
		const char *	color
	)

Add color to entity.

UIs can use color as hint to improve visualizing entities.

Parameters

world	The world.
entity	The entity to which to add the link.
color	The color to add.

ecs_doc_set_detail()

FLECS_API void ecs_doc_set_detail	(	ecs_world_t *	world,
		ecs_entity_t	entity,
		const char *	description
	)

Add detailed description to entity.

Parameters

world	The world.
entity	The entity to which to add the description.
description	The description to add.

ecs_doc_set_link()

FLECS_API void ecs_doc_set_link	(	ecs_world_t *	world,
		ecs_entity_t	entity,
		const char *	link
	)

Add link to external documentation to entity.

Parameters

world	The world.
entity	The entity to which to add the link.
link	The link to add.

ecs_doc_set_name()

FLECS_API void ecs_doc_set_name	(	ecs_world_t *	world,
		ecs_entity_t	entity,
		const char *	name
	)

Add human-readable name to entity.

Contrary to entity names, human readable names do not have to be unique and can contain special characters used in the query language like '*'.

Parameters

world	The world.
entity	The entity to which to add the name.
name	The name to add.

Variable Documentation

value

char* EcsDocDescription::value

Definition at line 39 of file doc.h.