Difference between revisions of "Dot:displayedge"

From SpecNext official Wiki
Jump to: navigation, search
(refresh info for v2.2)
 
Line 5: Line 5:
 
Controls:
 
Controls:
  
     OP  : to select the edge of display for editing
+
     SPACE  : select active corner of display (top left vs bottom right)
     HJKL : subtract/add to the margin of selected edge
+
     arrows : edit visible position of the active corner ("cursor joystick")
     Q   : exit back to NextZXOS
+
    (also Kempston/MD controller can be used, fire then selects corner)
     R   : reload the cfg file currently stored on disk (discards any changes)
+
     Q     : exit back to NextZXOS
     S   : save the currently modified values to cfg file
+
     R     : reload the cfg file currently stored on disk (discards any changes)
     F   : change between 50Hz/60Hz mode (also regular "F3" should work)
+
     S     : save the currently modified values to cfg file
     T   : in VGA modes you can switch between different video-mode timings
+
     F     : change between 50Hz/60Hz mode (also regular "F3" key works)
 +
     T     : in VGA modes you can switch between different video-mode timings
 
     (Q/R/S/F/T usually requires confirmation by pressing "Y" after)
 
     (Q/R/S/F/T usually requires confirmation by pressing "Y" after)
  
Line 29: Line 30:
 
-----
 
-----
  
The DISPLAYEDGE dot command and source code is (c) 2020 of Peter Helcmanovsky, published under [https://opensource.org/licenses/MIT MIT license], for latest version of sources or to report issue use the github repository of the project: https://github.com/ped7g/ZXSpectrumNextMisc (latest version is v1.3 from 2020-01-30)
+
The DISPLAYEDGE dot command and source code is (c) 2020 of Peter Helcmanovsky, published under [https://opensource.org/licenses/MIT MIT license], for latest version of sources or to report issue use the github repository of the project: https://github.com/ped7g/ZXSpectrumNextMisc (latest version is v2.2 from 2021-01-23)
  
 
[[Category:System Configuration Tools]]
 
[[Category:System Configuration Tools]]

Latest revision as of 04:59, 2 July 2022

DISPLAYEDGE dot command allows user to store information about visible area of their display in global configuration file /sys/env.cfg

To launch the tool enter .displayedge in command-line, there are no command line arguments (yet).

Controls:

   SPACE  : select active corner of display (top left vs bottom right)
   arrows : edit visible position of the active corner ("cursor joystick")
   (also Kempston/MD controller can be used, fire then selects corner)
   Q      : exit back to NextZXOS
   R      : reload the cfg file currently stored on disk (discards any changes)
   S      : save the currently modified values to cfg file
   F      : change between 50Hz/60Hz mode (also regular "F3" key works)
   T      : in VGA modes you can switch between different video-mode timings
   (Q/R/S/F/T usually requires confirmation by pressing "Y" after)

Some other SW may then read the global configuration file and adjust the playfield area of the SW to avoid displaying important information in invisible (on your display) areas.


The configuration file can be also edited in any text editor, keywords (variables) used by displayedge:
edge_hdmi_50, edge_zx48_50, edge_zx128_50, edge_zx128p3_50, edge_hdmi_60, edge_zx48_60, edge_zx128_60, edge_zx128p3_60, edge_pentagon

For particular mode the line should be keyword=0,1,2,3 where the numbers are amount of invisible pixels on particular edge in order: left, right, top, bottom (valid values are 0 to 31).


If you are creating your own SW and you want to read the configuration, you can use the provided "runtime" part of the code: displayedge_rt.i.asm (check also the project README and source comments for more detailed info about usage).


The DISPLAYEDGE dot command and source code is (c) 2020 of Peter Helcmanovsky, published under MIT license, for latest version of sources or to report issue use the github repository of the project: https://github.com/ped7g/ZXSpectrumNextMisc (latest version is v2.2 from 2021-01-23)