Nelze vybrat více než 25 témat Téma musí začínat písmenem nebo číslem, může obsahovat pomlčky („-“) a může být dlouhé až 35 znaků.
 
 
 
 
 
 

261 řádky
7.1 KiB

  1. /*
  2. * libcucul Canvas for ultrafast compositing of Unicode letters
  3. * Copyright (c) 2002-2006 Sam Hocevar <sam@zoy.org>
  4. * All Rights Reserved
  5. *
  6. * $Id$
  7. *
  8. * This library is free software. It comes without any warranty, to
  9. * the extent permitted by applicable law. You can redistribute it
  10. * and/or modify it under the terms of the Do What The Fuck You Want
  11. * To Public License, Version 2, as published by Sam Hocevar. See
  12. * http://sam.zoy.org/wtfpl/COPYING for more details.
  13. */
  14. /*
  15. * This file contains a small framework for canvas frame management.
  16. */
  17. #include "config.h"
  18. #if !defined(__KERNEL__)
  19. # include <stdio.h>
  20. # include <stdlib.h>
  21. # include <string.h>
  22. #endif
  23. #include "cucul.h"
  24. #include "cucul_internals.h"
  25. /** \brief Get the number of frames in a canvas.
  26. *
  27. * Return the current canvas' frame count.
  28. *
  29. * This function never fails.
  30. *
  31. * \param cv A libcucul canvas
  32. * \return The frame count
  33. */
  34. int cucul_get_frame_count(cucul_canvas_t const *cv)
  35. {
  36. return cv->framecount;
  37. }
  38. /** \brief Activate a given canvas frame.
  39. *
  40. * Set the active canvas frame. All subsequent drawing operations will
  41. * be performed on that frame. The current painting context set by
  42. * cucul_set_attr() is inherited.
  43. *
  44. * If the frame index is outside the canvas' frame range, nothing happens.
  45. *
  46. * If an error occurs, -1 is returned and \b errno is set accordingly:
  47. * - \c EINVAL Requested frame is out of range.
  48. *
  49. * \param cv A libcucul canvas
  50. * \param id The canvas frame to activate
  51. * \return 0 in case of success, -1 if an error occurred.
  52. */
  53. int cucul_set_frame(cucul_canvas_t *cv, int id)
  54. {
  55. if(id < 0 || id >= cv->framecount)
  56. {
  57. seterrno(EINVAL);
  58. return -1;
  59. }
  60. _cucul_save_frame_info(cv);
  61. cv->frame = id;
  62. _cucul_load_frame_info(cv);
  63. return 0;
  64. }
  65. /** \brief Get the current frame's name.
  66. *
  67. * Return the current frame's name. The returned string is valid until
  68. * the frame is deleted or cucul_set_frame_name() is called to change
  69. * the frame name again.
  70. *
  71. * This function never fails.
  72. *
  73. * \param cv A libcucul canvas.
  74. * \return The current frame's name.
  75. */
  76. char const *cucul_get_frame_name(cucul_canvas_t const *cv)
  77. {
  78. return cv->frames[cv->frame].name;
  79. }
  80. /** \brief Set the current frame's name.
  81. *
  82. * Set the current frame's name. Upon creation, a frame has a default name
  83. * of \c "frame#xxxxxxxx" where \c xxxxxxxx is a self-incrementing
  84. * hexadecimal number.
  85. *
  86. * If an error occurs, -1 is returned and \b errno is set accordingly:
  87. * - \c ENOMEM Not enough memory to allocate new frame.
  88. *
  89. * \param cv A libcucul canvas.
  90. * \param name The name to give to the current frame.
  91. * \return 0 in case of success, -1 if an error occurred.
  92. */
  93. int cucul_set_frame_name(cucul_canvas_t *cv, char const *name)
  94. {
  95. char *newname = strdup(name);
  96. if(!newname)
  97. {
  98. seterrno(ENOMEM);
  99. return -1;
  100. }
  101. free(cv->frames[cv->frame].name);
  102. cv->frames[cv->frame].name = newname;
  103. return 0;
  104. }
  105. /** \brief Add a frame to a canvas.
  106. *
  107. * Create a new frame within the given canvas. Its contents and attributes
  108. * are copied from the currently active frame.
  109. *
  110. * The frame index indicates where the frame should be inserted. Valid
  111. * values range from 0 to the current canvas frame count. If the frame
  112. * index is greater than or equals the current canvas frame count, the new
  113. * frame is appended at the end of the canvas. If the frame index is less
  114. * than zero, the new frame is inserted at index 0.
  115. *
  116. * The active frame does not change, but its index may be renumbered due
  117. * to the insertion.
  118. *
  119. * If an error occurs, -1 is returned and \b errno is set accordingly:
  120. * - \c ENOMEM Not enough memory to allocate new frame.
  121. *
  122. * \param cv A libcucul canvas
  123. * \param id The index where to insert the new frame
  124. * \return 0 in case of success, -1 if an error occurred.
  125. */
  126. int cucul_create_frame(cucul_canvas_t *cv, int id)
  127. {
  128. int size = cv->width * cv->height;
  129. int f;
  130. if(id < 0)
  131. id = 0;
  132. else if(id > cv->framecount)
  133. id = cv->framecount;
  134. cv->framecount++;
  135. cv->frames = realloc(cv->frames,
  136. sizeof(struct cucul_frame) * cv->framecount);
  137. for(f = cv->framecount - 1; f > id; f--)
  138. cv->frames[f] = cv->frames[f - 1];
  139. if(cv->frame >= id)
  140. cv->frame++;
  141. cv->frames[id].width = cv->width;
  142. cv->frames[id].height = cv->height;
  143. cv->frames[id].chars = malloc(size * sizeof(uint32_t));
  144. memcpy(cv->frames[id].chars, cv->chars, size * sizeof(uint32_t));
  145. cv->frames[id].attrs = malloc(size * sizeof(uint32_t));
  146. memcpy(cv->frames[id].attrs, cv->attrs, size * sizeof(uint32_t));
  147. cv->frames[id].curattr = cv->curattr;
  148. cv->frames[id].x = cv->frames[cv->frame].x;
  149. cv->frames[id].y = cv->frames[cv->frame].y;
  150. cv->frames[id].handlex = cv->frames[cv->frame].handlex;
  151. cv->frames[id].handley = cv->frames[cv->frame].handley;
  152. cv->frames[id].name = strdup("frame#--------");
  153. sprintf(cv->frames[id].name + 6, "%.08x", ++cv->autoinc);
  154. return 0;
  155. }
  156. /** \brief Remove a frame from a canvas.
  157. *
  158. * Delete a frame from a given canvas.
  159. *
  160. * The frame index indicates the frame to delete. Valid values range from
  161. * 0 to the current canvas frame count minus 1. If the frame index is
  162. * greater than or equals the current canvas frame count, the last frame
  163. * is deleted.
  164. *
  165. * If the active frame is deleted, frame 0 becomes the new active frame.
  166. * Otherwise, the active frame does not change, but its index may be
  167. * renumbered due to the deletion.
  168. *
  169. * If an error occurs, -1 is returned and \b errno is set accordingly:
  170. * - \c EINVAL Requested frame is out of range, or attempt to delete the
  171. * last frame of the canvas.
  172. *
  173. * \param cv A libcucul canvas
  174. * \param id The index of the frame to delete
  175. * \return 0 in case of success, -1 if an error occurred.
  176. */
  177. int cucul_free_frame(cucul_canvas_t *cv, int id)
  178. {
  179. int f;
  180. if(id < 0 || id >= cv->framecount)
  181. {
  182. seterrno(EINVAL);
  183. return -1;
  184. }
  185. if(cv->framecount == 1)
  186. {
  187. seterrno(EINVAL);
  188. return -1;
  189. }
  190. free(cv->frames[id].chars);
  191. free(cv->frames[id].attrs);
  192. free(cv->frames[id].name);
  193. for(f = id + 1; f < cv->framecount; f++)
  194. cv->frames[f - 1] = cv->frames[f];
  195. cv->framecount--;
  196. cv->frames = realloc(cv->frames,
  197. sizeof(struct cucul_frame) * cv->framecount);
  198. if(cv->frame > id)
  199. cv->frame--;
  200. else if(cv->frame == id)
  201. {
  202. cv->frame = 0;
  203. _cucul_load_frame_info(cv);
  204. }
  205. return 0;
  206. }
  207. /*
  208. * XXX: the following functions are local.
  209. */
  210. void _cucul_save_frame_info(cucul_canvas_t *cv)
  211. {
  212. cv->frames[cv->frame].width = cv->width;
  213. cv->frames[cv->frame].height = cv->height;
  214. cv->frames[cv->frame].curattr = cv->curattr;
  215. }
  216. void _cucul_load_frame_info(cucul_canvas_t *cv)
  217. {
  218. cv->width = cv->frames[cv->frame].width;
  219. cv->height = cv->frames[cv->frame].height;
  220. cv->chars = cv->frames[cv->frame].chars;
  221. cv->attrs = cv->frames[cv->frame].attrs;
  222. cv->curattr = cv->frames[cv->frame].curattr;
  223. }