277 lines
16 KiB
C
277 lines
16 KiB
C
/***************************************************************************/
|
|
/* */
|
|
/* ftlist.h */
|
|
/* */
|
|
/* Generic list support for FreeType (specification). */
|
|
/* */
|
|
/* Copyright 1996-2015 by */
|
|
/* David Turner, Robert Wilhelm, and Werner Lemberg. */
|
|
/* */
|
|
/* This file is part of the FreeType project, and may only be used, */
|
|
/* modified, and distributed under the terms of the FreeType project */
|
|
/* license, LICENSE.TXT. By continuing to use, modify, or distribute */
|
|
/* this file you indicate that you have read the license and */
|
|
/* understand and accept it fully. */
|
|
/* */
|
|
/***************************************************************************/
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* This file implements functions relative to list processing. Its */
|
|
/* data structures are defined in `freetype.h'. */
|
|
/* */
|
|
/*************************************************************************/
|
|
|
|
|
|
#ifndef __FTLIST_H__
|
|
#define __FTLIST_H__
|
|
|
|
|
|
#include <ft2build.h>
|
|
#include FT_FREETYPE_H
|
|
|
|
#ifdef FREETYPE_H
|
|
#error "freetype.h of FreeType 1 has been loaded!"
|
|
#error "Please fix the directory search order for header files"
|
|
#error "so that freetype.h of FreeType 2 is found first."
|
|
#endif
|
|
|
|
|
|
FT_BEGIN_HEADER
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Section> */
|
|
/* list_processing */
|
|
/* */
|
|
/* <Title> */
|
|
/* List Processing */
|
|
/* */
|
|
/* <Abstract> */
|
|
/* Simple management of lists. */
|
|
/* */
|
|
/* <Description> */
|
|
/* This section contains various definitions related to list */
|
|
/* processing using doubly-linked nodes. */
|
|
/* */
|
|
/* <Order> */
|
|
/* FT_List */
|
|
/* FT_ListNode */
|
|
/* FT_ListRec */
|
|
/* FT_ListNodeRec */
|
|
/* */
|
|
/* FT_List_Add */
|
|
/* FT_List_Insert */
|
|
/* FT_List_Find */
|
|
/* FT_List_Remove */
|
|
/* FT_List_Up */
|
|
/* FT_List_Iterate */
|
|
/* FT_List_Iterator */
|
|
/* FT_List_Finalize */
|
|
/* FT_List_Destructor */
|
|
/* */
|
|
/*************************************************************************/
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_List_Find */
|
|
/* */
|
|
/* <Description> */
|
|
/* Find the list node for a given listed object. */
|
|
/* */
|
|
/* <Input> */
|
|
/* list :: A pointer to the parent list. */
|
|
/* data :: The address of the listed object. */
|
|
/* */
|
|
/* <Return> */
|
|
/* List node. NULL if it wasn't found. */
|
|
/* */
|
|
FT_EXPORT( FT_ListNode )
|
|
FT_List_Find( FT_List list,
|
|
void* data );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_List_Add */
|
|
/* */
|
|
/* <Description> */
|
|
/* Append an element to the end of a list. */
|
|
/* */
|
|
/* <InOut> */
|
|
/* list :: A pointer to the parent list. */
|
|
/* node :: The node to append. */
|
|
/* */
|
|
FT_EXPORT( void )
|
|
FT_List_Add( FT_List list,
|
|
FT_ListNode node );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_List_Insert */
|
|
/* */
|
|
/* <Description> */
|
|
/* Insert an element at the head of a list. */
|
|
/* */
|
|
/* <InOut> */
|
|
/* list :: A pointer to parent list. */
|
|
/* node :: The node to insert. */
|
|
/* */
|
|
FT_EXPORT( void )
|
|
FT_List_Insert( FT_List list,
|
|
FT_ListNode node );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_List_Remove */
|
|
/* */
|
|
/* <Description> */
|
|
/* Remove a node from a list. This function doesn't check whether */
|
|
/* the node is in the list! */
|
|
/* */
|
|
/* <Input> */
|
|
/* node :: The node to remove. */
|
|
/* */
|
|
/* <InOut> */
|
|
/* list :: A pointer to the parent list. */
|
|
/* */
|
|
FT_EXPORT( void )
|
|
FT_List_Remove( FT_List list,
|
|
FT_ListNode node );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_List_Up */
|
|
/* */
|
|
/* <Description> */
|
|
/* Move a node to the head/top of a list. Used to maintain LRU */
|
|
/* lists. */
|
|
/* */
|
|
/* <InOut> */
|
|
/* list :: A pointer to the parent list. */
|
|
/* node :: The node to move. */
|
|
/* */
|
|
FT_EXPORT( void )
|
|
FT_List_Up( FT_List list,
|
|
FT_ListNode node );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <FuncType> */
|
|
/* FT_List_Iterator */
|
|
/* */
|
|
/* <Description> */
|
|
/* An FT_List iterator function that is called during a list parse */
|
|
/* by @FT_List_Iterate. */
|
|
/* */
|
|
/* <Input> */
|
|
/* node :: The current iteration list node. */
|
|
/* */
|
|
/* user :: A typeless pointer passed to @FT_List_Iterate. */
|
|
/* Can be used to point to the iteration's state. */
|
|
/* */
|
|
typedef FT_Error
|
|
(*FT_List_Iterator)( FT_ListNode node,
|
|
void* user );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_List_Iterate */
|
|
/* */
|
|
/* <Description> */
|
|
/* Parse a list and calls a given iterator function on each element. */
|
|
/* Note that parsing is stopped as soon as one of the iterator calls */
|
|
/* returns a non-zero value. */
|
|
/* */
|
|
/* <Input> */
|
|
/* list :: A handle to the list. */
|
|
/* iterator :: An iterator function, called on each node of the list. */
|
|
/* user :: A user-supplied field that is passed as the second */
|
|
/* argument to the iterator. */
|
|
/* */
|
|
/* <Return> */
|
|
/* The result (a FreeType error code) of the last iterator call. */
|
|
/* */
|
|
FT_EXPORT( FT_Error )
|
|
FT_List_Iterate( FT_List list,
|
|
FT_List_Iterator iterator,
|
|
void* user );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <FuncType> */
|
|
/* FT_List_Destructor */
|
|
/* */
|
|
/* <Description> */
|
|
/* An @FT_List iterator function that is called during a list */
|
|
/* finalization by @FT_List_Finalize to destroy all elements in a */
|
|
/* given list. */
|
|
/* */
|
|
/* <Input> */
|
|
/* system :: The current system object. */
|
|
/* */
|
|
/* data :: The current object to destroy. */
|
|
/* */
|
|
/* user :: A typeless pointer passed to @FT_List_Iterate. It can */
|
|
/* be used to point to the iteration's state. */
|
|
/* */
|
|
typedef void
|
|
(*FT_List_Destructor)( FT_Memory memory,
|
|
void* data,
|
|
void* user );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_List_Finalize */
|
|
/* */
|
|
/* <Description> */
|
|
/* Destroy all elements in the list as well as the list itself. */
|
|
/* */
|
|
/* <Input> */
|
|
/* list :: A handle to the list. */
|
|
/* */
|
|
/* destroy :: A list destructor that will be applied to each element */
|
|
/* of the list. Set this to NULL if not needed. */
|
|
/* */
|
|
/* memory :: The current memory object that handles deallocation. */
|
|
/* */
|
|
/* user :: A user-supplied field that is passed as the last */
|
|
/* argument to the destructor. */
|
|
/* */
|
|
/* <Note> */
|
|
/* This function expects that all nodes added by @FT_List_Add or */
|
|
/* @FT_List_Insert have been dynamically allocated. */
|
|
/* */
|
|
FT_EXPORT( void )
|
|
FT_List_Finalize( FT_List list,
|
|
FT_List_Destructor destroy,
|
|
FT_Memory memory,
|
|
void* user );
|
|
|
|
/* */
|
|
|
|
|
|
FT_END_HEADER
|
|
|
|
#endif /* __FTLIST_H__ */
|
|
|
|
|
|
/* END */
|