https://sourceforge.net/p/arcanfe/wiki/Video%2520Functions/Recent changes to Video FunctionsenWed, 27 Mar 2013 06:13:01 -0000https://sourceforge.net/p/arcanfe/wiki/Video%2520Functions/<div class="markdown_content"><pre>--- v15 +++ v16 @@ -59,6 +59,8 @@ [copy_image_transform] | srcvid, dstvid | | create a duplicate transformation queue [image_origo_offset] | vid, xv, yv, zv | | shift the rotation origo from center of the object to an arbitrary point (world-space) [image_transform_cycle] | srcvid, 1 or 0 | | change how completed transformations are managed +[copy_surface_properties] | srcvid, dstvid | instantly copy current surface properties (position, dimensions etc.) to from src to dst + Texturing ---- @@ -67,6 +69,7 @@ -------- | ---- | ------- | ----------- [image_set_txcos] | vid, tbl(8f) | | override default 2D quad texture coordinates [image_get_txcos] | vid | tbl(8f) | retrieve current 2D quad texture coordinates +[image_set_txcos_default] | vid, *mirror* | replace current 2D quad texture coordinates with the default (optionally flip y if mirror is set [image_scale_txcos] | vid, f_s, f_t | | apply a specific multiplier to current texture coordinates [switch_default_scalemode] | mode_v, mode_h, *vid* | | (global state) change image loading transformations [switch_default_texmode] | mode | | (global state) change image upload behavior </pre> </div>Björn StåhlWed, 27 Mar 2013 06:13:01 -0000https://sourceforge.net031eb6824c5d29c1362b1939e47b65f2298623dchttps://sourceforge.net/p/arcanfe/wiki/Video%2520Functions/<pre>--- v14 +++ v15 @@ -13,6 +13,7 @@ [render_text] | fmtstr, *vspace*, *tspace* | vid, linehtbl | render format string to image [expire_image] | vid, *time* | | timed cleanup call [raw_surface] | vid, w, h, bpp, tbl | vid | convert a table of numeric values into a video object +[persist_image] | vid | irreversible transform allowing VID to survive push/pop operations Measurements / Statistics ---- </pre>Björn StåhlSun, 09 Dec 2012 17:48:46 -0000https://sourceforge.net93a95e09816711dd9e30216f270092680155fa84https://sourceforge.net/p/arcanfe/wiki/Video%2520Functions/<pre>--- v13 +++ v14 @@ -11,7 +11,8 @@ [random_surface] | desw, desh | vid | high-frequency (poor) noise [fill_surface] | visw, vish, r, g, b *storw*, *storh* | vid | generate solid color texture [render_text] | fmtstr, *vspace*, *tspace* | vid, linehtbl | render format string to image -[expire_image] | vid, *time* | | timed cleanup call +[expire_image] | vid, *time* | | timed cleanup call +[raw_surface] | vid, w, h, bpp, tbl | vid | convert a table of numeric values into a video object Measurements / Statistics ---- @@ -26,6 +27,8 @@ [max_current_image_order] | vid | proptbl | finding topmost object [current_context_usage] | vid | proptbl | measure VID namespace usage [image_borderscan] | vid | x1,x2,y1,y2 | find coordinates for border around transparent image center +[image_screen_coordinates] | vid | x, y, x2, y2 | resolve coordinates and transform to screen space + Visibility ---- @@ -53,6 +56,7 @@ [reset_image_transform] | vid | | remove all queued transformations [transfer_image_transform] | srcvid, dstvid | | move transformation queue between VIDs [copy_image_transform] | srcvid, dstvid | | create a duplicate transformation queue +[image_origo_offset] | vid, xv, yv, zv | | shift the rotation origo from center of the object to an arbitrary point (world-space) [image_transform_cycle] | srcvid, 1 or 0 | | change how completed transformations are managed Texturing @@ -65,7 +69,10 @@ [image_scale_txcos] | vid, f_s, f_t | | apply a specific multiplier to current texture coordinates [switch_default_scalemode] | mode_v, mode_h, *vid* | | (global state) change image loading transformations [switch_default_texmode] | mode | | (global state) change image upload behavior +[switch_default_texfilter] | mode | | (global state) change the active texture filtering mode [switch_default_imageproc] | mode | | (global state) change image postprocess transformations +[image_texfilter] | vid, mode | | switch texfilter operation for a single VID + Hierarchy Management ---- </pre>Björn StåhlFri, 26 Oct 2012 01:26:40 -0000https://sourceforge.netbd0aeb601c998d2c3d3f7b34f9e23072f76cddf3https://sourceforge.net/p/arcanfe/wiki/Video%2520Functions/<pre>--- v12 +++ v13 @@ -83,7 +83,7 @@ function | args | returns | description -------- | ---- | ------- | ----------- [image_framesetsize] | vid, ncells, mode | | force increment the number of allowed frames -[image_framecyclemode] vid, cyclerate | | automatically switch between active frames +[image_framecyclemode] | vid, cyclerate | | automatically switch between active frames [set_image_as_frame] | contvid, framevid, slot, *detach* | | link an image to a specific frameset [image_active_frame] | contvid, slot | | change the current active frame </pre>Björn StåhlWed, 24 Oct 2012 03:24:45 -0000https://sourceforge.net27bd15e7fd51b70153cd44a7a1fa0d45a3f2c32ahttps://sourceforge.net/p/arcanfe/wiki/Video%2520Functions/<pre>--- v11 +++ v12 @@ -93,7 +93,7 @@ function | args | returns | description -------- | ---- | ------- | ----------- [image_mask_toggle] | vid, mask | | invert a specific mask flag -[image_mask_set] | | vid, mask | | force-set a specific mask flag +[image_mask_set] | vid, mask | | force-set a specific mask flag [image_mask_clear] | vid, mask | | force-clear a specific mask flag [image_mask_clearall] | rvid | | eset mask options to default </pre>Björn StåhlWed, 24 Oct 2012 03:24:09 -0000https://sourceforge.netc5912ba5226bcd72d255294b1d5a492870906c3bhttps://sourceforge.net/p/arcanfe/wiki/Video%2520Functions/<pre>--- v10 +++ v11 @@ -5,13 +5,13 @@ -------- | ---- | ------- | ----------- [load_image] | path, *order*, *desw*, *desh* | vid | image loading [load_image_asynch] | path, *handler* | vid | asynchronous image loading -[delete_image] | vid | nil | removing / freeing resources -[pop_video_context] | | nil | mass- deallocation / cleanup -[push_video_context] | | nil | save/hide current pipeline +[delete_image] | vid | | removing / freeing resources +[pop_video_context] | | | mass- deallocation / cleanup +[push_video_context] | | | save/hide current pipeline [random_surface] | desw, desh | vid | high-frequency (poor) noise [fill_surface] | visw, vish, r, g, b *storw*, *storh* | vid | generate solid color texture [render_text] | fmtstr, *vspace*, *tspace* | vid, linehtbl | render format string to image -[expire_image] | vid, *time* | nil | timed cleanup call +[expire_image] | vid, *time* | | timed cleanup call Measurements / Statistics ---- @@ -32,79 +32,79 @@ function | args | returns | description -------- | ---- | ------- | ----------- -[show_image] | vid | nil | set visibility to 1.0 -[hide_image] | vid | nil | set visibility to 0.0 -[blend_image] | vid, opa, *time* | nil | set specific (0..1 range) opacity -[order_image] | vid, order | nil | change draw order -[image_clip_on] | vid | nil | toggle clipping for hierarchical objects -[image_clip_off] | vid | nil | toggle clipping for hierarchical objects -[force_image_blend] | vid, *blendmode* | use alpha- channel in 1.0 visibility +[show_image] | vid | | set visibility to 1.0 +[hide_image] | vid | | set visibility to 0.0 +[blend_image] | vid, opa, *time* | | set specific (0..1 range) opacity +[order_image] | vid, order | | change draw order +[image_clip_on] | vid | | toggle clipping for hierarchical objects +[image_clip_off] | vid | | toggle clipping for hierarchical objects +[force_image_blend] | vid, *blendmode* | | use alpha- channel in 1.0 visibility Transformations ---- function | args | returns | description -------- | ---- | ------- | ----------- -[move_image] | vid, x, y, *time* | nil | reposition -[rotate_image] | vid, deg, *time* | nil | reorient -[scale_image] | vid, sfw, sfh, *time* | nil | setting relative scale -[resize_image] | vid, wpx, hpx, *time* | nil | setting absolute dimensions -[instant_image_transform] | vid | nil | apply all queued transformations -[reset_image_transform] | vid | nil | remove all queued transformations -[transfer_image_transform] | srcvid, dstvid | nil | move transformation queue between VIDs -[copy_image_transform] | srcvid, dstvid | nil | create a duplicate transformation queue -[image_transform_cycle] | srcvid, 1 or 0 | nil | change how completed transformations are managed +[move_image] | vid, x, y, *time* | | reposition +[rotate_image] | vid, deg, *time* | | reorient +[scale_image] | vid, sfw, sfh, *time* | | setting relative scale +[resize_image] | vid, wpx, hpx, *time* | | setting absolute dimensions +[instant_image_transform] | vid | | apply all queued transformations +[reset_image_transform] | vid | | remove all queued transformations +[transfer_image_transform] | srcvid, dstvid | | move transformation queue between VIDs +[copy_image_transform] | srcvid, dstvid | | create a duplicate transformation queue +[image_transform_cycle] | srcvid, 1 or 0 | | change how completed transformations are managed Texturing ---- function | args | returns | description -------- | ---- | ------- | ----------- -[image_set_txcos] | override default 2D quad texture coordinates -[image_get_txcos] | retrieve current 2D quad texture coordinates -[image_scale_txcos] | apply a specific multiplier to current texture coordinates -[switch_default_scalemode] | (global state) change image loading transformations -[switch_default_texmode] | (global state) change image upload transformations -[switch_default_imageproc] | (global state) change image postprocess transformations +[image_set_txcos] | vid, tbl(8f) | | override default 2D quad texture coordinates +[image_get_txcos] | vid | tbl(8f) | retrieve current 2D quad texture coordinates +[image_scale_txcos] | vid, f_s, f_t | | apply a specific multiplier to current texture coordinates +[switch_default_scalemode] | mode_v, mode_h, *vid* | | (global state) change image loading transformations +[switch_default_texmode] | mode | | (global state) change image upload behavior +[switch_default_imageproc] | mode | | (global state) change image postprocess transformations Hierarchy Management ---- function | args | returns | description -------- | ---- | ------- | ----------- -[instance_image] | create a linked clone of an image -[link_image] | link coordinate and transformation spaces -[image_children] | find all children associated with a VID -[image_parent] | find image parent +[instance_image] | vid | newvid | create a linked clone of an image +[link_image] | src, parent | bool | link coordinate and transformation spaces +[image_children] | vid | vidary | find all children associated with a VID +[image_parent] | vid | parent | find image parent Framesets ---- function | args | returns | description -------- | ---- | ------- | ----------- -[image_framesetsize] | force increment the number of allowed frames -[image_framecyclemode] | automatically switch between active frames -[set_image_as_frame] | link an image to a specific frameset -[image_active_frame] | change the current active frame +[image_framesetsize] | vid, ncells, mode | | force increment the number of allowed frames +[image_framecyclemode] vid, cyclerate | | automatically switch between active frames +[set_image_as_frame] | contvid, framevid, slot, *detach* | | link an image to a specific frameset +[image_active_frame] | contvid, slot | | change the current active frame Masking ---- function | args | returns | description -------- | ---- | ------- | ----------- -[image_mask_toggle] | invert a specific mask flag -[image_mask_set] | force-set a specific mask flag -[image_mask_clear] | force-clear a specific mask flag -[image_mask_clearall] | reset mask options to default +[image_mask_toggle] | vid, mask | | invert a specific mask flag +[image_mask_set] | | vid, mask | | force-set a specific mask flag +[image_mask_clear] | vid, mask | | force-clear a specific mask flag +[image_mask_clearall] | rvid | | eset mask options to default Miscellaneous ---- function | args | returns | description -------- | ---- | ------- | ----------- -[image_pushasynch] | block until all asynch operations are completed -[valid_vid] | determine if a VID is valid or not -[define_rendertarget] | (0.2.1) render a set of VIDs to an offscreen image -[define_recordtarget] | (0.2.1) take a subset of AIDs / VIDs and record -[save_screenshot] | (0.2.1) take a screenshot of the current display +[image_pushasynch] | vid | | block until all asynch operations on the vid are completed +[valid_vid] | vid | bool | determine if a VID is valid or not +[define_rendertarget] | vid, vidary, detachopt, scaleopt | | render a set of VIDs to an offscreen image +[define_recordtarget] | vid, dstres, fmtstr, vidary, aidary, detach, scale, pollrate | | take a subset of AIDs / VIDs and record +[save_screenshot] | dstres | | take a screenshot of the current display </pre>Björn StåhlWed, 24 Oct 2012 03:22:34 -0000https://sourceforge.netebac9851c23ae073be711e233a73077053503fbfhttps://sourceforge.net/p/arcanfe/wiki/Video%2520Functions/<pre>--- v9 +++ v10 @@ -8,58 +8,58 @@ [delete_image] | vid | nil | removing / freeing resources [pop_video_context] | | nil | mass- deallocation / cleanup [push_video_context] | | nil | save/hide current pipeline -[random_surface] => vid | desw, desh | nil | high-frequency (poor) noise -[fill_surface] | visw, vish, r, g, b *storw*, *storh* | nil | generate solid color texture +[random_surface] | desw, desh | vid | high-frequency (poor) noise +[fill_surface] | visw, vish, r, g, b *storw*, *storh* | vid | generate solid color texture [render_text] | fmtstr, *vspace*, *tspace* | vid, linehtbl | render format string to image -[expire_image] | vid, *time* | timed cleanup call +[expire_image] | vid, *time* | nil | timed cleanup call Measurements / Statistics ---- -function | description --------- | ----------- -[text_dimensions] | estimate [render_text] output -[image_storage_properties] | measure resource use -[image_surface_resolve_properties] | derive world- transform state -[image_surface_properties] | transform state in object space -[image_surface_initial_properties] | dimensions after load -[max_current_image_order] | finding topmost object -[current_context_usage] | measure VID namespace usage -[image_borderscan] | find coordinates for border around transparent image center +function | args | returns | description +-------- | ---- | ------- | ----------- +[text_dimensions] | fmtstr, *vspace*, *tspace* | maxw, maxh | estimate [render_text] output +[image_storage_properties] | vid | proptbl | measure resource use +[image_surface_resolve_properties] | vid, *time* | proptbl | derive world- transform state +[image_surface_properties] | vid, *time* | proptbl | transform state in object space +[image_surface_initial_properties] | vid | proptbl | dimensions after load +[max_current_image_order] | vid | proptbl | finding topmost object +[current_context_usage] | vid | proptbl | measure VID namespace usage +[image_borderscan] | vid | x1,x2,y1,y2 | find coordinates for border around transparent image center Visibility ---- -function | description --------- | ----------- -[show_image] | set visibility to 1.0 -[hide_image] | set visibility to 0.0 -[blend_image] | set specific (0..1 range) opacity -[order_image] | change draw order -[image_clip_on] | toggle clipping for hierarchical objects -[image_clip_off] | toggle clipping for hierarchical objects -[force_image_blend] | use alpha- channel in 1.0 visibility +function | args | returns | description +-------- | ---- | ------- | ----------- +[show_image] | vid | nil | set visibility to 1.0 +[hide_image] | vid | nil | set visibility to 0.0 +[blend_image] | vid, opa, *time* | nil | set specific (0..1 range) opacity +[order_image] | vid, order | nil | change draw order +[image_clip_on] | vid | nil | toggle clipping for hierarchical objects +[image_clip_off] | vid | nil | toggle clipping for hierarchical objects +[force_image_blend] | vid, *blendmode* | use alpha- channel in 1.0 visibility Transformations ---- -function | description --------- | ----------- -[move_image] | reposition -[rotate_image] | reorient -[scale_image] | setting relative scale -[resize_image] | setting absolute dimensions -[instant_image_transform] | apply all queued transformations -[reset_image_transform] | remove all queued transformations -[transfer_image_transform] | move transformation queue between VIDs -[copy_image_transform] | create a duplicate transformation queue -[image_transform_cycle] | change how completed transformations are managed +function | args | returns | description +-------- | ---- | ------- | ----------- +[move_image] | vid, x, y, *time* | nil | reposition +[rotate_image] | vid, deg, *time* | nil | reorient +[scale_image] | vid, sfw, sfh, *time* | nil | setting relative scale +[resize_image] | vid, wpx, hpx, *time* | nil | setting absolute dimensions +[instant_image_transform] | vid | nil | apply all queued transformations +[reset_image_transform] | vid | nil | remove all queued transformations +[transfer_image_transform] | srcvid, dstvid | nil | move transformation queue between VIDs +[copy_image_transform] | srcvid, dstvid | nil | create a duplicate transformation queue +[image_transform_cycle] | srcvid, 1 or 0 | nil | change how completed transformations are managed Texturing ---- -function | description --------- | ----------- +function | args | returns | description +-------- | ---- | ------- | ----------- [image_set_txcos] | override default 2D quad texture coordinates [image_get_txcos] | retrieve current 2D quad texture coordinates [image_scale_txcos] | apply a specific multiplier to current texture coordinates @@ -70,8 +70,8 @@ Hierarchy Management ---- -function | description --------- | ----------- +function | args | returns | description +-------- | ---- | ------- | ----------- [instance_image] | create a linked clone of an image [link_image] | link coordinate and transformation spaces [image_children] | find all children associated with a VID @@ -80,8 +80,8 @@ Framesets ---- -function | description --------- | ----------- +function | args | returns | description +-------- | ---- | ------- | ----------- [image_framesetsize] | force increment the number of allowed frames [image_framecyclemode] | automatically switch between active frames [set_image_as_frame] | link an image to a specific frameset @@ -90,8 +90,8 @@ Masking ---- -function | description --------- | ----------- +function | args | returns | description +-------- | ---- | ------- | ----------- [image_mask_toggle] | invert a specific mask flag [image_mask_set] | force-set a specific mask flag [image_mask_clear] | force-clear a specific mask flag @@ -100,8 +100,8 @@ Miscellaneous ---- -function | description --------- | ----------- +function | args | returns | description +-------- | ---- | ------- | ----------- [image_pushasynch] | block until all asynch operations are completed [valid_vid] | determine if a VID is valid or not [define_rendertarget] | (0.2.1) render a set of VIDs to an offscreen image </pre>Björn StåhlWed, 24 Oct 2012 02:07:21 -0000https://sourceforge.net0b6c06e40cf6e2157c07314b970c1ea4411a3a92https://sourceforge.net/p/arcanfe/wiki/Video%2520Functions/<pre>--- v8 +++ v9 @@ -1,17 +1,17 @@ Creation / Destruction ---- -function | args | description --------- | ---- | ----------- -[load_image] => vid | path, *order*, *desw*, *desh* | image loading -[load_image_asynch] => vid | path, *handler* | asynchronous image loading -[delete_image] | vid | removing / freeing resources -[pop_video_context] | | mass- deallocation / cleanup -[push_video_context] | | save/hide current pipeline -[random_surface] => vid | desw, desh | high-frequency (poor) noise -[fill_surface] | visw, vish, r, g, b *storw*, *storh* | generate solid color texture -[render_text] | render format string to image -[expire_image] | timed cleanup call +function | args | returns | description +-------- | ---- | ------- | ----------- +[load_image] | path, *order*, *desw*, *desh* | vid | image loading +[load_image_asynch] | path, *handler* | vid | asynchronous image loading +[delete_image] | vid | nil | removing / freeing resources +[pop_video_context] | | nil | mass- deallocation / cleanup +[push_video_context] | | nil | save/hide current pipeline +[random_surface] => vid | desw, desh | nil | high-frequency (poor) noise +[fill_surface] | visw, vish, r, g, b *storw*, *storh* | nil | generate solid color texture +[render_text] | fmtstr, *vspace*, *tspace* | vid, linehtbl | render format string to image +[expire_image] | vid, *time* | timed cleanup call Measurements / Statistics ---- </pre>Björn StåhlWed, 24 Oct 2012 01:53:26 -0000https://sourceforge.net51e5a6db2b455047a53ca062314b71484e82adbdhttps://sourceforge.net/p/arcanfe/wiki/Video%2520Functions/<pre>--- v7 +++ v8 @@ -1,15 +1,15 @@ Creation / Destruction ---- -function | description --------- | ----------- -[load_image] | image loading -[load_image_asynch] | asynchronous image loading -[delete_image] | removing / freeing resources -[pop_video_context] | mass- deallocation / cleanup -[push_video_context] | save/hide current pipeline -[random_surface] | high-frequency (poor) noise -[fill_surface] | generate solid color texture +function | args | description +-------- | ---- | ----------- +[load_image] => vid | path, *order*, *desw*, *desh* | image loading +[load_image_asynch] => vid | path, *handler* | asynchronous image loading +[delete_image] | vid | removing / freeing resources +[pop_video_context] | | mass- deallocation / cleanup +[push_video_context] | | save/hide current pipeline +[random_surface] => vid | desw, desh | high-frequency (poor) noise +[fill_surface] | visw, vish, r, g, b *storw*, *storh* | generate solid color texture [render_text] | render format string to image [expire_image] | timed cleanup call </pre>Björn StåhlWed, 24 Oct 2012 01:50:24 -0000https://sourceforge.net6ac3354bfe702a41950c7626726d403d256c4721https://sourceforge.net/p/arcanfe/wiki/Video%2520Functions/<pre></pre>Björn StåhlTue, 23 Oct 2012 12:43:03 -0000https://sourceforge.net7cf2c09250b278eee1244d59586c581560004bad