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

FreeBSD Manual Pages

  
 
  

home | help
mapscroller(6)		      XScreenSaver manual		mapscroller(6)

NAME
       mapscroller - a slowly-scrolling	map of a random	place on Earth.

SYNOPSIS
       mapscroller  [--display	host:display.screen] [--visual visual] [--win-
       dow] [--root] [--window-id number] [--delay  number]  [--speed  number]
       [--duration  seconds] [--map-level number] [--url-template URL] [--ori-
       gin LAT/LON] [--no-titles] [--no-arrow] [--fps]

DESCRIPTION
       A slowly-scrolling map of a random place	on Earth.  The map images  are
       loaded from openstreetmap.org, or any compatible	service.

       The Earth is very big, and full of Things.

       As  you ponder these maps, remember that	traffic	always expands to fill
       all available lanes, every car is a policy failure, and the concept  of
       "jaywalking"  was invented for profit by	auto industry lobbyists	in the
       1920s.

OPTIONS
       --visual	visual
	       Specify which visual to use.  Legal values are the  name	 of  a
	       visual  class,  or the id number	(decimal or hex) of a specific
	       visual.

       --window
	       Draw on a newly-created window.	This is	the default.

       --root  Draw on the root	window.

       --window-id number
	       Draw on the specified window.

       --delay number
	       Per-frame delay,	in microseconds.  Default:  30000  (0.03  sec-
	       onds).

       --speed number
	       Scrolling  speed.   2.0	means twice as fast, 0.5 means half as
	       fast.

       --duration seconds
	       When in one of the random modes,	 re-select  the	 map  position
	       every N seconds.	 Default 20 minutes.

       --map-level number
	       Larger numbers are zoomed in more. 5 - 18, default 15.

       --url-template URL
	       The  map	tile server to use. Default: Open Street Map.  You can
	       find others here:

	       https://wiki.openstreetmap.org/wiki/Tiles#Servers

       --origin	location
	       "Random"	means a	fully random location somewhere	on Earth,  ex-
	       cluding the oceans.

	       "Random-city"  means  to	select from a built-in list of several
	       hundred major cities.  This is the default.

	       Otherwise, this must be a latitude/longitude pair, as floats.

       --titles	| --no-titles
	       Whether to show the current coordinates in the upper left.  De-
	       fault true.

       --arrow | --no-arrow
	       Whether to show a  directional  arrow  in  the  middle  of  the
	       screen.	Default	true.

       --fps | --no-fps
	       Whether	to  show  a frames-per-second display at the bottom of
	       the screen.

FILES
       The map tile images are loaded from the network and cached on disk.  Up
       to  20MB	of them	are retained.  Depending on your operating system, the
       cache directory will be one of:

	       $HOME/.cache/xscreensaver/mapscroller/
	       $HOME/tmp/.xscreensaver-mapscroller/
	       $HOME/.xscreensaver-mapscroller.cache/
	       $HOME/Library/Caches/org.jwz.xscreensaver.mapscroller/

BUGS
       Some parts of the world are boring.

ENVIRONMENT
       DISPLAY to get the default host and display number.

       XENVIRONMENT
	       to get the name of a resource file that	overrides  the	global
	       resources stored	in the RESOURCE_MANAGER	property.

       XSCREENSAVER_WINDOW
	       The window ID to	use with --root.

       HTTP_PROXY, HTTPS_PROXY,	http_proxy, or https_proxy
	   to get the default proxy host and port.

SEE ALSO
       X(1), xscreensaver(1), https://www.openstreetmap.org/

COPYRIGHT
       Copyright (C) 2022 by Jamie Zawinski.  Permission to use, copy, modify,
       distribute,  and	 sell this software and	its documentation for any pur-
       pose is hereby granted without fee, provided that the  above  copyright
       notice  appear  in  all	copies and that	both that copyright notice and
       this permission notice appear in	supporting documentation.   No	repre-
       sentations are made about the suitability of this software for any pur-
       pose.  It is provided "as is" without express or	implied	warranty.

       OpenStreetMap map data is (C) OpenStreetMap contributors	under the Open
       Database	License.

AUTHOR
       Jamie Zawinski.

X Version 11		      6.09 (07-Jun-2024)		mapscroller(6)

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

home | help