You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

209 lines
5.7 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; you can redistribute it and/or
  9. * modify it under the terms of the Do What The Fuck You Want To
  10. * Public License, Version 2, as published by Sam Hocevar. See
  11. * http://sam.zoy.org/wtfpl/COPYING for more details.
  12. */
  13. /*
  14. * This file contains a small framework for canvas frame management.
  15. */
  16. #include "config.h"
  17. #include "common.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. unsigned int cucul_get_canvas_frame_count(cucul_canvas_t *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 frame The canvas frame to activate
  51. * \return 0 in case of success, -1 if an error occurred.
  52. */
  53. int cucul_set_canvas_frame(cucul_canvas_t *cv, unsigned int frame)
  54. {
  55. if(frame >= cv->framecount)
  56. {
  57. seterrno(EINVAL);
  58. return -1;
  59. }
  60. _cucul_save_frame_info(cv);
  61. cv->frame = frame;
  62. _cucul_load_frame_info(cv);
  63. return 0;
  64. }
  65. /** \brief Add a frame to a canvas.
  66. *
  67. * Create a new frame within the given canvas. Its contents and attributes
  68. * are copied from the currently active frame.
  69. *
  70. * The frame index indicates where the frame should be inserted. Valid
  71. * values range from 0 to the current canvas frame count. If the frame
  72. * index is greater than or equals the current canvas frame count, the new
  73. * frame is appended at the end of the canvas.
  74. *
  75. * The active frame does not change, but its index may be renumbered due
  76. * to the insertion.
  77. *
  78. * If an error occurs, -1 is returned and \b errno is set accordingly:
  79. * - \c ENOMEM Not enough memory to allocate new frame.
  80. *
  81. * \param cv A libcucul canvas
  82. * \param id The index where to insert the new frame
  83. * \return 0 in case of success, -1 if an error occurred.
  84. */
  85. int cucul_create_canvas_frame(cucul_canvas_t *cv, unsigned int id)
  86. {
  87. unsigned int size = cv->width * cv->height;
  88. unsigned int f;
  89. if(id > cv->framecount)
  90. id = cv->framecount;
  91. cv->framecount++;
  92. cv->frames = realloc(cv->frames,
  93. sizeof(struct cucul_frame) * cv->framecount);
  94. for(f = cv->framecount - 1; f > id; f--)
  95. cv->frames[f] = cv->frames[f - 1];
  96. if(cv->frame >= id)
  97. cv->frame++;
  98. cv->frames[id].width = cv->width;
  99. cv->frames[id].height = cv->height;
  100. cv->frames[id].chars = malloc(size * sizeof(uint32_t));
  101. memcpy(cv->frames[id].chars, cv->chars, size * sizeof(uint32_t));
  102. cv->frames[id].attrs = malloc(size * sizeof(uint32_t));
  103. memcpy(cv->frames[id].attrs, cv->attrs, size * sizeof(uint32_t));
  104. cv->frames[id].curattr = cv->curattr;
  105. cv->frames[id].x = cv->frames[cv->frame].x;
  106. cv->frames[id].y = cv->frames[cv->frame].y;
  107. cv->frames[id].handlex = cv->frames[cv->frame].handlex;
  108. cv->frames[id].handley = cv->frames[cv->frame].handley;
  109. return 0;
  110. }
  111. /** \brief Remove a frame from a canvas.
  112. *
  113. * Delete a frame from a given canvas.
  114. *
  115. * The frame index indicates the frame to delete. Valid values range from
  116. * 0 to the current canvas frame count minus 1. If the frame index is
  117. * greater the or equals the current canvas frame count, the last frame
  118. * is deleted.
  119. *
  120. * If the active frame is deleted, frame 0 becomes the new active frame.
  121. * Otherwise, the active frame does not change, but its index may be
  122. * renumbered due to the deletion.
  123. *
  124. * If an error occurs, -1 is returned and \b errno is set accordingly:
  125. * - \c EINVAL Requested frame is out of range, or attempt to delete the
  126. * last frame of the canvas.
  127. *
  128. * \param cv A libcucul canvas
  129. * \param id The index of the frame to delete
  130. * \return 0 in case of success, -1 if an error occurred.
  131. */
  132. int cucul_free_canvas_frame(cucul_canvas_t *cv, unsigned int id)
  133. {
  134. unsigned int f;
  135. if(id >= cv->framecount)
  136. {
  137. seterrno(EINVAL);
  138. return -1;
  139. }
  140. if(cv->framecount == 1)
  141. {
  142. seterrno(EINVAL);
  143. return -1;
  144. }
  145. free(cv->frames[id].chars);
  146. free(cv->frames[id].attrs);
  147. for(f = id + 1; f < cv->framecount; f++)
  148. cv->frames[f - 1] = cv->frames[f];
  149. cv->framecount--;
  150. cv->frames = realloc(cv->frames,
  151. sizeof(struct cucul_frame) * cv->framecount);
  152. if(cv->frame > id)
  153. cv->frame--;
  154. else if(cv->frame == id)
  155. {
  156. cv->frame = 0;
  157. _cucul_load_frame_info(cv);
  158. }
  159. return 0;
  160. }
  161. /*
  162. * XXX: the following functions are local.
  163. */
  164. void _cucul_save_frame_info(cucul_canvas_t *cv)
  165. {
  166. cv->frames[cv->frame].width = cv->width;
  167. cv->frames[cv->frame].height = cv->height;
  168. cv->frames[cv->frame].curattr = cv->curattr;
  169. }
  170. void _cucul_load_frame_info(cucul_canvas_t *cv)
  171. {
  172. cv->width = cv->frames[cv->frame].width;
  173. cv->height = cv->frames[cv->frame].height;
  174. cv->chars = cv->frames[cv->frame].chars;
  175. cv->attrs = cv->frames[cv->frame].attrs;
  176. cv->curattr = cv->frames[cv->frame].curattr;
  177. }