flipbook(1) General Commands Manual flipbook(1)NAME
flipbook - multi-frame editor and viewer derived from drawtool
SYNOPSIS
flipbook [-bookgeom] [-slideshow sec] ['X-params'] [file]
DESCRIPTION
flipbook is a program derived from idraw/drawtool that supports multi-frame graphic display. The zeroth frame is always visible as the
background frame, and in front of it is displayed the current frame (1 thru n).
The Frame menu controls the frame display mechanism. The operations are:
Menu Item Keyboard Description
-------------- -------- -----------
Move Forward ^F move forward one frame
Move Backward ^B move backward one frame
Goto First Frame move to the first frame
Goto Last Frame move to the last frame
New Forward F create new frame in front of the current
frame and make it the current frame
New Backward B create new frame in back of the current
frame and make it the current frame
Copy Forward X copy current frame in front of itself
Copy Backward Y copy current frame in back of itself
Delete D delete current frame (the zeroth frame
can never be deleted)
By default a flipbook document is positioned on the first frame when opened (if one exists). "Move Backward" can be used to move to the
background frame when positioned on the first frame. "Move Forward" then returns to the first frame.
The New command creates a document with only a background frame. The "New After" command can then be used to initialize the first frame
("New Before" does not work when the current frame is the background frame).
flipbook save/restores its documents with a document format specific to flipbook (and possibly programs derived from flipbook). Idraw for-
mat drawings can be imported via the "Import Graphic" command (under the File menu). The rest of the flexibile import mechanism of draw-
tool is supported as well. "Export Graphic" exports currently selected graphics in idraw or drawtool format. The Print command (under the
File menu) generates a multi-page Postscript document, one page per frame except for the zeroth frame which is always the background.
OPTIONS
"-bookgeom" brings up the flipbook in landscape mode, with a 906 by 700 pixel page size. Useful for viewing illustrated books prepared in
this mode.
"-slideshow sec" continuously plays the contents of a flipbook file with "sec" delay between frames (currently only available when built
with ACE).
Also see "-help" for more options, and the comdraw, drawtool, and idraw man pages.
SEE ALSO
drawtool, idraw
WEB PAGE
http://www.ivtools.org/ivtools/flipbook.html
flipbook(1)
Check Out this Related Man Page
libcaca canvas frame handling(3caca) libcaca libcaca canvas frame handling(3caca)NAME
libcaca canvas frame handling -
Functions
__extern int caca_get_frame_count (caca_canvas_t const *)
Get the number of frames in a canvas.
__extern int caca_set_frame (caca_canvas_t *, int)
Activate a given canvas frame.
__extern char const * caca_get_frame_name (caca_canvas_t const *)
Get the current frame's name.
__extern int caca_set_frame_name (caca_canvas_t *, char const *)
Set the current frame's name.
__extern int caca_create_frame (caca_canvas_t *, int)
Add a frame to a canvas.
__extern int caca_free_frame (caca_canvas_t *, int)
Remove a frame from a canvas.
Detailed Description
These functions provide high level routines for canvas frame insertion, removal, copying etc.
Function Documentation
__extern int caca_get_frame_count (caca_canvas_t const *cv) Return the current canvas' frame count.
This function never fails.
Parameters:
cv A libcaca canvas
Returns:
The frame count
Referenced by caca_set_canvas_boundaries().
__extern int caca_set_frame (caca_canvas_t *cv, intid) Set the active canvas frame. All subsequent drawing operations will be performed on that
frame. The current painting context set by caca_set_attr() is inherited.
If the frame index is outside the canvas' frame range, nothing happens.
If an error occurs, -1 is returned and errno is set accordingly:
o EINVAL Requested frame is out of range.
Parameters:
cv A libcaca canvas
id The canvas frame to activate
Returns:
0 in case of success, -1 if an error occurred.
References caca_add_dirty_rect().
Referenced by caca_set_canvas_boundaries().
__extern char const* caca_get_frame_name (caca_canvas_t const *cv) Return the current frame's name. The returned string is valid until the
frame is deleted or caca_set_frame_name() is called to change the frame name again.
This function never fails.
Parameters:
cv A libcaca canvas.
Returns:
The current frame's name.
__extern int caca_set_frame_name (caca_canvas_t *cv, char const *name) Set the current frame's name. Upon creation, a frame has a default name
of 'frame#xxxxxxxx' where xxxxxxxx is a self-incrementing hexadecimal number.
If an error occurs, -1 is returned and errno is set accordingly:
o ENOMEM Not enough memory to allocate new frame.
Parameters:
cv A libcaca canvas.
name The name to give to the current frame.
Returns:
0 in case of success, -1 if an error occurred.
__extern int caca_create_frame (caca_canvas_t *cv, intid) Create a new frame within the given canvas. Its contents and attributes are copied
from the currently active frame.
The frame index indicates where the frame should be inserted. Valid values range from 0 to the current canvas frame count. If the frame
index is greater than or equals the current canvas frame count, the new frame is appended at the end of the canvas. If the frame index is
less than zero, the new frame is inserted at index 0.
The active frame does not change, but its index may be renumbered due to the insertion.
If an error occurs, -1 is returned and errno is set accordingly:
o ENOMEM Not enough memory to allocate new frame.
Parameters:
cv A libcaca canvas
id The index where to insert the new frame
Returns:
0 in case of success, -1 if an error occurred.
Referenced by caca_set_canvas_boundaries().
__extern int caca_free_frame (caca_canvas_t *cv, intid) Delete a frame from a given canvas.
The frame index indicates the frame to delete. Valid values range from 0 to the current canvas frame count minus 1. If the frame index is
greater than or equals the current canvas frame count, the last frame is deleted.
If the active frame is deleted, frame 0 becomes the new active frame. Otherwise, the active frame does not change, but its index may be
renumbered due to the deletion.
If an error occurs, -1 is returned and errno is set accordingly:
o EINVAL Requested frame is out of range, or attempt to delete the last frame of the canvas.
Parameters:
cv A libcaca canvas
id The index of the frame to delete
Returns:
0 in case of success, -1 if an error occurred.
References caca_add_dirty_rect().
Author
Generated automatically by Doxygen for libcaca from the source code.
Version 0.99.beta18 Fri Apr 6 2012 libcaca canvas frame handling(3caca)