Difference between revisions of "HowTo:Configure your favorite text editor to work with POV-Ray"

From POV-Wiki
Jump to navigation Jump to search
m (/* POV-Ray supporting text editors * /I took the liberty of adding two more POV syntax highlighted working options(Maurice))
 
(27 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
==POV-Ray supporting text editors==
 
==POV-Ray supporting text editors==
  
;Windows
+
;BSD
*[http://www.qwined.org/products/qwined/schemas.htm Qwined]
+
*[http://nextpe.sourceforge.net/ neXtgen Povray Editor]
*[http://www.scintilla.org/SciTE.html SciTE]
+
*[https://www.freebsd.org/cgi/man.cgi?query=vim&amp%3Bsektion=1&amp%3Bmanpath=FreeBSD+8.2-RELEASE+and+Ports Vim]features POV highlighting and POV CTags support file can be found [http://news.povray.org/povray.binaries.utilities/thread/%3Cweb.5e0e133572d06ba48c662f470%40news.povray.org%3E/ on the newsgroups]
 +
*[https://www.freshports.org/graphics/blender/ Blender] has a text editor with POV features when native addon is activated
  
 
;Linux
 
;Linux
Line 10: Line 11:
 
*[http://www.kpovmodeler.org/ KPovModeler]
 
*[http://www.kpovmodeler.org/ KPovModeler]
 
*[http://kate-editor.org/ Kate]
 
*[http://kate-editor.org/ Kate]
 +
*[https://www.vim.org/ Vim]
 +
*[https://www.blender.org/download/ Blender]'s text editor
 +
 +
;Windows
 +
*[http://www.qwined.org/products/qwined/schemas.htm Qwined]
 +
*[http://www.scintilla.org/SciTE.html SciTE]
 +
*[http://nextpe.sourceforge.net/ neXtgen Povray Editor]
 +
*[http://www.contexteditor.org/ ConTEXT] using a [http://cdn.contextstatic.org/downloads/highlighters/POV-Ray.chl language extension]
 +
*[https://www.vim.org/download.php#pc Vim]
 +
*[https://www.blender.org/download/ Blender]'s text editor
  
 
== Instructions ==
 
== Instructions ==
  
;SciTE on Windows
+
;SciTE on Windows (other platforms should be similar)
  
Syntax highlighting is already supported by default. However, POV-Ray is missing from some of the menus. To fix this:
+
Syntax highlighting of POV-Ray SDL is already supported by default. However, an option for POV-Ray is missing from some of the necessary menus and dialogs. To fix this:
  
 
# Select the "Options" menu. Select "Open Global Options File". A text file with a bunch of SciTE configuration settings will open in the editor window.
 
# Select the "Options" menu. Select "Open Global Options File". A text file with a bunch of SciTE configuration settings will open in the editor window.
# Scroll to the section that starts with "The open.filter setting is used in the file selector which has a menu of filters to apply...". Add the common POV-Ray file extensions to the list. These include the POV, INC, INI and MCR extensions. After restarting SciTE Povray source files should now be listed in the "Open File", "Save File", etc. dialogs.
+
# Scroll down to the section that looks like this:<pre>source.files=*.asm;*.c;*.cc;*.cpp;*.cxx;*.cs;*.h;*.hh;*.hxx;*.hpp;\</pre><pre>*.idl;*.odl;*.rc;*.rc2;*.dlg;*.def;\</pre><pre>*.vb;*.vbs;*.bas;*.frm;*.cls;*.ctl;\</pre><pre>*.java;*.js;*.py;*.pl;*.rb;*.cgi;*.lua;*.conf;\</pre><pre>make*;*.mak;\</pre><pre>*.properties;*.html;*.xml;*.iface;*.bat;*.el</pre>
# Scroll to the section labeled "Define the Lexer menu". Uncomment the line that reads "P&OV-Ray SDL|pov||\". After restarting SciTE Povray should now appear in the "Language" menu.
+
# Add the common POV-Ray file extensions to the list. These include the POV, INC, INI and MCR extensions. It should now look like this:<pre>source.files=*.asm;*.c;*.cc;*.cpp;*.cxx;*.cs;*.h;*.hh;*.hxx;*.hpp;\</pre><pre>*.idl;*.odl;*.rc;*.rc2;*.dlg;*.def;\</pre><pre>*.vb;*.vbs;*.bas;*.frm;*.cls;*.ctl;\</pre><pre>*.java;*.js;*.py;*.pl;*.rb;*.cgi;*.lua;*.conf;\</pre><pre>make*;*.mak;\</pre><pre>*.properties;*.html;*.xml;*.iface;*.bat;*.el;*.pov;*.inc;*.ini;*.mcr</pre>
 +
# After restarting SciTE Povray source files should now be listed in the "Open File", "Save File", etc. dialogs.
 +
# Scroll to the section labeled "Define the Lexer menu". Uncomment the line that reads:<pre>#P&OV-Ray SDL|pov||\</pre>
 +
# It should now look like this:<pre>P&OV-Ray SDL|pov||\</pre>
 +
# After restarting SciTE an entry for POV-Ray SDL should now appear in the "Language" menu.
 +
 
 +
To set up SciTE to send files to POV-Ray for editing:
 +
 
 +
# Select the "Options" menu and select "Open pov.properties". A text file with POV-Ray-specific configuration settings will open in the editor window.
 +
# Scroll down to where it says:<pre>command.compile.*.pov=pvengine.exe $(FileName)</pre>
 +
# Replace the line with the following. Also change the file path to reflect the location of your POV-Ray installation. On my system (Windows 7) it ended up being:<pre>command.build.*.pov=cmd /c start "" "C:\Users\...username...\AppData\Roaming\POV-Ray\v3.6\bin\pvengine64.exe" /EDIT "$(FilePath)"</pre>
 +
# Note: The <tt>cmd /c start ""</tt> part is necessary to keep SciTE from waiting for POV-Ray to quit.
 +
# After restarting SciTE pressing the F7 key should now automatically send the file to POV-Ray for editing.
  
 
To set up SciTE to send files to POV-Ray for rendering:
 
To set up SciTE to send files to POV-Ray for rendering:
  
# Select the "Options" menu. Select "Open pov.properties". A text file with POV-Ray-specific configuration settings will open in the editor window.
+
# If not already open, select the "Options" menu and select "Open pov.properties". A text file with POV-Ray-specific configuration settings will open in the editor window.
# Scroll down to where it says "if PLAT_WIN". ''[Then what? To be continued.]''
+
# Scroll down to where it says:<pre>command.go.*.pov=pvengine.exe $(FileName)</pre>
 +
# Replace the line with the following. Also change the file path to reflect the location of your POV-Ray installation. On my system it ended up being:<pre>command.go.*.pov=cmd /c start "" "C:\Users\...username...\AppData\Roaming\POV-Ray\v3.6\bin\pvengine64.exe" /RENDER "$(FilePath)"</pre>
 +
# Note: The <tt>cmd /c start ""</tt> part is necessary to keep SciTE from waiting for POV-Ray to quit.
 +
# After restarting SciTE pressing the F5 key should now automatically send the file to POV-Ray for rendering.
  
To set up SciTe for context-sensitive help:
+
To set up SciTE for context-sensitive POV-Ray help:
  
 
# Select the "Options" menu. Select "Open pov.properties". A text file with POV-Ray-specific configuration settings will open in the editor window.
 
# Select the "Options" menu. Select "Open pov.properties". A text file with POV-Ray-specific configuration settings will open in the editor window.
# Scroll down to where it says "if PLAT_WIN". Where it says:<br><pre>command.help.$(file.patterns.pov)=$(CurrentWord)!...</pre><br>change the file path to reflect the location of your POV-Ray installation. On my system it was:<br><pre>command.help.$(file.patterns.pov)=$(CurrentWord)!C:\Users\...username...\AppData\Roaming\POV-Ray\v3.6\help\povray36.chm</pre>
+
# Scroll down to where it says:<pre>command.help.$(file.patterns.pov)=$(CurrentWord)!...</pre>change the file path to reflect the location of your POV-Ray installation. On my system it was:<pre>command.help.$(file.patterns.pov)=$(CurrentWord)!C:\Users\...username...\AppData\Roaming\POV-Ray\v3.6\help\povray36.chm</pre>
 +
# After restarting SciTE pressing the F1 key should now automatically open the POV-Ray help file to the correct entry based on the keyword you have highlighted in the scene description file.
  
 
==External links==
 
==External links==
 
*[http://news.povray.org/povray.unix/thread/%[email protected]%3E/ Comfortable editor for POV-Ray under Debian Linux?]
 
*[http://news.povray.org/povray.unix/thread/%[email protected]%3E/ Comfortable editor for POV-Ray under Debian Linux?]
 
*[http://www.povray.org/download/unix-tools.php Useful tools for POV-Ray for Unix]
 
*[http://www.povray.org/download/unix-tools.php Useful tools for POV-Ray for Unix]

Latest revision as of 16:25, 13 May 2021

POV-Ray supporting text editors

BSD
Linux
Windows

Instructions

SciTE on Windows (other platforms should be similar)

Syntax highlighting of POV-Ray SDL is already supported by default. However, an option for POV-Ray is missing from some of the necessary menus and dialogs. To fix this:

  1. Select the "Options" menu. Select "Open Global Options File". A text file with a bunch of SciTE configuration settings will open in the editor window.
  2. Scroll down to the section that looks like this:
    source.files=*.asm;*.c;*.cc;*.cpp;*.cxx;*.cs;*.h;*.hh;*.hxx;*.hpp;\
    *.idl;*.odl;*.rc;*.rc2;*.dlg;*.def;\
    *.vb;*.vbs;*.bas;*.frm;*.cls;*.ctl;\
    *.java;*.js;*.py;*.pl;*.rb;*.cgi;*.lua;*.conf;\
    make*;*.mak;\
    *.properties;*.html;*.xml;*.iface;*.bat;*.el
  3. Add the common POV-Ray file extensions to the list. These include the POV, INC, INI and MCR extensions. It should now look like this:
    source.files=*.asm;*.c;*.cc;*.cpp;*.cxx;*.cs;*.h;*.hh;*.hxx;*.hpp;\
    *.idl;*.odl;*.rc;*.rc2;*.dlg;*.def;\
    *.vb;*.vbs;*.bas;*.frm;*.cls;*.ctl;\
    *.java;*.js;*.py;*.pl;*.rb;*.cgi;*.lua;*.conf;\
    make*;*.mak;\
    *.properties;*.html;*.xml;*.iface;*.bat;*.el;*.pov;*.inc;*.ini;*.mcr
  4. After restarting SciTE Povray source files should now be listed in the "Open File", "Save File", etc. dialogs.
  5. Scroll to the section labeled "Define the Lexer menu". Uncomment the line that reads:
    #P&OV-Ray SDL|pov||\
  6. It should now look like this:
    P&OV-Ray SDL|pov||\
  7. After restarting SciTE an entry for POV-Ray SDL should now appear in the "Language" menu.

To set up SciTE to send files to POV-Ray for editing:

  1. Select the "Options" menu and select "Open pov.properties". A text file with POV-Ray-specific configuration settings will open in the editor window.
  2. Scroll down to where it says:
    command.compile.*.pov=pvengine.exe $(FileName)
  3. Replace the line with the following. Also change the file path to reflect the location of your POV-Ray installation. On my system (Windows 7) it ended up being:
    command.build.*.pov=cmd /c start "" "C:\Users\...username...\AppData\Roaming\POV-Ray\v3.6\bin\pvengine64.exe" /EDIT "$(FilePath)"
  4. Note: The cmd /c start "" part is necessary to keep SciTE from waiting for POV-Ray to quit.
  5. After restarting SciTE pressing the F7 key should now automatically send the file to POV-Ray for editing.

To set up SciTE to send files to POV-Ray for rendering:

  1. If not already open, select the "Options" menu and select "Open pov.properties". A text file with POV-Ray-specific configuration settings will open in the editor window.
  2. Scroll down to where it says:
    command.go.*.pov=pvengine.exe $(FileName)
  3. Replace the line with the following. Also change the file path to reflect the location of your POV-Ray installation. On my system it ended up being:
    command.go.*.pov=cmd /c start "" "C:\Users\...username...\AppData\Roaming\POV-Ray\v3.6\bin\pvengine64.exe" /RENDER "$(FilePath)"
  4. Note: The cmd /c start "" part is necessary to keep SciTE from waiting for POV-Ray to quit.
  5. After restarting SciTE pressing the F5 key should now automatically send the file to POV-Ray for rendering.

To set up SciTE for context-sensitive POV-Ray help:

  1. Select the "Options" menu. Select "Open pov.properties". A text file with POV-Ray-specific configuration settings will open in the editor window.
  2. Scroll down to where it says:
    command.help.$(file.patterns.pov)=$(CurrentWord)!...
    change the file path to reflect the location of your POV-Ray installation. On my system it was:
    command.help.$(file.patterns.pov)=$(CurrentWord)!C:\Users\...username...\AppData\Roaming\POV-Ray\v3.6\help\povray36.chm
  3. After restarting SciTE pressing the F1 key should now automatically open the POV-Ray help file to the correct entry based on the keyword you have highlighted in the scene description file.

External links