Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
target_seek(3)			 Arcan Lua API			target_seek(3)

NAME
       target_seek  - Request a	change playback	or presentation	position for a
       frameserver.

SYNOPSIS
       nil
       target_seek( vid:tgt, number:step )
       target_seek( vid:tgt, number:step, bool:relative	)
       target_seek( vid:tgt, number:step, bool:relative	)
       target_seek( vid:tgt, number:step, bool:relative, bool:time )
       target_seek( vid:tgt, number:step, bool:relative, bool:time=false )
       target_seek( vid:tgt, number:step, bool:relative, bool:time=false, num-
       ber:xaxis )
       target_seek( vid:tgt, number:step, bool:relative, bool:time=false, num-
       ber:xaxis, number:zaxis )

DESCRIPTION
       Request an absolute or relative step  sized change  in  active  content
       position	 in  either time or space. Frameservers	communicate this capa-
       bility and the meaning of the ranges through the	'content_state'	event.
       This feature can	be used	to implement things like scrollbars,  as  well
       as  client  side	 defined UI  'scaling'.	If seeking in time  (default),
       the relative (default) step  is expected	to be an  offset  in  milisec-
       onds.  If  setting  an  absolute	 time  position, the absolute step  is
       floating	point in the 0..1 range. If seeking in space	(panning)  the
       relative	(default) is in	a discrete +- steps on a target	defined	scale.
       Absolute	 seeking  is  a	 float in the 0..1 range from start (0)	to end
       (1). The	zaxis  axis is a hint on  magnification	 where,	 the  absolute
       value will treat	1 as normal scale, < 1 as minification and > 1 as mag-
       nification. The boolean arguments relative  and time  has constants de-
       fined as	SEEK_SPACE  | SEEK_TIME	 and SEEK_ABSOLUTE  | SEEK_RELATIVE .

EXAMPLE
       function	target_seek0()
	     vid = launch_avfeed("file=test.mkv", "",
		   function(source, status)
			 if status.kind	== "resized" then
			       show_image(source)
			       resize_image(source, status.width, status.height)
			 end
		   end
	     )
	     target_seek(vid, 100) -- seek +100ms
       end

EXAMPLE
       function	target_seek1()
	     vid = launch_avfeed("file=test.mkv", "",
		   function(source, status)
			 if status.kind	== "resized" then
			       show_image(source)
			       resize_image(source, status.width, status.height)
			 end
		   end
	     )
       end
       function	main_clock_pulse()
	     target_seek(vid, 1, SEEK_RELATIVE,	SEEK_SPACE, 1) -- dx,dy	+= 1 every tick
       end
       end

EXAMPLE
       function	target_seek2()
	     vid = launch_avfeed("file=test.mkv", "",
		   function(source, status)
			 if status.kind	== "resized" then
			       show_image(source)
			       resize_image(source, status.width, status.height)
			 end
		   end
	     )
       end
       function	main_clock_pulse()
	     target_seek(vid, 0, SEEK_ABSOLUTE,	SEEK_SPACE, 0, math.random(0.1,	3)) -- randomized zoom each tick
       end
       end

MISUSE
       function	target_seek0()
	     vid = launch_avfeed("file=test.mkv", "",
		   function(source, status)
			 if status.kind	== "resized" then
			       show_image(source)
			       resize_image(source, status.width, status.height)
			 end
		   end
	     )
       end
	     target_seek(BADID)
       end

targetcontrol			  April	2025			target_seek(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=target_seek&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help